Actions AWS CloudWatch

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.

Cette page fournit une référence complète des actions AWS CloudWatch disponibles dans le catalogue des actions d'automatisation des workflows. Ces actions vous permettent d'effectuer des opérations sur les logs CloudWatch.

Prérequis

Avant d'utiliser AWS Actions dans l'automatisation workflow, assurez-vous de disposer des éléments suivants :

Un compte AWS disposant des autorisations appropriées.
Informations d'identification AWS configurées (informations d'identification de l'utilisateur IAM, ARN du rôle IAM ou informations d'identification de session).
Les autorisations IAM nécessaires pour les services AWS spécifiques que vous prévoyez d'utiliser.

Consultez la section Configurer les informations d'identification AWS pour savoir comment créer un utilisateur IAM et des rôles IAM, et comment configurer les informations d'identification AWS statiques et de session pour l'intégration avec les actions AWS d'automatisation workflow.

Récupère un lot d'événements de log à partir d'un flux de log spécifié dans AWS CloudWatch Logs. Il est essentiel pour le monitoring, l'audit et le dépannage des applications en récupérant par programme les données de logs.

Champ de saisie	optionnalité	Type	Exemple
awsRoleArn	Facultatif	Chaîne	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Facultatif	Chaîne	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	Facultatif	Chaîne	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	Facultatif	Chaîne	`${{ :secrets:<awsSessionToken> }}`
région	Requis	Chaîne	`"us-east-2"`
logStreamName	Requis	Chaîne	`"2023/10/27/[$LATEST]abcdef123456"`
logGroupName	Facultatif	Chaîne	`"/aws/lambda/my-function"`
logGroupIdentifier	Facultatif	Chaîne	`"arn:partition:service:region:account-id:resource"`
startTime	Facultatif	Int	`1759296000000`
endTime	Facultatif	Int	`1759296000000`
limit	Facultatif	Int	`50`
startFromHead	Facultatif	Booléen	`true`
unmask	Facultatif	Booléen	`false`
nextToken	Facultatif	Chaîne	`"f/39218833627378687642013305455131706539523449361490509828/s"`

Champ de sortie	Type	Exemple
response	Objet	`{ 'events': [ { 'timestamp': 123, 'message': 'string', 'ingestionTime': 123 }, ], 'nextForwardToken': 'string', 'nextBackwardToken': 'string' }`
succès	Booléen	`success: true \| false`
message d'erreur	Chaîne	`"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

Cela télécharge un lot d'événements de log vers le flux de log spécifié dans AWS CloudWatch Logs. Il est utilisé pour envoyer par programme des données de logs à partir d'applications ou de services vers CloudWatch à des fins de monitoring et d'analyse.

Champ de saisie	optionnalité	Type	Exemple
awsRoleArn	Facultatif	Chaîne	`arn:aws:iam::123456789012:role/my-workflow-role`
awsAccessKeyId	Facultatif	Chaîne	`${{ :secrets:<awsAccessKeyId> }}`
awsSecretAccessKey	Facultatif	Chaîne	`${{ :secrets:<awsSecretAccessKey> }}`
awsSessionToken	Facultatif	Chaîne	`${{ :secrets:<awsSessionToken> }}`
région	Requis	Chaîne	`"us-east-2"`
logGroupName	Requis	Chaîne	`"/aws/lambda/hello-you"`
logStreamName	Requis	Chaîne	`"2025/09/24/[$LATEST]09f7ca9e9ab044f389419ce60305f594"`
logEvents	Requis	List	`[ { "timestamp": 1698384000000, "message": "Workflow task started." }, { "timestamp": 1698384000015, "message": "Data validated successfully." } ]`
entité	Facultatif	Dict	`{ "entity": { "keyAttributes": { "ResourceType": "AWS::ElasticLoadBalancingV2::LoadBalancer", "Identifier": "app/my-web-lb/12345", "Environment": "Production" }, "attributes": { "MonitoringTier": "Gold", "OwnerTeam": "Networking", "MaintenanceWindow": "Sat: 0200-0400" } } }`

Champ de sortie	Type	Description	Exemple
response	Objet	La réponse JSON brute, qui inclut `nextSequenceToken` .	`{ 'nextSequenceToken': 'string', 'rejectedLogEventsInfo': { 'tooNewLogEventStartIndex': 123, 'tooOldLogEventEndIndex': 123, 'expiredLogEventEndIndex': 123 }, 'rejectedEntityInfo': { 'errorType': 'InvalidEntity'\|'InvalidTypeValue'\|'InvalidKeyAttributes'\|'InvalidAttributes'\|'EntitySizeTooLarge'\|'UnsupportedLogGroupType'\|'MissingRequiredFields' } }`
succès	Booléen	Indique si les événements de log ont été correctement téléchargés.	`true`
message d'erreur	Chaîne	Un message d'erreur descriptif si l'action a échoué.	`"An error occurred (ExpiredTokenException) when calling the PutLogEvents operation: The security token included in the request is expired"`

Champ de sortie

Type

Description

Exemple

response

Objet

La réponse JSON brute, qui inclut

nextSequenceToken

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

succès

Booléen

Indique si les événements de log ont été correctement téléchargés.

true

message d'erreur

Chaîne

Un message d'erreur descriptif si l'action a échoué.

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

Exemple de workflow
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

Exemple de workflow

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

Cette traduction automatique est fournie pour votre commodité.

Aperçu

Prérequis

Obtenir les événements de log CloudWatch

Mettre les événements de log

Cette traduction automatique est fournie pour votre commodité.

Actions AWS CloudWatch

Aperçu

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

Mettre les événements de log

Prérequis