

# 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
<a name="action-logs-getting-started-prerequisites"></a>

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

### Permisos de IAM necesarios
<a name="action-logs-iam-permissions"></a>

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
<a name="action-logs-destination-policy"></a>

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
<a name="action-logs-enable-console"></a>

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](https://console.aws.amazon.com/ecs/v2).

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

1. Elija la pestaña **Configuración**.

1. Seleccione **Agregar** en la sección **Registros de acciones**.

1. 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.

1. Seleccione **Save**.

## Habilitación de Action Logs con las API de Registros de CloudWatch
<a name="action-logs-enable-api"></a>

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
   ```

1. 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}}"}'
   ```

1. 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
<a name="action-logs-verify-delivery"></a>

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.

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

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

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

## Eliminación de Action Logs
<a name="action-logs-delete"></a>

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}}
   ```

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

   ```
   aws logs delete-delivery-source \
       --name {{my-ecs-action-logs}}
   ```

1. 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
<a name="action-logs-next-steps"></a>

Tras activar Action Logs, utilice los siguientes recursos para supervisar los clústeres de Amazon ECS y solucionar sus problemas:
+ [Solución de problemas con Amazon ECS Action Logs](action-logs-troubleshooting.md)