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.
Temas
Acciones
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-namemy-logs-
Para obtener información sobre la API, consulte CreateLogGroup
en la Referencia de comandos de la AWS CLI.
-
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
20150601en el grupo de registromy-logs:aws logs create-log-stream --log-group-namemy-logs--log-stream-name20150601-
Para obtener información sobre la API, consulte CreateLogStream
en la Referencia de comandos de la AWS CLI.
-
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-namemy-logs-
Para obtener información sobre la API, consulte DeleteLogGroup
en la Referencia de comandos de la AWS CLI.
-
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
20150531de un grupo de registro denominadomy-logs:aws logs delete-log-stream --log-group-namemy-logs--log-stream-name20150531-
Para obtener información sobre la API, consulte DeleteLogStream
en la Referencia de comandos de la AWS CLI.
-
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-namemy-logs-
Para obtener información sobre la API, consulte DeleteRetentionPolicy
en la Referencia de comandos de la AWS CLI.
-
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-prefixmy-logsSalida:
{ "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
en la Referencia de comandos de la AWS CLI.
-
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
2015del grupo de registromy-logs:aws logs describe-log-streams --log-group-namemy-logs--log-stream-name-prefix2015Salida:
{ "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
en la Referencia de comandos de la AWS CLI.
-
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
20150601en el grupo de registromy-logs:aws logs get-log-events --log-group-namemy-logs--log-stream-name20150601Salida:
{ "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
en la Referencia de comandos de la AWS CLI.
-
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
20150601en el grupo de registromy-logs:aws logs put-log-events --log-group-namemy-logs--log-stream-name20150601--log-eventsfile://eventsSalida:
{ "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346" }En el ejemplo anterior, se lee una matriz JSON de eventos de un archivo denominado
eventsen 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-namemy-logs--log-stream-name20150601--log-eventsfile://events2--sequence-token"49542672486831074009579604567656788214806863282469607346"Salida:
{ "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826" }-
Para obtener información acerca de la API, consulte PutLogEvents
en la Referencia de comandos de la AWS CLI.
-
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-namemy-logs--retention-in-days5-
Para obtener información sobre la API, consulte PutRetentionPolicy
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar start-live-tail.
- AWS CLI
-
El siguiente comando inicia una sesión de Live Tail en un grupo de registro denominado
my-logs:aws logs start-live-tail --log-group-identifiersarn:aws:logs:us-east-1:111111222222:log-group:my-logsEl siguiente comando inicia una sesión de Live Tail en un grupo de registro denominado
my-logsen modo interactivo:aws logs start-live-tail --log-group-identifiersarn:aws:logs:us-east-1:111111222222:log-group:my-logs--modeinteractiveEn el modo interactivo, puede resaltar hasta cinco términos en los registros supervisados. Los códigos de gravedad aparecen resaltados de forma predeterminada. Pulse
hpara entrar en el modo de resaltado y, a continuación, escriba los términos que desee resaltar, uno por uno, y pulse Intro. Pulsecpara borrar los términos resaltados. Pulsetpara cambiar el formato entre JSON/texto sin formato. PulseEscpara salir de la sesión de Live Tail. Pulse las teclasup/downpara desplazarse arriba o abajo entre los eventos del registro; useCtrl + u/Ctrl + dpara desplazarse más rápido. Pulseqpara desplazarse hasta los últimos eventos del registro.-
Para obtener información acerca de la API, consulte StartLiveTail
en Referencia de comandos de la AWS CLI.
-