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

# Monitor dengan Amazon CloudWatch Logs
<a name="monitor-cloudwatch-logs"></a>

Konfigurasikan AWS IoT SiteWise untuk mencatat informasi ke CloudWatch Log untuk memantau dan memecahkan masalah layanan.

Saat Anda menggunakan AWS IoT SiteWise konsol, AWS IoT SiteWise buat peran terkait layanan yang memungkinkan layanan mencatat informasi atas nama Anda. Jika Anda tidak menggunakan AWS IoT SiteWise konsol, Anda harus membuat peran terkait layanan secara manual untuk menerima log. Untuk informasi selengkapnya, lihat [Membuat peran terkait layanan untuk AWS IoT SiteWise](create-service-linked-role.md).

Anda harus memiliki kebijakan sumber daya yang memungkinkan AWS IoT SiteWise untuk menempatkan peristiwa log ke CloudWatch aliran. Untuk membuat dan memperbarui kebijakan sumber daya untuk CloudWatch Log, jalankan perintah berikut. Ganti *logging-policy-name* dengan nama kebijakan yang akan dibuat.

```
aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\" } ] }"
```

CloudWatch Log juga mendukung kunci konteks SourceAccount kondisi [aws: SourceArn](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn) [dan aws:](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-ke-sourceaccount). Kunci konteks kondisi ini bersifat opsional.

Untuk membuat atau memperbarui kebijakan sumber daya yang memungkinkan AWS IoT SiteWise untuk hanya menempatkan log yang terkait dengan AWS IoT SiteWise sumber daya tertentu ke dalam CloudWatch aliran, jalankan perintah dan lakukan hal berikut:
+ Ganti *logging-policy-name* dengan nama kebijakan yang akan dibuat.
+ Ganti *source-ARN* dengan ARN AWS IoT SiteWise sumber daya Anda, seperti model aset atau aset. Untuk menemukan ARN untuk setiap jenis sumber daya, lihat Jenis AWS IoT SiteWise sumber daya yang [ditentukan oleh AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-resources-for-iam-policies) dalam Referensi *Otorisasi Layanan*.
+ Ganti *account-ID* dengan ID AWS akun yang terkait dengan AWS IoT SiteWise sumber daya yang ditentukan.

```
aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\", \"Condition\":{\"StringLike\":{\"aws:SourceArn\":[\"source-ARN\"],\"aws:SourceAccount\":[\"account-ID\"]}}}]}"
```

Secara default, AWS IoT SiteWise tidak mencatat informasi ke CloudWatch Log. Untuk mengaktifkan logging, pilih level logging selain **Disabled** (`OFF`). AWS IoT SiteWise mendukung tingkat logging berikut:
+ `OFF`— Logging dimatikan.
+ `ERROR`— Kesalahan dicatat.
+ `INFO`— Kesalahan dan pesan informasi dicatat.

Anda dapat mengonfigurasi gateway SiteWise Edge untuk mencatat informasi ke CloudWatch Log melalui. AWS IoT Greengrass Untuk informasi selengkapnya, lihat [Pantau log gateway SiteWise Edge](monitor-gateway-logs.md).

Anda juga dapat mengonfigurasi AWS IoT Core untuk mencatat informasi ke CloudWatch Log jika Anda memecahkan masalah tindakan AWS IoT SiteWise aturan. Untuk informasi selengkapnya, lihat [Memecahkan masalah tindakan aturan AWS IoT SiteWise](troubleshoot-rule.md).

**Contents**
+ [Mengelola masuk AWS IoT SiteWise](#manage-cloudwatch-logs)
  + [Temukan tingkat pencatatan Anda](#find-logging-level)
  + [Ubah level logging Anda](#change-logging-level)
+ [Contoh: entri file AWS IoT SiteWise log](#sitewise-log-format)

## Mengelola masuk AWS IoT SiteWise
<a name="manage-cloudwatch-logs"></a>

Gunakan AWS IoT SiteWise konsol atau AWS CLI untuk tugas konfigurasi logging berikut.

### Temukan tingkat pencatatan Anda
<a name="find-logging-level"></a>

------
#### [ Console ]

Gunakan prosedur berikut untuk menemukan level logging Anda saat ini di AWS IoT SiteWise konsol.

**Untuk menemukan level AWS IoT SiteWise logging Anda saat ini**

1. <a name="sitewise-open-console"></a>Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.

1. Di panel navigasi kiri, pilih **Opsi Pencatatan**.

   Status logging saat ini muncul di bawah **status Logging**. Jika logging diaktifkan, level logging saat ini muncul di bawah **Level verbositas**.

------
#### [ AWS CLI ]

Jalankan perintah berikut untuk menemukan level AWS IoT SiteWise logging Anda saat ini dengan file AWS CLI.

```
aws iotsitewise describe-logging-options
```

Operasi mengembalikan respons yang berisi tingkat logging Anda dalam format berikut.

```
{
  "loggingOptions": {
    "level": "String"
  }
}
```

------

### Ubah level logging Anda
<a name="change-logging-level"></a>

Gunakan prosedur berikut untuk mengubah level logging Anda di AWS IoT SiteWise konsol atau menggunakan AWS CLI.

------
#### [ Console ]

**Untuk mengubah level AWS IoT SiteWise logging Anda**

1. <a name="sitewise-open-console"></a>Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.

1. Di panel navigasi kiri, pilih **Opsi Pencatatan**.

1. Pilih **Edit**.

1. Pilih **Level verbositas untuk diaktifkan**.

1. Pilih **Simpan**.

------
#### [ AWS CLI ]

Jalankan AWS CLI perintah berikut untuk mengubah level AWS IoT SiteWise logging Anda. Ganti *logging-level* dengan level logging yang Anda inginkan.

```
aws iotsitewise put-logging-options --logging-options level=logging-level
```

------

## Contoh: entri file AWS IoT SiteWise log
<a name="sitewise-log-format"></a>

Setiap entri AWS IoT SiteWise log mencakup informasi peristiwa dan sumber daya yang relevan untuk acara tersebut, sehingga Anda dapat memahami dan menganalisis data log.

Contoh berikut menunjukkan entri CloudWatch AWS IoT SiteWise Log yang mencatat saat Anda berhasil membuat model aset.

```
{
  "eventTime": "2020-05-05T00:10:22.902Z",
  "logLevel": "INFO",
  "eventType": "AssetModelCreationSuccess",
  "message": "Successfully created asset model.",
  "resources": {
    "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
  }
}
```