Acciones de AWS CloudWatch

Esta página proporciona una referencia de las acciones de AWS CloudWatch disponibles en el catálogo de acciones de automatización del flujo de trabajo. Utilice estas acciones para recuperar y cargar datos de log en AWS CloudWatch.

Requisitos previos

Para los requisitos previos y la configuración de credenciales, consulte Configurar las credenciales de AWS.

Obtener eventos de log

El identificador de la acción es aws.cloudwatch.getLogEvents.

Recupera un lote de logs de eventos de un flujo de logs específico en AWS CloudWatch Logs.

La siguiente tabla describe los campos de entrada para esta acción.

Aporte	Tipo	Descripción	Ejemplo
`awsRoleArn`	Cadena	Opcional. ARN del rol de IAM que se debe asumir para las llamadas API de AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Cadena	Opcional. ID de clave de acceso de AWS. Páselo como un secreto.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Cadena	Opcional. Clave de acceso secreta de AWS. Páselo como un secreto.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Cadena	Opcional. Token de sesión temporal para la autenticación STS. Páselo como un secreto.	`${{ :secrets:awsSessionToken }}`
`region`	Cadena	Requerido. Región de AWS del grupo de logs objetivo.	`us-east-2`
`logStreamName`	Cadena	Requerido. Nombre del flujo de log del cual recuperar eventos.	`2023/10/27/[$LATEST]abcdef123456`
`logGroupName`	Cadena	Opcional. Nombre del grupo de logs que contiene el flujo de logs.	`/aws/lambda/my-function`
`logGroupIdentifier`	Cadena	Opcional. ARN o nombre del grupo de log. Úselo en lugar de `logGroupName` al hacer referencia a un grupo de log por ARN.	`arn:partition:service:region:account-id:resource`
`startTime`	En t	Opcional. Inicio del rango de tiempo, expresado como un timestamp de Unix en milisegundos.	`1759296000000`
`endTime`	En t	Opcional. Fin del rango de tiempo, expresado como un timestamp de Unix en milisegundos.	`1759296000000`
`limit`	En t	Opcional. Número máximo de logs de evento que se devolverán.	`50`
`startFromHead`	Booleano	Opcional. Si `true` , devuelve primero los logs de evento más antiguos. Por defecto es `false` .	`true`
`unmask`	Booleano	Opcional. Si `true` , devuelve datos de log de evento sin enmascarar. Por defecto es `false` .	`false`
`nextToken`	Cadena	Opcional. Token de paginación de una respuesta anterior para obtener la siguiente página de resultados.	`f/39218833627378687642013305455131706539523449361490509828/s`

La siguiente tabla describe los campos de salida para esta acción.

Producción	Tipo	Ejemplo
`response`	Objeto	`{"events": [{"timestamp": 123, "message": "string", "ingestionTime": 123}], "nextForwardToken": "string", "nextBackwardToken": "string"}`
`success`	Booleano	`true` o `false`
`errorMessage`	Cadena	`"An error occurred (ExpiredTokenException) when calling the GetLogEvents operation: The security token included in the request is expired"`

Producción

Tipo

Ejemplo

response

Objeto

{"events": [{"timestamp": 123, "message": "string", "ingestionTime": 123}], "nextForwardToken": "string", "nextBackwardToken": "string"}

success

Booleano

true

false

errorMessage

Cadena

"An error occurred (ExpiredTokenException) when calling the GetLogEvents operation: The security token included in the request is expired"

El siguiente flujo de trabajo de ejemplo muestra cómo usar esta acción.

name: get-lambda-logs
description: 'Retrieve log events from an AWS Lambda function'
workflowInputs:
  region:
    type: String
    defaultValue: us-east-2
  logGroupName:
    type: String
    defaultValue: /aws/lambda/my-function
  logStreamName:
    type: String
    defaultValue: 2023/10/27/[$LATEST]abcdef123456
steps:
  - name: get_events_step
    type: action
    action: aws.cloudwatch.getLogEvents
    version: '1'
    inputs:
      region: ${{ .workflowInputs.region }}
      logGroupName: ${{ .workflowInputs.logGroupName }}
      logStreamName: ${{ .workflowInputs.logStreamName }}
      limit: 100
    next: end

Cargar eventos de log

El identificador de la acción es aws.cloudwatch.putLogEvents.

Carga un lote de logs de eventos en la secuencia de logs especificada en AWS CloudWatch Logs.