Pencatatan output tindakan Otomatisasi dengan CloudWatch Logs

Otomatisasi, sebuah kemampuanAWS Systems Manager, berintegrasi dengan Amazon CloudWatch Logs. Anda dapat mengirim output dari tindakan aws:executeScript di runbook Anda ke grup log yang Anda tentukan. Systems Manager tidak membuat grup log atau aliran log apa pun untuk dokumen yang tidak menggunakan tindakan aws:executeScript. Jika dokumen tidak digunakanaws:executeScript, output yang CloudWatch dikirimkan ke tindakan tersebut. Anda dapat menggunakan outputaws:executeScript tindakan yang disimpan di grup CloudWatch log Anda untuk tujuan debugging dan pemecahan masalah. Jika Anda memilih grup log yang dienkripsi, output tindakan aws:executeScript juga dienkripsi. Pencatatan output dari tindakan aws:executeScript adalah pengaturan tingkat akun.

Untuk mengirim output tindakan ke CloudWatch Log untuk runbook milik Amazon, pengguna atau peran yang menjalankan otomatisasi harus memiliki izin untuk operasi berikut:

• logs:CreateLogGroup

• logs:CreateLogStream

• logs:DescribeLogGroups

• logs:DescribeLogStreams

• logs:PutLogEvents

Untuk runbook yang Anda miliki, izin yang sama harus ditambahkan ke peran layanan IAM (atau AssumeRole) yang Anda gunakan untuk menjalankan runbook.

Untuk mengirim output tindakan ke CloudWatch Logs (konsol)

1. Buka konsol AWS Systems Manager pada https://console.aws.amazon.com/systems-manager/.

2. Pada panel navigasi, pilih Otomatisasi.

3. Pilih tab Preferensi, dan kemudian pilih Edit.

4. Pilih kotak centang di samping Mengirim output ke CloudWatch Logs.

5. (Disarankan) Pilih kotak centang di samping Mengenkripsi data log. Dengan pengaktifan pilihan ini, data log dienkripsi menggunakan kunci enkripsi sisi server yang ditentukan untuk grup log. Jika Anda tidak ingin mengenkripsi data log yang dikirimkan ke CloudWatch Logs, kosongkan kotak centang. Kosongkan kotak centang jika enkripsi tidak diizinkan pada grup log.

6. Untuk GrupCloudWatch log, untuk menentukan grup CloudWatch log yang ada di yang merupakan tujuan dari output tindakanAkun AWS yang ingin Anda kirimkan, pilih salah satu hal berikut:

   • Mengirimkan output ke grup log default – Jika grup log default tidak ada (/aws/ssm/automation/executeScript), Otomatisasi membuatnya untuk Anda.

   • Memilih dari daftar grup log – Pilih grup log yang telah dibuat di akun Anda untuk menyimpan output tindakan.

   • Masukkan nama grup log - Masukkan nama grup log di kotak teks yang telah dibuat di akun Anda untuk menyimpan output tindakan.

7. Pilih Save (Simpan).

Untuk mengirim output tindakan ke CloudWatch Logs (baris perintah)

1. Buka alat baris perintah pilihan Anda dan jalankan perintah berikut untuk memperbarui tujuan output tindakan.

   Linux & macOS

   aws ssm update-service-setting \
       --setting-id arn:aws:ssm:region:account-id:servicesetting/ssm/automation/customer-script-log-destination \
       --setting-value CloudWatch

   Windows

   aws ssm update-service-setting ^
       --setting-id arn:aws:ssm:region:account-id:servicesetting/ssm/automation/customer-script-log-destination ^
       --setting-value CloudWatch

   PowerShell

   Update-SSMServiceSetting `
       -SettingId "arn:aws:ssm:region:account-id:servicesetting/ssm/automation/customer-script-log-destination" `
       -SettingValue "CloudWatch"

   Tidak ada output jika perintah berhasil.

2. Jalankan perintah berikut untuk menentukan grup log yang merupakan tujuan dari output tindakan yang ingin Anda kirimkan.

   Linux & macOS

   aws ssm update-service-setting \
       --setting-id arn:aws:ssm:region:account-id:servicesetting/ssm/automation/customer-script-log-group-name \
       --setting-value my-log-group

   Windows

   aws ssm update-service-setting ^
       --setting-id arn:aws:ssm:region:account-id:servicesetting/ssm/automation/customer-script-log-group-name ^
       --setting-value my-log-group

   PowerShell

   Update-SSMServiceSetting `
       -SettingId "arn:aws:ssm:region:account-id:servicesetting/ssm/automation/customer-script-log-group-name" `
       -SettingValue "my-log-group"

   Tidak ada output jika perintah berhasil.

3. Jalankan perintah berikut untuk melihat pengaturan layanan saat ini untuk preferensi pencatatan tindakan Otomatisasi di Akun AWS dan Wilayah AWS saat ini.

   Linux & macOS

   aws ssm get-service-setting \
       --setting-id arn:aws:ssm:region:account-id:servicesetting/ssm/automation/customer-script-log-destination

   Windows

   aws ssm get-service-setting ^
       --setting-id arn:aws:ssm:region:account-id:servicesetting/ssm/automation/customer-script-log-destination

   PowerShell

   Get-SSMServiceSetting `
       -SettingId "arn:aws:ssm:region:account-id:servicesetting/ssm/automation/customer-script-log-destination"

   Perintah tersebut mengembalikan informasi seperti berikut.

   {
       "ServiceSetting": {
           "Status": "Customized",
           "LastModifiedDate": 1613758617.036,
           "SettingId": "/ssm/automation/customer-script-log-destination",
           "LastModifiedUser": "arn:aws:sts::123456789012:assumed-role/Administrator/User_1",
           "SettingValue": "CloudWatch",
           "ARN": "arn:aws:ssm:us-east-2:123456789012:servicesetting/ssm/automation/customer-script-log-destination"
       }
   }