Actions AWS CloudWatch

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 identifiants AWS pour savoir comment créer des utilisateurs et des rôles IAM, et configurer des identifiants AWS statiques et de session pour l'intégration aux actions AWS de Workflow Automation.

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é.

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

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

Mettre les événements de log

Prérequis