Ações do AWS CloudWatch

Esta página fornece uma referência completa para as ações do AWS CloudWatch disponíveis no catálogo de ações de automação de fluxo de trabalho. Essas ações permitem que você monitore as operações de log do CloudWatch.

Pré-requisitos

Antes de usar as ações AWS na automação do fluxo de trabalho, certifique-se de ter:

Uma conta da AWS com as permissões apropriadas.
Credenciais da AWS configuradas (credenciais de usuário do IAM, ARN da função do IAM ou credenciais de sessão).
As permissões IAM necessárias para os serviços específicos da AWS que você planeja usar.

Consulte Configurar credenciais da AWS para obter informações sobre como criar usuários e funções do IAM, e configurar credenciais da AWS estáticas e de sessão para integração com ações da AWS de automação de fluxo de trabalho.

Recupera um lote de eventos de log de um fluxo de log especificado no AWS CloudWatch Logs. É essencial para monitoramento, auditoria e resolução de problemas do aplicativo, buscando programaticamente os dados de log.

Campo de entrada	Opcionalidade	Tipo	Exemplo
awsRoleArn	Opcional	Corda	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Opcional	Corda	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	Opcional	Corda	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	Opcional	Corda	`${{ :secrets:<awsSessionToken> }}`
região	Obrigatório	Corda	`"us-east-2"`
logStreamName	Obrigatório	Corda	`"2023/10/27/[$LATEST]abcdef123456"`
logGroupName	Opcional	Corda	`"/aws/lambda/my-function"`
logGroupIdentifier	Opcional	Corda	`"arn:partition:service:region:account-id:resource"`
startTime	Opcional	Interno	`1759296000000`
endTime	Opcional	Interno	`1759296000000`
limit	Opcional	Interno	`50`
startFromHead	Opcional	Boleano	`true`
unmask	Opcional	Boleano	`false`
nextToken	Opcional	Corda	`"f/39218833627378687642013305455131706539523449361490509828/s"`

Campo de saída	Tipo	Exemplo
response	Objeto	`{ 'events': [ { 'timestamp': 123, 'message': 'string', 'ingestionTime': 123 }, ], 'nextForwardToken': 'string', 'nextBackwardToken': 'string' }`
sucesso	Boleano	`success: true \| false`
mensagem de erro	Corda	`"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

Isso carrega um lote de eventos de log para o fluxo de logs especificado no AWS CloudWatch Logs. É utilizado para enviar programaticamente dados de log de aplicativos ou serviços para o CloudWatch para monitoramento e análise.

Campo de entrada	Opcionalidade	Tipo	Exemplo
awsRoleArn	Opcional	Corda	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Opcional	Corda	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	Opcional	Corda	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	Opcional	Corda	`${{ :secrets:<awsSessionToken> }}`
região	Obrigatório	Corda	`"us-east-2"`
logGroupName	Obrigatório	Corda	`"/aws/lambda/hello-you"`
logStreamName	Obrigatório	Corda	`"2025/09/24/[$LATEST]09f7ca9e9ab044f389419ce60305f594"`
logEvents	Obrigatório	Lista	`[ { "timestamp": 1698384000000, "message": "Workflow task started." }, { "timestamp": 1698384000015, "message": "Data validated successfully." } ]`
entidade	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 saída	Tipo	Descrição	Exemplo
response	Objeto	A resposta JSON bruta, que inclui o `nextSequenceToken` .	`{ 'nextSequenceToken': 'string', 'rejectedLogEventsInfo': { 'tooNewLogEventStartIndex': 123, 'tooOldLogEventEndIndex': 123, 'expiredLogEventEndIndex': 123 }, 'rejectedEntityInfo': { 'errorType': 'InvalidEntity'\|'InvalidTypeValue'\|'InvalidKeyAttributes'\|'InvalidAttributes'\|'EntitySizeTooLarge'\|'UnsupportedLogGroupType'\|'MissingRequiredFields' } }`
sucesso	Boleano	Indica se o evento de log foi carregado com sucesso.	`true`
mensagem de erro	Corda	Uma mensagem descritiva de erro se a ação falhar.	`"An error occurred (ExpiredTokenException) when calling the PutLogEvents operation: The security token included in the request is expired"`

Campo de saída

Tipo

Descrição

Exemplo

response

Objeto

A resposta JSON bruta, que inclui o

nextSequenceToken

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

sucesso

Boleano

Indica se o evento de log foi carregado com sucesso.

true

mensagem de erro

Corda

Uma mensagem descritiva de erro se a ação falhar.

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

Exemplo de fluxo de trabalho
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

Exemplo de fluxo de trabalho

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

Esta tradução de máquina é fornecida para sua comodidade.

Pré-requisitos

Obter log de eventos do CloudWatch

Inserir evento de log

Esta tradução de máquina é fornecida para sua comodidade.

Ações do AWS CloudWatch

Pré-requisitos.css-21sua1{background:none;border:none;width:0;padding:0;}

Inserir evento de log

Pré-requisitos