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

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

Menginstal 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 AWS Systems Manager Panduan 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 ini dari jarak jauh. Anda juga dapat menggunakan baris perintah, tetapi hanya untuk memeriksa server on-premise.

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

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

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

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:

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

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 memulai ulang agen, ikuti petunjuk di (Opsional) Ubah konfigurasi umum dan profil bernama untuk CloudWatch agen.