CloudWatch Registra ejemplos usando AWS CLI - AWS Command Line Interface

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

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.

CloudWatch Registra ejemplos usando AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso AWS Command Line Interface de CloudWatch registros.

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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usarlocreate-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 API obtener más información, consulte CreateLogGroupla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-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 API obtener más información, consulte CreateLogStreamla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-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 API obtener más información, consulte DeleteLogGroupla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-log-stream.

AWS CLI

El siguiente comando elimina un flujo de registro denominado 20150531 de un grupo de registros denominadomy-logs:

aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531
  • Para API obtener más información, consulte DeleteLogStreamla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-retention-policy.

AWS CLI

El siguiente comando elimina la política de retención que se aplicó anteriormente a un grupo de registros denominadomy-logs:

aws logs delete-retention-policy --log-group-name my-logs

El siguiente ejemplo de código muestra cómo usarlodescribe-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 API obtener más información, consulte DescribeLogGroupsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-log-streams.

AWS CLI

El siguiente comando muestra todos los flujos de registro que comienzan por el prefijo 2015 del grupo my-logs de registros:

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 API obtener más información, consulte DescribeLogStreamsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloget-log-events.

AWS CLI

El siguiente comando recupera los eventos de registro de un flujo de registro denominado 20150601 en el grupo my-logs de registros:

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 API obtener más información, consulte GetLogEventsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloput-log-events.

AWS CLI

El siguiente comando coloca los eventos de registro en un flujo de registro denominado 20150601 en el grupo de registrosmy-logs:

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events

Salida:

{ "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346" }

El ejemplo anterior lee una JSON matriz de eventos de un archivo nombrado 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 API obtener más información, consulte PutLogEventsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloput-retention-policy.

AWS CLI

El siguiente comando agrega una política de retención de 5 días a un grupo de registros denominadomy-logs:

aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5
  • Para API obtener más información, consulte PutRetentionPolicyla Referencia de AWS CLI comandos.