Splunk

Konektor Splunk memungkinkan Anda melakukan operasi penyisipan, penghapusan, pembaruan, dan baca di database Splunk.

Sebelum memulai

Sebelum menggunakan konektor Splunk, lakukan tugas berikut:

• Di project Google Cloud Anda:
  • Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
  • Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk konektor:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    Akun layanan adalah jenis Akun Google khusus yang dimaksudkan untuk mewakili pengguna non-manusia yang perlu melakukan autentikasi dan diberi otorisasi untuk mengakses data di Google API. Jika tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk mengetahui informasi selengkapnya, lihat Membuat akun layanan.

  • Aktifkan layanan berikut:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (Connectors API)

    Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan.

  Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

Mengonfigurasi konektor

Mengonfigurasi konektor mengharuskan Anda membuat koneksi ke sumber data (sistem backend). Koneksi bersifat khusus untuk sumber data. Artinya, jika memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan langkah-langkah berikut:

1. Di Konsol Cloud, buka halaman Integration Connectors > Connections, lalu pilih atau buat project Google Cloud.

   Buka halaman Connections

2. Klik + CREATE NEW untuk membuka halaman Create Connection.
3. Di bagian Lokasi, pilih lokasi untuk koneksi.
   1. Region: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua wilayah yang didukung, lihat Lokasi.

   2. Klik BERIKUTNYA.
4. Di bagian Connection Details, selesaikan tindakan berikut:
   1. Konektor: Pilih Splunk dari menu drop-down Konektor yang tersedia.
   2. Versi konektor: Pilih versi Konektor dari menu drop-down versi yang tersedia.
   3. Di kolom Connection Name, masukkan nama untuk instance Connection.

      Nama koneksi harus memenuhi kriteria berikut:

      • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
      • Huruf harus kecil.
      • Nama koneksi harus dimulai dengan huruf dan diakhiri dengan huruf atau angka.
      • Nama koneksi tidak boleh lebih dari 63 karakter.
   4. Secara opsional, masukkan Deskripsi untuk instance koneksi.
   5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
   6. Secara opsional, konfigurasikan Setelan node koneksi:
      • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
      • Jumlah maksimum node: Masukkan jumlah maksimum node koneksi.

      {i>Node<i} adalah unit (atau replika) koneksi yang memproses transaksi. Lebih banyak node diperlukan untuk memproses lebih banyak transaksi untuk sebuah koneksi dan sebaliknya, lebih sedikit node diperlukan untuk memproses transaksi yang lebih sedikit. Untuk memahami pengaruh node terhadap harga konektor Anda, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum akan ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

   Catatan: Anda dapat menyesuaikan nilai node koneksi hanya jika Anda adalah pelanggan Bayar sesuai penggunaan.
   7. Secara opsional, klik + TAMBAHKAN LABEL untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
   8. Klik BERIKUTNYA.
5. Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
   1. Jenis Tujuan: Pilih Jenis Tujuan.
      1. Di kolom Host address, tentukan nama host atau alamat IP tujuan.
         1. Jika ingin membuat koneksi pribadi ke sistem backend, ikuti langkah-langkah berikut:
            1. Buat lampiran layanan PSC.
            2. Buat lampiran endpoint, lalu masukkan detail lampiran endpoint di kolom Alamat host.
         2. Jika ingin membuat koneksi publik ke sistem backend dengan keamanan tambahan, Anda dapat mempertimbangkan untuk mengonfigurasi alamat IP keluar statis untuk koneksi Anda, lalu mengonfigurasi aturan firewall untuk hanya mengizinkan alamat IP statis tertentu.

      Untuk memasukkan tujuan tambahan, klik +TAMBAHKAN TUJUAN.

   2. Klik BERIKUTNYA.
6. Di bagian Authentication, masukkan detail autentikasi.
   1. Pilih Jenis autentikasi, lalu masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh koneksi Splunk:

      • Nama pengguna dan sandi (Autentikasi dasar)
      • AccessToken
      • HTTPEventCollectorToken

   Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

   2. Klik BERIKUTNYA.
7. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
8. Klik Create.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

• Nama pengguna dan sandi
  • Username: Nama pengguna Splunk yang akan digunakan untuk koneksi.
  • Password: Secret Manager Secret berisi sandi yang terkait dengan nama pengguna Splunk.
• AccessToken - Tetapkan parameter ini untuk melakukan autentikasi berbasis token menggunakan properti AccessToken.
• HTTPEventCollectorToken - Tetapkan ini untuk melakukan autentikasi berbasis token menggunakan properti HTTPEventCollectorToken.

Entitas, operasi, dan tindakan

Semua Integration Connectors menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ditampilkan kepada Anda sebagai entity, operasi, dan tindakan.

Catatan: Anda dapat melihat entity, operasi, dan tindakan konektor di tugas Konektor.

• Entity: Entity dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entity berbeda dari konektor ke konektor. Misalnya, pada konektor database, tabel adalah entity, pada konektor server file, folder adalah entity, dan di konektor sistem pesan, antrean adalah entity.

  Namun, mungkin saja konektor tidak mendukung atau memiliki entitas, dalam hal ini daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Cantumkan
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih entity dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entity tersebut. Untuk deskripsi operasi secara mendetail, lihat operasi entity tugas Konektor. Namun, jika konektor tidak mendukung salah satu operasi entity, operasi yang tidak didukung tersebut tidak akan dicantumkan dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan bervariasi dari satu konektor ke konektor lainnya. Namun, mungkin saja konektor tidak mendukung tindakan apa pun, dalam hal ini daftar Actions akan kosong.

Keterbatasan sistem

Konektor Splunk dapat memproses 5 transaksi per detik, per node, dan throttle setiap transaksi di luar batas ini. Namun, jumlah transaksi yang dapat diproses konektor ini juga bergantung pada batasan yang diberlakukan oleh instance Splunk. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk satu koneksi.

Untuk informasi tentang batas yang berlaku untuk Konektor Integrasi, lihat Batas.

Catatan: Jumlah node Konektor Integrasi akan diskalakan otomatis secara dinamis berdasarkan penggunaan Anda. Namun, jika ingin mencadangkan kapasitas untuk volume besar tanpa menunggu penskalaan otomatis, Anda dapat menyesuaikan nilai node minimum untuk koneksi. Perlu lebih banyak node untuk memproses lebih banyak transaksi untuk sebuah koneksi. Sebaliknya, lebih sedikit node yang diperlukan jika koneksi memproses transaksi yang lebih sedikit. Untuk mengonfigurasi nilai node, lakukan langkah berikut:

• Jika Anda adalah pelanggan yang membayar sesuai penggunaan, konfigurasikan nilai node minimum dan maksimum di halaman edit koneksi.
• Jika Anda adalah pelanggan yang berbasis langganan, hubungi dukungan.

Transaksi maksimum yang dapat ditangani node bergantung pada berbagai faktor. Jadi, sebelum menyesuaikan node minimum untuk throughput yang lebih baik, sebaiknya periksa apakah sistem backend Anda sudah disiapkan secara optimal untuk menangani traffic yang diperlukan.

Tindakan

Bagian ini mencantumkan tindakan yang didukung oleh konektor. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Catatan: Hasil semua tindakan akan tersedia sebagai respons JSON dalam parameter respons connectorOutputPayload tugas Connectors setelah Anda menjalankan integrasi.

Tindakan CreateHTTPEvent

Tindakan ini memungkinkan Anda mengirimkan data dan peristiwa aplikasi ke deployment Splunk melalui protokol HTTP dan HTTPS.

Catatan: Untuk menggunakan tindakan ini, Anda harus menggunakan autentikasi HTTPEventCollectorToken.

Parameter input tindakan CreateHTTPEvent

Nama parameter	Jenis data	Diperlukan	Deskripsi
EventContent	String	Ya	Nama tabel atau tampilan.
ContentType	String	Tidak	Jenis konten yang ditentukan untuk input EventContent. Nilai yang didukung adalah JSON dan RAWTEXT.
ChannelGUID	Bilangan bulat	Tidak	GUID saluran yang digunakan untuk peristiwa. Anda harus menentukan nilai ini jika ContentType adalah RAWTEXT.

Parameter output tindakan CreateHTTPEvent

Tindakan ini menampilkan status keberhasilan peristiwa yang dibuat.

Tindakan CreateIndex

Tindakan ini memungkinkan Anda membuat indeks.

Parameter input tindakan CreateIndex

Nama parameter	Jenis data	Diperlukan	Deskripsi
MaxMetaEntries	String	Tidak	Menetapkan jumlah maksimum baris unik dalam file .data di bucket, yang dapat membantu mengurangi konsumsi memori.
FrozenTimePeriodInSecs	String	Tidak	Jumlah detik setelah data terindeks dibekukan. Default-nya adalah 188697600 (6 tahun).
HomePath	String	Tidak	Jalur absolut yang berisi bucket hot dan warm untuk indeks.
MinRawFileSyncSecs	String	Tidak	Tentukan bilangan bulat (atau disable) untuk parameter ini. Parameter ini menetapkan seberapa sering splunkd memaksa sinkronisasi sistem file saat mengompresi slice jurnal.
ProcessTrackerServiceInterval	String	Tidak	Menentukan, dalam detik, seberapa sering pengindeks memeriksa status proses OS turunan yang diluncurkan untuk melihat apakah pengindeks dapat meluncurkan proses baru untuk permintaan dalam antrean. Jika disetel ke 0, pengindeks akan memeriksa status proses turunan setiap detik.
ServiceMetaPeriod	String	Tidak	Menentukan seberapa sering (dalam detik) metadata disinkronkan ke disk.
MaxHotSpanSecs	String	Tidak	Batas atas rentang waktu maksimum target (dalam detik) bucket panas atau hangat.
QuarantinePastSecs	String	Tidak	Peristiwa dengan stempel waktu karantinaPastSecs yang lebih lama dari >now akan dimasukkan ke bucket karantina.
ColdToFrozenDir	String	Tidak	Jalur tujuan untuk arsip beku. Gunakan sebagai alternatif untuk ColdToFrozenScript.
ColdPath	String	Tidak	Jalur absolut yang berisi colddbs untuk indeks. Jalur harus dapat dibaca dan ditulis.
MaxHotIdleSecs	String	Tidak	Masa pakai maksimum, dalam hitungan detik, dari hot bucket
WarmToColdScript	String	Tidak	Jalur ke skrip yang akan dijalankan saat memindahkan data dari warm ke cold.
ColdToFrozenScript	String	Tidak	Jalur ke skrip pengarsipan.
MaxHotBuckets	String	Tidak	Hot bucket maksimum yang bisa ada per indeks.
TstatsHomePath	String	Tidak	Lokasi untuk menyimpan data TSIDX akselerasi model data untuk indeks ini. Jika ditentukan, volume harus ditentukan dalam definisi volume. Jalur harus dapat ditulis
RepFactor	String	Tidak	Kontrol replikasi indeks. Parameter ini hanya berlaku untuk node peer di cluster. auto - Gunakan nilai konfigurasi replikasi indeks master. 0 - Nonaktifkan replikasi untuk indeks ini.
MaxDataSize	String	Tidak	Ukuran maksimum dalam MB yang dapat dicapai hot DB sebelum roll ke warm dipicu. Menentukan auto atau auto_high_volume menyebabkan Splunk menyesuaikan parameter ini secara otomatis (direkomendasikan).
MaxBloomBackfillBucketAge	String	Tidak	Nilai yang valid adalah: integer[m|s|h|d] jika warm bucket atau cold bucket lebih lama dari usia yang ditentukan, jangan membuat atau membuat ulang bloomfilternya. Tentukan 0 untuk tidak pernah membuat ulang bloomfilter.
BlockSignSize	String	Tidak	Mengontrol jumlah peristiwa yang membentuk blok tanda tangan blok. Jika disetel ke 0, penandatanganan blok akan dinonaktifkan untuk indeks ini. Nilai yang direkomendasikan adalah 100.
Nama	String	Ya	Nama indeks yang akan dibuat
MaxTotalDataSizeMB	String	Tidak	Ukuran maksimum indeks (dalam MB). Jika indeks tumbuh lebih besar dari ukuran maksimum, data terlama akan dibekukan.
MaxWarmDBCount	String	Tidak	Jumlah maksimum bucket hangat. Jika jumlah ini terlampaui, bucket warm dengan nilai terendah untuk waktu terakhirnya akan dipindahkan ke cold.
RawChunkSizeBytes	String	Tidak	Targetkan ukuran yang tidak dikompresi dalam byte untuk setiap irisan mentah dalam jurnal data mentah indeks. 0 bukan nilai yang valid. Jika 0 ditentukan, rawChunkSizeBytes ditetapkan ke nilai default.
DataType	String	Tidak	Menentukan jenis indeks
MaxConcurrentOptimizes	String	Tidak	Jumlah proses pengoptimalan serentak yang dapat dijalankan terhadap hot bucket.
ThrottleCheckPeriod	String	Tidak	Menentukan seberapa sering (dalam detik) Splunk memeriksa kondisi throttling indeks.
SyncMeta	String	Tidak	Jika true (benar), operasi sinkronisasi akan dipanggil sebelum deskriptor file ditutup pada update file metadata. Fungsi ini meningkatkan integritas file metadata, terutama yang terkait dengan error sistem operasi atau kegagalan mesin.
RotatePeriodInSecs	String	Tidak	Seberapa sering (dalam detik) memeriksa apakah bucket hot baru perlu dibuat. Selain itu, seberapa sering memeriksa apakah ada bucket hangat/dingin yang harus digulung/dibekukan.

Parameter output tindakan CreateIndex

Tindakan ini akan menampilkan pesan konfirmasi tindakan CreateIndex.

Untuk mengetahui contoh cara mengonfigurasi tindakan CreateIndex, lihat Contoh tindakan.

Tindakan CreateSavedSearch

Tindakan ini memungkinkan Anda menyimpan penelusuran

Parameter input tindakan CreateSavedSearch

Nama parameter	Jenis data	Diperlukan	Deskripsi
IsVisible	Boolean	Ya	Menunjukkan jika penelusuran tersimpan ini ditampilkan dalam daftar penelusuran tersimpan yang terlihat.
RealTimeSchedule	Boolean	Ya	Jika nilai ini disetel ke 1, penjadwal akan mendasarkan penentuannya pada waktu eksekusi penelusuran terjadwal berikutnya pada waktu saat ini. Jika ditetapkan ke 0, nilai ini ditentukan berdasarkan waktu eksekusi penelusuran terakhir.
Penelusuran	String	Ya	Kueri penelusuran yang akan disimpan
Deskripsi	String	Tidak	Deskripsi penelusuran tersimpan ini
SchedulePriority	String	Ya	Menunjukkan prioritas penjadwalan untuk pencarian tertentu
CronSchedule	String	Ya	Jadwal cron untuk menjalankan penelusuran ini. Misalnya, */5 * * * * menyebabkan penelusuran dijalankan setiap 5 menit.
Nama	String	Ya	Nama penelusuran
UserContext	String	Ya	Jika konteks pengguna diberikan, node servicesNS akan digunakan (/servicesNS/[UserContext]/search), jika tidak, default-nya adalah endpoint umum, /services.
RunOnStartup	Boolean	Ya	Menunjukkan apakah penelusuran ini dijalankan saat browser mulai dijalankan. Jika tidak berjalan saat startup, penelusuran akan berjalan pada waktu yang dijadwalkan berikutnya.
Nonaktif	Boolean	Tidak	Menunjukkan jika penelusuran tersimpan ini dinonaktifkan.
IsScheduled	Boolean	Ya	Menunjukkan apakah penelusuran ini akan dijalankan sesuai jadwal.

Parameter output tindakan CreateSavedSearch

Tindakan ini menampilkan pesan konfirmasi tindakan CreateSavedSearch.

Untuk mengetahui contoh cara mengonfigurasi tindakan CreateSavedSearch, lihat Contoh tindakan.

Tindakan UpdateSavedSearch

Tindakan ini memungkinkan Anda memperbarui penelusuran tersimpan.

Parameter input tindakan UpdateSavedSearch

Nama parameter	Jenis data	Diperlukan	Deskripsi
IsVisible	Boolean	Ya	Menunjukkan jika penelusuran tersimpan ini ditampilkan dalam daftar penelusuran tersimpan yang terlihat.
RealTimeSchedule	Boolean	Ya	Jika nilai ini disetel ke 1, penjadwal akan mendasarkan penentuannya pada waktu eksekusi penelusuran terjadwal berikutnya pada waktu saat ini. Jika ditetapkan ke 0, nilai ini ditentukan berdasarkan waktu eksekusi penelusuran terakhir.
Penelusuran	String	Ya	Kueri penelusuran yang akan disimpan
Deskripsi	String	Tidak	Deskripsi penelusuran tersimpan ini
SchedulePriority	String	Ya	Menunjukkan prioritas penjadwalan untuk pencarian tertentu
CronSchedule	String	Ya	Jadwal cron untuk menjalankan penelusuran ini. Misalnya, */5 * * * * menyebabkan penelusuran dijalankan setiap 5 menit.
Nama	String	Ya	Nama penelusuran
UserContext	String	Ya	Jika konteks pengguna diberikan, node servicesNS akan digunakan (/servicesNS/[UserContext]/search), jika tidak, node tersebut akan ditetapkan secara default ke endpoint umum, /services.
RunOnStartup	Boolean	Ya	Menunjukkan apakah penelusuran ini dijalankan saat browser mulai dijalankan. Jika tidak berjalan saat startup, penelusuran akan berjalan pada waktu yang dijadwalkan berikutnya.
Nonaktif	Boolean	Tidak	Menunjukkan jika penelusuran tersimpan ini dinonaktifkan.
IsScheduled	Boolean	Ya	Menunjukkan apakah penelusuran ini akan dijalankan sesuai jadwal.

Parameter output tindakan UpdateSavedSearch

Tindakan ini akan menampilkan pesan konfirmasi tindakan UpdateSavedSearch.

Untuk mengetahui contoh cara mengonfigurasi tindakan UpdateSavedSearch, lihat Contoh tindakan.

Tindakan DeleteIndex

Tindakan ini memungkinkan Anda menghapus indeks.

Parameter input tindakan DeleteIndex

Nama parameter	Jenis data	Diperlukan	Deskripsi
Nama	String	Ya	Nama indeks yang akan dihapus.

Parameter output tindakan DeleteIndex

Tindakan ini akan menampilkan pesan konfirmasi tindakan DeleteIndex

Untuk mengetahui contoh cara mengonfigurasi tindakan DeleteIndex, lihat Contoh tindakan.

Tindakan UpdateIndex

Tindakan ini memungkinkan Anda mengupdate indeks.

Parameter input tindakan UpdateIndex

Nama parameter	Jenis data	Diperlukan	Deskripsi
MaxMetaEntries	String	Tidak	Menetapkan jumlah maksimum baris unik dalam file .data di bucket, yang dapat membantu mengurangi konsumsi memori.
FrozenTimePeriodInSecs	String	Tidak	Jumlah detik setelah data terindeks dibekukan. Default-nya adalah 188697600 (6 tahun).
HomePath	String	Tidak	Jalur absolut yang berisi bucket hot dan warm untuk indeks.
MinRawFileSyncSecs	String	Tidak	Tentukan bilangan bulat (atau disable) untuk parameter ini. Parameter ini menetapkan seberapa sering splunkd memaksa sinkronisasi sistem file saat mengompresi slice jurnal.
ProcessTrackerServiceInterval	String	Tidak	Menentukan, dalam detik, seberapa sering pengindeks memeriksa status proses OS turunan yang diluncurkan untuk melihat apakah pengindeks dapat meluncurkan proses baru untuk permintaan dalam antrean. Jika ditetapkan ke 0, pengindeks akan memeriksa status proses turunan setiap detik.
ServiceMetaPeriod	String	Tidak	Menentukan seberapa sering (dalam detik) metadata disinkronkan ke disk.
MaxHotSpanSecs	String	Tidak	Batas atas rentang waktu maksimum target (dalam detik) bucket panas atau hangat.
QuarantinePastSecs	String	Tidak	Peristiwa dengan stempel waktu karantinaPastSecs yang lebih lama dari now akan dimasukkan ke bucket karantina.
ColdToFrozenDir	String	Tidak	Jalur tujuan untuk arsip beku. Gunakan sebagai alternatif untuk ColdToFrozenScript.
ColdPath	String	Tidak	Jalur absolut yang berisi colddbs untuk indeks. Jalur harus dapat dibaca dan ditulis.
MaxHotIdleSecs	String	Tidak	Masa pakai maksimum, dalam hitungan detik, dari hot bucket.
WarmToColdScript	String	Tidak	Jalur ke skrip yang akan dijalankan saat memindahkan data dari warm ke cold.
ColdToFrozenScript	String	Tidak	Jalur ke skrip pengarsipan.
MaxHotBuckets	String	Tidak	Hot bucket maksimum yang bisa ada per indeks.
TstatsHomePath	String	Tidak	Lokasi untuk menyimpan data TSIDX akselerasi model data untuk indeks ini. Jika ditentukan, volume harus ditentukan dalam definisi volume. Jalur harus dapat ditulis
RepFactor	String	Tidak	Kontrol replikasi indeks. Parameter ini hanya berlaku untuk node peer di cluster. auto - Gunakan nilai konfigurasi replikasi indeks master. 0 - Nonaktifkan replikasi untuk indeks ini.
MaxDataSize	String	Tidak	Ukuran maksimum dalam MB yang dapat dicapai hot DB sebelum roll ke warm dipicu. Menentukan auto atau auto_high_volume menyebabkan Splunk menyesuaikan parameter ini secara otomatis (direkomendasikan).
MaxBloomBackfillBucketAge	String	Tidak	Nilai yang valid adalah: integer[m|s|h|d] jika warm bucket atau cold bucket lebih lama dari usia yang ditentukan, jangan membuat atau membangun ulang bloomfilternya. Tentukan 0 untuk tidak pernah membuat ulang bloomfilter.
BlockSignSize	String	Tidak	Mengontrol jumlah peristiwa yang membentuk blok tanda tangan blok. Jika disetel ke 0, penandatanganan blok akan dinonaktifkan untuk indeks ini. Nilai yang direkomendasikan adalah 100.
Nama	String	Ya	Nama indeks yang akan dibuat
MaxTotalDataSizeMB	String	Ya	Ukuran maksimum indeks (dalam MB). Jika indeks melebihi ukuran maksimum, data terlama akan dibekukan.
MaxWarmDBCount	String	Tidak	Jumlah maksimum bucket hangat. Jika jumlah ini terlampaui, bucket warm dengan nilai terendah untuk waktu terakhirnya akan dipindahkan ke cold.
RawChunkSizeBytes	String	Tidak	Targetkan ukuran yang tidak dikompresi dalam byte untuk irisan mentah individual dalam jurnal data mentah indeks. 0 bukan nilai yang valid. Jika 0 ditentukan, rawChunkSizeBytes ditetapkan ke nilai default.
DataType	String	Tidak	Menentukan jenis indeks
MaxConcurrentOptimizes	String	Tidak	Jumlah proses pengoptimalan serentak yang dapat dijalankan terhadap hot bucket.
ThrottleCheckPeriod	String	Tidak	Menentukan seberapa sering (dalam detik) Splunk memeriksa kondisi throttling indeks.
SyncMeta	String	Tidak	Jika true (benar), operasi sinkronisasi akan dipanggil sebelum deskriptor file ditutup pada update file metadata. Fungsi ini meningkatkan integritas file metadata, terutama yang terkait dengan error sistem operasi atau kegagalan mesin.
RotatePeriodInSecs	String	Tidak	Seberapa sering (dalam detik) memeriksa apakah bucket hot baru perlu dibuat. Selain itu, seberapa sering memeriksa apakah ada bucket hangat atau dingin yang harus digulung atau dibekukan.

Parameter output tindakan UpdateIndex

Tindakan ini akan menampilkan pesan konfirmasi tindakan UpdateIndex.

Untuk mengetahui contoh cara mengonfigurasi tindakan UpdateIndex, lihat Contoh tindakan.

Contoh tindakan

Contoh - Membuat peristiwa HTTP

Contoh ini akan membuat peristiwa HTTP.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CreateHTTPEvent, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "EventContent": "Testing Task",
   "ContentType": "RAWTEXT",
   "ChannelGUID": "ContentType=RAWTEXT"
   }

Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas CreateHTTPEvent akan memiliki nilai yang mirip dengan yang berikut:

[{
"Success": "Success"
}]

Contoh - Membuat indeks

Contoh ini akan membuat indeks.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CreateIndex, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Name": "http_testing"
   }

Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas CreateIndex akan memiliki nilai yang mirip dengan yang berikut:

[{
"AssureUTF8": null,
"BlockSignSize": null,
"BlockSignatureDatabase": null,
"BucketRebuildMemoryHint": null,
"ColdPath": null,
"FrozenTimePeriodInSecs": null,
"HomePath": null,
"HomePathExpanded": null,
"IndexThreads": null,
"IsInternal": null,
"MaxConcurrentOptimizes": null,
"MaxDataSize": null,
"MaxHotBuckets": null,
"SuppressBannerList": null,
"Sync": null,
"SyncMeta": null,
"ThawedPath": null,
"ThawedPathExpanded": null,
"TstatsHomePath": null,
"WarmToColdScript": null,
}]

Contoh - Membuat penelusuran tersimpan

Contoh ini akan membuat penelusuran tersimpan.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan CreateSavedSearch, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Name": "test_created_g",
   "Search": "index=\"http_testing\"",
   "CronSchedule": "*/1 * * * *",
   "IsVisible": true,
   "RealTimeSchedule": true,
   "RunOnStartup": true,
   "IsScheduled": true,
   "SchedulePriority": "highest",
   "UserContext": "nobody"
   }

Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas CreateSavedSearch akan memiliki nilai yang mirip dengan yang berikut:

[{
"Success": true,
"Message": null
}]

Contoh - Memperbarui penelusuran tersimpan

Contoh ini memperbarui penelusuran tersimpan.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan UpdateSavedSearch, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Name": "test_created_g",
   "Search": "index=\"december_test_data\"",
   "CronSchedule": "*/1 * * * *",
   "IsVisible": true,
   "RealTimeSchedule": true,
   "RunOnStartup": true,
   "IsScheduled": true,
   "SchedulePriority": "highest"
   }

Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas UpdateSavedSearch akan memiliki nilai yang mirip dengan yang berikut:

[{
"Success": true,
"Message": null
}]

Contoh - Menghapus indeks

Contoh ini menghapus indeks.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan DeleteIndex, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Name": "g_http_testing"
   }

Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas DeleteIndex akan memiliki nilai yang mirip dengan yang berikut:

[{
"Success": true,
"ErrorCode": null,
"ErrorMessage": null
}]

Contoh - Memperbarui indeks

Contoh ini memperbarui indeks.

1. Dalam dialog Configure connector task, klik Actions.
2. Pilih tindakan UpdateIndex, lalu klik Done.
3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "MaxTotalDataSizeMB": "400000",
   "Name": "g_http_testing"
   }

Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas UpdateIndex akan memiliki nilai yang mirip dengan yang berikut:

[{
"AssureUTF8": false,
"BlockSignSize": null,
"BlockSignatureDatabase": null,
"BucketRebuildMemoryHint": "auto",
"ColdPath": "$SPLUNK_DB\\g_http_testing\\colddb",
"ColdPathExpanded": "C:\\Program Files\\Splunk\\var\\lib\\splunk\\g_http_testing\\colddb",
"ColdToFrozenDir": "",
"ColdToFrozenScript": "",
"CurrentDBSizeMB": 1.0,
"DefaultDatabase": "main",
"EnableOnlineBucketRepair": true,
"EnableRealtimeSearch": true,
"FrozenTimePeriodInSecs": 1.886976E8,
"HomePath": "$SPLUNK_DB\\g_http_testing\\db",
"HomePathExpanded": "C:\\Program Files\\Splunk\\var\\lib\\splunk\\g_http_testing\\db",
"IndexThreads": "auto",
"IsInternal": false,
"LastInitTime": "2024-01-08 05:15:28.0",
"MaxBloomBackfillBucketAge": "30d",
"ThawedPath": "$SPLUNK_DB\\g_http_testing\\thaweddb",
"ThawedPathExpanded": "C:\\Program Files\\Splunk\\var\\lib\\splunk\\g_http_testing\\thaweddb",
"ThrottleCheckPeriod": 15.0,
"TotalEventCount": 0.0,
"TsidxDedupPostingsListMaxTermsLimit": 8388608.0,
"TstatsHomePath": "volume:_splunk_summaries\\$_index_name\\datamodel_summary",
"WarmToColdScript": "",
"Success": true,
"ErrorCode": null,
"ErrorMessage": null
}]

Contoh operasi entitas

Bagian ini menunjukkan cara melakukan beberapa operasi entity di konektor ini.

Contoh - Menampilkan daftar semua catatan

Contoh ini mencantumkan semua data dalam entity SearchJobs.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih SearchJobs dari daftar Entity.
3. Pilih operasi List, lalu klik Done.
4. Secara opsional, di bagian Task Input pada tugas Connectors, Anda dapat memfilter kumpulan hasil dengan menentukan klausa filter. Tentukan nilai klausa filter selalu dalam tanda kutip tunggal (').

Contoh - Mendapatkan kumpulan data dari entity

Contoh ini mendapatkan data dengan ID yang ditentukan dari entity SearchJobs.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih SearchJobs dari daftar Entity.
3. Pilih operasi Get, lalu klik Done.
4. Di bagian Task Input pada tugas Connectors, klik EntityId lalu masukkan 1698309163.1300 di kolom Default Value.

   Di sini, 1698309163.1300 adalah ID data unik dalam entity SearchJobs.

Contoh - Membuat data dalam entity

Contoh ini membuat data dalam entity DataModels.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih DataModels dari daftar Entity.
3. Pilih operasi Create, lalu klik Done.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Id": "Test1",
   "Acceleration": "{\"enabled\":false,\"earliest_time\":\"\",
   \"max_time\":3600,\"backfill_time\":\"\",\"source_guid\":\"\",
   \"manual_rebuilds\":false,\"poll_buckets_until_maxtime\":false,
   \"max_concurrent\":3,\"allow_skew\":\"0\",\"schedule_priority\":\"default\"
   ,\"allow_old_summaries\":false,\"hunk.file_format\":\"\",\"hunk.dfs_block_size\":0,
   \"hunk.compression_codec\":\"\",\"workload_pool\":\"\"}"
   }

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

   [{
   "Id": "Test1"
   }]

Contoh - Menghapus data dari entity

Contoh ini menghapus data dengan ID yang ditentukan dalam entity DataModels.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih DataModels dari daftar Entity.
3. Pilih operasi Delete, lalu klik Done.
4. Di bagian Task Input pada tugas Connectors, klik entityId, lalu masukkan Test1 di kolom Default Value.

Catatan: Jika entitas Anda memiliki kunci utama gabungan, Anda dapat menentukan klausa filter.

Contoh - Memperbarui data dalam entity

Contoh ini memperbarui data dalam entity DataModels.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih DataModels dari daftar Entity.
3. Pilih operasi Update, lalu klik Done.
4. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

   {
   "Acceleration": "{\"enabled\":true,\"earliest_time\":\"-3mon\",
   \"cron_schedule\":\"*/5 * * * *\",\"max_time\":60,
   \"backfill_time\":\"\",\"source_guid\":\"\",\"manual_rebuilds\":false,
   \"poll_buckets_until_maxtime\":false,\"max_concurrent\":3,
   \"allow_skew\":\"0\",\"schedule_priority\":\"default\",
   \"allow_old_summaries\":false,\"hunk.file_format\":\"\",\"hunk.dfs_block_size\":0,
   \"hunk.compression_codec\":\"\",\"workload_pool\":\"\"}"
   }

5. Klik entityId, lalu masukkan /servicesNS/nobody/search/datamodel/model/Testing di kolom Default Value.

   Jika integrasi berhasil, kolom connectorOutputPayload tugas konektor Anda akan memiliki nilai yang mirip dengan berikut ini:

   [{
    "Id": "/servicesNS/nobody/search/datamodel/model/Testing"
    }]

Gunakan terraform untuk membuat koneksi

Anda dapat menggunakan resource Terraform untuk membuat koneksi baru.

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Untuk melihat contoh template terraform untuk pembuatan koneksi, lihat contoh template.

Saat membuat koneksi ini menggunakan Terraform, Anda harus menetapkan variabel berikut dalam file konfigurasi Terraform:

Nama parameter	Jenis data	Diperlukan	Deskripsi
panjang	STRING	Salah	Tingkat panjang untuk koneksi, bervariasi dari 1-5. Tingkat panjang yang lebih tinggi akan mencatat semua detail komunikasi (sertifikat permintaan,respons & SSL).
proxy_enabled	BOOLEAN	Salah	Pilih kotak centang ini untuk mengonfigurasi server proxy untuk koneksi.
proxy_auth_scheme	ENUM	Salah	Jenis autentikasi yang akan digunakan untuk mengautentikasi ke proxy ProxyServer. Nilai yang didukung adalah: BASIC, DIGEST, NONE
proxy_user	STRING	Salah	Nama pengguna yang akan digunakan untuk mengautentikasi ke proxy ProxyServer.
proxy_password	SECRET	Salah	Sandi yang akan digunakan untuk mengautentikasi ke proxy ProxyServer.
proxy_ssltype	ENUM	Salah	Jenis SSL yang akan digunakan saat menghubungkan ke proxy ProxyServer. Nilai yang didukung adalah: AUTO, ALWAYS, NEVER, WorkManager

Menggunakan koneksi Splunk dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

• Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Apigee, lihat Tugas konektor.
• Untuk memahami cara membuat dan menggunakan tugas Konektor dalam Application Integration, lihat tugas konektor.

Dapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Cloud Forums.

Langkah selanjutnya

• Memahami cara menangguhkan dan melanjutkan koneksi.
• Pahami cara memantau penggunaan konektor.
• Pahami cara melihat log konektor.