Ações do AWS CloudWatch

Esta página fornece uma referência para as ações do AWS CloudWatch disponíveis no catálogo de ações de automação de fluxo de trabalho. Use estas ações para recuperar e fazer upload de dados de log no AWS CloudWatch.

Pré-requisitos

Para pré-requisitos e configuração de credenciais, consulte Configurar credenciais da AWS.

Obter evento de log

O identificador da ação é aws.cloudwatch.getLogEvents.

Recupera um lote de eventos de log de um fluxo de logs especificado no AWS CloudWatch Logs.

A tabela a seguir descreve os campos de entrada para esta ação.

Entrada	Tipo	Descrição	Exemplo
`awsRoleArn`	Corda	Opcional. ARN da função do IAM a ser assumida para chamadas de API da AWS.	`arn:aws:iam::123456789012:role/my-workflow-role`
`awsAccessKeyId`	Corda	Opcional. ID da chave de acesso da AWS. Passe como um segredo.	`${{ :secrets:awsAccessKeyId }}`
`awsSecretAccessKey`	Corda	Opcional. Chave de acesso secreta da AWS. Passe como um segredo.	`${{ :secrets:awsSecretAccessKey }}`
`awsSessionToken`	Corda	Opcional. Token de sessão temporário para autenticação STS. Passe como um segredo.	`${{ :secrets:awsSessionToken }}`
`region`	Corda	Obrigatório. Região da AWS do grupo de logs de destino.	`us-east-2`
`logStreamName`	Corda	Obrigatório. Nome do stream de log do qual recuperar eventos.	`2023/10/27/[$LATEST]abcdef123456`
`logGroupName`	Corda	Opcional. Nome do grupo de logs que contém o fluxo de logs.	`/aws/lambda/my-function`
`logGroupIdentifier`	Corda	Opcional. ARN ou nome do grupo de logs. Use em vez de `logGroupName` ao referenciar um grupo de logs por ARN.	`arn:partition:service:region:account-id:resource`
`startTime`	Interno	Opcional. Início do intervalo de tempo, expresso como um timestamp Unix em milissegundos.	`1759296000000`
`endTime`	Interno	Opcional. Fim do intervalo de tempo, expresso como um timestamp Unix em milissegundos.	`1759296000000`
`limit`	Interno	Opcional. Número máximo de eventos de log a serem retornados.	`50`
`startFromHead`	Boleano	Opcional. Se `true` , retorna os eventos de log mais antigos primeiro. O padrão é `false` .	`true`
`unmask`	Boleano	Opcional. Se `true` , retorna dados de evento de log não mascarados. O padrão é `false` .	`false`
`nextToken`	Corda	Opcional. Token de paginação de uma resposta anterior para recuperar a próxima página de resultados.	`f/39218833627378687642013305455131706539523449361490509828/s`

A tabela a seguir descreve os campos de saída para esta ação.

Saída	Tipo	Exemplo
`response`	Objeto	`{"events": [{"timestamp": 123, "message": "string", "ingestionTime": 123}], "nextForwardToken": "string", "nextBackwardToken": "string"}`
`success`	Boleano	`true` ou `false`
`errorMessage`	Corda	`"An error occurred (ExpiredTokenException) when calling the GetLogEvents operation: The security token included in the request is expired"`

Saída

Tipo

Exemplo

response

Objeto

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

success

Boleano

true

false

errorMessage

Corda

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

O fluxo de trabalho de exemplo a seguir mostra como usar esta ação.

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

Fazer upload de eventos de log

O identificador da ação é aws.cloudwatch.putLogEvents.

Carrega um lote de eventos de log para o fluxo de logs especificado no AWS CloudWatch Logs.