View a markdown version of this page

Registro que requiere permisos adicionales [V2] - Amazon CloudWatch Logs
Ejemplos de configuración de entrega de registros

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.

Registro que requiere permisos adicionales [V2]

Algunos AWS servicios utilizan un método nuevo para enviar sus registros. Se trata de un método flexible que le permite configurar la entrega de registros desde estos servicios a uno o más de los siguientes destinos: CloudWatch Logs, Amazon S3 o Firehose y X-Ray para la entrega de rastreo.

La entrega de un registro funcional consta de tres elementos:

  • Una DeliverySource, que es un objeto lógico que representa el recurso que realmente envía los registros.

  • Un DeliveryDestination, que es un objeto lógico que representa el destino de entrega real.

  • Un Delivery, que conecta un origen de entrega con el destino de la entrega.

Para configurar la entrega de registros entre un AWS servicio compatible y un destino, debe hacer lo siguiente:

  • Cree una fuente de entrega con PutDeliverySource.

  • Cree un destino de entrega con PutDeliveryDestination.

  • Si entrega registros entre cuentas, solo puede usar los destinos de Amazon S3 y Firehose. Debe utilizarla PutDeliveryDestinationPolicyen la cuenta de destino para asignar una IAM política al destino. Esta política autoriza la creación de una entrega desde el origen de entrega de la cuenta A hasta el destino de la entrega en la cuenta B. En el caso de las entregas entre cuentas, debe crear manualmente las políticas de permisos. Para ver ejemplos de configuración, consulteCross-account ejemplo de entrega.

  • Cree una entrega combinando exactamente una fuente de entrega y un destino de entrega, mediante CreateDelivery.

Ejemplos de configuración de entrega de registros

Los siguientes ejemplos crean el origen y el destino de la entrega en la misma AWS cuenta. Sustituya el ARN y el tipo de registro del recurso de origen por valores compatibles con el servicio que genera los registros. Estos ejemplos no requieren una política de destino de entrega.

Cree una fuente de entrega para CloudWatch los registros de ejecución de consultas de Logs Insights

En el siguiente ejemplo, se crea una fuente de entrega para CloudWatch los registros de ejecución de consultas de Logs Insights. Para conocer los requisitos de ARN completos logType y de recursos, consulte. PutDeliverySource

nota

El comodín final log-group:* es obligatorio porque los registros de ejecución de consultas no están vinculados a un grupo de registros. AWS no admite un ARN de grupo de registros específico para este tipo de registro.

aws logs put-delivery-source \
    --name insights-query-logs \
    --resource-arn arn:aws:logs:region:account-id:log-group:* \
    --log-type INSIGHTS_QUERY_LOGS

Cree una fuente de entrega

Cree la fuente de entrega y, a continuación, utilice uno de los ejemplos de destino que aparecen a continuación.

aws logs put-delivery-source \
    --name my-delivery-source \
    --resource-arn source-resource-arn \
    --log-type log-type

Cree una entrega a CloudWatch Logs

Cree un destino de entrega para un grupo de registros existente.

aws logs put-delivery-destination \
    --name my-cwl-delivery-destination \
    --delivery-destination-configuration \
    "destinationResourceArn=arn:aws:logs:region:account-id:log-group:log-group-name"

Cree la entrega.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-cwl-delivery-destination

Crear una entrega a Amazon S3

Cree un destino de entrega para un depósito existente.

aws logs put-delivery-destination \
    --name my-s3-delivery-destination \
    --delivery-destination-configuration \
    "destinationResourceArn=arn:aws:s3:::bucket-name"

Crea la entrega.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-s3-delivery-destination

Para configurar un prefijo, ruta de sufijo o Hive-compatible ruta de destino, consulte. Formato de clave de objeto de Amazon S3

Crea una entrega a Firehose

Crea un destino de entrega para un flujo de DirectPut entrega existente.

aws logs put-delivery-destination \
    --name my-firehose-delivery-destination \
    --delivery-destination-configuration \
    "destinationResourceArn=arn:aws:firehose:region:account-id:deliverystream/delivery-stream-name"

Crea la entrega.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-firehose-delivery-destination

Crea una entrega para X-Ray

Para rastrear la entrega, usa un servicio de origen y un tipo de registro que admitan la entrega a X-Ray. Cree el destino X-Ray de entrega lógico.

aws logs put-delivery-destination \
    --name my-xray-delivery-destination \
    --delivery-destination-type XRAY

Cree la entrega.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-xray-delivery-destination

Para verificar la entrega, usa el siguiente comando.

aws logs describe-deliveries \
    --delivery-source-name-prefix my-delivery-source

En las siguientes secciones, se brindan detalles de los permisos que debe tener al iniciar sesión para configurar la entrega de registros en cada tipo de destino, mediante el proceso V2. Estos permisos se pueden conceder a un rol de IAM con el que haya iniciado sesión.

importante

Es su responsabilidad eliminar los recursos de entrega de registros después de eliminar el recurso que genera los registros. Para ello, siga estos pasos.

  1. Elimine el Delivery mediante la DeleteDeliveryoperación.

  2. Elimine el DeliverySource mediante la DeleteDeliverySourceoperación.

  3. Si lo DeliveryDestination asociado al DeliverySource que acaba de eliminar se usa solo para esto específicoDeliverySource, puede eliminarlo mediante la DeleteDeliveryDestinationsoperación.

Contenido