• AWS Systems Manager CloudWatch Dasbor tidak akan lagi tersedia setelah 30 April 2026. Pelanggan dapat terus menggunakan CloudWatch konsol Amazon untuk melihat, membuat, dan mengelola dasbor Amazon CloudWatch mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat dokumentasi CloudWatch Dasbor [ Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pemecahan Masalah SSM Agent
Jika Anda mengalami masalah dalam menjalankan operasi pada node terkelola, mungkin ada masalah dengan AWS Systems Manager Agent (SSM Agent). Gunakan informasi berikut untuk membantu Anda melihat file SSM Agent log dan memecahkan masalah agen. Jika agen Anda tampaknya tidak responsif atau memiliki frekuensi komunikasi yang berkurang, lihat[Memahami SSM Agent hibernasi](ssm-agent-technical-details.md#ssm-agent-hibernation).
**Topics**
+ [SSM Agent sudah ketinggalan zaman](#ssm-agent-out-of-date)
+ [Memecahkan masalah menggunakan SSM Agent berkas log](#systems-manager-ssm-agent-log-files)
+ [File log agen tidak berputar (Windows)](#systems-manager-ssm-agent-troubleshooting-log-rotation)
+ [Tidak dapat terhubung ke titik akhir SSM](#systems-manager-ssm-agent-troubleshooting-endpoint-access)
+ [Verifikasi konfigurasi VPC Anda](#agent-ts-vpc-configuration)
+ [Verifikasi atribut VPC DNS-related Anda](#agent-ts-dns-attributes)
+ [Verifikasi aturan masuk pada grup keamanan titik akhir](#agent-ts-ingress-egress-rules)
+ [Gunakan `ssm-cli` untuk memecahkan masalah ketersediaan node terkelola](#agent-ts-ssm-cli)
## SSM Agent sudah ketinggalan zaman
Versi terbaru dirilis setiap kali alat baru ditambahkan ke Manajer Sistem atau pembaruan dibuat untuk alat yang ada. SSM Agent Gagal menggunakan versi terbaru dari agen dapat mencegah node terkelola Anda menggunakan berbagai alat dan fitur Manajer Sistem. Untuk alasan itu, kami menyarankan Anda mengotomatiskan proses untuk tetap SSM Agent up to date pada mesin Anda. Untuk informasi, lihat [Mengotomatiskan pembaruan ke SSM Agent](ssm-agent-automatic-updates.md). Berlangganan ke [SSM Agent](https://github.com/aws/amazon-ssm-agent/blob/mainline/RELEASENOTES.md) halaman Catatan Rilis GitHub untuk mendapatkan pemberitahuan tentang SSM Agent pembaruan.
## Memecahkan masalah menggunakan SSM Agent berkas log
SSM Agentmencatat informasi dalam file-file berikut. Informasi dalam file ini juga dapat membantu Anda memecahkan masalah. Untuk informasi selengkapnya tentang file SSM Agent log, termasuk cara mengaktifkan pencatatan debug, lihat[Melihat SSM Agent log](ssm-agent-logs.md).
**catatan**
Jika Anda memilih untuk melihat log ini menggunakan Windows File Explorer, pastikan untuk mengizinkan tampilan file tersembunyi dan file sistem dalam Opsi Folder.
**Di Windows**
+ `%PROGRAMDATA%\Amazon\SSM\Logs\amazon-ssm-agent.log`
+ `%PROGRAMDATA%\Amazon\SSM\Logs\errors.log`
**Di Linux dan macOS**
+ `/var/log/amazon/ssm/amazon-ssm-agent.log`
+ `/var/log/amazon/ssm/errors.log`
Untuk node yang dikelola Linux, Anda mungkin menemukan informasi lebih lanjut dalam `messages` file yang ditulis ke direktori berikut:`/var/log`.
Untuk informasi tambahan tentang pemecahan masalah menggunakan log agen, lihat [ Bagaimana cara menggunakan SSM Agent log untuk memecahkan masalah dengan SSM Agent instans terkelola saya? ](https://repost.aws/knowledge-center/ssm-agent-logs)di *AWS Pusat Pengetahuan RE: Post. *
## File log agen tidak berputar (Windows)
Jika Anda menentukan rotasi file log berbasis tanggal dalam file seelog.xml (pada node ter Windows Server kelola) dan log tidak berputar, tentukan `fullname=true` parameternya. Berikut adalah contoh dari file konfigurasi seelog.xml dengan parameter `fullname=true` yang ditentukan.
```
```
## Tidak dapat terhubung ke titik akhir SSM
SSM Agentharus mengizinkan lalu lintas keluar HTTPS (port 443) ke titik akhir berikut:
+ `ssm.{{region}}.amazonaws.com`
+ `ssmmessages.{{region}}.amazonaws.com`
{{region}}mewakili pengidentifikasi untuk yang Wilayah AWS didukung oleh AWS Systems Manager, seperti `us-east-2` untuk Wilayah AS Timur (Ohio). Untuk daftar {{region}} nilai yang didukung, lihat ** kolom Wil ** ayah di titik akhir layanan Manajer [ Sistem ](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region) di *Referensi Umum Amazon Web Services*.
**catatan**
Sebelum 2024, `ec2messages.{{region}}.amazonaws.com` juga diperlukan. Untuk Wilayah AWS diluncurkan sebelum 2024, mengizinkan lalu lintas `ssmmessages.{{region}}.amazonaws.com` masih diperlukan tetapi opsional untuk`ec2messages.{{region}}.amazonaws.com`.
Untuk Wilayah yang diluncurkan pada tahun 2024 dan yang lebih baru, memungkinkan lalu lintas `ssmmessages.{{region}}.amazonaws.com` diperlukan, `ec2messages.{{region}}.amazonaws.com` tetapi titik akhir tidak didukung untuk Wilayah ini.
SSM Agenttidak akan berfungsi jika tidak dapat berkomunikasi dengan titik akhir sebelumnya, seperti yang dijelaskan, bahkan jika Anda menggunakan AWS disediakan Amazon Machine Images (AMIs) seperti Amazon Linux 2 atau Amazon Linux 2023. Konfigurasi jaringan Anda harus memiliki akses internet terbuka atau Anda harus memiliki titik akhir virtual private cloud (VPC) khusus yang dikonfigurasi. Jika Anda tidak berencana untuk membuat VPC endpoint khusus, periksa gateway internet atau gateway NAT Anda. Untuk informasi lebih lanjut tentang cara mengelola VPC endpoint, lihat [Meningkatkan keamanan instans EC2 dengan menggunakan titik akhir VPC untuk Manajer Sistem](setup-create-vpc.md).
## Verifikasi konfigurasi VPC Anda
Jika Anda menggunakan cloud pribadi virtual (VPC), untuk mengelola instans EC2 dengan Manajer Sistem, titik akhir VPC Anda harus dikonfigurasi dengan benar untuk`ssm.{{region}}.amazonaws.com`,`ssmmessages.{{region}}.amazonaws.com`, dan dalam beberapa kasus dijelaskan sebelumnya dalam topik ini di,. [Tidak dapat terhubung ke titik akhir SSM](#systems-manager-ssm-agent-troubleshooting-endpoint-access) `ec2messages.{{region}}.amazonaws.com`
**catatan**
Alternatif untuk menggunakan VPC endpoint adalah untuk memungkinkan akses internet luar pada instans terkelola Anda. Dalam kasus ini, instans terkelola juga harus mengizinkan lalu lintas keluar HTTPS (port 443) ke titik akhir berikut:
`ssm.{{region}}.amazonaws.com`
`ssmmessages.{{region}}.amazonaws.com`
`ec2messages.{{region}}.amazonaws.com`
SSM Agentmemulai semua koneksi ke layanan Manajer Sistem di cloud. Untuk alasan ini, Anda tidak perlu mengonfigurasi firewall Anda untuk mengizinkan lalu lintas masuk ke instans Anda untuk Systems Manager.
Untuk informasi lebih lanjut tentang panggilan ke titik akhir ini, lihat [Referensi: ec2messages, ssmmessages, dan operasi API lainnya](systems-manager-setting-up-messageAPIs.md).
Untuk memecahkan masalah dengan titik akhir VPC Anda, lakukan hal berikut:
+ Pastikan bahwa titik akhir VPC disertakan pada tingkat VPC. Jika titik akhir VPC dengan nama layanan tertentu tidak ditemukan di VPC, verifikasi terlebih dahulu bahwa dukungan DNS diaktifkan di tingkat VPC. Selanjutnya, buat titik akhir VPC baru dan kaitkan dengan satu subnet di setiap Zona Ketersediaan.
+ Pastikan nama DNS pribadi diaktifkan di tingkat titik akhir VPC. Nama DNS pribadi diaktifkan secara default tetapi mungkin telah dinonaktifkan secara manual di beberapa titik.
+ Pastikan bahwa titik akhir VPC yang ada dikaitkan dengan subnet yang tepat. Selain itu, pastikan bahwa VPCE sudah dikaitkan dengan subnet di Zona Ketersediaan tersebut.
Untuk informasi selengkapnya, lihat topik berikut:
+ [Mengakses titik akhir VPC Layanan AWS menggunakan antarmuka ](https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html) di Panduan *AWS PrivateLink *
+ [Mengaitkan nama DNS pribadi ](https://docs.aws.amazon.com/vpc/latest/privatelink/configure-endpoint-service.html#associate-private-dns-name) dalam *AWS PrivateLink Panduan *
+ [Meningkatkan keamanan instans EC2 dengan menggunakan titik akhir VPC untuk Manajer Sistem](setup-create-vpc.md)
## Verifikasi atribut VPC DNS-related Anda
Jika Anda menggunakan cloud pribadi virtual (VPC), sebagai bagian dari memverifikasi konfigurasi VPC Anda, pastikan atribut `enableDnsSupport` dan `enableDnsHostnames` diaktifkan.
Anda dapat mengaktifkan atribut ini menggunakan tindakan Amazon EC2 [ ModifyVPCAttribute ](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyVpcAttribute.html) API atau perintah modify-vpc-atribut. AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-vpc-attribute.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-vpc-attribute.html)
Untuk informasi tentang mengaktifkan atribut ini di Amazon VPC Console, lihat Meli [ hat dan memperbarui atribut DNS untuk VPC Anda ](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-dns-updating.html) di Panduan Pengguna * Amazon VPC. *
**catatan**
Alternatif untuk menggunakan VPC endpoint adalah untuk memungkinkan akses internet luar pada instans terkelola Anda. Dalam kasus ini, instans terkelola juga harus mengizinkan lalu lintas keluar HTTPS (port 443) ke titik akhir berikut:
`ssm.{{region}}.amazonaws.com`
`ssmmessages.{{region}}.amazonaws.com`
`ec2messages.{{region}}.amazonaws.com`
SSM Agentmemulai semua koneksi ke layanan Manajer Sistem di cloud. Untuk alasan ini, Anda tidak perlu mengonfigurasi firewall Anda untuk mengizinkan lalu lintas masuk ke instans Anda untuk Systems Manager.
Untuk informasi lebih lanjut tentang panggilan ke titik akhir ini, lihat [Referensi: ec2messages, ssmmessages, dan operasi API lainnya](systems-manager-setting-up-messageAPIs.md).
## Verifikasi aturan masuk pada grup keamanan titik akhir
Pastikan bahwa setiap titik akhir VPC yang telah Anda konfigurasikan (`ssm`,`ssmmessages`, dan`ec2messages`) menyertakan aturan masuk pada grup keamanan mereka untuk mengizinkan lalu lintas masuk pada port 443. Jika perlu, Anda dapat membuat grup keamanan baru di VPC dengan aturan masuk untuk mengizinkan lalu lintas pada port 443 untuk blok Classless Inter-Domain Routing (CIDR) untuk VPC. Setelah Anda membuat grup keamanan, lampirkan ke setiap titik akhir VPC.
Untuk informasi selengkapnya, lihat topik berikut:
+ [Bagaimana cara membuat titik akhir VPC sehingga saya dapat menggunakan Manajer Sistem untuk mengelola instans EC2 pribadi tanpa akses internet? ](https://repost.aws/knowledge-center/ec2-systems-manager-vpc-endpoints)di AWS re:post
+ [Blok VPC CIDR ](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-cidr-blocks.html) di Panduan Pengguna * Amazon VPC *
## Gunakan `ssm-cli` untuk memecahkan masalah ketersediaan node terkelola
Dimulai dengan SSM Agent versi 3.1.501.0, Anda dapat menggunakan `ssm-cli` untuk menentukan apakah node terkelola memenuhi persyaratan utama untuk dikelola oleh Manajer Sistem, dan untuk muncul dalam daftar node terkelola di. Fleet Manager Ini `ssm-cli` adalah alat baris perintah mandiri yang termasuk dalam SSM Agent instalasi. Perintah pra-konfigurasi disertakan yang mengumpulkan informasi yang diperlukan untuk membantu Anda mendiagnosis mengapa instans Amazon EC2 atau mesin non-EC2 yang telah Anda konfirmasi berjalan tidak disertakan dalam daftar node terkelola di Manajer Sistem. Perintah ini dijalankan saat Anda menentukan `get-diagnostics` opsi.
Lihat informasi yang lebih lengkap di [Memecahkan masalah ketersediaan node terkelola menggunakan `ssm-cli`](troubleshooting-managed-nodes-using-ssm-cli.md).