Incident Manager-Daten exportieren - Incident Manager

AWS Systems Manager Incident Manager steht neuen Kunden nicht mehr offen. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der AWS Systems Manager Incident 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.

Incident Manager-Daten exportieren

In diesem Thema wird beschrieben, wie Sie ein Python-Skript verwenden, um Ereignisaufzeichnungen und Analysen nach einem Vorfall aus AWS Systems Manager Incident Manager zu exportieren. Das Skript exportiert Daten für weitere Analyse- oder Archivierungszwecke in strukturierte JSON-Dateien.

Was können Sie exportieren

Das Skript exportiert die folgenden Daten:

  • Vollständige Aufzeichnungen über Vorfälle, einschließlich:

    • Zeitleiste der Ereignisse

    • Verwandte Elemente

    • Engagements

    • Automatisierte Ausführungen

    • Ergebnisse zur Sicherheit

    • Tags (Markierungen)

  • Dokumente zur Analyse nach einem Vorfall von Systems Manager

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

  • Python 3.7 oder höher installiert

  • AWS CLI mit den entsprechenden Anmeldeinformationen konfiguriert

  • Die folgenden Python-Pakete sind installiert:

    pip install boto3 python-dateutil

Erforderliche IAM-Berechtigungen

Um dieses Skript verwenden zu können, stellen Sie sicher, dass Sie über die folgenden Berechtigungen verfügen:

Berechtigungen für Systems Manager Incidents

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ssm-incidents:ListIncidentRecords", "ssm-incidents:GetIncidentRecord", "ssm-incidents:ListTimelineEvents", "ssm-incidents:GetTimelineEvent", "ssm-incidents:ListRelatedItems", "ssm-incidents:ListEngagements", "ssm-incidents:GetEngagement", "ssm-incidents:BatchGetIncidentFindings", "ssm-incidents:ListTagsForResource" ], "Resource": "*" } ] }

Systems Manager Manager-Berechtigungen

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ssm:ListDocuments", "ssm:GetDocument", "ssm:GetAutomationExecution" ], "Resource": "*" } ] }

Struktur exportieren

Das Skript erstellt die folgende Verzeichnisstruktur für exportierte Daten:

incident_manager_export_YYYYMMDD_HHMMSS/ ├── incident_records/ │ ├── 20250309_102129_IAD_Service_A_Lambda_High_Latency.json │ ├── 20250314_114820_SecurityFinding_SecurityHubFindings.json │ └── ... └── post_incident_analyses/ ├── 20250310_143022_Root_Cause_Analysis_Service_A.json ├── 20250315_091545_Security_Incident_Review.json └── ...

Das Exportskript wird ausgeführt

Grundlegende Verwendung

Das Incident Manager-Datenexport-Skript wird bereitgestellthere. Bitte laden Sie das Skript herunter und verwenden Sie die folgenden Anweisungen, um das Skript auszuführen.

Um das Skript mit den Standardeinstellungen auszuführen:

python3 export-incident-manager-data.py

Verfügbare Optionen

Sie können den Export mithilfe der folgenden Befehlszeilenoptionen anpassen:

Option Description Standard
--region AWS Region us-east-1
--profile AWS Name des Profils Standardprofil
--verbose, -v Aktivieren Sie die detaillierte Protokollierung FALSE
--limit Maximale Anzahl der zu exportierenden Vorfälle Kein Limit
--timeline-events-limit Maximale Anzahl von Ereignissen pro Vorfall 100
--timeline-details-limit Maximaler Zeitplan für Ereignisdetails pro Vorfall 100
--related-items-limit Maximale Anzahl verwandter Artikel pro Vorfall 50
--engagements-limit Maximale Anzahl an Interaktionen pro Vorfall 20
--analysis-docs-limit Maximale Anzahl an zu exportierenden Analysedokumenten 50

Beispiele

Export aus einer bestimmten Region mithilfe eines benutzerdefinierten Profils:

python3 export-incident-manager-data.py --region us-east-1 --profile my-aws-profile

Export mit ausführlicher Protokollierung und Einschränkungen für Tests:

python3 export-incident-manager-data.py --verbose --limit 5 --timeline-events-limit 10

Export mit konservativen Grenzwerten für große Datensätze:

python3 export-incident-manager-data.py --timeline-events-limit 50 --timeline-details-limit 25

Struktur der Ausgabedatei

JSON-Struktur des Ereignisdatensatzes

Jede Vorfallaufzeichnungsdatei enthält die folgende Struktur:

{ "incident_record": { // Complete incident record from get-incident-record }, "incident_summary": { // Incident summary from list-incident-records }, "incident_source_details": { "from_incident_record": {}, "from_incident_summary": {}, "enhanced_details": { "created_by": "arn:aws:sts::...", "source": "aws.ssm-incidents.custom", "source_analysis": { "source_type": "manual", "creation_method": "human_via_console", "automation_involved": false, "human_created": true } } }, "timeline_events": { "detailed_events": [ { "summary": {}, // From list-timeline-events "details": {} // From get-timeline-event } ], "summary_only_events": [], "metadata": { "total_events_found": 45, "events_with_details": 25, "limits_applied": {} } }, "related_items": { "items": [], "metadata": {} }, "engagements": { "engagements": [], "metadata": {} }, "automation_executions": [], "findings": [], "tags": [], "post_incident_analysis": { "analysis_reference": {}, "metadata": {} }, "export_metadata": { "exported_at": "2025-09-18T...", "region": "us-east-*", "incident_arn": "arn:aws:ssm-incidents::..." } }

JSON-Struktur nach der Analyse des Vorfalls

Jede Analysedokumentdatei enthält:

{ "document_metadata": { // Document metadata from list-documents }, "document_details": { "Name": "037fc5dd-cd86-49bb-9c3d-15720e78798e", "Content": "...", // Full JSON content "DocumentType": "ProblemAnalysis", "CreatedDate": 1234567890, "ReviewStatus": "APPROVED", "AttachmentsContent": [], // ... other fields from get-document }, "export_metadata": { "exported_at": "2025-09-18T...", "region": "us-east-*", "document_name": "..." } }