Memecahkan masalah agen CloudWatch

Anda dapat menggunakan informasi di bagian ini untuk memecahkan masalah yang mungkin Anda temui dengan agen. CloudWatch

CloudWatch parameter baris perintah agen

Untuk melihat daftar lengkap parameter yang didukung oleh CloudWatch agen, masukkan yang berikut ini di baris perintah di komputer tempat Anda menginstalnya:

amazon-cloudwatch-agent-ctl -help

Instal CloudWatch agen menggunakan Run Command gagal

Untuk menginstal CloudWatch agen menggunakan Systems Manager Run Command, SSM Agen pada server target harus versi 2.2.93.0 atau yang lebih baru dari agen Agen. SSM Jika SSM Agen Anda bukan versi yang benar, Anda mungkin melihat kesalahan yang menyertakan pesan berikut:

no latest version found for package AmazonCloudWatchAgent on platform linux

failed to download installation package reliably

Untuk informasi tentang memperbarui versi SSM Agen, lihat Menginstal dan Mengonfigurasi SSM Agen di Panduan AWS Systems Manager Pengguna.

CloudWatch Agen tidak akan memulai

Jika CloudWatch agen gagal memulai, mungkin ada masalah dalam konfigurasi Anda. Informasi konfigurasi masuk configuration-validation.log file Anda. File ini berada di /opt/aws/amazon-cloudwatch-agent/logs/configuration-validation.log di server Linux dan di $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\configuration-validation.log pada server yang menjalankan Server Windows.

Verifikasi bahwa CloudWatch agen sedang berjalan

Anda dapat menanyakan CloudWatch agen untuk mengetahui apakah itu berjalan atau berhenti. Anda dapat menggunakan AWS Systems Manager untuk melakukan hal ini dari jarak jauh. Anda juga dapat menggunakan baris perintah, tetapi hanya untuk memeriksa server on-premise.

Untuk menanyakan status CloudWatch agen menggunakan Run Command

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

2. Pada panel navigasi, silakan pilih Perintah Eksekusi.

   -atau-

   Jika AWS Systems Manager halaman beranda terbuka, gulir ke bawah dan pilih Jelajahi Jalankan Perintah.

3. Pilih Jalankan perintah.

4. Dalam daftar dokumen Perintah, pilih tombol di sebelah AmazonCloudWatch- ManageAgent.

5. Di Action pilih, status.

6. Untuk Sumber Konfigurasi Opsional pilih default dan menjaga Lokasi Konfigurasi Opsional kosong.

7. Pada Target area, pilih instans untuk memeriksa.

8. Pilih Jalankan.

Jika agen sedang berjalan, output menyerupai yang berikut.

{
       "status": "running",
       "starttime": "2017-12-12T18:41:18",
       "version": "1.73.4"
}

Jika agen dihentikan, "status" bidang menampilkan "stopped".

Untuk menanyakan status CloudWatch agen secara lokal menggunakan baris perintah

• Pada server Linux, masukkan hal berikut:

  sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -m ec2 -a status

  Di server yang menjalankan Windows Server, masukkan yang berikut ini PowerShell sebagai administrator:

  & $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a status

CloudWatch Agen tidak akan memulai, dan kesalahan menyebutkan Wilayah Amazon EC2

Jika agen tidak memulai dan pesan kesalahan menyebutkan titik akhir EC2 Wilayah Amazon, Anda mungkin telah mengonfigurasi agen agar memerlukan akses ke EC2 titik akhir Amazon tanpa memberikan akses tersebut.

Misalnya, jika Anda menentukan nilai untuk append_dimensions parameter dalam file konfigurasi agen yang bergantung pada EC2 metadata Amazon dan Anda menggunakan proxy, Anda harus memastikan bahwa server dapat mengakses titik akhir untuk Amazon. EC2 Untuk informasi selengkapnya tentang titik akhir ini, lihat Amazon Elastic Compute Cloud EC2 (Amazon) di. Referensi Umum Amazon Web Services

CloudWatch Agen tidak akan memulai di Windows Server

Di Windows Server, Anda mungkin melihat kesalahan berikut:

Start-Service : Service 'Amazon CloudWatch Agent (AmazonCloudWatchAgent)' cannot be started due to the following
error: Cannot start service AmazonCloudWatchAgent on computer '.'.
At C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1:113 char:12
+     $svc | Start-Service
+            ~~~~~~~~~~~~~
    + CategoryInfo          : OpenError: (System.ServiceProcess.ServiceController:ServiceController) [Start-Service],
   ServiceCommandException
    + FullyQualifiedErrorId : CouldNotStartService,Microsoft.PowerShell.Commands.StartServiceCommand

Untuk memperbaiki hal ini, pastikan bahwa layanan server berjalan. Kesalahan ini dapat terlihat jika agen mencoba memulai saat layanan server tidak sedang berjalan.

Jika layanan server sudah berjalan, hal berikut mungkin menjadi masalah. Pada beberapa instalasi Windows Server, CloudWatch agen membutuhkan waktu lebih dari 30 detik untuk memulai. Karena Windows Server secara default hanya memungkinkan 30 detik untuk memulai layanan, hal ini menyebabkan agen gagal dengan kesalahan yang serupa dengan yang berikut:

Untuk mengatasi masalah ini, tingkatkan nilai waktu layanan. Untuk informasi selengkapnya, silakan lihat Layanan tidak dimulai, dan peristiwa 7000 dan 7011 dimasukkan ke dalam log peristiwa Windows.

Di Mana Metriknya?

Jika CloudWatch agen telah berjalan tetapi Anda tidak dapat menemukan metrik yang dikumpulkan olehnya di AWS Management Console atau di AWS CLI, konfirmasikan bahwa Anda menggunakan namespace yang benar. Secara bawaan, bidang nama untuk metrik yang dikumpulkan oleh agen adalah CWAgent. Anda dapat menyesuaikan namespace ini menggunakan bidang namespace di bagian metrics file konfigurasi agen. Jika Anda tidak melihat metrik yang diharapkan, periksa file konfigurasi untuk mengonfirmasi ruangnama yang sedang digunakan.

Saat pertama kali mengunduh paket CloudWatch agen, file konfigurasi agen adalahamazon-cloudwatch-agent.json. File ini berada di direktori tempat Anda menjalankan pemandu konfigurasi, atau Anda mungkin telah memindahkannya ke direktori lain. Jika Anda menggunakan pemandu konfigurasi, output file konfigurasi agen dari pemandu bernama config.json. Untuk informasi selengkapnya tentang file konfigurasi, termasuk bidang namespace, silakan lihat CloudWatch file konfigurasi agen: Bagian metrik.

CloudWatch Agen membutuhkan waktu lama untuk berjalan dalam wadah atau mencatat kesalahan batas hop

Saat menjalankan CloudWatch agen sebagai layanan kontainer dan ingin menambahkan dimensi EC2 metrik Amazon ke semua metrik yang dikumpulkan oleh agen, Anda mungkin melihat kesalahan berikut di versi v1.247354.0 agen:

2022-06-07T03:36:11Z E! [processors.ec2tagger] ec2tagger: Unable to retrieve Instance Metadata Tags. This plugin must only be used on an EC2 instance.
2022-06-07T03:36:11Z E! [processors.ec2tagger] ec2tagger: Please increase hop limit to 2 by following this document https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html#configuring-IMDS-existing-instances.
2022-06-07T03:36:11Z E! [telegraf] Error running agent: could not initialize processor ec2tagger: EC2MetadataRequestError: failed to get EC2 instance identity document
caused by: EC2MetadataError: failed to make EC2Metadata request
        status code: 401, request id: 
caused by:

Anda mungkin melihat kesalahan ini jika agen mencoba mendapatkan metadata dari IMDSv2 dalam wadah tanpa batas hop yang sesuai. Dalam versi agen lebih awal dari v1.247354.0, Anda dapat mengalami masalah ini tanpa melihat pesan log.

Untuk mengatasi ini, tingkatkan batas hop menjadi 2 dengan mengikuti instruksi di Konfigurasikan opsi metadata instans.

Saya memperbarui konfigurasi agen saya tetapi tidak melihat metrik atau log baru di konsol CloudWatch

Jika Anda memperbarui file konfigurasi CloudWatch agen Anda, saat berikutnya Anda memulai agen, Anda perlu menggunakan fetch-config opsi. Sebagai contoh, jika Anda menyimpan file yang diperbarui di komputer lokal, masukkan perintah berikut:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -s -m ec2 -c file:configuration-file-path

CloudWatch file dan lokasi agen

Tabel berikut mencantumkan file yang diinstal oleh dan digunakan dengan CloudWatch agen, bersama dengan lokasi mereka di server yang menjalankan Linux atau Windows Server.

File	Lokasi Linux	Lokasi Server Windows
Naskah kendali yang mengendalikan mulai, menghentikan, dan memulai ulang agen.	/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl atau /usr/bin/amazon-cloudwatch-agent-ctl	$Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1
File log tempat agen menulis. Anda mungkin perlu melampirkan ini saat menghubungi AWS Support.	/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log atau /var/log/amazon/amazon-cloudwatch-agent/amazon-cloudwatch-agent.log	$Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\amazon-cloudwatch-agent.log
File validasi konfigurasi agen.	/opt/aws/amazon-cloudwatch-agent/logs/configuration-validation.log atau /var/log/amazon/amazon-cloudwatch-agent/configuration-validation.log	$Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\configuration-validation.log
JSONFile yang digunakan untuk mengkonfigurasi agen segera setelah wizard membuatnya. Untuk informasi selengkapnya, lihat Buat file konfigurasi CloudWatch agen.	/opt/aws/amazon-cloudwatch-agent/bin/config.json	$Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\config.json
JSONFile yang digunakan untuk mengkonfigurasi agen jika file konfigurasi ini telah diunduh dari Parameter Store.	/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json atau /etc/amazon/amazon-cloudwatch-agent/amazon-cloudwatch-agent.json	$Env:ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json
TOMLFile yang digunakan untuk menentukan Wilayah dan informasi kredensi yang akan digunakan oleh agen, mengesampingkan default sistem.	/opt/aws/amazon-cloudwatch-agent/etc/common-config.toml atau /etc/amazon/amazon-cloudwatch-agent/common-config.toml	$Env:ProgramData\Amazon\AmazonCloudWatchAgent\common-config.toml
TOMLFile yang berisi konten yang dikonversi dari file JSON konfigurasi. Script amazon-cloudwatch-agent-ctl menghasilkan file ini. Pengguna tidak boleh langsung memodifikasi file ini. Ini dapat berguna untuk memverifikasi bahwa JSON TOML terjemahan berhasil.	/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.toml atau /etc/amazon/amazon-cloudwatch-agent/amazon-cloudwatch-agent.toml	$Env:ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.toml
YAMLFile yang berisi konten yang dikonversi dari file JSON konfigurasi. Script amazon-cloudwatch-agent-ctl menghasilkan file ini. Anda tidak boleh langsung memodifikasi file ini. File ini dapat berguna untuk memverifikasi bahwa YAML terjemahan JSON to berhasil.	/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.yaml or /etc/amazon/amazon-cloudwatch-agent/amazon-cloudwatch-agent.yaml	$Env:ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.yaml

Menemukan informasi tentang versi CloudWatch agen

Untuk menemukan nomor versi CloudWatch agen di server Linux, masukkan perintah berikut:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a status

Untuk menemukan nomor versi CloudWatch agen di Windows Server, masukkan perintah berikut:

& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a status

catatan

Menggunakan perintah ini adalah cara yang benar untuk menemukan versi CloudWatch agen. Jika Anda menggunakan Program dan Fitur di Panel Kendali, Anda akan melihat nomor versi yang salah.

Anda juga dapat mengunduh README file tentang perubahan terbaru pada agen, dan file yang menunjukkan nomor versi yang saat ini tersedia untuk diunduh. File-file ini ada di lokasi-lokasi berikut ini:

• https://amazoncloudwatch-agent.s3.amazonaws.com/info/latest/RELEASE_NOTES atau https://amazoncloudwatch-agent-region.s3.region.amazonaws.com/info/latest/RELEASE_NOTES

• https://amazoncloudwatch-agent.s3.amazonaws.com/info/latest/CWAGENT_VERSION atau https://amazoncloudwatch-agent-region.s3.region.amazonaws.com/info/latest/CWAGENT_VERSION

Log yang dihasilkan oleh CloudWatch agen

Agen membuat log ketika sedang bekerja. Log ini mencakup informasi pemecahan masalah. Log ini adalah file amazon-cloudwatch-agent.log Anda. File ini berada di /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log di server Linux dan di $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\amazon-cloudwatch-agent.log pada server yang menjalankan Server Windows.

Anda dapat mengonfigurasi agen untuk mencatat log detail tambahan dalam file amazon-cloudwatch-agent.log. Dalam file konfigurasi agen, di agent bagian, atur debug bidang ketrue, lalu konfigurasikan ulang dan restart CloudWatch agen. Untuk menonaktifkan logging informasi tambahan ini, tetapkan bidang debug ke bidang false. Kemudian, konfigurasikan ulang dan restart agen. Untuk informasi selengkapnya, lihat Buat atau edit file konfigurasi CloudWatch agen secara manual.

Di versi 1.247350.0 dan CloudWatch agen yang lebih baru, Anda dapat secara opsional mengatur aws_sdk_log_level bidang di agent bagian file konfigurasi agen ke satu atau beberapa opsi berikut. Pisahkan beberapa opsi dengan karakter |.

• LogDebug

• LogDebugWithSigning

• LogDebugWithHTTPBody

• LogDebugRequestRetries

• LogDebugWithEventStreamBody

Untuk informasi selengkapnya tentang opsi ini, lihat LogLevelType.

Menghentikan dan memulai kembali agen CloudWatch

Anda dapat menghentikan CloudWatch agen secara manual menggunakan salah satu AWS Systems Manager atau baris perintah.

Untuk menghentikan CloudWatch agen menggunakan Run Command

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

2. Pada panel navigasi, silakan pilih Perintah Eksekusi.

   -atau-

   Jika AWS Systems Manager halaman beranda terbuka, gulir ke bawah dan pilih Jelajahi Jalankan Perintah.

3. Pilih Jalankan perintah.

4. Dalam daftar dokumen Command, pilih AmazonCloudWatch- ManageAgent.

5. Di area Target, pilih instance tempat Anda menginstal CloudWatch agen.

6. Di daftar Tindakan, pilih berhenti.

7. Tetap kosongkan Sumber Konfigurasi Opsional dan Lokasi Konfigurasi Opsional.

8. Pilih Jalankan.

Untuk menghentikan CloudWatch agen secara lokal menggunakan baris perintah

• Pada server Linux, masukkan hal berikut:

  sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -m ec2 -a stop

  Di server yang menjalankan Windows Server, masukkan yang berikut ini PowerShell sebagai administrator:

  & $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a stop

Untuk memulai ulang agen, ikuti petunjuk di (Opsional) Ubah konfigurasi umum dan profil bernama untuk CloudWatch agen.