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 memublikasikan CloudWatch metrik dengan komponen ini, publikasikan pesan ke topik tempat komponen ini berlangganan. Secara default, komponen ini berlangganan topik publikasi/berlangganan lokal cloudwatch/metric/put. Anda dapat menentukan topik lain, termasuk topik AWS IoT Core MQTT, saat Anda menerapkan komponen ini.

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

catatan

Komponen ini menyediakan fungsionalitas yang mirip 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:

  • 3.1.x

  • 3.0.x

  • 2.1.x

  • 2.0.x

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

Tipe

v3.x

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

v2.x

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

Untuk informasi selengkapnya, lihat Jenis komponen.

Sistem operasi

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:

3.x

  • 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.

    {
  "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.

    {
  "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 pemutakhiran konfigurasi berikut untuk komponen router langganan lama (aws.greengrass.LegacySubscriptionRouter) saat 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 wilayah dengan Wilayah AWS yang Anda gunakan.

    • Ganti versi dengan versi fungsi Lambda yang komponen ini jalankan. 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, gunakan AWS IoT Greengrass juga 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.

3.0.0 - 3.1.0

Tabel berikut mencantumkan dependensi untuk versi 3.0.0 hingga 3.1.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.2 and 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 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.

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 dipublikasikan CloudWatch setelah menerima 20 metrik di namespace yang sama atau setelah interval yang Anda tentukan.

catatan

Komponen tidak menentukan urutan penerbitan peristiwa.

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 di mana komponen menerbitkan tanggapan status.

Default: cloudwatch/metric/put/status

PubSubToIoTCore

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

Default: false

UseInstaller

(Opsional) Nilai Boolean yang menentukan apakah akan menggunakan skrip penginstal dalam komponen ini untuk menginstal dependensi SDK komponen ini.

Tetapkan nilai ini false jika Anda ingin menggunakan skrip kustom untuk menginstal dependensi, atau jika Anda ingin menyertakan dependensi runtime dalam image Linux yang sudah dibuat sebelumnya. Untuk menggunakan komponen ini, Anda harus menginstal pustaka berikut, termasuk dependensi apa pun, dan membuatnya tersedia untuk pengguna sistem Greengrass default.

Default: true

PublishRegion

(Opsional) Wilayah AWS Untuk mempublikasikan CloudWatch metrik. 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 mempublikasikan 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 dipublikasikan CloudWatch setelah menerima 20 metrik di 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) Wilayah AWS Untuk mempublikasikan CloudWatch metrik. 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 yang 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 penerbitan/langganan lokal.

Objek ini berisi informasi berikut:

0 - Ini adalah indeks himpunan sebagai string.

Objek yang berisi informasi berikut:

type

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

  • PUB_SUB — Berlangganan pesan publish/subscribe 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 Terbitkan/berlangganan pesan MQTT AWS IoT Core.

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 topik publikasi/berlangganan 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 mengonfigurasi komponen ini secara opsional untuk berlangganan topik MQTT dengan menyetel parameter konfigurasi ke. PubSubToIoTCore true Untuk informasi selengkapnya tentang memublikasikan pesan ke topik MQTT di komponen kustom Anda, lihat. Terbitkan/berlangganan pesan MQTT AWS IoT Core

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 PutMetricDataoperasi.

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 dari 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 terbitkan 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 topik penerbitan/langganan 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 mengonfigurasi komponen ini secara opsional untuk memublikasikan ke topik MQTT dengan menyetel parameter konfigurasi kePubSubToIoTCore. true Untuk informasi selengkapnya tentang berlangganan pesan tentang topik MQTT di komponen kustom Anda, lihat. Terbitkan/berlangganan pesan MQTT AWS IoT Core

catatan

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

Topik default: cloudwatch/metric/put/status

contoh Contoh output: Berhasil

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

{
  "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, ia akan mencoba ulang publikasi di batch berikutnya.

Lisensi

Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut:

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.

v3.x

Versi

Perubahan

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 meningkatkan 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 jenis 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 tanggapan status.

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

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

Perbaikan bug dan peningkatan

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

Versi

Perubahan

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 stempel 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