Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Konektor Integrasi Splunk **Awas** Konektor ini telah pindah ke *fase umur yang diperpanjang*, dan AWS IoT Greengrass tidak akan merilis pembaruan yang menyediakan fitur, penyempurnaan pada fitur yang ada, patch keamanan, atau perbaikan bug. Untuk informasi selengkapnya, lihat [AWS IoT Greengrass Version 1 kebijakan pemeliharaan](maintenance-policy.md). [Konektor](connectors.md) Integrasi Splunk menerbitkan data dari perangkat Greengrass ke Splunk. Ini mengizinkan Anda untuk menggunakan Splunk untuk memantau dan menganalisis lingkungan core Greengrass, dan bertindak pada peristiwa lokal. Konektor terintegrasi dengan HTTP Event Collector (HEC). Untuk informasi lebih lanjut, lihat [Pengantar Splunk HTTP Event Collector](https://dev.splunk.com/view/event-collector/SP-CAAAE6M) dalam dokumentasi Splunk. Konektor ini menerima data logging dan data peristiwa pada topik MQTT dan menerbitkan data seperti Splunk API. Anda dapat menggunakan konektor ini untuk mendukung skenario industri, seperti: + Operator dapat menggunakan data berkala dari aktuator dan sensor (sebagai contoh, suhu, tekanan, dan pembacaan air) untuk memulai alarm jika nilai melebihi ambang batas tertentu. + Developer menggunakan data yang dikumpulkan dari mesin industri untuk membangun model ML yang dapat memantau peralatan untuk potensi masalah. Konektor ini memiliki versi berikut. | Versi | ARN | | --- | --- | | 4 | `arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/4` | | 3 | `arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/3` | | 2 | `arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/2` | | 1 | `arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/1` | Untuk informasi tentang perubahan versi, lihat [Changelog](#splunk-connector-changelog). ## Persyaratan Konektor ini memiliki persyaratan sebagai berikut: ------ #### [ Version 3 - 4 ] + AWS IoT Greengrass Perangkat lunak inti v1.9.3 atau yang lebih baru. AWS IoT Greengrass harus dikonfigurasi untuk mendukung rahasia lokal, seperti yang dijelaskan dalam [Persyaratan Rahasia](secrets.md#secrets-reqs). **catatan** Persyaratan ini mencakup akses ke rahasia Secrets Manager Anda. Jika Anda menggunakan peran layanan default Greengrass, Greengrass memiliki izin untuk mendapatkan nilai-nilai rahasia dengan nama yang dimulai dengan *greengrass-*. + [Python](https://www.python.org/) versi 3.7 atau 3.8 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH. **catatan** Untuk menggunakan Python 3.8, jalankan perintah berikut untuk membuat link simbolik dari folder instalasi default Python 3.7 ke binari Python 3.8 yang diinstal. ``` sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7 ``` Ini mengonfigurasi perangkat Anda untuk memenuhi persyaratan Python untuk AWS IoT Greengrass. + Fungsi HTTP Event Collector harus diaktifkan dalam Splunk. Untuk informasi lebih lanjut, lihat [Atur dan gunakan HTTP eEvent Collector dalam Splunk Web](https://docs.splunk.com/Documentation/Splunk/7.2.0/Data/UsetheHTTPEventCollector) dalam dokumentasi Splunk. + Rahasia tipe teks AWS Secrets Manager yang menyimpan token Splunk HTTP Event Collector Anda. Untuk informasi lebih lanjut, lihat [Tentang token kolektor peristiwa](https://docs.splunk.com/Documentation/Splunk/7.2.0/Data/UsetheHTTPEventCollector#About_Event_Collector_tokens) dalam dokumentasi Splunk dan [Membuat rahasia dasar](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dalam *AWS Secrets Manager Panduan Pengguna*. **catatan** Untuk membuat rahasia dalam konsol Secrets Manager, masukkan token Anda pada tab **Plaintext** ini. Jangan sertakan tanda kutip atau pemformatan lainnya. Dalam API, tentukan token sebagai nilai untuk properti `SecretString` ini. + Sebuah sumber daya rahasia dalam grup Greengrass yang mereferensikan rahasia Secrets Manager. Untuk informasi selengkapnya, lihat [Menyebarkan rahasia ke inti AWS IoT Greengrass](secrets.md). ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass Perangkat lunak inti v1.7 atau yang lebih baru. AWS IoT Greengrass harus dikonfigurasi untuk mendukung rahasia lokal, seperti yang dijelaskan dalam [Persyaratan Rahasia](secrets.md#secrets-reqs). **catatan** Persyaratan ini mencakup akses ke rahasia Secrets Manager Anda. Jika Anda menggunakan peran layanan default Greengrass, Greengrass memiliki izin untuk mendapatkan nilai-nilai rahasia dengan nama yang dimulai dengan *greengrass-*. + [Python](https://www.python.org/) versi 2.7 diinstal pada perangkat core dan ditambahkan ke variabel lingkungan PATH. + Fungsi HTTP Event Collector harus diaktifkan dalam Splunk. Untuk informasi lebih lanjut, lihat [Atur dan gunakan HTTP eEvent Collector dalam Splunk Web](https://docs.splunk.com/Documentation/Splunk/7.2.0/Data/UsetheHTTPEventCollector) dalam dokumentasi Splunk. + Rahasia tipe teks AWS Secrets Manager yang menyimpan token Splunk HTTP Event Collector Anda. Untuk informasi lebih lanjut, lihat [Tentang token kolektor peristiwa](https://docs.splunk.com/Documentation/Splunk/7.2.0/Data/UsetheHTTPEventCollector#About_Event_Collector_tokens) dalam dokumentasi Splunk dan [Membuat rahasia dasar](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dalam *AWS Secrets Manager Panduan Pengguna*. **catatan** Untuk membuat rahasia dalam konsol Secrets Manager, masukkan token Anda pada tab **Plaintext** ini. Jangan sertakan tanda kutip atau pemformatan lainnya. Dalam API, tentukan token sebagai nilai untuk properti `SecretString` ini. + Sebuah sumber daya rahasia dalam grup Greengrass yang mereferensikan rahasia Secrets Manager. Untuk informasi selengkapnya, lihat [Menyebarkan rahasia ke inti AWS IoT Greengrass](secrets.md). ------ ## Parameter Konektor Konektor ini menyediakan parameter berikut: ------ #### [ Version 4 ] `SplunkEndpoint` Titik akhir dari instans Splunk Anda. Nilai ini harus berisi protokol, hostname, dan port. Nama tampilan di AWS IoT konsol: Titik akhir **Splunk** Wajib: `true` Jenis: `string` Pola yang valid: `^(http:\/\/|https:\/\/)?[a-z0-9]+([-.]{1}[a-z0-9]+)*.[a-z]{2,5}(:[0-9]{1,5})?(\/.*)?$` `MemorySize` Jumlah memori (dalam KB) untuk mengalokasikan ke konektor. Nama tampilan di AWS IoT konsol: **Ukuran memori** Wajib: `true` Jenis: `string` Pola yang valid: `^[0-9]+$` `SplunkQueueSize` Jumlah maksimum item untuk dipertahankan dalam memori sebelum item dikirimkan atau dibuang. Ketika batas ini terpenuhi, item tertua dalam antrian diganti dengan item yang lebih baru. Batas ini biasanya berlaku ketika tidak ada koneksi ke internet. Nama tampilan di AWS IoT konsol: **Item maksimum yang harus dipertahankan** Wajib: `true` Jenis: `string` Pola yang valid: `^[0-9]+$` `SplunkFlushIntervalSeconds` Interval (dalam detik) untuk menerbitkan data yang diterima ke Splunk HEC. Nilai maksimumnya adalah 900. Untuk mengonfigurasi konektor untuk menerbitkan item seperti yang diterima (tanpa batching), tentukan 0. Nama tampilan di AWS IoT konsol: Interval **publikasi Splunk** Wajib: `true` Jenis: `string` Pola yang valid: `[0-9]|[1-9]\d|[1-9]\d\d|900` `SplunkTokenSecretArn` Rahasia AWS Secrets Manager yang menyimpan token Splunk. Ini harus berupa rahasia jenis teks. Nama tampilan di AWS IoT konsol: **ARN rahasia token autentikasi Splunk** Wajib: `true` Jenis: `string` Pola yang valid: `arn:aws:secretsmanager:[a-z]{2}-[a-z]+-\d{1}:\d{12}?:secret:[a-zA-Z0-9-_]+-[a-zA-Z0-9-_]+` `SplunkTokenSecretArn-ResourceId` Sumber daya rahasia dalam grup Greengrass yang mereferensikan rahasia Splunk. Nama tampilan di AWS IoT konsol: Sumber daya token **autentikasi splunk** Wajib: `true` Jenis: `string` Pola yang valid: `.+` `SplunkCustomCALocation` Jalur file kustom otoritas sertifikasi (CA) untuk Splunk (sebagai contoh, `/etc/ssl/certs/splunk.crt`). Nama tampilan di AWS IoT konsol: Lokasi **otoritas sertifikat khusus Splunk** Wajib: `false` Jenis: `string` Pola yang valid: `^$|/.*` `IsolationMode` Mode [kontainerisasi](connectors.md#connector-containerization) untuk konektor ini. Defaultnya adalah`GreengrassContainer`, yang berarti konektor berjalan di lingkungan runtime yang terisolasi di dalam AWS IoT Greengrass container. Pengaturan kontainerisasi default untuk grup tidak berlaku untuk konektor. Nama tampilan di AWS IoT konsol: **Mode isolasi kontainer** Wajib: `false` Jenis: `string` Nilai yang valid: `GreengrassContainer` or `NoContainer` Pola yang valid: `^NoContainer$|^GreengrassContainer$` ------ #### [ Version 1 - 3 ] `SplunkEndpoint` Titik akhir dari instans Splunk Anda. Nilai ini harus berisi protokol, hostname, dan port. Nama tampilan di AWS IoT konsol: Titik akhir **Splunk** Wajib: `true` Jenis: `string` Pola yang valid: `^(http:\/\/|https:\/\/)?[a-z0-9]+([-.]{1}[a-z0-9]+)*.[a-z]{2,5}(:[0-9]{1,5})?(\/.*)?$` `MemorySize` Jumlah memori (dalam KB) untuk mengalokasikan ke konektor. Nama tampilan di AWS IoT konsol: **Ukuran memori** Wajib: `true` Jenis: `string` Pola yang valid: `^[0-9]+$` `SplunkQueueSize` Jumlah maksimum item untuk dipertahankan dalam memori sebelum item dikirimkan atau dibuang. Ketika batas ini terpenuhi, item tertua dalam antrian diganti dengan item yang lebih baru. Batas ini biasanya berlaku ketika tidak ada koneksi ke internet. Nama tampilan di AWS IoT konsol: **Item maksimum yang harus dipertahankan** Wajib: `true` Jenis: `string` Pola yang valid: `^[0-9]+$` `SplunkFlushIntervalSeconds` Interval (dalam detik) untuk menerbitkan data yang diterima ke Splunk HEC. Nilai maksimumnya adalah 900. Untuk mengonfigurasi konektor untuk menerbitkan item seperti yang diterima (tanpa batching), tentukan 0. Nama tampilan di AWS IoT konsol: Interval **publikasi Splunk** Wajib: `true` Jenis: `string` Pola yang valid: `[0-9]|[1-9]\d|[1-9]\d\d|900` `SplunkTokenSecretArn` Rahasia AWS Secrets Manager yang menyimpan token Splunk. Ini harus berupa rahasia jenis teks. Nama tampilan di AWS IoT konsol: **ARN rahasia token autentikasi Splunk** Wajib: `true` Jenis: `string` Pola yang valid: `arn:aws:secretsmanager:[a-z]{2}-[a-z]+-\d{1}:\d{12}?:secret:[a-zA-Z0-9-_]+-[a-zA-Z0-9-_]+` `SplunkTokenSecretArn-ResourceId` Sumber daya rahasia dalam grup Greengrass yang mereferensikan rahasia Splunk. Nama tampilan di AWS IoT konsol: Sumber daya token **autentikasi splunk** Wajib: `true` Jenis: `string` Pola yang valid: `.+` `SplunkCustomCALocation` Jalur file kustom otoritas sertifikasi (CA) untuk Splunk (sebagai contoh, `/etc/ssl/certs/splunk.crt`). Nama tampilan di AWS IoT konsol: Lokasi **otoritas sertifikat khusus Splunk** Wajib: `false` Jenis: `string` Pola yang valid: `^$|/.*` ------ ### Buat Contoh Konektor (AWS CLI) Perintah CLI berikut membuat `ConnectorDefinition` dengan versi awal yang berisi konektor Integrasi Splunk. ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MySplunkIntegrationConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/SplunkIntegration/versions/4", "Parameters": { "SplunkEndpoint": "https://myinstance.cloud.splunk.com:8088", "MemorySize": 200000, "SplunkQueueSize": 10000, "SplunkFlushIntervalSeconds": 5, "SplunkTokenSecretArn":"arn:aws:secretsmanager:region:account-id:secret:greengrass-secret-hash", "SplunkTokenSecretArn-ResourceId": "MySplunkResource", "IsolationMode" : "GreengrassContainer" } } ] }' ``` **catatan** Fungsi Lambda dalam konektor mempunyai siklus hidup yang [berumur panjang](lambda-functions.md#lambda-lifecycle) ini. Di AWS IoT Greengrass konsol, Anda dapat menambahkan konektor dari halaman **Konektor** grup. Untuk informasi selengkapnya, lihat [Memulai dengan konektor Greengrass (konsol)](connectors-console.md). ## Data input Konektor ini menerima data logging dan peristiwa pada topik MQTT dan menerbitkan data yang diterima seperti Splunk API. Pesan input harus dalam format JSON. **Filter topik dalam langganan** `splunk/logs/put` **Properti pesan** `request` Data peristiwa untuk mengirim ke Splunk API. Acara harus memenuhi spesifikasi dari [layanan/kolektor](https://docs.splunk.com/Documentation/Splunk/latest/RESTREF/RESTinput#services.2Fcollector) API. Wajib: `true` Jenis:`object`. Hanya `event` properti diperlukan. `id` ID arbitrer untuk permintaan. Properti ini digunakan untuk memetakan permintaan input untuk status output. Wajib: `false` Jenis: `string` **Batas** Semua batas yang dikenakan oleh Splunk API berlaku ketika menggunakan konektor ini. Untuk informasi lebih lanjut, lihat [layanan/kolektor](https://docs.splunk.com/Documentation/Splunk/latest/RESTREF/RESTinput#services.2Fcollector). **Contoh masukan** ``` { "request": { "event": "some event", "fields": { "severity": "INFO", "category": [ "value1", "value2" ] } }, "id": "request123" } ``` ## Data output Konektor ini menerbitkan data output pada dua topik: + Informasi status pada `splunk/logs/put/status` topik. + Kesalahan pada topik `splunk/logs/put/error` ini. **Filter topik:** `splunk/logs/put/status` Gunakan topik ini untuk mendengarkan status permintaan. Setiap kali konektor mengirimkan sekumpulan data yang diterima ke API Splunk, ia menerbitkan daftar permintaan IDs yang berhasil dan gagal. **Contoh keluaran** ``` { "response": { "succeeded": [ "request123", ... ], "failed": [ "request789", ... ] } } ``` **Filter topik:** `splunk/logs/put/error` Gunakan topik ini untuk mendengarkan kesalahan dari konektor. Properti `error_message` yang menjelaskan kesalahan atau timeout yang dihadapi sambil memproses permintaan. **Contoh keluaran** ``` { "response": { "error": "UnauthorizedException", "error_message": "invalid splunk token", "status": "fail" } } ``` Jika konektor mendeteksi kesalahan yang dapat diulang (sebagai contoh, kesalahan koneksi), konektor mengulang lagi publikasinya dalam batch berikutnya. ## Contoh Penggunaan Gunakan langkah-langkah tingkat tinggi berikut untuk mengatur contoh fungsi Lambda Python 3.7 yang dapat Anda gunakan untuk mencoba konektor. **catatan** Jika Anda menggunakan waktu aktif Python lainnya, Anda dapat membuat symlink dari Python3.x ke Python 3.7. Topik [Memulai dengan konektor (konsol)](connectors-console.md) dan [Memulai dengan konektor (CLI)](connectors-cli.md) berisi langkah-langkah terperinci yang menunjukkan cara mengonfigurasi dan men-deploy contoh konektor Notifikasi Twilio. 1. Pastikan Anda memenuhi [persyaratan](#splunk-connector-req) untuk konektor. 1. Buat dan terbitkan fungsi Lambda yang mengirimkan data input ke konektor. Simpan [kode contoh](#splunk-connector-usage-example) sebagai file PY. Unduh dan unzip [AWS IoT Greengrass Core SDK for Python](lambda-functions.md#lambda-sdks-core). Kemudian, buat paket zip yang berisi file PY dan folder `greengrasssdk` dalam tingkat root. Paket zip ini adalah paket deployment yang Anda unggah ke AWS Lambda. Setelah Anda membuat fungsi Lambda Python 3.7, terbitkankan versi fungsi dan buat alias. 1. Konfigurasikan grup Greengrass Anda. 1. Tambahkan fungsi Lambda dengan aliasnya (direkomendasikan). Konfigurasikan siklus hidup Lambda sebagai berumur panjang (atau `"Pinned": true` dalam CLI). 1. Tambahkan sumber daya rahasia yang diperlukan dan berikan akses baca ke fungsi Lambda. 1. Tambahkan konektor dan konfigurasikan [parameter](#splunk-connector-param). 1. Tambahkan langganan yang mengizinkan konektor untuk menerima [data input](#splunk-connector-data-input) dan mengirim [data output](#splunk-connector-data-output) pada filter topik yang didukung. + Atur fungsi Lambda sebagai sumber, konektor sebagai target, dan gunakan filter topik input yang mendukung. + Atur konektor sebagai sumber, AWS IoT Core sebagai target, dan gunakan filter topik input yang mendukung. Anda menggunakan langganan ini untuk melihat pesan status di AWS IoT konsol. 1. Men-deploy grup. 1. Di AWS IoT konsol, pada halaman **Uji**, berlangganan topik data keluaran untuk melihat pesan status dari konektor. Contoh fungsi Lambda yang berumur panjang dan mulai mengirim pesan segera setelah grup dalam-deploy. Setelah selesai pengujian, Anda dapat mengatur siklus hidup Lambda ke sesuai permintaan (atau `"Pinned": false` dalam CLI) dan men-deploy grup. Ini menghentikan fungsi dari mengirim pesan. ### Contoh Contoh fungsi Lambda berikut mengirimkan pesan input ke konektor. ``` import greengrasssdk import time import json iot_client = greengrasssdk.client('iot-data') send_topic = 'splunk/logs/put' def create_request_with_all_fields(): return { "request": { "event": "Access log test message." }, "id" : "req_123" } def publish_basic_message(): messageToPublish = create_request_with_all_fields() print("Message To Publish: ", messageToPublish) iot_client.publish(topic=send_topic, payload=json.dumps(messageToPublish)) publish_basic_message() def lambda_handler(event, context): return ``` ## Lisensi Konektor ini dirilis di bawah [Perjanjian Lisensi Perangkat lunak core Greengrass](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog Tabel berikut menjelaskan perubahan dalam setiap versi konektor. | Versi | Perubahan | | --- | --- | | 4 | Ditambahkan parameter `IsolationMode` untuk mengonfigurasi mode kontainerisasi untuk konektor. | | 3 | Memperbarui waktu aktif Lambda untuk Python 3.7, yang mengubah persyaratan waktu aktif. | | 2 | Perbaiki untuk mengurangi pencatatan berlebihan. | | 1 | Pelepasan awal. | Sebuah grup Greengrass dapat berisi hanya satu versi konektor pada suatu waktu. Untuk informasi lebih lanjut tentang pembaruan versi konektor, lihat [Versi upgrade konektor](connectors.md#upgrade-connector-versions). ## Lihat juga + [Integrasikan dengan layanan dan protokol menggunakan konektor Greengrass](connectors.md) + [Memulai dengan konektor Greengrass (konsol)](connectors-console.md) + [Memulai dengan konektor Greengrass (CLI)](connectors-cli.md)