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

Pemecahan Masalah Session Manager

Gunakan informasi berikut untuk membantu memecahkan masalah AWS Systems Manager Session Manager.

Proses dokumen gagal secara tak terduga: pekerja dokumen kehabisan waktu

Masalah: Saat memulai sesi ke host Linux, Systems Manager mengembalikan kesalahan berikut:

document process failed unexpectedly: document worker timed out, 
check [ssm-document-worker]/[ssm-session-worker] log for crash reason

Jika Anda mengkonfigurasi SSM Agent logging, seperti yang dijelaskan diMelihat SSM Agent log, Anda dapat melihat detail lebih lanjut di log debugging. Untuk masalah ini, Session Manager menunjukkan entri log berikut:

failed to create channel: too many open files

Kesalahan ini biasanya menunjukkan bahwa ada terlalu banyak Session Manager proses pekerja berjalan dan sistem operasi yang mendasarinya mencapai batas. Anda memiliki dua opsi untuk menyelesaikan masalah ini.

Solusi A: Tingkatkan batas notifikasi file sistem operasi

Anda dapat meningkatkan batas dengan menjalankan perintah berikut dari host Linux terpisah. Perintah ini menggunakan Systems Manager Run Command. Nilai yang ditentukan meningkat max_user_instances menjadi 8192. Nilai ini jauh lebih tinggi daripada nilai default 128, tetapi tidak akan membebani sumber daya host:

aws ssm send-command --document-name AWS-RunShellScript \
--instance-id i-02573cafcfEXAMPLE  --parameters \
"commands=sudo sysctl fs.inotify.max_user_instances=8192"

Solusi B: Kurangi notifikasi file yang digunakan oleh Session Manager di host target

Jalankan perintah berikut dari host Linux terpisah untuk membuat daftar sesi yang berjalan pada host target:

aws ssm describe-sessions --state Active --filters key=Target,value=i-02573cafcfEXAMPLE

Tinjau output perintah untuk mengidentifikasi sesi yang tidak lagi diperlukan. Anda dapat mengakhiri sesi tersebut dengan jalankan perintah berikut dari host Linux terpisah:

aws ssm terminate-session —session-id session ID

Secara opsional, setelah tidak ada lagi sesi yang berjalan di server jarak jauh, Anda dapat membebaskan sumber daya tambahan dengan menjalankan perintah berikut dari host Linux terpisah. Perintah ini mengakhiri semua Session Manager proses yang berjalan pada host jarak jauh, dan akibatnya semua sesi ke host jarak jauh. Sebelum Anda menjalankan perintah ini, pastikan tidak ada sesi berkelanjutan yang ingin Anda pertahankan:

aws ssm send-command --document-name AWS-RunShellScript \
            --instance-id i-02573cafcfEXAMPLE --parameters \
'{"commands":["sudo kill $(ps aux | grep ssm-session-worker | grep -v grep | awk '"'"'{print $2}'"'"')"]}'

Session Manager tidak dapat terhubung dari EC2 konsol Amazon

Masalah: Setelah membuat instance baru, tab Session Manager di konsol Amazon Elastic Compute Cloud (AmazonEC2) tidak memberi Anda opsi untuk terhubung.

Solusi A: Buat profil instance: Jika Anda belum melakukannya (seperti yang diinstruksikan oleh informasi di tab Session Manager di EC2 konsol), buat profil instance AWS Identity and Access Management (IAM) dengan menggunakan Quick Setup. Quick Setup adalah kemampuan AWS Systems Manager.

Session Manager memerlukan profil IAM instance untuk terhubung ke instans Anda. Anda dapat membuat profil instance dan menetapkannya ke instans Anda dengan membuat konfigurasi manajemen host dengan Quick Setup. Konfigurasi manajemen host membuat profil instance dengan izin yang diperlukan dan menetapkannya ke instans Anda. Konfigurasi manajemen host juga memungkinkan kemampuan Systems Manager lainnya dan menciptakan IAM peran untuk menjalankan kemampuan tersebut. Tidak ada biaya untuk digunakan Quick Setup atau kemampuan yang diaktifkan oleh konfigurasi manajemen host. terbuka Quick Setup dan membuat konfigurasi manajemen host.

Jika Anda masih tidak dapat terhubung setelah membuat konfigurasi manajemen host, atau jika Anda menerima kesalahan, termasuk kesalahan tentang SSM Agent, lihat salah satu solusi berikut:

Solusi B: Tidak ada kesalahan, tetapi masih tidak dapat terhubung

Jika Anda membuat konfigurasi manajemen host, menunggu beberapa menit sebelum mencoba terhubung, dan masih tidak dapat terhubung, maka Anda mungkin perlu menerapkan konfigurasi manajemen host secara manual ke instans Anda. Gunakan prosedur berikut untuk memperbarui Quick Setup konfigurasi manajemen host dan menerapkan perubahan pada sebuah instance.

Tunggu beberapa menit EC2 untuk menyegarkan tab Session Manager. Jika Anda masih tidak dapat terhubung atau jika Anda menerima kesalahan, tinjau solusi yang tersisa untuk masalah ini.

Solusi C: Kesalahan tentang hilang SSM Agent

Jika Anda tidak dapat membuat konfigurasi manajemen host dengan menggunakan Quick Setup, atau jika Anda menerima kesalahan tentang SSM Agent tidak diinstal, Anda mungkin perlu menginstal secara manual SSM Agent pada instans Anda. SSM Agent adalah perangkat lunak Amazon yang memungkinkan Systems Manager terhubung ke instans Anda dengan menggunakan Session Manager. SSM Agent diinstal secara default di sebagian besar Gambar Mesin Amazon (AMIs). Jika instance Anda dibuat dari non-standar AMI atau yang lebih lamaAMI, Anda mungkin harus menginstal agen secara manual. Untuk prosedur untuk menginstal SSM Agent, lihat topik berikut yang sesuai dengan sistem operasi instans Anda.

Untuk masalah dengan SSM Agent, lihat Pemecahan Masalah SSM Agent.

Tidak ada izin untuk memulai sesi

Masalah: Anda mencoba untuk memulai sesi, tetapi sistem memberitahu Anda bahwa Anda tidak memiliki izin yang diperlukan.

SSM Agent tidak online

Masalah: Anda melihat pesan di EC2 instance Amazon Session Managertab yang menyatakan: SSM Agent tidak online. Bagian SSM Agent tidak dapat terhubung ke titik akhir Systems Manager untuk mendaftarkan dirinya ke layanan.

Solusi: SSM Agent adalah perangkat lunak Amazon yang berjalan pada EC2 instans Amazon sehingga Session Manager dapat terhubung ke mereka. Jika Anda melihat kesalahan ini, SSM Agent tidak dapat membuat koneksi dengan titik akhir Systems Manager. Sumber masalahnya bisa berupa pembatasan firewall, masalah perutean, atau kurangnya konektivitas internet. Untuk mengatasi masalah ini, selidiki masalah konektivitas jaringan.

Tidak ada izin untuk mengubah preferensi sesi

Masalah: Anda mencoba untuk memperbarui preferensi sesi global untuk organisasi Anda, tetapi sistem memberitahu Anda bahwa Anda tidak memiliki izin yang diperlukan.

Node terkelola tidak tersedia atau tidak dikonfigurasi untuk Session Manager

Masalah 1: Anda ingin memulai sesi pada Memulai sesi, namun node terkelola tidak ada dalam daftar.

Masalah 2: Node terkelola yang ingin Anda hubungkan adalah dalam daftar pada halam konsol Memulai sesi, namun halaman melaporkan bahwa “Instans yang Anda pilih tidak dikonfigurasi untuk digunakan Session Manager."

Session Manager Plugin tidak ditemukan

Untuk menggunakan perintah AWS CLI to run session, Session Manager Plugin juga harus diinstal pada mesin lokal Anda. Untuk informasi, lihat Instal Session Manager plugin untuk AWS CLI.

Session Manager Plugin tidak secara otomatis ditambahkan ke jalur baris perintah (Windows)

Saat Anda menginstal Session Manager Plugin pada Windows, session-manager-plugin executable harus secara otomatis ditambahkan ke variabel PATH lingkungan sistem operasi Anda. Jika perintah gagal setelah Anda menjalankannya untuk memeriksa apakah Session Manager plugin diinstal dengan benar (aws ssm start-session --target instance-id), Anda mungkin perlu mengaturnya secara manual menggunakan prosedur berikut.

Session Manager Plugin menjadi tidak responsif

Selama sesi penerusan port, lalu lintas mungkin berhenti meneruskan jika Anda memiliki perangkat lunak antivirus yang diinstal pada komputer lokal Anda. Dalam beberapa kasus, perangkat lunak antivirus mengganggu Session Manager plugin menyebabkan kebuntuan proses. Untuk mengatasi masalah ini, izinkan atau kecualikan Session Manager Plugin dari perangkat lunak antivirus. Untuk informasi tentang jalur instalasi default untuk Session Manager plugin, lihatInstal Session Manager plugin untuk AWS CLI.

TargetNotConnected

Masalah: Anda mencoba memulai sesi, tetapi sistem mengembalikan pesan kesalahan, “Terjadi kesalahan (TargetNotConnected) saat memanggil StartSession operasi: InstanceID tidak terhubung.”

Layar kosong ditampilkan setelah memulai sesi

Masalah: Anda memulai sesi dan Session Manager menampilkan layar kosong.

Node terkelola menjadi tidak responsif selama sesi berjalan lama

Masalah: Node terkelola Anda menjadi tidak responsif atau terganggu selama sesi berjalan lama.

Solusi: Kurangi SSM Agent durasi retensi log untuk Session Manager.

Terjadi kesalahan (InvalidDocument) saat memanggil StartSession operasi

Masalah: Anda menerima kesalahan berikut saat memulai sesi dengan menggunakan AWS CLI.

An error occurred (InvalidDocument) when calling the StartSession operation: Document type: 'Command' is not supported. Only type: 'Session' is supported for Session Manager.

Solusi: SSM Dokumen yang Anda tentukan untuk --document-name parameter bukanlah dokumen Sesi. Gunakan prosedur berikut untuk melihat daftar dokumen Sesi di AWS Management Console.