Monitor dengan Amazon CloudWatch Logs

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.

Anda harus memiliki kebijakan sumber daya yang memungkinkan AWS IoT SiteWise untuk menempatkan peristiwa log ke dalam 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 dan aws:. 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 AWS IoT SiteWise sumber daya Anda, seperti model aset atau aset. ARN Untuk menemukan ARN untuk setiap jenis AWS IoT SiteWise sumber daya, lihat Jenis sumber daya yang ditentukan oleh AWS IoT SiteWise 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.

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.

Daftar Isi

• Mengelola masuk AWS IoT SiteWise
  • Temukan tingkat pencatatan Anda
  • Ubah level logging Anda
• Contoh: entri file AWS IoT SiteWise log

Mengelola masuk AWS IoT SiteWise

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

Temukan tingkat pencatatan Anda

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. Navigasikan ke konsol AWS IoT SiteWise tersebut.

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

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

1. Navigasikan ke konsol AWS IoT SiteWise tersebut.

2. Di panel navigasi kiri, pilih Opsi Pencatatan.

3. Pilih Edit.

4. Pilih Level verbositas untuk diaktifkan.

5. Pilih Simpan.

AWS CLI

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

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

Contoh: entri file AWS IoT SiteWise log

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"
  }
}