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. # ServiceNow MetricBase Konektor integrasi **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 ServiceNow MetricBase ](connectors.md) Integrasi menerbitkan metrik deret waktu dari perangkat Greengrass ke. ServiceNow MetricBase Hal ini memungkinkan Anda untuk menyimpan, menganalisis, dan memvisualisasikan data time series dari lingkungan core Greengrass, dan bertindak pada peristiwa lokal. Konektor ini menerima data deret waktu pada topik MQTT, dan menerbitkan data ke ServiceNow API secara berkala. Anda dapat menggunakan konektor ini untuk mendukung skenario seperti: + Buat peringatan dan alarm berbasis ambang batas berdasarkan data time series yang dikumpulkan dari perangkat Greengrass. + Gunakan data layanan waktu dari perangkat Greengrass dengan aplikasi khusus yang dibangun di platform. ServiceNow Konektor ini memiliki versi berikut. | Versi | ARN | | --- | --- | | 4 | `arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/4` | | 3 | `arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/3` | | 2 | `arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/2` | | 1 | `arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/1` | Untuk informasi tentang perubahan versi, lihat [Changelog](#servicenow-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. + ServiceNow Akun dengan langganan yang diaktifkan ke MetricBase. Sebagai tambahan, metrik dan tabel metrik harus dibuat dalam akun. Untuk informasi lebih lanjut, lihat [MetricBase](https://docs.servicenow.com/bundle/london-servicenow-platform/page/administer/metricbase/concept/metricbase.html)di ServiceNow dokumentasi. + Rahasia tipe teks AWS Secrets Manager yang menyimpan nama pengguna dan kata sandi untuk masuk ke ServiceNow instance Anda dengan otentikasi dasar. Rahasianya harus berisi tombol "pengguna” dan "kata sandi” dengan nilai yang sesuai. Untuk informasi lebih lanjut, lihat [Membuat rahasia dasar](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dalam *AWS Secrets Manager Panduan Pengguna*. + 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. + ServiceNow Akun dengan langganan yang diaktifkan ke MetricBase. Sebagai tambahan, metrik dan tabel metrik harus dibuat dalam akun. Untuk informasi lebih lanjut, lihat [MetricBase](https://docs.servicenow.com/bundle/london-servicenow-platform/page/administer/metricbase/concept/metricbase.html)di ServiceNow dokumentasi. + Rahasia tipe teks AWS Secrets Manager yang menyimpan nama pengguna dan kata sandi untuk masuk ke ServiceNow instance Anda dengan otentikasi dasar. Rahasianya harus berisi tombol "pengguna” dan "kata sandi” dengan nilai yang sesuai. Untuk informasi lebih lanjut, lihat [Membuat rahasia dasar](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_create-basic-secret.html) dalam *AWS Secrets Manager Panduan Pengguna*. + 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 ] `PublishInterval` Jumlah maksimum detik untuk menunggu antara mempublikasikan acara ke ServiceNow. Nilai maksimumnya adalah 900. Konektor mempublikasikan ServiceNow kapan `PublishBatchSize` tercapai atau `PublishInterval` kedaluwarsa. Nama tampilan di AWS IoT konsol: **Publikasikan interval dalam hitungan detik** Wajib: `true` Jenis: `string` Nilai yang valid: `1 - 900` Pola yang valid: `[1-9]|[1-9]\d|[1-9]\d\d|900` `PublishBatchSize` Jumlah maksimum nilai metrik yang dapat dikelompokkan sebelum dipublikasikan ke ServiceNow. Konektor mempublikasikan ServiceNow kapan `PublishBatchSize` tercapai atau `PublishInterval` kedaluwarsa. Nama tampilan di AWS IoT konsol: **Publikasikan ukuran batch** Wajib: `true` Jenis: `string` Pola yang valid: `^[0-9]+$` `InstanceName` Nama instance yang digunakan untuk terhubung ke ServiceNow. Nama tampilan di AWS IoT konsol: **Nama ServiceNow contoh** Wajib: `true` Jenis: `string` Pola yang valid: `.+` `DefaultTableName` Nama tabel yang berisi `GlideRecord` terkait dengan MetricBase database deret waktu. Properti `table` dalam muatan pesan input dapat digunakan untuk menimpa nilai ini. Nama tampilan di AWS IoT konsol: **Nama tabel yang berisi metrik** Wajib: `true` Jenis: `string` Pola yang valid: `.+` `MaxMetricsToRetain` Jumlah maksimum metrik untuk dipertahankan dalam memori sebelum diganti dengan metrik baru. Batas ini berlaku bila tidak ada koneksi ke internet dan konektor mulai buffer metrik untuk diterbitkan nanti. Ketika buffer penuh, metrik terlama digantikan oleh metrik baru. Metrik tidak dipertahankan jika proses host untuk konektor terganggu. Sebagai contoh, hal ini dapat terjadi selama deployment grup atau ketika perangkat restart. Nilai ini harus lebih besar daripada ukuran batch dan cukup besar untuk menyimpan pesan berdasarkan tingkat masuk pesan MQTT. Nama tampilan di AWS IoT konsol: **Metrik maksimum untuk disimpan dalam memori** Wajib: `true` Jenis: `string` Pola yang valid: `^[0-9]+$` `AuthSecretArn` AWS Secrets Manager Rahasianya menyimpan nama ServiceNow pengguna dan kata sandi. Ini harus berupa rahasia jenis teks. Rahasianya harus berisi tombol "pengguna” dan "kata sandi” dengan nilai yang sesuai. Nama tampilan di AWS IoT konsol: **ARN rahasia autentikasi** Wajib: `true` Jenis: `string` Pola yang valid: `arn:aws:secretsmanager:[a-z0-9\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\]+/)*[a-zA-Z0-9/_+=,.@\-]+-[a-zA-Z0-9]+` `AuthSecretArn-ResourceId` Sumber daya rahasia dalam grup yang mereferensikan rahasia Secrets Manager untuk ServiceNow kredensialnya. Nama tampilan di AWS IoT konsol: Sumber daya **token autentikasi** Wajib: `true` 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 wadah** Wajib: `false` Jenis: `string` Nilai yang valid: `GreengrassContainer` or `NoContainer` Pola yang valid: `^NoContainer$|^GreengrassContainer$` ------ #### [ Version 1 - 3 ] `PublishInterval` Jumlah maksimum detik untuk menunggu antara mempublikasikan acara ke ServiceNow. Nilai maksimumnya adalah 900. Konektor mempublikasikan ServiceNow kapan `PublishBatchSize` tercapai atau `PublishInterval` kedaluwarsa. Nama tampilan di AWS IoT konsol: **Publikasikan interval dalam hitungan detik** Wajib: `true` Jenis: `string` Nilai yang valid: `1 - 900` Pola yang valid: `[1-9]|[1-9]\d|[1-9]\d\d|900` `PublishBatchSize` Jumlah maksimum nilai metrik yang dapat dikelompokkan sebelum dipublikasikan ke ServiceNow. Konektor mempublikasikan ServiceNow kapan `PublishBatchSize` tercapai atau `PublishInterval` kedaluwarsa. Nama tampilan di AWS IoT konsol: **Publikasikan ukuran batch** Wajib: `true` Jenis: `string` Pola yang valid: `^[0-9]+$` `InstanceName` Nama instance yang digunakan untuk terhubung ke ServiceNow. Nama tampilan di AWS IoT konsol: **Nama ServiceNow contoh** Wajib: `true` Jenis: `string` Pola yang valid: `.+` `DefaultTableName` Nama tabel yang berisi `GlideRecord` terkait dengan MetricBase database deret waktu. Properti `table` dalam muatan pesan input dapat digunakan untuk menimpa nilai ini. Nama tampilan di AWS IoT konsol: **Nama tabel yang berisi metrik** Wajib: `true` Jenis: `string` Pola yang valid: `.+` `MaxMetricsToRetain` Jumlah maksimum metrik untuk dipertahankan dalam memori sebelum diganti dengan metrik baru. Batas ini berlaku bila tidak ada koneksi ke internet dan konektor mulai buffer metrik untuk diterbitkan nanti. Ketika buffer penuh, metrik terlama digantikan oleh metrik baru. Metrik tidak dipertahankan jika proses host untuk konektor terganggu. Sebagai contoh, hal ini dapat terjadi selama deployment grup atau ketika perangkat restart. Nilai ini harus lebih besar daripada ukuran batch dan cukup besar untuk menyimpan pesan berdasarkan tingkat masuk pesan MQTT. Nama tampilan di AWS IoT konsol: **Metrik maksimum untuk disimpan dalam memori** Wajib: `true` Jenis: `string` Pola yang valid: `^[0-9]+$` `AuthSecretArn` AWS Secrets Manager Rahasianya menyimpan nama ServiceNow pengguna dan kata sandi. Ini harus berupa rahasia jenis teks. Rahasianya harus berisi tombol "pengguna” dan "kata sandi” dengan nilai yang sesuai. Nama tampilan di AWS IoT konsol: **ARN rahasia autentikasi** Wajib: `true` Jenis: `string` Pola yang valid: `arn:aws:secretsmanager:[a-z0-9\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\]+/)*[a-zA-Z0-9/_+=,.@\-]+-[a-zA-Z0-9]+` `AuthSecretArn-ResourceId` Sumber daya rahasia dalam grup yang mereferensikan rahasia Secrets Manager untuk ServiceNow kredensialnya. Nama tampilan di AWS IoT konsol: Sumber daya **token autentikasi** Wajib: `true` Jenis: `string` Pola yang valid: `.+` ------ ### Buat Contoh Konektor (AWS CLI) Perintah CLI berikut membuat `ConnectorDefinition` dengan versi awal yang berisi konektor ServiceNow MetricBase Integrasi. ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyServiceNowMetricBaseIntegrationConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/ServiceNowMetricBaseIntegration/versions/4", "Parameters": { "PublishInterval" : "10", "PublishBatchSize" : "50", "InstanceName" : "myinstance", "DefaultTableName" : "u_greengrass_app", "MaxMetricsToRetain" : "20000", "AuthSecretArn" : "arn:aws:secretsmanager:region:account-id:secret:greengrass-secret-hash", "AuthSecretArn-ResourceId" : "MySecretResource", "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 metrik deret waktu pada topik MQTT dan menerbitkan metrik ke. ServiceNow Pesan input harus dalam format JSON. **Filter topik dalam langganan** `servicenow/metricbase/metric` **Properti pesan** `request` Informasi tentang tabel, catatan, dan metrik. Permintaan ini mewakili `seriesRef` objek dalam permintaan time series POST. Untuk informasi lebih lanjut, lihat [ API Deret Waktu Clotho - POST](https://docs.servicenow.com/bundle/london-application-development/page/integrate/inbound-rest/concept/Clotho-Time-Series-API.html#clotho-POST-put). Wajib: `true` Jenis: `object` yang mencakup properti berikut: `subject` Ini `sys_id` adalah catatan khusus dalam tabel. Wajib: `true` Jenis: `string` `metric_name` Nama bidang metrik. Wajib: `true` Jenis: `string` `table` Nama tabel untuk menyimpan catatan dalam. Tentukan nilai ini untuk menimpa `DefaultTableName` parameter. Wajib: `false` Jenis: `string` `value` Nilai data poin individu. Wajib: `true` Jenis: `float` `timestamp` Timestamp dari data poin individu. Nilai default adalah waktu ketika ini. Wajib: `false` Jenis: `string` **Contoh masukan** ``` { "request": { "subject":"ef43c6d40a0a0b5700c77f9bf387afe3", "metric_name":"u_count", "table": "u_greengrass_app" "value": 1.0, "timestamp": "2018-10-14T10:30:00" } } ``` ## Data output Konektor ini menerbitkan informasi status sebagai data output pada topik MQTT. **Filter topik dalam langganan** `servicenow/metricbase/metric/status` **Contoh keluaran: Sukses** ``` { "response": { "metric_name": "Errors", "table_name": "GliderProd", "processed_on": "2018-10-14T10:35:00", "response_id": "khjKSkj132qwr23fcba", "status": "success", "values": [ { "timestamp": "2016-10-14T10:30:00", "value": 1.0 }, { "timestamp": "2016-10-14T10:31:00", "value": 1.1 } ] } } ``` **Contoh keluaran: Kegagalan** ``` { "response": { "error": "InvalidInputException", "error_message": "metric value is invalid", "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](#servicenow-connector-req) untuk konektor. 1. Buat dan terbitkan fungsi Lambda yang mengirimkan data input ke konektor. Simpan [kode contoh](#servicenow-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](#servicenow-connector-param). 1. Tambahkan langganan yang mengizinkan konektor untuk menerima [data input](#servicenow-connector-data-input) dan mengirim [data output](#servicenow-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 json iot_client = greengrasssdk.client('iot-data') SEND_TOPIC = 'servicenow/metricbase/metric' def create_request_with_all_fields(): return { "request": { "subject": '2efdf6badbd523803acfae441b961961', "metric_name": 'u_count', "value": 1234, "timestamp": '2018-10-20T20:22:20', "table": 'u_greengrass_metricbase_test' } } 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 ServiceNow MetricBase Integrasi mencakup perangkat lunak/lisensi pihak ketiga berikut: + [pysnow](https://github.com/rbw/pysnow)/MIT 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)