Acciones de AWS CloudWatch

avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta característica se proporciona actualmente como parte de un programa de vista previa de conformidad con nuestras políticas de prelanzamiento.

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 AWS para obtener información sobre cómo crear usuarios y roles de IAM, y configurar credenciales AWS estáticas y de sesión para la integración con acciones de automatización de flujo de trabajo AWS.

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.

avance

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

avance

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

Poner eventos de log

Requisitos previos