View a markdown version of this page

Introducción a Amazon ECS Action Logs - Amazon Elastic Container Service
Requisitos previosHabilitación de Action Logs mediante la consola de Amazon ECSHabilitación de Action Logs con las API de Registros de CloudWatchVerificación de la entrega de los registrosEliminación de Action LogsSiguientes pasos

Introducción a Amazon ECS Action Logs

Amazon ECS Action Logs utiliza el mecanismo de entrega de registros suministrados de Registros de Amazon CloudWatch para publicar registros detallados de las acciones del servicio en el destino que prefiera. Al habilitar Action Logs, puede ver todos los pasos que Amazon ECS lleva a cabo durante las implementaciones y las operaciones de daemons, como el aprovisionamiento de la infraestructura, el registro de los recursos y la especificación de los errores. Esta visibilidad lo ayuda a solucionar los problemas sin tener que ponerse en contacto con AWS Support y reduce el tiempo necesario para identificar las causas principales. Puede habilitar Action Logs para sus clústeres mediante la consola de Amazon ECS o las API de Registros de CloudWatch.

Requisitos previos

Antes de habilitar Action Logs, compruebe que su identidad de IAM tenga los permisos necesarios.

Permisos de IAM necesarios

Su identidad de IAM debe tener los siguientes permisos para poder habilitar y administrar Action Logs:

{
    "Effect": "Allow",
    "Action": [
        "logs:PutDeliverySource",
        "logs:PutDeliveryDestination",
        "logs:CreateDelivery",
        "logs:GetDelivery",
        "ecs:AllowVendedLogDeliveryForResource"
    ],
    "Resource": "*"
}

Política de recursos de destino

El grupo de registros de Registros de CloudWatch del destino debe tener una política de recursos que permita al servicio delivery.logs.amazonaws.com escribir registros. Agregue la siguiente instrucción a la política de recursos del grupo de registros:

{
    "Effect": "Allow",
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": [
        "logs:CreateLogStream",
        "logs:PutLogEvents"
    ],
    "Resource": "arn:aws:logs:region:account-id:log-group:log-group-name:log-stream:*"
}

Habilitación de Action Logs mediante la consola de Amazon ECS

Puede habilitar los registros de acciones directamente desde la página de detalles del clúster en la consola de Amazon ECS.

Para habilitar los registros de acciones desde la consola

  1. Abra la consola en https://console.aws.amazon.com/ecs/v2.

  2. En el panel de navegación, seleccione Clústeres y, luego, seleccione el clúster.

  3. Elija la pestaña Configuración.

  4. Seleccione Agregar en la sección Registros de acciones.

  5. En Destination (Destino), elija una de las siguientes opciones:

    • Registros de CloudWatch (predeterminado)

    • Amazon S3

    • Amazon Data Firehose

    Para Registros de CloudWatch, Amazon ECS crea un grupo de registros predeterminado denominado /aws/vendedlogs/ecs/action-logs/cluster-name con un período de retención de 7 días.

  6. Seleccione Save.

Habilitación de Action Logs con las API de Registros de CloudWatch

Puede habilitar los registros de acciones mediante programación usando las API de entrega de registros suministrados de Registros de CloudWatch. Este enfoque requiere tres pasos: registrar el origen de la entrega, configurar el destino y crear la entrega.

Para habilitar Action Logs mediante la AWS CLI

  1. Registre el origen de entrega ejecutando el siguiente comando:

    aws logs put-delivery-source \
    --name my-ecs-action-logs \
    --resource-arn arn:aws:ecs:region:account-id:cluster/cluster-name \
    --log-type EcsActionLogs

  2. Configure el destino de entrega ejecutando el siguiente comando:

    aws logs put-delivery-destination \
    --name my-ecs-logs-destination \
    --output-format json \
    --delivery-destination-configuration '{"destinationResourceArn": "arn:aws:logs:region:account-id:log-group:/aws/vendedlogs/ecs/action-logs/cluster-name"}'

  3. Cree la entrega para vincular el origen con el destino ejecutando el siguiente comando:

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

Verificación de la entrega de los registros

Después de habilitar los registros de acciones, compruebe que los registros se entreguen a su destino.

Para verificar la entrega de los registros

  1. Desencadene una acción en su clúster. Por ejemplo, cree o actualice un servicio de daemon.

  2. Abra la consola de CloudWatch en https://console.aws.amazon.com/cloudwatch/.

  3. En el panel de navegación, seleccione Grupos de registro.

  4. Seleccione su grupo de registros de Action Logs y compruebe que aparezcan nuevos flujos de registro.

Eliminación de Action Logs

Puede eliminar los registros de acciones mediante la AWS CLI o la consola Amazon ECS.

Para eliminar los registros de acciones, su identidad de IAM debe tener los siguientes permisos adicionales:

{
    "Effect": "Allow",
    "Action": [
        "logs:DeleteDelivery",
        "logs:DeleteDeliverySource",
        "logs:DeleteDeliveryDestination"
    ],
    "Resource": "*"
}
Para eliminar Action Logs mediante la AWS CLI

  1. Elimine la entrega ejecutando el siguiente comando:

    aws logs delete-delivery \
    --delivery-id delivery-id

  2. Elimine el origen de entrega ejecutando el siguiente comando:

    aws logs delete-delivery-source \
    --name my-ecs-action-logs

  3. Elimine el destino de entrega ejecutando el siguiente comando.

    aws logs delete-delivery-destination \
    --name my-ecs-logs-destination

Para eliminar los registros de acciones mediante la consola, vaya a la página de detalles del clúster, seleccione la pestaña Configuración y, a continuación, elija Eliminar en la sección Registros de acciones.

Siguientes pasos

Tras activar Action Logs, utilice los siguientes recursos para supervisar los clústeres de Amazon ECS y solucionar sus problemas: