Konfigurieren der Sitzungsprotokollierung auf Festplatte - AWS Systems Manager

AWS Systems ManagerChange Managersteht neuen Kunden nicht mehr offen. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der AWS Systems ManagerChange Manager Verfügbarkeit.

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.

Konfigurieren der Sitzungsprotokollierung auf Festplatte

Nachdem Sie die Session Manager Protokollierung bei Amazon S3 CloudWatch oder Amazon S3 aktiviert haben, werden alle während einer Sitzung ausgeführten Befehle (und die daraus resultierenden Ausgaben) in einer temporären Datei auf der Festplatte der Ziel-Instance protokolliert. Die temporäre Datei hat den Namen ipcTempFile.log.

ipcTempFile.log wird durch den SessionLogsDestination-Parameter in der SSM Agent-Konfigurationsdatei gesteuert. Dieser Parameter akzeptiert die folgenden Werte:

  • Festplatte: Wenn Sie diesen Parameter angeben und die Sitzungsprotokollierung auf CloudWatch oder Amazon S3 aktiviert ist, SSM Agent erstellt die ipcTempFile.log temporäre Protokolldatei und protokolliert Sitzungsbefehle sowie die Ausgabe auf der Festplatte. Session Managerlädt dieses Protokoll je nach Protokollierungskonfiguration während oder nach der Sitzung entweder CloudWatch auf S3 hoch. Das Protokoll wird dann entsprechend der für den SSM Agent SessionLogsRetentionDurationHours Konfigurationsparameter angegebenen Dauer gelöscht.

    Wenn Sie diesen Parameter angeben und die Sitzungsprotokollierung bei Amazon S3 deaktiviert ist, werden SSM Agent trotzdem der Befehlsverlauf und die Ausgabe in der ipcTempFile.log Datei protokolliert. CloudWatch Die Datei wird entsprechend der für den SSM Agent SessionLogsRetentionDurationHours Konfigurationsparameter angegebenen Dauer gelöscht.

  • none: Wenn Sie diesen Parameter angeben und die Sitzungsprotokollierung bei CloudWatch oder Amazon S3 aktiviert ist, funktioniert die Protokollierung auf der Festplatte genauso, als ob Sie den disk Parameter angegeben hätten. SSM Agentbenötigt die temporäre Datei, wenn die Sitzungsprotokollierung bei CloudWatch oder Amazon S3 aktiviert ist.

    Wenn Sie diesen Parameter angeben und die Sitzungsprotokollierung bei CloudWatch oder Amazon S3 deaktiviert SSM Agent ist, wird die ipcTempFile.log Datei nicht erstellt.

Gehen Sie wie folgt vor, um die Erstellung der ipcTempFile.log-temporären Protokolldatei auf der Festplatte zu aktivieren oder zu deaktivieren, wenn eine Sitzung gestartet wird.

Um die Erstellung der Session Manager-temporären Protokolldatei auf der Festplatte zu aktivieren oder zu deaktivieren

  1. Installieren Sie SSM Agent entweder auf Ihrer Instance oder führen Sie ein Upgrade auf Version 3.2.2086 oder höher durch. Weitere Informationen zum Überprüfen der Agent-Versionsnummer finden Sie unter Überprüfen der SSM Agent-Versionsnummer. Informationen zur manuellen Installation des Agenten finden Sie in den folgenden Abschnitten nach dem Verfahren für Ihr Betriebssystem:

  2. Erstellen Sie eine Verbindung zu Ihrer Instance und suchen Sie die amazon-ssm-agent.json-Datei am folgenden Speicherort.

    • Linux:/etc/amazon/ssm/

    • macOS: /opt/aws/ssm/

    • Windows Server: C:\Program Files\Amazon\SSM

    Wenn die Datei amazon-ssm-agent.json nicht existiert, kopieren Sie den Inhalt von amazon-ssm-agent.json.template in eine neue Datei im selben Verzeichnis. Benennen Sie die Datei amazon-ssm-agent.json.

  3. Geben Sie entweder none oder disk für den SessionLogsDestination-Parameter an. Speichern Sie Ihre Änderungen.

  4. Starten Sie SSM Agent neu.

Wenn Sie disk für den SessionLogsDestination-Parameter angegeben haben, können Sie überprüfen, ob die temporäre Protokolldatei SSM Agent erstellt wird, indem Sie eine neue Sitzung starten und die ipcTempFile.log-Datei dann am folgenden Speicherort suchen:

  • Linux://var/lib/amazon/ssmtarget ID/Sitzung/Orchestration/ session ID /Standard_Stream/ .log ipcTempFile

  • macOS: opt/aws/ssm/datatarget ID/session ID/sitzung/orchestration/ ipcTempFile /Standard_Stream/ .log

  • Windows Server: C:\\ AmazonProgramData\ SSM\\ SitzungInstanceData\ target ID Orchestrierung\\ Standard_Streamsession ID\ .log ipcTempFile

Anmerkung

Standardmäßig wird die temporäre Protokolldatei 14 Tage lang auf der Instance gespeichert.

Wenn Sie den SessionLogsDestination-Parameter für mehrere Instances aktualisieren möchten, empfehlen wir Ihnen, ein SSM-Dokument zu erstellen, das die neue Konfiguration spezifiziert. Anschließend können Sie Systems Manager Run Command verwenden, um die Änderung auf Ihren Instances zu implementieren. Weitere Informationen finden Sie unter Eigene AWS Systems Manager Dokumente schreiben (Blog) und. Ausführen von Befehlen auf verwalteten Knoten