Administrador de incidentes de AWS Systems Manager ya no está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de Administrador de incidentes de AWS Systems Manager.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Exportación de datos de Incident Manager

En este tema se describe cómo utilizar una secuencia de comandos de Python para exportar registros de incidentes y análisis posteriores a los incidentes desde Administrador de incidentes de AWS Systems Manager. El script exporta los datos a archivos JSON estructurados para su posterior análisis o archivado.

¿Qué puede exportar

El script exporta los siguientes datos:

Requisitos previos

Antes de empezar, asegúrese de que tiene lo siguiente:

Permisos de IAM necesarios

Para usar este script, asegúrese de tener los siguientes permisos:

Permisos de incidentes de Systems Manager

{
    "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": "*"
        }
    ]
}

Permisos de Systems Manager

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

Estructura de exportación

El script crea la siguiente estructura de directorios para los datos exportados:

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
    └── ...

Ejecutar el script de exportación

Uso básico

Se proporciona el script de exportación de datos de Incident Managerhere. Descargue el script y siga las instrucciones siguientes para ejecutarlo.

Para ejecutar el script con la configuración predeterminada:

python3 export-incident-manager-data.py

Opciones disponibles

Puede personalizar la exportación mediante estas opciones de línea de comandos:

Ejemplos

Exporte desde una región específica mediante un perfil personalizado:

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

Exporte con un registro detallado y límites de prueba:

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

Exportación con límites conservadores para conjuntos de datos grandes:

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

Estructura del archivo de salida

Estructura JSON del registro de incidentes

Cada archivo de registro de incidentes contiene la siguiente estructura:

{
    "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::..."
    }
}

Análisis posterior al incidente (estructura JSON)

Cada archivo de documento de análisis contiene:

{
    "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": "..."
    }
}