View a markdown version of this page

CloudWatch metrik - AWS IoT Greengrass
VersiTipeSistem operasiPersyaratanDependensiKonfigurasiData inputData outputLisensiFile log lokalChangelogLihat juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CloudWatch metrik

Komponen CloudWatch metrik Amazon (aws.greengrass.Cloudwatch) menerbitkan metrik khusus dari perangkat inti Greengrass ke Amazon CloudWatch. Komponen ini memungkinkan komponen untuk mempublikasikan CloudWatch metrik, yang dapat Anda gunakan untuk memantau dan menganalisis lingkungan perangkat inti Greengrass. Untuk informasi selengkapnya, lihat Menggunakan CloudWatch metrik Amazon di Panduan CloudWatch Pengguna Amazon.

Untuk menerbitkan CloudWatch metrik dengan komponen ini, publikasikan pesan ke topik tempat komponen ini berlangganan. Secara default, komponen ini berlangganan publish/subscribe topik cloudwatch/metric/put lokal. Anda dapat menentukan topik lain, termasuk topik AWS IoT Core MQTT, saat Anda menerapkan komponen ini.

Komponen ini menggabungkan metrik yang berada di namespace yang sama dan menerbitkannya secara CloudWatch berkala.

catatan

Komponen ini menyediakan fungsionalitas serupa dengan konektor CloudWatch metrik di AWS IoT Greengrass V1. Untuk informasi selengkapnya, lihat konektor CloudWatch metrik di Panduan Pengembang AWS IoT Greengrass V1.

Versi

Komponen ini memiliki versi berikut:

  • 4.0.x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.1.x

  • 2.0.x

Untuk informasi tentang perubahan di setiap versi komponen, lihat changelog.

Tipe

v4.x - v3.x

Komponen ini adalah komponen generik (aws.greengrass.generic). In ti Greengrass menjalankan skrip siklus hidup komponen.

v2.x

Komponen ini adalah komponen Lambda (aws.greengrass.lambda). In ti Greengrass menjalankan fungsi Lambda komponen ini menggunakan komponen peluncur Lambda.

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

v4.x - v3.x

Komponen ini dapat diinstal pada perangkat inti yang menjalankan sistem operasi berikut:

  • Linux

  • Windows

v2.x

Komponen ini hanya dapat diinstal pada perangkat inti Linux.

Persyaratan

Komponen ini memiliki persyaratan sebagai berikut:

v4.x - v3.x

  • Python versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH.

  • Pustaka Python berikut, termasuk dependensi apa pun, harus diinstal dan tersedia untuk pengguna yang menjalankan komponen:

    catatan

    Anda dapat mengatur UseInstaller konfigurasi true untuk menginstal pustaka ini secara otomatis ke lingkungan Python yang disediakan.

  • Peran perangkat Greengrass harus mengizinkan tindakan cloudwatch:PutMetricData, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut.

    JSON
    JSON
    {
  "Version":"2012-10-17",
  "Statement": [
    {
      "Action": [
        "cloudwatch:PutMetricData"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

    Untuk informasi selengkapnya, lihat referensi CloudWatch izin Amazon di Panduan CloudWatch Pengguna Amazon.

2.x

  • Perangkat inti Anda harus memenuhi persyaratan untuk menjalankan fungsi Lambda. Jika Anda ingin perangkat inti untuk menjalankan fungsi Lambda kontainer, perangkat harus memenuhi persyaratan untuk melakukannya. Untuk informasi selengkapnya, lihat Persyaratan fungsi Lambda.

  • Python versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH.

  • Peran perangkat Greengrass harus mengizinkan tindakan cloudwatch:PutMetricData, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut.

    JSON
    JSON
    {
  "Version":"2012-10-17",
  "Statement": [
    {
      "Action": [
        "cloudwatch:PutMetricData"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

    Untuk informasi selengkapnya, lihat referensi CloudWatch izin Amazon di Panduan CloudWatch Pengguna Amazon.

  • Untuk menerima data keluaran dari komponen ini, Anda harus menggabungkan pembaruan konfigurasi berikut untuk komponen router langganan lama (aws.greengrass.LegacySubscriptionRouter) saat Anda menerapkan komponen ini. Konfigurasi ini menentukan topik di mana komponen ini menerbitkan tanggapan.

    Legacy subscription router v2.1.xLegacy subscription router v2.0.x
    Legacy subscription router v2.1.x
    {
  "subscriptions": {
    "aws-greengrass-cloudwatch": {
      "id": "aws-greengrass-cloudwatch",
      "source": "component:aws.greengrass.Cloudwatch",
      "subject": "cloudwatch/metric/put/status",
      "target": "cloud"
    }
  }
}
    Legacy subscription router v2.0.x
    {
  "subscriptions": {
    "aws-greengrass-cloudwatch": {
      "id": "aws-greengrass-cloudwatch",
      "source": "arn:aws:lambda:region:aws:function:aws-greengrass-cloudwatch:version",
      "subject": "cloudwatch/metric/put/status",
      "target": "cloud"
    }
  }
}

    • Ganti region dengan Wilayah AWS yang Anda gunakan.

    • Ganti version dengan versi fungsi Lambda yang dijalankan komponen ini. Untuk menemukan versi fungsi Lambda, Anda harus melihat resep untuk versi komponen ini yang ingin Anda deploy. Buka halaman detail komponen ini di konsol AWS IoT Greengrass tersebut, dan cari pasangan nilai kunci Fungsi Lambda. Pasangan kunci-nilai ini berisi nama dan versi fungsi Lambda.

    penting

    Anda harus memperbarui versi fungsi Lambda pada router langganan warisan setiap kali Anda men-deploy komponen ini. Hal ini memastikan bahwa Anda menggunakan versi fungsi Lambda yang benar untuk versi komponen yang Anda deploy.

    Untuk informasi selengkapnya, lihat Buat deployment.

Titik akhir dan port

Komponen ini harus dapat melakukan permintaan keluar ke titik akhir dan port berikut, selain titik akhir dan port yang diperlukan untuk operasi dasar. Untuk informasi selengkapnya, lihat Izinkan lalu lintas perangkat melalui proxy atau firewall.

Titik akhir Port Diperlukan Deskripsi

monitoring.region.amazonaws.com

 443 Ya

Unggah CloudWatch metrik.

Dependensi

Saat Anda menerapkan komponen, AWS IoT Greengrass juga menerapkan versi dependensinya yang kompatibel. Ini berarti bahwa Anda harus memenuhi persyaratan untuk komponen dan semua dependensinya untuk berhasil men-deploy komponen. Bagian ini berisi daftar dependensi untuk versi yang dirilis dari komponen ini dan kendala versi semantik yang menentukan versi komponen untuk setiap dependensi. Anda juga dapat melihat dependensi untuk setiap versi komponen di konsol AWS IoT Greengrass tersebut. Pada halaman detail komponen, cari daftar Dependensi.

4.0.0 - 3.0.0

Tabel berikut mencantumkan dependensi untuk versi 4.0.0 hingga 3.0.0 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass > =2.0.0 <3.0.0 Lunak
Layanan pertukaran token >=0.0.0 Keras
2.1.4 - 2.1.9

Tabel berikut mencantumkan dependensi untuk versi 2.1.4 hingga 2.1.9 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass > =2.0.0 <3.0.0 Keras
Peluncur Lambda ^2.0.0 Keras
Runtime Lambda ^2.0.0 Lunak
Layanan pertukaran token ^2.0.0 Keras
2.1.4 - 2.1.8

Tabel berikut mencantumkan dependensi untuk versi 2.1.4 dan 2.1.8 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass > =2.0.0 <3.0.0 Keras
Peluncur Lambda ^2.0.0 Keras
Runtime Lambda ^2.0.0 Lunak
Layanan pertukaran token ^2.0.0 Keras
2.1.2 - 2.1.3

Tabel berikut mencantumkan dependensi untuk versi 2.1.2 dan 2.1.3 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass > =2.0.0 <2.8.0 Keras
Peluncur Lambda ^2.0.0 Keras
Runtime Lambda ^2.0.0 Lunak
Layanan pertukaran token ^2.0.0 Keras
2.1.1

Tabel berikut mencantumkan dependensi untuk versi 2.1.1 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass > =2.0.0 <2.7.0 Keras
Peluncur Lambda ^2.0.0 Keras
Runtime Lambda ^2.0.0 Lunak
Layanan pertukaran token ^2.0.0 Keras
2.0.8 - 2.1.0

Tabel berikut mencantumkan dependensi untuk versi 2.0.8 hingga 2.1.0 dari komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass > =2.0.0 <2.6.0 Keras
Peluncur Lambda ^2.0.0 Keras
Runtime Lambda ^2.0.0 Lunak
Layanan pertukaran token ^2.0.0 Keras
2.0.7

Tabel berikut mencantumkan dependensi untuk versi 2.0.7 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass > =2.0.0 <2.5.0 Keras
Peluncur Lambda ^2.0.0 Keras
Runtime Lambda ^2.0.0 Lunak
Layanan pertukaran token ^2.0.0 Keras
2.0.6

Tabel berikut mencantumkan dependensi untuk versi 2.0.6 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass >=2.0.0 <2.4.0 Keras
Peluncur Lambda ^2.0.0 Keras
Runtime Lambda ^2.0.0 Lunak
Layanan pertukaran token ^2.0.0 Keras
2.0.5

Tabel berikut mencantumkan dependensi untuk versi 2.0.5 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass >=2.0.0 <2.3.0 Keras
Peluncur Lambda ^2.0.0 Keras
Runtime Lambda ^2.0.0 Lunak
Layanan pertukaran token ^2.0.0 Keras
2.0.4

Tabel berikut mencantumkan dependensi untuk versi 2.0.4 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass >=2.0.0 <2.2.0 Keras
Peluncur Lambda ^2.0.0 Keras
Runtime Lambda ^2.0.0 Lunak
Layanan pertukaran token ^2.0.0 Keras
2.0.3

Tabel berikut mencantumkan dependensi untuk versi 2.0.3 komponen ini.

Dependensi Versi yang kompatibel Jenis dependensi
Inti greengrass >=2.0.3 <2.1.0 Keras
Peluncur Lambda >=1.0.0 Keras
Runtime Lambda >=1.0.0 Lunak
Layanan pertukaran token >=1.0.0 Keras

Untuk informasi selengkapnya tentang dependensi komponen, lihat referensi resep komponen.

Konfigurasi

Komponen ini menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan ketika Anda men-deploy komponen.

v4.x
PublishInterval

(Opsional) Jumlah detik maksimum untuk menunggu sebelum komponen menerbitkan metrik berkelompok untuk namespace tertentu. Untuk mengonfigurasi komponen untuk mempublikasikan metrik saat menerimanya, yang berarti tanpa batching, tentukan 0.

Komponen menerbitkan CloudWatch setelah menerima 20 metrik dalam namespace yang sama atau setelah interval yang Anda tentukan.

catatan

Komponen tidak menentukan urutan publikasi acara.

Nilai ini bisa maksimal 900 detik.

Default: 10 detik

MaxMetricsToRetain

(Opsional) Jumlah maksimum metrik di semua namespace untuk disimpan di memori sebelum komponen menggantikannya dengan metrik yang lebih baru.

Batas ini berlaku bila perangkat inti tidak memiliki koneksi ke internet, sehingga komponen mem-buffer metrik untuk dipublikasikan nanti. Ketika buffer penuh, komponen menggantikan metrik tertua dengan yang lebih baru. Metrik dalam namespace tertentu hanya menggantikan metrik dalam namespace yang sama.

catatan

Jika proses host untuk komponen terganggu, komponen tidak akan menyimpan metrik. Hal ini dapat terjadi selama deployment atau ketika perangkat inti restart, misalnya.

Nilai ini harus setidaknya 2.000 metrik.

Default: 5.000 metrik

InputTopic

(Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan true untukPubSubToIoTCore, Anda dapat menggunakan wildcard MQTT (+ dan #) dalam topik ini.

Default: cloudwatch/metric/put

OutputTopic

(Opsional) Topik tempat komponen menerbitkan tanggapan status.

Default: cloudwatch/metric/put/status

PubSubToIoTCore

(Opsional) Nilai string yang menentukan apakah akan menerbitkan dan berlangganan topik AWS IoT Core MQTT. Nilai yang didukung adalah true dan false.

Default: false

LogLevel

(Opsional) Level logging untuk komponen. Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • DEBUG

  • INFO

  • WARNING

  • ERROR

  • CRITICAL

Default: INFO

UseInstaller

(Opsional) Nilai Boolean yang menentukan apakah akan menggunakan skrip penginstal untuk menginstal dependensi Python komponen ini ke lingkungan Python yang disediakan.

Tetapkan nilai ini true untuk menginstal dependensi Python komponen ini secara otomatis. Ketika diset false el ke, Anda harus menginstal pustaka berikut, termasuk dependensi apa pun, dan membuatnya tersedia untuk lingkungan Python yang disediakan untuk pengguna yang menjalankan komponen.

Default: false

PublishRegion

(Opsional) CloudWatch Metrik yang akan dipublikasikan. Wilayah AWS Nilai ini menimpa Wilayah default untuk perangkat inti. Parameter ini diperlukan hanya untuk metrik lintas Wilayah.

accessControl

(Opsional) Objek yang berisi kebijakan otorisasi yang memungkinkan komponen untuk menerbitkan dan berlangganan topik yang ditentukan. Jika Anda menentukan nilai kustom untuk InputTopic danOutputTopic, Anda harus memperbarui nilai sumber daya dalam objek ini.

Default: 

{
  "aws.greengrass.ipc.pubsub": {
    "aws.greengrass.Cloudwatch:pubsub:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:pubsub:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  },
  "aws.greengrass.ipc.mqttproxy": {
    "aws.greengrass.Cloudwatch:mqttproxy:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:mqttproxy:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  }
}
contoh Contoh: Pembaruan gabungan konfigurasi
{
  "PublishInterval": 0,
  "PubSubToIoTCore": true
}
v3.x
PublishInterval

(Opsional) Jumlah detik maksimum untuk menunggu sebelum komponen menerbitkan metrik berkelompok untuk namespace tertentu. Untuk mengonfigurasi komponen untuk mempublikasikan metrik saat menerimanya, yang berarti tanpa batching, tentukan 0.

Komponen menerbitkan CloudWatch setelah menerima 20 metrik dalam namespace yang sama atau setelah interval yang Anda tentukan.

catatan

Komponen tidak menentukan urutan publikasi acara.

Nilai ini bisa maksimal 900 detik.

Default: 10 detik

MaxMetricsToRetain

(Opsional) Jumlah maksimum metrik di semua namespace untuk disimpan di memori sebelum komponen menggantikannya dengan metrik yang lebih baru.

Batas ini berlaku bila perangkat inti tidak memiliki koneksi ke internet, sehingga komponen mem-buffer metrik untuk dipublikasikan nanti. Ketika buffer penuh, komponen menggantikan metrik tertua dengan yang lebih baru. Metrik dalam namespace tertentu hanya menggantikan metrik dalam namespace yang sama.

catatan

Jika proses host untuk komponen terganggu, komponen tidak akan menyimpan metrik. Hal ini dapat terjadi selama deployment atau ketika perangkat inti restart, misalnya.

Nilai ini harus setidaknya 2.000 metrik.

Default: 5.000 metrik

InputTopic

(Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan true untukPubSubToIoTCore, Anda dapat menggunakan wildcard MQTT (+ dan #) dalam topik ini.

Default: cloudwatch/metric/put

OutputTopic

(Opsional) Topik tempat komponen menerbitkan tanggapan status.

Default: cloudwatch/metric/put/status

PubSubToIoTCore

(Opsional) Nilai string yang menentukan apakah akan menerbitkan dan berlangganan topik AWS IoT Core MQTT. Nilai yang didukung adalah true dan false.

Default: false

LogLevel

(Opsional) Level logging untuk komponen. Pilih dari tingkat log berikut, yang tercantum di sini dalam urutan tingkat:

  • DEBUG

  • INFO

  • WARNING

  • ERROR

  • CRITICAL

Default: INFO

UseInstaller

(Opsional) Nilai Boolean yang menentukan apakah akan menggunakan skrip penginstal untuk menginstal dependensi Python komponen ini ke lingkungan Python yang disediakan.

Tetapkan nilai ini false untuk menggunakan skrip kustom atau menginstal dependensi secara manual. Ketika diset false el ke, Anda harus menginstal pustaka berikut, termasuk dependensi apa pun, dan membuatnya tersedia untuk lingkungan Python yang disediakan untuk pengguna yang menjalankan komponen.

Default: true

PublishRegion

(Opsional) CloudWatch Metrik yang akan dipublikasikan. Wilayah AWS Nilai ini menimpa Wilayah default untuk perangkat inti. Parameter ini diperlukan hanya untuk metrik lintas Wilayah.

accessControl

(Opsional) Objek yang berisi kebijakan otorisasi yang memungkinkan komponen untuk menerbitkan dan berlangganan topik yang ditentukan. Jika Anda menentukan nilai kustom untuk InputTopic danOutputTopic, Anda harus memperbarui nilai sumber daya dalam objek ini.

Default: 

{
  "aws.greengrass.ipc.pubsub": {
    "aws.greengrass.Cloudwatch:pubsub:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:pubsub:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToTopic"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  },
  "aws.greengrass.ipc.mqttproxy": {
    "aws.greengrass.Cloudwatch:mqttproxy:1": {
      "policyDescription": "Allows access to subscribe to input topics.",
      "operations": [
        "aws.greengrass#SubscribeToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put"
      ]
    },
    "aws.greengrass.Cloudwatch:mqttproxy:2": {
      "policyDescription": "Allows access to publish to output topics.",
      "operations": [
        "aws.greengrass#PublishToIoTCore"
      ],
      "resources": [
        "cloudwatch/metric/put/status"
      ]
    }
  }
}
contoh Contoh: Pembaruan gabungan konfigurasi
{
  "PublishInterval": 0,
  "PubSubToIoTCore": true
}
v2.x
catatan

Konfigurasi default komponen ini meliputi parameter fungsi Lambda. Kami sarankan Anda mengedit hanya parameter berikut untuk mengonfigurasi komponen ini pada perangkat Anda.

lambdaParams

Sebuah objek yang berisi parameter untuk fungsi Lambda komponen ini. Objek ini berisi informasi berikut:

EnvironmentVariables

Sebuah objek yang berisi parameter fungsi Lambda ini. Objek ini berisi informasi berikut:

PUBLISH_INTERVAL

(Opsional) Jumlah detik maksimum untuk menunggu sebelum komponen menerbitkan metrik berkelompok untuk namespace tertentu. Untuk mengonfigurasi komponen untuk mempublikasikan metrik saat menerimanya, yang berarti tanpa batching, tentukan 0.

Komponen menerbitkan CloudWatch setelah menerima 20 metrik dalam namespace yang sama atau setelah interval yang Anda tentukan.

catatan

Komponen tidak menjamin urutan di mana peristiwa dipublikasikan.

Nilai ini bisa paling banyak 900 detik.

Default: 10 detik

MAX_METRICS_TO_RETAIN

(Opsional) Jumlah maksimum metrik di semua namespace untuk disimpan di memori sebelum komponen menggantikannya dengan metrik yang lebih baru.

Batas ini berlaku bila perangkat inti tidak memiliki koneksi ke internet, sehingga komponen mem-buffer metrik untuk dipublikasikan nanti. Ketika buffer penuh, komponen menggantikan metrik tertua dengan yang lebih baru. Metrik dalam namespace tertentu hanya menggantikan metrik dalam namespace yang sama.

catatan

Jika proses host untuk komponen terganggu, komponen tidak akan menyimpan metrik. Hal ini dapat terjadi selama deployment atau ketika perangkat inti restart, misalnya.

Nilai ini harus setidaknya 2.000 metrik.

Default: 5.000 metrik

PUBLISH_REGION

(Opsional) CloudWatch Metrik yang akan dipublikasikan. Wilayah AWS Nilai ini menimpa Wilayah default untuk perangkat inti. Parameter ini diperlukan hanya untuk metrik lintas Wilayah.

containerMode

(Opsional) Mode kontainerisasi untuk komponen ini. Pilih dari salah satu pilihan berikut:

  • NoContainer – Komponen tersebut tidak berjalan di lingkungan waktu aktif terisolasi.

  • GreengrassContainer— Komponen berjalan di lingkungan runtime terisolasi di dalam AWS IoT Greengrass wadah.

Default: GreengrassContainer

containerParams

(Opsional) Sebuah objek yang berisi parameter kontainer untuk komponen ini. Komponen menggunakan parameter ini jika Anda menentukan GreengrassContainer untuk containerMode.

Objek ini berisi informasi berikut:

memorySize

(Opsional) Jumlah memori (dalam kilobyte) yang akan dialokasikan ke komponen.

Default ke 64 MB (65.535 KB).

pubsubTopics

(Opsional) Sebuah objek yang berisi topik di mana komponen berlangganan untuk menerima pesan. Anda dapat menentukan setiap topik dan apakah komponen berlangganan topik MQTT dari AWS IoT Core atau topik lokal publish/subscribe .

Objek ini berisi informasi berikut:

0 - Ini adalah indeks himpunan sebagai string.

Objek yang berisi informasi berikut:

type

(Opsional) Jenis publish/subscribe pesan yang digunakan komponen ini untuk berlangganan pesan. Pilih dari salah satu pilihan berikut:

  • PUB_SUB— Berlangganan publish/subscribe pesan lokal. Jika Anda memilih opsi ini, topik tidak dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat Pesan lokal publikasi/berlangganan.

  • IOT_CORE— Berlangganan pesan AWS IoT Core MQTT. Jika Anda memilih opsi ini, topik dapat berisi wildcard MQTT. Untuk informasi lebih lanjut tentang cara mengirim pesan dari komponen kustom ketika Anda menentukan opsi ini, lihat Publish/subscribe AWS IoT Core Pesan MQTT.

Default: PUB_SUB

topic

(Opsional) Topik yang menjadi langganan komponen untuk menerima pesan. Jika Anda menentukan IotCore untuk type, Anda dapat menggunakan wildcard MQTT (+ dan #) dalam topik ini.

contoh Contoh: Pembaruan gabungan konfigurasi (mode kontainer)
{
  "containerMode": "GreengrassContainer"
}
contoh Contoh: Pembaruan gabungan konfigurasi (tidak ada mode kontainer)
{
  "containerMode": "NoContainer"
}

Data input

Komponen ini menerima metrik pada topik berikut dan menerbitkan metrik ke CloudWatch. Secara default, komponen ini berlangganan publish/subscribe pesan lokal. Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat Pesan lokal publikasi/berlangganan.

Dimulai dengan versi komponen v3.0.0, Anda dapat secara opsional mengonfigurasi komponen ini untuk berlangganan topik MQTT dengan menyetel parameter PubSubToIoTCore konfigurasi ke. true Untuk informasi selengkapnya tentang menerbitkan pesan ke topik MQTT di komponen kustom Anda, lihatPublish/subscribe AWS IoT Core Pesan MQTT.

Topik default: cloudwatch/metric/put

Pesan menerima properti berikut. Pesan input harus dalam format JSON.

request

Metrik dalam pesan ini.

Objek permintaan berisi data metrik untuk dipublikasikan CloudWatch. Nilai metrik harus memenuhi spesifikasi PutMetricData operasi.

Jenis: object yang berisi informasi berikut:

namespace

Namespace yang ditentukan pengguna untuk data metrik dalam permintaan ini. CloudWatch menggunakan ruang nama sebagai wadah untuk titik data metrik.

catatan

Anda tidak dapat menentukan namespace yang dimulai dengan string yang sudah dipesan AWS/.

Tipe: string

Pola yang valid: [^:].*

metricData

Data untuk metrik tersebut.

Jenis: object yang berisi informasi berikut:

metricName

Nama metrik.

Tipe: string

value

Nilai untuk metrik.

catatan

CloudWatch menolak nilai yang terlalu kecil atau terlalu besar. Nilai harus antara 8.515920e-109 dan 1.174271e+108 (Basis 10) atau 2e-360 dan 2e360 (Basis 2). CloudWatch tidak mendukung nilai-nilai khusus sepertiNaN,+Infinity, dan-Infinity.

Tipe: double

dimensions

(Opsional) Dimensi untuk metrik. Dimensi memberikan informasi tambahan tentang metrik dan datanya. Metrik dapat menentukan hingga 10 dimensi.

Komponen ini secara otomatis menyertakan dimensi bernamacoreName, di mana nilainya adalah nama perangkat inti.

Jenis: array dari objek yang masing-masing berisi informasi berikut:

name

(Opsional) Nama dimensi.

Tipe: string

value

(Opsional) Nilai dimensi.

Tipe: string

timestamp

(Opsional) Waktu penerimaan data metrik, dinyatakan dalam detik jangka waktu Unix.

Default untuk waktu di mana komponen menerima pesan.

Tipe: double

catatan

Jika Anda menggunakan antara versi 2.0.3 dan 2.0.7 komponen ini, sebaiknya Anda mengambil stempel waktu secara terpisah untuk setiap metrik saat Anda mengirim beberapa metrik dari satu sumber. Jangan menggunakan variabel untuk menyimpan cap waktu.

unit

(Opsional) Unit metrik.

Tipe: string

Nilai yang valid: Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None

Default ke None.

catatan

Semua kuota yang berlaku untuk CloudWatch PutMetricData API berlaku untuk metrik yang Anda publikasikan dengan komponen ini. Kuota berikut sangat penting:

  • Batas 40 KB pada muatan API

  • 20 metrik per permintaan API

  • 150 transaksi per detik (TPS) untuk API PutMetricData

Untuk informasi selengkapnya, lihat kuota CloudWatch layanan di Panduan CloudWatch Pengguna.

contoh Contoh input
{
  "request": {
    "namespace": "Greengrass",
    "metricData": {
      "metricName": "latency",
      "dimensions": [
        {
          "name": "hostname",
          "value": "test_hostname"
        }
      ],
      "timestamp": 1539027324,
      "value": 123.0,
      "unit": "Seconds"
    }
  }
}

Data output

Komponen ini menerbitkan tanggapan sebagai data keluaran pada publish/subscribe topik lokal berikut secara default. Untuk informasi lebih lanjut tentang cara mempublikasikan pesan ke komponen ini dari komponen kustom Anda, lihat Pesan lokal publikasi/berlangganan.

Anda dapat secara opsional mengonfigurasi komponen ini untuk dipublikasikan ke topik MQTT dengan menyetel parameter PubSubToIoTCore konfigurasi ketrue. Untuk informasi selengkapnya tentang berlangganan pesan pada topik MQTT di komponen kustom Anda, lihat. Publish/subscribe AWS IoT Core Pesan MQTT

catatan

Versi komponen 2.0.x mempublikasikan tanggapan sebagai data keluaran pada topik MQTT secara default. Anda harus menentukan topik seperti subject dalam konfigurasi untuk komponen router langganan lama.

Topik default: cloudwatch/metric/put/status

contoh Contoh output: Berhasil

Respons mencakup namespace dari data metrik dan RequestId bidang dari CloudWatch respons.

{
  "response": {
    "cloudwatch_rid": "70573243-d723-11e8-b095-75ff2EXAMPLE",
    "namespace": "Greengrass",
    "status": "success"
  }
}
contoh Contoh output: Gagal
{
  "response" : {
    "namespace": "Greengrass",
    "error": "InvalidInputException",
    "error_message": "cw metric is invalid",
    "status": "fail"
  }
}
catatan

Jika komponen mendeteksi kesalahan yang dapat dicoba ulang, seperti kesalahan koneksi, komponen akan mencoba lagi publikasi di batch berikutnya.

Lisensi

Komponen ini mencakup pihak ketiga berikut software/licensing:

Komponen ini dirilis menurut Perjanjian Lisensi Perangkat Lunak Greengrass Core.

File log lokal

Komponen ini menggunakan file log berikut.

Linux
/greengrass/v2/logs/aws.greengrass.Cloudwatch.log
Windows
C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log
Untuk melihat log komponen ini

  • Jalankan perintah berikut pada perangkat inti untuk melihat file log komponen ini secara real time. Ganti /greengrass/v2 atau C:\greengrass\v2 dengan jalur ke folder AWS IoT Greengrass root.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.greengrass.Cloudwatch.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.greengrass.Cloudwatch.log -Tail 10 -Wait

Changelog

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

v4.x - v3.x

Versi

Perubahan

4.0.0
Fitur baru

  • UseInstallerKonfigurasi sekarang default kefalse.

3.2.0
Fitur baru

  • Tambahkan dukungan resep untuk Greengrass nucleus lite

3.1.0
Perbaikan bug dan peningkatan

3.0.0

Versi komponen CloudWatch metrik ini mengharapkan parameter konfigurasi yang berbeda dari versi 2.x. Jika Anda menggunakan konfigurasi non-default untuk versi 2.x, dan Anda ingin memutakhirkan dari v2.x ke v3.x, Anda harus memperbarui konfigurasi komponen. Untuk informasi selengkapnya, lihat konfigurasi komponen CloudWatch metrik.

Fitur baru

  • Menambahkan dukungan untuk perangkat inti yang menjalankan Windows.

  • Mengubah tipe komponen dari komponen Lambda menjadi komponen generik. Komponen ini sekarang tidak lagi bergantung pada komponen router langganan lama untuk membuat langganan.

  • Menambahkan parameter InputTopic konfigurasi baru untuk menentukan topik yang komponen berlangganan untuk menerima pesan.

  • Menambahkan parameter OutputTopic konfigurasi baru untuk menentukan topik yang komponen menerbitkan respons status.

  • Menambahkan parameter PubSubToIoTCore konfigurasi baru untuk menentukan apakah akan menerbitkan dan berlangganan topik AWS IoT Core MQTT.

  • Menambahkan parameter UseInstaller konfigurasi baru yang memungkinkan Anda secara opsional menonaktifkan skrip instalasi yang menginstal dependensi komponen.

Perbaikan bug dan peningkatan

Menambahkan dukungan untuk cap waktu duplikat dalam data input.
v2.x

Versi

Perubahan

2.1.8

Versi diperbarui untuk Greengrass nucleus versi 2.13.0 rilis.

2.1.3

Versi diperbarui untuk Greengrass nucleus versi 2.11.0 rilis.

2.1.2

Versi diperbarui untuk Greengrass nucleus versi 2.7.0 rilis.

2.1.1

Versi diperbarui untuk Greengrass nucleus versi 2.6.0 rilis.

2.1.0
Fitur baru

2.0.8
Perbaikan bug dan peningkatan

  • Menambahkan dukungan untuk cap waktu duplikat dalam data input.

  • Versi diperbarui untuk Greengrass nucleus versi 2.5.0 rilis.

2.0.7

Versi diperbarui untuk Greengrass nucleus versi 2.4.0 rilis.

2.0.6

Versi yang diperbarui untuk rilis inti Greengrass versi 2.3.0.

2.0.5

Versi yang diperbarui untuk rilis inti Greengrass versi 2.2.0.

2.0.4

Versi yang diperbarui untuk rilis inti Greengrass versi 2.1.0.

2.0.3

Versi awal.

Lihat juga