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

# CloudWatch metrik
<a name="cloudwatch-metrics-component"></a>

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](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/working_with_metrics.html) *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](ipc-publish-subscribe.md) `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](https://docs.aws.amazon.com/greengrass/latest/developerguide/cloudwatch-metrics-connector.html) di Panduan *Pengembang AWS IoT Greengrass V1*.

**Topics**
+ [Versi](#cloudwatch-metrics-component-versions)
+ [Jenis](#cloudwatch-metrics-component-type)
+ [Sistem operasi](#cloudwatch-metrics-component-os-support)
+ [Persyaratan](#cloudwatch-metrics-component-requirements)
+ [Dependensi](#cloudwatch-metrics-component-dependencies)
+ [Konfigurasi](#cloudwatch-metrics-component-configuration)
+ [Masukan data](#cloudwatch-metrics-component-input-data)
+ [Data output](#cloudwatch-metrics-component-output-data)
+ [Lisensi](#cloudwatch-metrics-component-licenses)
+ [Berkas log lokal](#cloudwatch-metrics-component-log-file)
+ [Changelog](#cloudwatch-metrics-component-changelog)
+ [Lihat juga](#cloudwatch-metrics-component-see-also)

## Versi
<a name="cloudwatch-metrics-component-versions"></a>

Komponen ini memiliki versi berikut:
+ 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](#cloudwatch-metrics-component-changelog).

## Jenis
<a name="cloudwatch-metrics-component-type"></a>

------
#### [ v3.x ]

<a name="public-component-type-generic"></a><a name="public-component-type-generic-phrase"></a>Komponen ini adalah komponen generik (`aws.greengrass.generic`). Inti [Greengrass](greengrass-nucleus-component.md) menjalankan skrip siklus hidup komponen.

------
#### [ v2.x ]

<a name="public-component-type-lambda"></a><a name="public-component-type-lambda-phrase"></a>Komponen ini adalah komponen Lambda () `aws.greengrass.lambda`. [Inti [Greengrass](greengrass-nucleus-component.md) menjalankan fungsi Lambda komponen ini menggunakan komponen peluncur Lambda.](lambda-launcher-component.md)

------

<a name="public-component-type-more-information"></a>Untuk informasi selengkapnya, lihat [Jenis komponen](develop-greengrass-components.md#component-types).

## Sistem operasi
<a name="cloudwatch-metrics-component-os-support"></a>

------
#### [ 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
<a name="cloudwatch-metrics-component-requirements"></a>

Komponen ini memiliki persyaratan sebagai berikut:

------
#### [ 3.x ]
+ <a name="public-component-python3-requirement"></a>[Python](https://www.python.org/) versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH.
+ [Peran perangkat Greengrass](device-service-role.md) harus mengizinkan tindakan `cloudwatch:PutMetricData`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut.

------
#### [ JSON ]

****  

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

------

  Untuk informasi selengkapnya, lihat [referensi CloudWatch izin Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) *di Panduan CloudWatch Pengguna Amazon*.

------
#### [ 2.x ]
+ <a name="core-device-lambda-function-requirements"></a>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](setting-up.md#greengrass-v2-lambda-requirements).
+ <a name="public-component-python3-requirement"></a>[Python](https://www.python.org/) versi 3.7 diinstal pada perangkat inti dan ditambahkan ke variabel lingkungan PATH.
+ [Peran perangkat Greengrass](device-service-role.md) harus mengizinkan tindakan `cloudwatch:PutMetricData`, seperti yang ditunjukkan dalam contoh kebijakan IAM berikut.

------
#### [ JSON ]

****  

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

------

  Untuk informasi selengkapnya, lihat [referensi CloudWatch izin Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/permissions-reference-cw.html) *di Panduan CloudWatch Pengguna Amazon*.
+ <a name="connector-component-legacy-subscription-router-dependency"></a>Untuk menerima data keluaran dari komponen ini, Anda harus menggabungkan pemutakhiran konfigurasi berikut untuk [komponen router langganan lama (`aws.greengrass.LegacySubscriptionRouter`) saat menerapkan komponen](legacy-subscription-router-component.md) ini. Konfigurasi ini menentukan topik di mana komponen ini menerbitkan tanggapan.

------
#### [ 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"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + 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](https://console.aws.amazon.com//greengrass) tersebut, dan cari pasangan nilai kunci **Fungsi Lambda**. Pasangan kunci-nilai ini berisi nama dan versi fungsi Lambda.

**penting**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
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.

------

  <a name="connector-component-create-deployments"></a>Untuk informasi selengkapnya, lihat [Buat deployment](create-deployments.md).

------

### Titik akhir dan port
<a name="cloudwatch-metrics-component-endpoints"></a>

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](allow-device-traffic.md).


| Titik akhir | Port | Diperlukan | Deskripsi | 
| --- | --- | --- | --- | 
|  `monitoring.region.amazonaws.com`  | 443 | Ya |  Unggah CloudWatch metrik.  | 

## Dependensi
<a name="cloudwatch-metrics-component-dependencies"></a>

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](#cloudwatch-metrics-component-changelog) 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](https://console.aws.amazon.com//greengrass) tersebut. Pada halaman detail komponen, cari daftar **Dependensi**.

------
#### [ 3.2.0 ]

Tabel berikut mencantumkan dependensi untuk versi 3.2.0 komponen ini.


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | 

------
#### [ 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](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0 | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | >=0.0.0 | Keras | 

------
#### [ 2.1.4 - 2.1.9 ]

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


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | ^2.0.0  | Keras | 

------
#### [ 2.1.4 - 2.1.8 ]

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


| Dependensi | Versi yang kompatibel | Jenis dependensi | 
| --- | --- | --- | 
| [Inti Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <3.0.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | ^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](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | ^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](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | ^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](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | ^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](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | ^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](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | ^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](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | ^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](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | ^2.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | ^2.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | ^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](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0  | Keras | 
| [Peluncur Lambda](lambda-launcher-component.md) | >=1.0.0  | Keras | 
| [Runtime Lambda](lambda-runtimes-component.md) | >=1.0.0  | Lunak | 
| [Layanan pertukaran Token](token-exchange-service-component.md) | >=1.0.0  | Keras | 

------

Untuk informasi selengkapnya tentang dependensi komponen, lihat [referensi resep komponen](component-recipe-reference.md#recipe-reference-component-dependencies).

## Konfigurasi
<a name="cloudwatch-metrics-component-configuration"></a>

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.  
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.  
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` untuk`PubSubToIoTCore`, Anda dapat menggunakan wildcard MQTT (\$1 dan \$1) 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`

`LogLevel`  
(Opsional) Tingkat 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 dalam komponen ini untuk menginstal dependensi SDK komponen ini.  
Tetapkan nilai ini `false` jika Anda ingin menggunakan skrip khusus 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.  
+ [AWS IoT Device SDK v2 untuk Python](https://github.com/aws/aws-iot-device-sdk-python-v2)
+ [AWS SDK untuk Python (Boto3)](http://boto.readthedocs.org/en/latest/ref/)
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](interprocess-communication.md#ipc-authorization-policies) yang memungkinkan komponen untuk mempublikasikan dan berlangganan topik yang ditentukan. Jika Anda menentukan nilai kustom untuk `InputTopic` dan`OutputTopic`, 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"
      ]
    }
  }
}
```

**Example Contoh: Pembaruan gabungan konfigurasi**  

```
{
  "PublishInterval": 0,
  "PubSubToIoTCore": true
}
```

------
#### [ v2.x ]

**catatan**  <a name="connector-component-lambda-parameters"></a>
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.  
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.  
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`  <a name="connector-component-container-mode-parameter"></a>
(Opsional) Mode kontainerisasi untuk komponen ini. Pilih dari salah satu pilihan berikut:  <a name="lambda-function-component-container-mode-parameter"></a>
+ `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`   
<a name="connector-component-container-params-description"></a>(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`   
<a name="connector-component-container-params-memory-size-description"></a>(Opsional) Jumlah memori (dalam kilobyte) yang akan dialokasikan ke komponen.  
Default ke 64 MB (65.535 KB).

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
(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 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](ipc-publish-subscribe.md).
+ `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](ipc-iot-core-mqtt.md).
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.

**Example Contoh: Pembaruan gabungan konfigurasi (mode kontainer)**  

```
{
  "containerMode": "GreengrassContainer"
}
```

**Example Contoh: Pembaruan gabungan konfigurasi (tidak ada mode kontainer)**  

```
{
  "containerMode": "NoContainer"
}
```

------

## Masukan data
<a name="cloudwatch-metrics-component-input-data"></a>

Komponen ini menerima metrik pada topik berikut dan menerbitkan metrik ke. CloudWatch <a name="connector-component-local-publish"></a>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](ipc-publish-subscribe.md). 

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](ipc-iot-core-mqtt.md)

 **Topik default:** `cloudwatch/metric/put` 

<a name="connector-component-input-properties"></a>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 [https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)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.  
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.  
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 seperti`NaN`,`+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 bernama`coreName`, 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`  
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) di *Panduan CloudWatch Pengguna*.

**Example Contoh input**  

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

## Data output
<a name="cloudwatch-metrics-component-output-data"></a>

 <a name="connector-component-output-data-pubsub"></a>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](ipc-publish-subscribe.md). 

Anda dapat mengonfigurasi komponen ini secara opsional untuk memublikasikan ke topik MQTT dengan menyetel parameter konfigurasi ke`PubSubToIoTCore`. `true` Untuk informasi selengkapnya tentang berlangganan pesan tentang topik MQTT di komponen kustom Anda, lihat. [Terbitkan/berlangganan pesan MQTT AWS IoT Core](ipc-iot-core-mqtt.md)

**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](legacy-subscription-router-component.md).

 **Topik default:** `cloudwatch/metric/put/status` 

**Example 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"
  }
}
```

**Example Contoh output: Gagal**  

```
{
  "response" : {
    "namespace": "Greengrass",
    "error": "InvalidInputException",
    "error_message": "cw metric is invalid",
    "status": "fail"
  }
}
```

**catatan**  <a name="connector-component-retryable-error"></a>
Jika komponen mendeteksi kesalahan yang dapat dicoba ulang, seperti kesalahan koneksi, ia akan mencoba ulang publikasi di batch berikutnya.

## Lisensi
<a name="cloudwatch-metrics-component-licenses"></a>

Komponen ini mencakup perangkat lunak/lisensi pihak ketiga berikut:<a name="boto-3-licenses"></a>
+ [AWS SDK untuk Python (Boto3)](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD License, Lisensi Publik Umum (GPL) GNU, Lisensi Dasar Perangkat Lunak Python, Domain Publik
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT License

<a name="component-core-software-license"></a>Komponen ini dirilis menurut [Perjanjian Lisensi Perangkat Lunak Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Berkas log lokal
<a name="cloudwatch-metrics-component-log-file"></a>

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:\$1greengrass\$1v2* 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
<a name="cloudwatch-metrics-component-changelog"></a>

Tabel berikut menjelaskan perubahan dalam setiap versi komponen.

------
#### [ v3.x ]


|  **Versi**  |  **Perubahan**  | 
| --- | --- | 
|  3.2.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 
|  3.1.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 
|  3.0.0  |  <a name="changelog-cloudwatch-metrics-3.0.0-major-version-changes"></a>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](#cloudwatch-metrics-component-configuration). <a name="changelog-cloudwatch-metrics-3.0.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 

------
#### [ 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  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 
|  2.0.8  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/greengrass/v2/developerguide/cloudwatch-metrics-component.html)  | 
|  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
<a name="cloudwatch-metrics-component-see-also"></a>
+ [Menggunakan CloudWatch metrik Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html) di * CloudWatch Panduan Pengguna Amazon*
+ [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)di *Referensi CloudWatch API Amazon*