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 Saat menghadapi masalah dengan CloudWatch agen, Anda dapat menggunakan runbook `AWSSupport-TroubleshootCloudWatchAgent` otomatisasi. Alat AWS pemecahan masalah dapat: + Verifikasi izin IAM dan profil instans + Periksa status agen dan analisis log + Uji konektivitas titik akhir + Secara otomatis mengumpulkan dan mengunggah log yang relevan ke Amazon S3 Untuk informasi rinci tentang alat AWS pemecahan masalah, lihat [Support Automation Workflow (SAW) Runbook](https://repost.aws/articles/ARDFhNRgSMRcahrIbGJaIC4g/support-automation-workflow-saw-runbook-troubleshoot-amazon-cloudwatch-agent) - Agen pemecahan masalah. CloudWatch **Topics** + [CloudWatch parameter baris perintah agen](#CloudWatch-Agent-options-help) + [Instal CloudWatch agen menggunakan Run Command gagal](#CloudWatch-Agent-installation-fails) + [CloudWatch Agen tidak akan memulai](#CloudWatch-Agent-troubleshooting-cannot-start) + [Verifikasi bahwa CloudWatch agen sedang berjalan](#CloudWatch-Agent-troubleshooting-verify-running) + [CloudWatch Agen tidak akan memulai, dan kesalahan menyebutkan Wilayah Amazon EC2](#CloudWatch-Agent-troubleshooting-EC2-region) + [CloudWatch Agen tidak akan memulai di Windows Server](#CloudWatch-Agent-troubleshooting-Windows-start) + [Di Mana Metriknya?](#CloudWatch-Agent-troubleshooting-no-metrics) + [CloudWatch Agen membutuhkan waktu lama untuk berjalan dalam wadah atau mencatat kesalahan batas hop](#CloudWatch-Agent-container-slow) + [Saya memperbarui konfigurasi agen saya tetapi tidak melihat metrik atau log baru di konsol CloudWatch](#CloudWatch-Agent-troubleshooting-update-no-new-metrics) + [CloudWatch file dan lokasi agen](#CloudWatch-Agent-files-and-locations) + [Menemukan informasi tentang versi CloudWatch agen](#CloudWatch-Agent-troubleshooting-agent-version) + [Log yang dihasilkan oleh CloudWatch agen](#CloudWatch-Agent-troubleshooting-loginfo) + [Menghentikan dan memulai kembali agen CloudWatch](#CloudWatch-Agent-troubleshooting-stopping-restarting) ## 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, Agen SSM pada server target harus versi 2.2.93.0 atau yang lebih baru dari agen Agen SSM. Jika Agen SSM Anda bukan versi yang tepat, Anda mungkin melihat kesalahan yang mencakup pesan berikut: ``` no latest version found for package AmazonCloudWatchAgent on platform linux ``` ``` failed to download installation package reliably ``` Untuk informasi tentang cara memperbarui versi Agen SSM Anda, silakan lihat [Menginstal dan Mengonfigurasi Agen SSM](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent.html) di *Panduan Pengguna AWS Systems Manager *. ## 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/](https://console.aws.amazon.com/systems-manager/). 1. Pada panel navigasi, silakan pilih **Perintah Eksekusi**. -atau- Jika AWS Systems Manager halaman beranda terbuka, gulir ke bawah dan pilih **Jelajahi Jalankan Perintah**. 1. Pilih **Jalankan perintah**. 1. Dalam daftar **dokumen Command**, pilih tombol di sebelah **AmazonCloudWatch- ManageAgent**. 1. Di **Action** pilih, **status**. 1. Untuk **Sumber Konfigurasi Opsional** pilih **default** dan menjaga **Lokasi Konfigurasi Opsional** kosong. 1. Pada **Target** area, pilih instans untuk memeriksa. 1. 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 Amazon EC2 Region, Anda mungkin telah mengonfigurasi agen untuk memerlukan akses ke titik akhir Amazon EC2 tanpa memberikan akses tersebut. Sebagai contoh, jika Anda menentukan nilai untuk `append_dimensions` parameter dalam file konfigurasi agen yang bergantung pada metadata EC2 Amazon dan Anda menggunakan proksi, Anda harus memastikan bahwa server dapat mengakses titik akhir untuk Amazon EC2. Untuk informasi selengkapnya tentang titik akhir ini, silakan lihat [Amazon Elastic Compute Cloud (Amazon EC2)](https://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region) 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](https://support.microsoft.com/en-us/help/922918/a-service-does-not-start-and-events-7000-and-7011-are-logged-in-window). ## Di Mana Metriknya? Jika CloudWatch agen telah berjalan tetapi Anda tidak dapat menemukan metrik yang dikumpulkan olehnya di Konsol Manajemen AWS 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 adalah`amazon-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-Agent-Configuration-File-Details.md#CloudWatch-Agent-Configuration-File-Metricssection). ## CloudWatch Agen membutuhkan waktu lama untuk berjalan dalam wadah atau mencatat kesalahan batas hop Saat menjalankan CloudWatch agen sebagai layanan penampung dan ingin menambahkan dimensi metrik Amazon EC2 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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html#configuring-IMDS-existing-instances.). ## 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 Dukungan. | `/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` | | File JSON yang digunakan untuk mengonfigurasi agen segera setelah pemandu membuatnya. Untuk informasi selengkapnya, lihat [Buat file konfigurasi CloudWatch agen](create-cloudwatch-agent-configuration-file.md). | `/opt/aws/amazon-cloudwatch-agent/bin/config.json` | `$Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\config.json` | | File JSON yang digunakan untuk mengonfigurasi 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` | | File TOML digunakan untuk menentukan informasi Wilayah dan informasi kredensial yang akan digunakan oleh agen, yang kemudian membatalkan sistem default. | `/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` | | File TOMM yang berisi konten yang dikonversi dari file konfigurasi JSON. Script `amazon-cloudwatch-agent-ctl` menghasilkan file ini. Pengguna tidak boleh langsung memodifikasi file ini. Ini dapat berguna untuk memverifikasi bahwa terjemahan JSON ke TOLL 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` | | File YAMM yang berisi konten yang dikonversi dari file konfigurasi JSON. Script `amazon-cloudwatch-agent-ctl` menghasilkan file ini. Anda tidak boleh langsung memodifikasi file ini. File ini dapat berguna untuk memverifikasi bahwa terjemahan JSON ke YAMAL 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 file README tentang perubahan terbaru ke 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-{{us-east-1}}.s3.{{us-east-1}}.amazonaws.com/info/latest/RELEASE_NOTES` + `https://amazoncloudwatch-agent.s3.amazonaws.com/info/latest/CWAGENT_VERSION` atau `https://amazoncloudwatch-agent-{{us-east-1}}.s3.{{us-east-1}}.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 ke`true`, 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](CloudWatch-Agent-Configuration-File-Details.md). 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](https://docs.aws.amazon.com/sdk-for-go/api/aws/#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/](https://console.aws.amazon.com/systems-manager/). 1. Pada panel navigasi, silakan pilih **Perintah Eksekusi**. -atau- Jika AWS Systems Manager halaman beranda terbuka, gulir ke bawah dan pilih **Jelajahi Jalankan Perintah**. 1. Pilih **Jalankan perintah**. 1. Dalam daftar **dokumen Command**, pilih **AmazonCloudWatch- ManageAgent**. 1. Di area **Target**, pilih instance tempat Anda menginstal CloudWatch agen. 1. Di daftar **Tindakan**, pilih **berhenti**. 1. Tetap kosongkan **Sumber Konfigurasi Opsional** dan **Lokasi Konfigurasi Opsional**. 1. 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](installing-cloudwatch-agent-ssm.md#CloudWatch-Agent-profile-instance-fleet).