Acciones de AWS CloudWatch

Esta página proporciona una referencia completa de las acciones de AWS CloudWatch disponibles en el catálogo de acciones de automatización del flujo de trabajo. Estas acciones le permiten observar las operaciones de logs en la nube.

Requisitos previos

Antes de emplear las acciones AWS en la automatización del flujo de trabajo, cerciorar de tener lo siguiente:

Una cuenta de AWS con las licencias adecuadas.
Credenciales de AWS configuradas (credenciales de usuario de IAM, ARN de rol de IAM o credenciales de sesión).
Las licencias IAM necesarios para los servicios específicos de AWS que planea emplear.

Consulte Configurar credenciales de AWS para obtener información sobre cómo crear usuarios y roles de IAM, y configurar credenciales de AWS estáticas y de sesión para la integración con las acciones de AWS de automatización de flujos de trabajo.

Recupera un lote de logs de eventos de un flujo de logs específico en AWS CloudWatch Logs. Es esencial para el monitoreo, auditoría y resolución de problemas de la aplicación mediante la obtención de datos de log mediante programación.

Campo de entrada	Opcionalidad	Tipo	Ejemplo
awsRoleArn	Opcional	Cadena	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Opcional	Cadena	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	Opcional	Cadena	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	Opcional	Cadena	`${{ :secrets:<awsSessionToken> }}`
región	Requerido	Cadena	`"us-east-2"`
logStreamName	Requerido	Cadena	`"2023/10/27/[$LATEST]abcdef123456"`
logGroupName	Opcional	Cadena	`"/aws/lambda/my-function"`
logGroupIdentifier	Opcional	Cadena	`"arn:partition:service:region:account-id:resource"`
startTime	Opcional	En t	`1759296000000`
endTime	Opcional	En t	`1759296000000`
limit	Opcional	En t	`50`
startFromHead	Opcional	Booleano	`true`
unmask	Opcional	Booleano	`false`
nextToken	Opcional	Cadena	`"f/39218833627378687642013305455131706539523449361490509828/s"`

Campo de salida	Tipo	Ejemplo
response	Objeto	`{ 'events': [ { 'timestamp': 123, 'message': 'string', 'ingestionTime': 123 }, ], 'nextForwardToken': 'string', 'nextBackwardToken': 'string' }`
éxito	Booleano	`success: true \| false`
mensaje de error	Cadena	`"An error occurred (ExpiredTokenException) when calling the GetLogEvents operation: The security token included in the request is expired"`

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.get_log_events
  version: '1'
  inputs:
    region: ${{ .workflowInputs.region }}
    logGroupName: ${{ .workflowInputs.logGroupName }}
    logStreamName: ${{ .workflowInputs.logStreamName }}
    limit: 100

Esto carga un lote de logs de eventos en la secuencia de logs especificada en AWS CloudWatch Logs. Se emplea para enviar programáticamente datos de log desde aplicaciones o servicios a CloudWatch para su monitoreo y análisis.

Campo de entrada	Opcionalidad	Tipo	Ejemplo
awsRoleArn	Opcional	Cadena	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Opcional	Cadena	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	Opcional	Cadena	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	Opcional	Cadena	`${{ :secrets:<awsSessionToken> }}`
región	Requerido	Cadena	`"us-east-2"`
logGroupName	Requerido	Cadena	`"/aws/lambda/hello-you"`
logStreamName	Requerido	Cadena	`"2025/09/24/[$LATEST]09f7ca9e9ab044f389419ce60305f594"`
logEvents	Requerido	Lista	`[ { "timestamp": 1698384000000, "message": "Workflow task started." }, { "timestamp": 1698384000015, "message": "Data validated successfully." } ]`
entidad	Opcional	Dict	`{ "entity": { "keyAttributes": { "ResourceType": "AWS::ElasticLoadBalancingV2::LoadBalancer", "Identifier": "app/my-web-lb/12345", "Environment": "Production" }, "attributes": { "MonitoringTier": "Gold", "OwnerTeam": "Networking", "MaintenanceWindow": "Sat: 0200-0400" } } }`

Campo de salida	Tipo	Descripción	Ejemplo
response	Objeto	La respuesta JSON sin procesar, que incluye `nextSequenceToken` .	`{ 'nextSequenceToken': 'string', 'rejectedLogEventsInfo': { 'tooNewLogEventStartIndex': 123, 'tooOldLogEventEndIndex': 123, 'expiredLogEventEndIndex': 123 }, 'rejectedEntityInfo': { 'errorType': 'InvalidEntity'\|'InvalidTypeValue'\|'InvalidKeyAttributes'\|'InvalidAttributes'\|'EntitySizeTooLarge'\|'UnsupportedLogGroupType'\|'MissingRequiredFields' } }`
éxito	Booleano	Indica si el log de eventos se cargó correctamente.	`true`
mensaje de error	Cadena	Un mensaje de error descriptivo si la acción falló.	`"An error occurred (ExpiredTokenException) when calling the PutLogEvents operation: The security token included in the request is expired"`

Campo de salida

Tipo

Descripción

Ejemplo

response

Objeto

La respuesta JSON sin procesar, que incluye

nextSequenceToken

{
    'nextSequenceToken': 'string',
    'rejectedLogEventsInfo': {
        'tooNewLogEventStartIndex': 123,
        'tooOldLogEventEndIndex': 123,
        'expiredLogEventEndIndex': 123
    },
    'rejectedEntityInfo': {
        'errorType': 'InvalidEntity'|'InvalidTypeValue'|'InvalidKeyAttributes'|'InvalidAttributes'|'EntitySizeTooLarge'|'UnsupportedLogGroupType'|'MissingRequiredFields'
    }
}

éxito

Booleano

Indica si el log de eventos se cargó correctamente.

true

mensaje de error

Cadena

Un mensaje de error descriptivo si la acción falló.

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

Ejemplo de flujo de trabajo
name: put-custom-logs description: 'Upload a batch of custom log events to CloudWatch' workflowInputs: region: type: String defaultValue: us-east-2 logGroupName: type: String defaultValue: my-custom-app-logs logStreamName: type: String defaultValue: instance-01-thread-01 steps: - name: upload_logs type: action action: aws.cloudwatch.put_log_events version: '1' inputs: region: ${{ .workflowInputs.region }} logGroupName: ${{ .workflowInputs.logGroupName }} logStreamName: ${{ .workflowInputs.logStreamName }} logEvents: - timestamp: 1698384000000 message: "Workflow started successfully" - timestamp: 1698384005000 message: "Step 1 completed" next: end

Ejemplo de flujo de trabajo

name: put-custom-logs
description: 'Upload a batch of custom log events to CloudWatch'

workflowInputs:
  region:
    type: String
    defaultValue: us-east-2
  logGroupName:
    type: String
    defaultValue: my-custom-app-logs
  logStreamName:
    type: String
    defaultValue: instance-01-thread-01
  
steps:
  - name: upload_logs
    type: action
    action: aws.cloudwatch.put_log_events
    version: '1'
    inputs:
      region: ${{ .workflowInputs.region }}
      logGroupName: ${{ .workflowInputs.logGroupName }}
      logStreamName: ${{ .workflowInputs.logStreamName }}
      logEvents:
        - timestamp: 1698384000000
          message: "Workflow started successfully"
        - timestamp: 1698384005000
          message: "Step 1 completed"
    next: end

Te ofrecemos esta traducción automática para facilitar la lectura.

Requisitos previos

Obtener el log de eventos de CloudWatch

Poner eventos de log

Te ofrecemos esta traducción automática para facilitar la lectura.

Acciones de AWS CloudWatch

Requisitos previos.css-21sua1{background:none;border:none;width:0;padding:0;}

Poner eventos de log

Requisitos previos