Importe los eventos de las rutas a un banco de datos de eventos con el AWS CLI - AWS CloudTrail
Cómo prepararse para importar eventos de registros de seguimientoCrear un almacén de datos de eventos e importar eventos de registros de seguimiento al almacén de datos de eventos

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.

Importe los eventos de las rutas a un banco de datos de eventos con el AWS CLI

Esta sección muestra cómo crear y configurar un almacén de datos de eventos mediante la ejecución del comando create-event-data-store y, a continuación, cómo importar los eventos a ese almacén de datos de eventos mediante el comando start-import. Para obtener más información acerca de cómo importar eventos de registro de seguimiento, consulte Copia de los eventos de seguimiento en un almacén de datos de eventos.

Cómo prepararse para importar eventos de registros de seguimiento

Antes de importar los eventos de registro de seguimiento, realice los siguientes preparativos.

  • Asegúrese de tener un rol con los permisos necesarios para importar eventos de registros de seguimiento a un almacén de datos de eventos.

  • Determine el valor de --billing-mode que desea especificar para el almacén de datos de eventos. El --billing-mode determina el costo de la incorporación y el almacenamiento de los eventos, así como el periodo de retención predeterminado y máximo del almacén de datos de eventos.

    Al importar eventos de senderos a CloudTrail Lake, CloudTrail descomprime los registros que están almacenados en formato gzip (comprimido). A continuación, CloudTrail copia los eventos contenidos en los registros en el almacén de datos de eventos. El tamaño de los datos sin comprimir podría ser mayor que el tamaño real del almacenamiento de Amazon S3. Para obtener una estimación general del tamaño de los datos sin comprimir, multiplique por 10 el tamaño de los registros del bucket de S3. Puede usar esta estimación para elegir el valor de --billing-mode para su caso de uso.

  • Determine el valor que desea especificar para el--retention-period. CloudTrail no copiará un evento si eventTime es anterior al período de retención especificado.

    Para determinar el periodo de retención adecuado, tome la suma del evento más antiguo que desea copiar en días y el número de días que desea retener los eventos en el almacén de datos de eventos, como se muestra en esta ecuación:

    Periodo de retención = oldest-event-in-days + number-days-to-retain

    Por ejemplo, si el evento más antiguo que va a copiar tiene 45 días y desea conservar los eventos en el almacén de datos de eventos durante otros 45 días, debe establecer el periodo de retención en 90 días.

  • Decida si desea utilizar el almacén de datos de eventos para analizar cualquier evento futuro. Si no desea incorporar ningún evento futuro, incluya el parámetro --no-start-ingestion al crear el almacén de datos de eventos. De forma predeterminada, el almacén de datos de eventos comienza a incorporar eventos cuando se crea.

Crear un almacén de datos de eventos e importar eventos de registros de seguimiento al almacén de datos de eventos

  1. Ejecute el comando create-event-data-store para crear el nuevo almacén de datos de eventos. En este ejemplo, el --retention-period se establece en 120 porque el evento más antiguo que se está copiando tiene 90 días y queremos retener los eventos durante 30 días. El parámetro --no-start-ingestion está establecido porque no queremos incorporar ningún evento futuro. En este ejemplo, --billing-mode no se estableció porque estamos usando el valor predeterminado EXTENDABLE_RETENTION_PRICING ya que esperamos incorporar menos de 25 TB de datos de eventos.

    nota

    Si va a crear el almacén de datos de eventos para reemplazar su registro de seguimiento, le recomendamos que configure los --advanced-event-selectors de forma que coincidan con los selectores de eventos de su registro de seguimiento para asegurarse de tener la misma cobertura de eventos. De forma predeterminada, los almacenes de datos de eventos registran eventos de administración.

    aws cloudtrail create-event-data-store  --name import-trail-eds  --retention-period 120 --no-start-ingestion

    Lo que sigue es un ejemplo de respuesta:

    {
    "EventDataStoreArn": "arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLEa-4357-45cd-bce5-17ec652719d9",
    "Name": "import-trail-eds",
    "Status": "CREATED",
    "AdvancedEventSelectors": [
        {
            "Name": "Default management events",
            "FieldSelectors": [
                {
                    "Field": "eventCategory",
                    "Equals": [
                        "Management"
                    ]
                }
            ]
        }
    ],
    "MultiRegionEnabled": true,
    "OrganizationEnabled": false,
    "BillingMode": "EXTENDABLE_RETENTION_PRICING",
    "RetentionPeriod": 120,
    "TerminationProtectionEnabled": true,
    "CreatedTimestamp": "2023-11-09T16:52:25.444000+00:00",
    "UpdatedTimestamp": "2023-11-09T16:52:25.569000+00:00"
}

    El primer Status es CREATED para que ejecutemos el comando get-event-data-store para comprobar que se ha detenido la incorporación.

    aws cloudtrail get-event-data-store --event-data-store eds-id

    La respuesta muestra que el Status es ahora STOPPED_INGESTION, lo que indica que el almacén de datos de eventos no está incorporando eventos en vivo.

    {
    "EventDataStoreArn": "arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLEa-4357-45cd-bce5-17ec652719d9",
    "Name": "import-trail-eds",
    "Status": "STOPPED_INGESTION",
    "AdvancedEventSelectors": [
        {
            "Name": "Default management events",
            "FieldSelectors": [
                {
                    "Field": "eventCategory",
                    "Equals": [
                        "Management"
                    ]
                }
            ]
        }
    ],
    "MultiRegionEnabled": true,
    "OrganizationEnabled": false,
    "BillingMode": "EXTENDABLE_RETENTION_PRICING",
    "RetentionPeriod": 120,
    "TerminationProtectionEnabled": true,
    "CreatedTimestamp": "2023-11-09T16:52:25.444000+00:00",
    "UpdatedTimestamp": "2023-11-09T16:52:25.569000+00:00"
}

  2. Ejecute el comando start-import para importar los eventos de registro de seguimiento al almacén de datos de eventos creado en el paso 1. Especifique el ARN (o el sufijo de ID del ARN) del almacén de datos de eventos como valor del parámetro --destinations. Para --start-event-time, especifique el eventTime para el evento más antiguo que desee copiar y, para --end-event-time, especifique el eventTime del evento más reciente que desee copiar. Para --import-source especificar el URI de S3 para el depósito de S3 que contiene los registros de seguimiento, el Región de AWS del depósito de S3 y el ARN del rol utilizado para importar los eventos de seguimiento. 

    aws cloudtrail start-import \
--destinations ["arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLEa-4357-45cd-bce5-17ec652719d9"] \
--start-event-time 2023-08-11T16:08:12.934000+00:00 \
--end-event-time 2023-11-09T17:08:20.705000+00:00 \
--import-source {"S3": {"S3LocationUri": "s3://aws-cloudtrail-logs-123456789012-612ff1f6/AWSLogs/123456789012/CloudTrail/","S3BucketRegion":"us-east-1","S3BucketAccessRoleArn": "arn:aws:iam::123456789012:role/service-role/CloudTrailLake-us-east-1-copy-events-eds"}}

    A continuación, se muestra un ejemplo de respuesta.

    {
   "CreatedTimestamp": "2023-11-09T17:08:20.705000+00:00",
   "Destinations": [
        "arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLEa-4357-45cd-bce5-17ec652719d9"
    ],
   "EndEventTime": "2023-11-09T17:08:20.705000+00:00",
   "ImportId": "EXAMPLEe-7be2-4658-9204-b38c3257fcd1",
   "ImportSource": { 
      "S3": { 
         "S3BucketAccessRoleArn": "arn:aws:iam::123456789012:role/service-role/CloudTrailLake-us-east-1-copy-events-eds",
         "S3BucketRegion":"us-east-1",
         "S3LocationUri": "s3://aws-cloudtrail-logs-123456789012-111ff1f6/AWSLogs/123456789012/CloudTrail/"
      }
   },
   "ImportStatus": "INITIALIZING",
   "StartEventTime": "2023-08-11T16:08:12.934000+00:00",
   "UpdatedTimestamp": "2023-11-09T17:08:20.806000+00:00"
}

  3. Ejecute el comando get-import para obtener información acerca de la importación.

    aws cloudtrail get-import --import-id import-id

    A continuación, se muestra un ejemplo de respuesta.

    {
    "ImportId": "EXAMPLEe-7be2-4658-9204-b38c3EXAMPLE",
    "Destinations": [
        "arn:aws:cloudtrail:us-east-1:123456789012:eventdatastore/EXAMPLEa-4357-45cd-bce5-17ec652719d9"
    ],
    "ImportSource": {
        "S3": {
            "S3LocationUri": "s3://aws-cloudtrail-logs-123456789012-111ff1f6/AWSLogs/123456789012/CloudTrail/",
            "S3BucketRegion":"us-east-1",
            "S3BucketAccessRoleArn": "arn:aws:iam::123456789012:role/service-role/CloudTrailLake-us-east-1-copy-events-eds"
        }
    },
    "StartEventTime": "2023-08-11T16:08:12.934000+00:00",
    "EndEventTime": "2023-11-09T17:08:20.705000+00:00",
    "ImportStatus": "COMPLETED",
    "CreatedTimestamp": "2023-11-09T17:08:20.705000+00:00",
    "ImportStatistics": {
        "PrefixesFound": 1548,
        "PrefixesCompleted": 1548,
        "FilesCompleted": 92845,
        "EventsCompleted": 577249,
        "FailedEntries": 0
    }
}

    Una importación finaliza con un ImportStatus COMPLETED si no hubo errores o FAILED si los hubo.

    Si la importación tuvo FailedEntries, puede ejecutar el comandolist-import-failures para obtener una lista de errores.

    aws cloudtrail list-import-failures --import-id import-id

    Para volver a intentar una importación que tuvo errores, ejecute el comando start-import solo con el parámetro --import-id. Al volver a intentar una importación, la CloudTrail reanuda en la ubicación en la que se produjo el error.

    aws cloudtrail start-import --import-id import-id