Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Fehlerbehebung Session Manager

Im Folgenden finden Sie Informationen zur Behandlung von Problemen mit AWS Systems Manager Session Manager.

Der Dokumentvorgang ist unerwartet fehlgeschlagen: Das Zeitlimit für den Document Worker wurde überschritten

Problem: Beim Starten einer Sitzung auf einem Linux-Host gibt Systems Manager den folgenden Fehler zurück:

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

Wenn Sie konfiguriert haben SSM Agent Protokollierung, wie unter beschriebenAnzeigen von SSM Agent-Protokollen, können Sie weitere Details im Debugging-Protokoll einsehen. Für dieses Problem Session Manager zeigt den folgenden Protokolleintrag:

failed to create channel: too many open files

Dieser Fehler weist normalerweise darauf hin, dass zu viele vorhanden sind Session Manager Arbeitsprozesse wurden ausgeführt und das zugrunde liegende Betriebssystem hat ein Limit erreicht. Sie haben zwei Möglichkeiten, dieses Problem zu lösen.

Lösung A: Erhöhen Sie das Limit für Dateibenachrichtigungen im Betriebssystem

Sie können das Limit erhöhen, indem Sie den folgenden Befehl von einem separaten Linux-Host aus ausführen. Dieser Befehl verwendet Systems Manager Run Command. Der angegebene Wert erhöht sich max_user_instances auf 8192. Dieser Wert ist erheblich höher als der Standardwert 128, belastet aber die Hostressourcen nicht:

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

Lösung B: Reduzieren Sie die Anzahl der verwendeten Dateibenachrichtigungen von Session Manager auf dem Zielhost

Führen Sie den folgenden Befehl von einem separaten Linux-Host aus, um die auf dem Zielhost laufenden Sitzungen aufzulisten:

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

Überprüfen Sie die Befehlsausgabe, um Sitzungen zu identifizieren, die nicht mehr benötigt werden. Sie können diese Sitzung beenden, indem Sie den folgenden Befehl von einem separaten Linux-Host aus ausführen:

aws ssm terminate-session —session-id session ID

Wenn auf dem Remoteserver keine weiteren Sitzungen mehr laufen, können Sie optional zusätzliche Ressourcen freigeben, indem Sie den folgenden Befehl von einem separaten Linux-Host aus ausführen. Dieser Befehl beendet alle Session Manager Prozesse, die auf dem Remote-Host ausgeführt werden, und folglich alle Sitzungen auf dem Remote-Host. Bevor Sie diesen Befehl ausführen, stellen Sie sicher, dass keine laufenden Sitzungen vorhanden sind, die Sie behalten möchten:

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 Ich kann von der EC2 Amazon-Konsole aus keine Verbindung herstellen

Problem: Nach der Erstellung einer neuen Instance bietet Ihnen die Registerkarte Session Manager in der Konsole von Amazon Elastic Compute Cloud (AmazonEC2) nicht die Möglichkeit, sich zu verbinden.

Lösung A: Erstellen Sie ein Instance-Profil: Falls Sie dies noch nicht getan haben (wie in den Informationen auf der Registerkarte Session Manager in der EC2 Konsole beschrieben), erstellen Sie ein AWS Identity and Access Management (IAM) Instance-Profil mithilfe von Quick Setup. Quick Setup ist eine Fähigkeit von. AWS Systems Manager

Session Manager erfordert ein IAM Instance-Profil, um eine Verbindung mit Ihrer Instance herzustellen. Sie können ein Instance-Profil erstellen und es Ihrer Instance zuweisen, indem Sie eine Host-Verwaltungs-Konfiguration erstellen mit Quick Setup. Eine Host-Verwaltungs-Konfiguration erstellt ein Instance-Profil mit den erforderlichen Berechtigungen und weist es Ihrer Instance zu. Eine Host-Verwaltungs-Konfiguration ermöglicht auch andere Systems-Manager-Funktionen und erstellt IAM Rollen für die Ausführung dieser Funktionen. Die Nutzung ist kostenlos Quick Setup oder die Funktionen, die durch die Host-Verwaltungs-Konfiguration aktiviert werden. Öffnen Quick Setup und erstellen Sie eine Host-Management-Konfiguration.

Wenn Sie nach dem Erstellen einer Host-Verwaltungs-Konfiguration immer noch keine Verbindung herstellen können oder wenn Sie eine Fehlermeldung erhalten, einschließlich einer Fehlermeldung zu SSM Agent, sehen Sie eine der folgenden Lösungen:

Lösung B: Kein Fehler, aber es kann immer noch keine Verbindung hergestellt werden

Wenn Sie die Host-Verwaltungs-Konfiguration erstellt haben, mehrere Minuten gewartet haben, bevor Sie versucht haben, eine Verbindung herzustellen, und immer noch keine Verbindung herstellen können, müssen Sie die Host-Management-Konfiguratio möglicherweise manuell auf Ihre Instance anwenden. Gehen Sie wie folgt vor, um eine zu aktualisieren Quick Setup Host-Verwaltungs-Konfiguration und Anwenden von Änderungen auf eine Instance.

Warten Sie einige MinutenEC2, bis die Registerkarte Session Manager aktualisiert wurde. Wenn Sie immer noch keine Verbindung herstellen können oder eine Fehlermeldung angezeigt wird, überprüfen Sie die verbleibenden Lösungen für dieses Problem.

Lösung C: Fehler wegen fehlendem Problem SSM Agent

Wenn Sie keine Host-Management-Konfiguration erstellen konnten, indem Sie Quick Setup, oder wenn Sie eine Fehlermeldung erhalten haben über SSM Agent da es nicht installiert ist, müssen Sie es möglicherweise manuell installieren SSM Agent auf Ihrer -Instance. SSM Agent ist Amazon-Software, die es Systems Manager ermöglicht, eine Verbindung mit Ihrer Instance herzustellen, indem Session Manager. SSM Agent ist standardmäßig auf den meisten Amazon Machine Images (AMIs) installiert. Wenn Ihre Instance aus einer nicht standardmäßigen AMI oder älteren -Instance erstellt wurdeAMI, müssen Sie den Agenten möglicherweise manuell installieren. Für das Verfahren zur Installation SSM Agent, lesen Sie das folgende Thema, das Ihrem Instance-Betriebssystem entspricht.

Lösungen zu Problemen mit SSM Agent, finden Sie unter Fehlerbehebung SSM Agent.

Keine Berechtigung zum Starten einer Sitzung

Problem: Sie versuchen, eine Sitzung zu starten. Das System teilt Ihnen jedoch mit, dass Sie nicht über die erforderlichen Berechtigungen verfügen.

SSM Agent nicht online

Problem: Sie sehen eine Nachricht auf der EC2 Amazon-Instance Session ManagerRegisterkarte mit der Aufschrift: SSM Agent ist nicht online. Das Tool SSM Agent konnte keine Verbindung zu einem Systems Manager -Endpunkt herstellen, um sich beim Service zu registrieren.

Solution (Lösung): SSM Agent ist Amazon-Software, die auf EC2 Amazon-Instances läuft, sodass Session Manager kann eine Verbindung zu ihnen herstellen. Wenn dieser Fehler angezeigt wird, SSM Agent kann keine Verbindung mit dem Systems Manager -Endpunkt herstellen. Die Ursache des Problems könnten Firewall-Einschränkungen, Routing-Probleme oder mangelnde Internetverbindung sein. Sie lösen dieses Problem, indem Sie Probleme mit der Netzwerkverbindung untersuchen.

Keine Berechtigung zum Ändern von Sitzungspräferenzen

Problem: Sie versuchen, globale Sitzungspräferenzen für Ihre Organisation zu aktualisieren. Das System teilt Ihnen jedoch mit, dass Sie nicht über die erforderlichen Berechtigungen verfügen.

Verwalteter Knoten ist nicht verfügbar oder nicht konfiguriert für Session Manager

Problem 1: Sie möchten auf der Seite Start a session (Sitzung starten) der Konsole eine Sitzung starten. Es befindet sich jedoch kein verwalteter Knoten in der Liste.

Problem 2: Ein verwalteter Knoten, mit dem Sie eine Verbindung herstellen möchten, befindet sich in der Liste auf der Seite Start a session (Sitzung starten) der Konsole. Die Seite meldet jedoch, dass „die von Ihnen ausgewählte Instance nicht für die Verwendung konfiguriert wurde Session Manager."

Session Manager Plugin nicht gefunden

Um die Befehle AWS CLI zum Ausführen von Sessionbefehlen zu verwenden, Session Manager Das Plugin muss auch auf Ihrem lokalen Computer installiert sein. Weitere Informationen finden Sie unter Installieren des Session Manager-Plugins für die AWS CLI.

Session Manager -Plug-In wurde dem Befehlszeilenpfad nicht automatisch hinzugefügt (Windows)

Wenn Sie das installieren Session Manager -Plug-In aktiviert Windows, die session-manager-plugin ausführbare Datei sollte automatisch zur PATH Umgebungsvariablen Ihres Betriebssystems hinzugefügt werden. Wenn der Befehl fehlschlug, nachdem Sie ihn ausgeführt haben, überprüfen Sie, ob Session Manager Wenn das Plugin korrekt installiert wurde (aws ssm start-session --target instance-id), müssen Sie es möglicherweise manuell festlegen, indem Sie das folgende Verfahren verwenden.

Session Manager Plugin reagiert nicht mehr

Während einer Port-Weiterleitungssitzung kann der Datenverkehr nicht mehr weitergeleitet werden, wenn auf Ihrem lokalen Computer Antivirus-Software installiert ist. In einigen Fällen stört Antiviren-Software die Session Manager Plugin, das Prozess-Deadlocks verursacht. Um dieses Problem zu beheben, erlauben oder schließen Sie die Session Manager Plugin aus der Antivirensoftware. Informationen zum Standardinstallationspfad für Session Manager Plugin finden Sie unterInstallieren des Session Manager-Plugins für die AWS CLI.

TargetNotConnected

Problem: Sie möchten eine Sitzung starten. Das System gibt jedoch folgende Fehlermeldung zurück: „Beim Aufruf der StartSession Operation ist der Fehler (TargetNotConnected) aufgetreten: InstanceID ist nicht verbunden.“

Nach dem Starten einer Sitzung wird ein leerer Bildschirm angezeigt

Problem: Sie starten eine Sitzung und Session Manager zeigt einen leeren Bildschirm an.

Verwalteter Knoten reagiert während langer Sitzungen nicht mehr

Problem: Ihr verwalteter Knoten reagiert nicht oder stürzt während einer langen Sitzung ab.

Lösung: Verringern Sie den SSM Agent Protokollaufbewahrungsdauer für Session Manager.

An error occurred (InvalidDocument) when calling the StartSession operation

Problem: Sie erhalten den folgenden Fehler, wenn Sie eine Sitzung mit dem AWS CLI starten.

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

Lösung: Das SSM Dokument, das Sie für den --document-name Parameter angegeben haben, ist kein Sitzungsdokument. Gehen Sie wie folgt vor, um eine Liste von Sitzungsdokumenten in der AWS Management Console anzuzeigen.