# Ejemplos de registros de CloudWatch que utilizan la AWS CLI
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con registros de CloudWatch.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `create-log-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-log-group`.
**AWS CLI**
El siguiente comando crea un grupo de registro denominado `my-logs`:
```
aws logs create-log-group --log-group-name my-logs
```
+ Para obtener información sobre la API, consulte [CreateLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-group.html) en la *Referencia de comandos de la AWS CLI*.
### `create-log-stream`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-log-stream`.
**AWS CLI**
El siguiente comando crea un flujo de registro denominado `20150601` en el grupo de registro `my-logs`:
```
aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601
```
+ Para obtener información sobre la API, consulte [CreateLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-stream.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-log-group`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-log-group`.
**AWS CLI**
El siguiente comando elimina un grupo de registro denominado `my-logs`:
```
aws logs delete-log-group --log-group-name my-logs
```
+ Para obtener información sobre la API, consulte [DeleteLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-group.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-log-stream`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-log-stream`.
**AWS CLI**
El siguiente comando elimina un flujo de registro denominado `20150531` de un grupo de registro denominado `my-logs`:
```
aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531
```
+ Para obtener información sobre la API, consulte [DeleteLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-stream.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-retention-policy`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-retention-policy`.
**AWS CLI**
El siguiente comando elimina la política de retención que se aplicó anteriormente a un grupo de registro denominado `my-logs`:
```
aws logs delete-retention-policy --log-group-name my-logs
```
+ Para obtener información sobre la API, consulte [DeleteRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-retention-policy.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-log-groups`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-log-groups`.
**AWS CLI**
El siguiente comando describe un grupo de registro denominado `my-logs`:
```
aws logs describe-log-groups --log-group-name-prefix my-logs
```
Salida:
```
{
"logGroups": [
{
"storedBytes": 0,
"metricFilterCount": 0,
"creationTime": 1433189500783,
"logGroupName": "my-logs",
"retentionInDays": 5,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*"
}
]
}
```
+ Para obtener información sobre la API, consulte [DescribeLogGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-groups.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-log-streams`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-log-streams`.
**AWS CLI**
El siguiente comando muestra todos los flujos de registro que comienzan con el prefijo `2015` del grupo de registro `my-logs`:
```
aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015
```
Salida:
```
{
"logStreams": [
{
"creationTime": 1433189871774,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531",
"logStreamName": "20150531",
"storedBytes": 0
},
{
"creationTime": 1433189873898,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601",
"logStreamName": "20150601",
"storedBytes": 0
}
]
}
```
+ Para obtener información sobre la API, consulte [DescribeLogStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-streams.html) en la *Referencia de comandos de la AWS CLI*.
### `get-log-events`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-log-events`.
**AWS CLI**
El siguiente comando recupera eventos de registro de un flujo de registro denominado `20150601` en el grupo de registro `my-logs`:
```
aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601
```
Salida:
```
{
"nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130",
"events": [
{
"ingestionTime": 1433190494190,
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"ingestionTime": 1433190516679,
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"ingestionTime": 1433190494190,
"timestamp": 1433190184358,
"message": "Example Event 2"
}
],
"nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120"
}
```
+ Para obtener información sobre la API, consulte [GetLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/get-log-events.html) en la *Referencia de comandos de la AWS CLI*.
### `put-log-events`
En el siguiente ejemplo de código, se muestra cómo utilizar `put-log-events`.
**AWS CLI**
El siguiente comando incluye eventos de registro en un flujo de registro denominado `20150601` en el grupo de registro `my-logs`:
```
aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events
```
Salida:
```
{
"nextSequenceToken": "49542672486831074009579604567656788214806863282469607346"
}
```
En el ejemplo anterior, se lee una matriz JSON de eventos de un archivo denominado `events` en el directorio actual:
```
[
{
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"timestamp": 1433190184358,
"message": "Example Event 2"
},
{
"timestamp": 1433190184360,
"message": "Example Event 3"
}
]
```
Cada llamada posterior requiere que el siguiente token de secuencia, proporcionado por la llamada anterior, se especifique con la opción de token de secuencia:
```
aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346"
```
Salida:
```
{
"nextSequenceToken": "49542672486831074009579604567900991230369019956308219826"
}
```
+ Para obtener información acerca de la API, consulte [PutLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-log-events.html) en la *Referencia de comandos de la AWS CLI*.
### `put-retention-policy`
En el siguiente ejemplo de código, se muestra cómo utilizar `put-retention-policy`.
**AWS CLI**
El siguiente comando agrega una política de retención de 5 días a un grupo de registro denominado `my-logs`:
```
aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5
```
+ Para obtener información sobre la API, consulte [PutRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-retention-policy.html) en la *Referencia de comandos de la AWS CLI*.