View a markdown version of this page

Memahami status perintah - AWS Systems Manager
Run Command statusMemahami nilai batas waktu perintah

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

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

Memahami status perintah

Run Commandmelaporkan informasi status terperinci tentang berbagai status yang dialami perintah selama pemrosesan dan untuk setiap node terkelola yang memproses perintah. Anda dapat memantau status perintah menggunakan metode berikut:

  • Pilih ikon Refresh pada tab Per intah di antarmuka Run Command konsol.

  • Panggil perintah daftar atau pemanggilan perintah daftar menggunakan (). AWS Command Line Interface AWS CLI Atau menelep Get-SSMCommand on atau Get-SSMCommandInvocation menggunakan AWS Tools for Windows PowerShell.

  • Konfigurasikan Amazon EventBridge untuk menanggapi perubahan status atau status.

  • Konfigurasikan Amazon Simple Notification Service (Amazon SNS) untuk mengirim pemberitahuan untuk semua perubahan status atau status tertentu seperti Failed atau. TimedOut

Run Command status

Run Commandmelaporkan rincian status untuk tiga area: plugin, pemanggilan, dan status perintah keseluruhan. plugin adalah blok eksekusi kode yang ditetapkan dalam dokumen SSM perintah Anda. Untuk informasi selengkapnya tentang plugin, lihat Referensi plugin dokumen perintah.

Ketika Anda mengirim perintah ke beberapa node terkelola secara bersamaan, setiap salinan perintah yang menargetkan setiap node adalah pemang gilan perintah. Misalnya, jika Anda menggunakan dokumen AWS-RunShellScript dan mengirimkan perintah ifconfig ke 20 instans Linux, perintah tersebut memiliki 20 pemanggilan. Setiap pemanggilan perintah secara individual melaporkan status. Plugin untuk pemanggilan perintah tertentu juga secara individual melaporkan status.

Terakhir, Run Command termasuk status perintah agregat untuk semua plugin dan pemanggilan. Status perintah agregat dapat berbeda dari status yang dilaporkan oleh plugin atau pemanggilan, seperti yang tercantum dalam tabel berikut.

catatan

Jika Anda menjalankan perintah ke sejumlah besar node terkelola menggunakan max-errors parameter max-concurrency or, status perintah mencerminkan batas yang diberlakukan oleh parameter tersebut, seperti yang dijelaskan dalam tabel berikut. Untuk informasi selengkapnya tentang parameter ini, lihat Jalankan perintah dalam skala.

Status detail untuk plugin dan pemanggilan perintah
Status Detail
Tertunda Perintah belum dikirim ke node yang dikelola atau belum diterima olehSSM Agent. Jika perintah tidak diterima oleh agen sebelum panjang waktu berlalu yang sama dengan jumlah parameter Waktu habis (detik) dan parameter Waktu eksekusi, status berubah ke Delivery Timed Out.
InProgress Manajer Sistem mencoba mengirim perintah ke node yang dikelola, atau perintah diterima oleh SSM Agent dan telah mulai berjalan pada instance. Tergantung pada hasil dari semua plugin perintah, status berubah ke Success, Failed, Delivery Timed Out, atau Execution Timed Out. Pengecualian: Jika agen tidak berjalan atau tersedia di node, status perintah tetap In Progress sampai agen tersedia lagi, atau sampai batas waktu tunggu eksekusi tercapai. Status kemudian berubah ke status terakhir.
Terlambat Sistem mencoba mengirim perintah ke node yang dikelola tetapi tidak berhasil. Sistem mencoba lagi.
Berhasil Status ini dikembalikan dalam berbagai kondisi. Status ini tidak berarti perintah diproses pada node. Misalnya, perintah dapat diterima oleh SSM Agent pada node yang dikelola dan mengembalikan kode keluar nol sebagai akibat dari Anda PowerShell ExecutionPolicy mencegah perintah berjalan. Ini adalah status terakhir. Kondisi yang menghasilkan perintah mengembalikan Success status adalah:

  • Saat menargetkan satu instance, perintah diterima oleh SSM Agent pada node yang dikelola dan mengembalikan kode keluar nol.

  • Saat menargetkan beberapa instance, jumlah pemanggilan yang gagal belum melewati ambang kesalahan yang ditentukan dalam perintah.

  • Saat menargetkan beberapa instans, setidaknya 1 pemanggilan berhasil sementara yang lain telah habis waktunya. Ambang batas kesalahan yang ditentukan masih berlaku.

  • Saat menargetkan tag, tidak ada instance yang ditemukan terkait dengan tag.

  • Saat menargetkan tag, jumlah pemanggilan yang gagal belum melewati ambang kesalahan yang ditentukan dalam perintah.

  • Saat menargetkan tag, setidaknya 1 pemanggilan berhasil sementara yang lain telah habis waktunya. Ambang batas kesalahan yang ditentukan masih berlaku.

  • Anda memiliki aplikasi atau kebijakan yang diberlakukan di tingkat OS yang mencegah atau mengganti eksekusi perintah yang mengakibatkan kode keluar nol dikembalikan.

catatan

Kondisi yang sama berlaku saat menargetkan grup sumber daya. Untuk memecahkan masalah kesalahan atau mendapatkan informasi selengkapnya tentang eksekusi perintah, kirim perintah yang menangani kesalahan atau pengecualian dengan mengembalikan kode keluar yang sesuai (kode keluar bukan nol untuk kegagalan perintah).
DeliveryTimedOut Perintah tidak dikirimkan ke node terkelola sebelum batas waktu total berakhir. Total batas waktu tidak dihitung terhadap max-errors batas perintah induk, tetapi mereka berkontribusi pada apakah status perintah induk adalahSuccess,Incomplete, atauDelivery Timed Out. Ini adalah status terakhir.
ExecutionTimedOut Otomatisasi perintah dimulai pada node terkelola, tetapi perintah tidak selesai sebelum batas waktu eksekusi berakhir. Waktu tunggu eksekusi dihitung sebagai kegagalan, yang akan mengirimkan balasan bukan nol dan Manajer Sistem akan keluar dari upaya untuk menjalankan otomatisasi perintah, dan melaporkan status kegagalan.
Gagal Perintah tidak berhasil pada node yang dikelola. Untuk plugin, ini menunjukkan bahwa kode hasil tidak nol. Untuk pemanggilan perintah, ini menunjukkan bahwa kode hasil untuk satu atau lebih plugin tidak nol. Kegagalan pemanggilan dihitung terhadap batas max-errors perintah induk. Ini adalah status terakhir.
Dibatalkan Perintah dibatalkan sebelum selesai. Ini adalah keadaan akhir.
Tidak terkirim Perintah tidak dapat dikirim ke node yang dikelola. Node mungkin tidak ada atau mungkin tidak merespons. Pemanggilan tidak terkirim tidak dihitung terhadap batas max-errors perintah induk, tetapi berkontribusi pada apakah status perintah induk adalah Success atau Incomplete. Sebagai contoh, jika semua pemanggilan dalam perintah memiliki status Undeliverable, maka status perintah yang dikembalikan adalah Failed. Namun, jika perintah memiliki lima pemanggilan, empat di antaranya mengembalikan status Undeliverable dan salah satunya mengembalikan status Success, maka status perintah induk adalah Success. Ini adalah keadaan akhir.
Diakhiri Perintah induk melebihi batas max-errors dan pemanggilan perintah berikutnya dibatalkan oleh sistem. Ini adalah status terakhir.
InvalidPlatform Perintah dikirim ke node terkelola yang tidak cocok dengan platform yang diperlukan yang ditentukan oleh dokumen yang dipilih. Invalid Platformtidak diperhitungkan terhadap batas kesalahan max-perintah induk, tetapi itu berkontribusi pada apakah status perintah induk Sukses atau Gagal. Sebagai contoh, jika semua pemanggilan dalam perintah memiliki status Invalid Platform, maka status perintah yang dikembalikan adalah Failed. Namun, jika perintah memiliki lima pemanggilan, empat di antaranya mengembalikan status Invalid Platform dan salah satunya mengembalikan status Success, maka status perintah induk adalah Success. Ini adalah status terakhir.
AccessDenied Pengguna atau peran AWS Identity and Access Management (IAM) yang memulai perintah tidak memiliki akses ke node terkelola yang ditargetkan. Access Deniedtidak dihitung terhadap max-errors batas perintah induk, tetapi itu berkontribusi pada apakah status perintah induk adalah Success atauFailed. Sebagai contoh, jika semua pemanggilan dalam perintah memiliki status Access Denied, maka status perintah yang dikembalikan adalah Failed. Namun, jika perintah memiliki lima pemanggilan, empat di antaranya mengembalikan status Access Denied dan salah satunya mengembalikan status Success, maka status perintah induk adalah Success. Ini adalah keadaan akhir.
Status detail untuk perintah
Status Detail
Tertunda Perintah belum diterima oleh agen di node terkelola mana pun.
InProgress Perintah telah dikirim ke setidaknya satu node terkelola tetapi belum mencapai status akhir pada semua node.
Terlambat Sistem mencoba mengirim perintah ke node tetapi tidak berhasil. Sistem mencoba lagi.
Berhasil Perintah diterima oleh SSM Agent pada semua node terkelola yang ditentukan atau ditargetkan dan mengembalikan kode keluar nol. Semua pemanggilan perintah telah mencapai keadaan akhir, dan nilai max-errors tidak tercapai. Status ini tidak berarti perintah berhasil diproses pada semua node terkelola yang ditentukan atau ditargetkan. Ini adalah keadaan akhir.
catatan

Untuk memecahkan masalah kesalahan atau mendapatkan informasi selengkapnya tentang eksekusi perintah, kirim perintah yang menangani kesalahan atau pengecualian dengan mengembalikan kode keluar yang sesuai (kode keluar bukan nol untuk kegagalan perintah).
DeliveryTimedOut Perintah tidak dikirimkan ke node terkelola sebelum batas waktu total berakhir. Nilai max-errors atau lebih pemanggilan perintah menunjukkan status Delivery Timed Out. Ini adalah keadaan akhir.
Gagal

Perintah tidak berhasil pada node yang dikelola. Nilai max-errors atau lebih pemanggilan perintah menunjukkan status Failed. Ini adalah keadaan akhir.
Tidak lengkap Perintah dicoba pada semua node yang dikelola dan satu atau lebih pemanggilan tidak memiliki nilai. Success Namun, tidak terjadi cukup pemanggilan yang gagal untuk status menjadi Failed. Ini adalah status terakhir.
Dibatalkan Perintah dibatalkan sebelum selesai. Ini adalah status terakhir.
RateExceeded Jumlah node terkelola yang ditargetkan oleh perintah melebihi kuota akun untuk pemanggilan yang tertunda. Sistem telah membatalkan perintah sebelum menjalankannya pada node apa pun. Ini adalah status terakhir.
AccessDenied Pengguna atau peran yang memulai perintah tidak memiliki akses ke grup sumber daya yang ditargetkan. AccessDeniedtidak dihitung terhadap max-errors batas perintah induk, tetapi berkontribusi pada apakah status perintah induk adalah Success atauFailed. (Sebagai contoh, jika semua pemanggilan dalam perintah memiliki status AccessDenied, maka status perintah yang dikembalikan adalah Failed. Namun, jika perintah memiliki 5 pemanggilan, 4 di antaranya mengembalikan status AccessDenied dan 1 mengembalikan status Success, maka status perintah induk adalah Success.) Ini adalah keadaan akhir.
Tidak Ada Instans Dalam Tag Nilai pasangan kunci tag atau grup sumber daya yang ditargetkan oleh perintah tidak cocok dengan node terkelola mana pun. Ini adalah status terakhir.

Memahami nilai batas waktu perintah

Systems Manager memberlakukan nilai batas waktu berikut saat menjalankan perintah.

Total Batas Waktu

Di konsol Manajer Sistem, Anda menentukan nilai batas waktu di bidang Batas waktu (detik). Setelah perintah dikirim, periksa apakah Run Command perintah telah kedaluwarsa atau tidak. Jika sebuah perintah mencapai batas kedaluwarsa perintah (total batas waktu), statusnya berubah ke DeliveryTimedOut untuk semua pemanggilan yang memiliki status InProgress, Pending atau Delayed.

Bidang Waktu habis (detik) di konsol Systems Manager

Pada tingkat yang lebih teknis, batas waktu total (T imeout (detik)) adalah kombinasi dari dua nilai batas waktu, seperti yang ditunjukkan di sini:

Total timeout = "Timeout(seconds)" from the console + "timeoutSeconds": "{{ executionTimeout }}" from your SSM document

Misalnya, nilai default Waktu habis (detik) di konsol Systems Manager adalah 600 detik. Jika Anda menjalankan perintah dengan menggunakan dokumen SSM AWS-RunShellScript, nilai default "timeoutSeconds": "{{ executionTimeout }}" adalah 3600 detik, seperti yang ditunjukkan dalam contoh dokumen berikut:


  "executionTimeout": {
      "type": "String",
      "default": "3600",

  "runtimeConfig": {
    "aws:runShellScript": {
      "properties": [
        {
          "timeoutSeconds": "{{ executionTimeout }}"

Ini berarti perintah berjalan selama 4.200 detik (70 menit) sebelum sistem menetapkan status perintah keDeliveryTimedOut.

Batas Waktu Eksekusi

Di konsol Systems Manager, Anda menentukan nilai batas waktu eksekusi di bidang Batas Waktu Eksekusi, jika tersedia. Tidak semua dokumen SSM mengharuskan Anda menentukan batas waktu eksekusi. Bid ang Waktu B atas Eksekusi hanya ditampilkan ketika parameter input yang sesuai telah ditentukan dalam dokumen SSM. Jika ditentukan, perintah harus selesai dalam periode waktu ini.

catatan

Run Commandbergantung pada respons terminal SSM Agent dokumen untuk menentukan apakah perintah dikirimkan ke agen. SSM Agentharus mengirim ExecutionTimedOut sinyal agar pemanggilan atau perintah ditandai sebagaiExecutionTimedOut.

Bidang Batas Waktu Eksekusi di konsol Systems Manager
Batas Waktu Eksekusi Default

Jika dokumen SSM tidak mengharuskan Anda secara eksplisit menentukan nilai batas waktu eksekusi, maka Systems Manager memberlakukan batas waktu eksekusi default hard-coded.

Cara Systems Manager melaporkan waktu habis

Jika Manajer Sistem menerima bal execution timeout asan dari SSM Agent target, maka Manajer Sistem menandai pemanggilan perintah sebagaiexecutionTimeout.

Jika Run Command tidak menerima respons terminal dokumen dariSSM Agent, pemanggilan perintah ditandai sebagaideliveryTimeout.

Untuk menentukan status batas waktu pada target, gab SSM Agent ungkan semua parameter dan konten dokumen SSM untuk dihitung. executionTimeout Ketika SSM Agent menentukan bahwa perintah telah habis waktunya, ia mengirim executionTimeout ke layanan.

default untuk Waktu habis (detik) adalah 3600 detik. default untuk Batas Waktu Eksekusi juga 3600 detik. Oleh karena itu, total batas waktu default untuk perintah adalah 7200 detik.

catatan

SSM Agentproses executionTimeout yang berbeda tergantung pada jenis dokumen SSM dan versi dokumen.