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.
# Inicio rápido: instale y configure el agente CloudWatch Logs en una instancia EC2 de Linux en el momento del lanzamiento
**sugerencia**
El antiguo agente de CloudWatch registros que se describe en esta sección está en vías de quedar obsoleto. Le recomendamos encarecidamente que, en su lugar, utilice el nuevo CloudWatch agente unificado, que puede recopilar tanto registros como métricas. Además, el agente CloudWatch Logs anterior requiere Python 3.3 o una versión anterior, y estas versiones no se instalan en las nuevas instancias de EC2 de forma predeterminada. Para obtener más información sobre el CloudWatch agente unificado, consulte [Instalación del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html).
En el resto de esta sección se explica el uso del antiguo agente de CloudWatch Logs.
## Instalación del antiguo agente de CloudWatch Logs en una instancia EC2 de Linux en el momento del lanzamiento
Puede usar los datos de usuario de Amazon EC2, una función de Amazon EC2 que permite transferir información paramétrica a la instancia en el momento del lanzamiento, para instalar y configurar CloudWatch el agente Logs en esa instancia. Para pasar la información de instalación y configuración del agente CloudWatch Logs a Amazon EC2, puede proporcionar el archivo de configuración en una ubicación de red, como un bucket de Amazon S3.
No se admite configurar varias fuentes de registro para enviar datos a un único flujo de registro.
**Requisito previo**
Cree un archivo de configuración de agente que describa todos los grupos de registro y flujos de registro. Se trata de un archivo de texto que describe los archivos de registros que monitorear, así como los grupos de registro y los flujos de registro para cargarlos. El agente consume este archivo de configuración y comienza a monitorear y a cargar todos los archivos de registros descritos en el mismo. Para obtener más información sobre la configuración en el archivo de configuración del agente, consulte [CloudWatch Registra la referencia del agente](AgentReference.md).
A continuación, se muestra un ejemplo de archivo de configuración del agente para Amazon Linux 2.
```
[general]
state_file = /var/lib/awslogs/state/agent-state
[/var/log/messages]
file = /var/log/messages
log_group_name = /var/log/messages
log_stream_name = {instance_id}
datetime_format = %b %d %H:%M:%S
```
A continuación, se muestra un ejemplo de archivo de configuración del agente para Ubuntu.
```
[general]
state_file = /var/awslogs/state/agent-state
[/var/log/syslog]
file = /var/log/syslog
log_group_name = /var/log/syslog
log_stream_name = {instance_id}
datetime_format = %b %d %H:%M:%S
```
**Para configurar su rol de IAM**
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. En el panel de navegación, elija **Policies (Políticas)**, **Create Policy (Crear política)**.
1. En la página **Create Policy (Crear política)**, en **Create Your Own Policy (Crear su propia política)**, elija **Select (Seleccionar)**. Para obtener más información acerca de la creación de políticas personalizadas, consulte [Políticas de IAM para Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-policies-for-amazon-ec2.html) en la *Guía del usuario de Amazon EC2*.
1. En la página **Review Policy (Revisar políticas)**, en **Policy Name (Nombre de la política)**, escriba un nombre para la política.
1. En **Policy Document (Documento de la política)**, pegue la siguiente política:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents",
"logs:DescribeLogStreams"
],
"Resource": [
"arn:aws:logs:*:*:*"
]
},
{
"Effect": "Allow",
"Action": [
"s3:GetObject"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
------
1. Elija **Create Policy (Crear política)**.
1. En el panel de navegación, elija **Roles (Roles)**, **Create New Role (Crear nuevo rol)**.
1. En la página **Set Role Name (Establecer nombre del rol)**, escriba un nombre de rol y, a continuación, elija **Next Step (Siguiente paso)**.
1. En la página **Select Role Type (Seleccionar tipo de rol)**, elija **Select (Seleccionar)** junto a **Amazon EC2**.
1. En la página **Attach Policy (Adjuntar política)**, en el encabezado de la tabla, elija **Policy Type (Tipo de política)**, **Customer Managed (Administrada por el cliente)**.
1. Seleccione la política de IAM que ha creado y, a continuación, elija **Next Step (Siguiente paso)**.
1. Seleccione **Crear rol**.
Para obtener más información sobre los usuarios y políticas, consulte [Usuarios y grupos de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_WorkingWithGroupsAndUsers.html) y [Administración de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingPolicies.html) en la *Guía del usuario de IAM*.
**Para lanzar una nueva instancia y habilitar Logs CloudWatch**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Elija **Iniciar instancia**.
Para obtener más información, consulte [Lanzamiento de una instancia](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/launching-instance.html) en la *Guía del usuario de Amazon EC2*.
1. En la página **Step 1: Choose an Amazon Machine Image (AMI) (Paso 1: elegir una Amazon Machine Image [AMI])**, seleccione el tipo de instancia de Linux que desea lanzar y, a continuación, en la página **Step 2: Choose an Instance Type (Paso 2: elegir un tipo de instancia)**, elija **Next: Configure Instance Details (Siguiente: configurar detalles de la instancia)**.
Asegúrese de que [cloud-init](http://cloudinit.readthedocs.org/en/latest/index.html) se incluye en la Amazon Machine Image (AMI). Amazon Linux AMIs, y AMIs para Ubuntu y RHEL, ya incluyen cloud-init, pero es posible que CentOS y otros AMIs no. AWS Marketplace
1. En la página **Step 3: Configure Instance Details (Paso 3: configurar detalles de la instancia)**, en **IAM role (Rol de IAM)**, seleccione el rol de IAM que creó.
1. En **Advanced Details (Detalles avanzados)**, en **User data (Datos de usuario)**, pegue el siguiente script en el cuadro. A continuación, para actualizar el script, cambie el valor de la opción **-c** a la ubicación de su archivo de configuración del agente:
```
#!/bin/bash
curl https://s3.amazonaws.com/aws-cloudwatch/downloads/latest/awslogs-agent-setup.py -O
chmod +x ./awslogs-agent-setup.py
./awslogs-agent-setup.py -n -r us-east-1 -c {{s3://amzn-s3-demo-bucket/my-config-file}}
```
1. Realice los demás cambios en la instancia, revise la configuración de lanzamiento y, a continuación, elija **Launch (Lanzar)**.
1. Debería ver el grupo de registros y el flujo de registros recién creados en la CloudWatch consola después de que el agente haya estado ejecutándose durante unos instantes.
Para obtener más información, consulte [Vea los datos de registro enviados a Logs CloudWatch](Working-with-log-groups-and-streams.md#ViewingLogData).