View a markdown version of this page

CloudWatch Exemples de journaux utilisant AWS CLI - AWS Command Line Interface

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CloudWatch Exemples de journaux utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with CloudWatch Logs.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser create-log-group.

AWS CLI

La commande suivante permet de créer un groupe de journaux nommé my-logs :

aws logs create-log-group --log-group-name my-logs
  • Pour plus de détails sur l'API, voir CreateLogGroupla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser create-log-stream.

AWS CLI

La commande suivante crée un flux de journaux nommé 20150601 dans le groupe de journaux my-logs :

aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601
  • Pour plus de détails sur l'API, voir CreateLogStreamla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser delete-log-group.

AWS CLI

La commande suivante supprime un groupe de journaux nommé my-logs :

aws logs delete-log-group --log-group-name my-logs
  • Pour plus de détails sur l'API, voir DeleteLogGroupla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser delete-log-stream.

AWS CLI

La commande suivante supprime un flux de journaux nommé 20150531 à partir d’un groupe de journaux nommé my-logs :

aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531
  • Pour plus de détails sur l'API, voir DeleteLogStreamla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser delete-retention-policy.

AWS CLI

La commande suivante supprime la politique de rétention précédemment appliquée à un groupe de journaux nommé my-logs :

aws logs delete-retention-policy --log-group-name my-logs
  • Pour plus de détails sur l'API, voir DeleteRetentionPolicyla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser describe-log-groups.

AWS CLI

La commande suivante décrit un groupe de journaux nommé my-logs :

aws logs describe-log-groups --log-group-name-prefix my-logs

Sortie :

{ "logGroups": [ { "storedBytes": 0, "metricFilterCount": 0, "creationTime": 1433189500783, "logGroupName": "my-logs", "retentionInDays": 5, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*" } ] }
  • Pour plus de détails sur l'API, voir DescribeLogGroupsla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser describe-log-streams.

AWS CLI

La commande suivante affiche tous les flux de journaux 2015 commençant par le préfixe my-logs dans le groupe de journaux :

aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015

Sortie :

{ "logStreams": [ { "creationTime": 1433189871774, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531", "logStreamName": "20150531", "storedBytes": 0 }, { "creationTime": 1433189873898, "arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601", "logStreamName": "20150601", "storedBytes": 0 } ] }
  • Pour plus de détails sur l'API, voir DescribeLogStreamsla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser get-log-events.

AWS CLI

La commande suivante extrait les événements du journal à partir d’un flux de journaux nommé 20150601 dans le groupe de journaux my-logs :

aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601

Sortie :

{ "nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130", "events": [ { "ingestionTime": 1433190494190, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190516679, "timestamp": 1433190184356, "message": "Example Event 1" }, { "ingestionTime": 1433190494190, "timestamp": 1433190184358, "message": "Example Event 2" } ], "nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120" }
  • Pour plus de détails sur l'API, voir GetLogEventsla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser put-log-events.

AWS CLI

La commande suivante place les événements du journal dans un flux de journaux nommé 20150601 dans le groupe de journaux my-logs :

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events

Sortie :

{ "nextSequenceToken": "49542672486831074009579604567656788214806863282469607346" }

L’exemple ci-dessus lit un tableau JSON d’événements à partir d’un fichier nommé events dans le répertoire actuel :

[ { "timestamp": 1433190184356, "message": "Example Event 1" }, { "timestamp": 1433190184358, "message": "Example Event 2" }, { "timestamp": 1433190184360, "message": "Example Event 3" } ]

Chaque appel ultérieur nécessite que le jeton de séquence suivant fourni par l’appel précédent soit spécifié avec l’option de jeton de séquence :

aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346"

Sortie :

{ "nextSequenceToken": "49542672486831074009579604567900991230369019956308219826" }
  • Pour plus de détails sur l'API, voir PutLogEventsla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser put-retention-policy.

AWS CLI

La commande suivante ajoute une politique de conservation de 5 jours à un groupe de journaux nommé my-logs :

aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5
  • Pour plus de détails sur l'API, voir PutRetentionPolicyla section Référence des AWS CLI commandes.

L’exemple de code suivant montre comment utiliser start-live-tail.

AWS CLI

La commande suivante démarre une session Live Tail sur un groupe de journaux nommé my-logs :

aws logs start-live-tail --log-group-identifiers arn:aws:logs:us-east-1:111111222222:log-group:my-logs

La commande suivante démarre une session Live Tail sur un groupe de journaux nommé my-logs en mode interactif :

aws logs start-live-tail --log-group-identifiers arn:aws:logs:us-east-1:111111222222:log-group:my-logs --mode interactive

En mode interactif, vous pouvez surligner jusqu'à cinq termes dans les journaux détaillés. Les codes de gravité sont surlignés par défaut. Appuyez h pour passer en mode surlignage, puis saisissez les termes à surligner, un par un, puis appuyez sur Entrée. Appuyez c pour effacer le ou les termes surlignés. Appuyez sur t ce bouton pour passer d'un JSON/Plain texte à l'autre. Appuyez Esc pour quitter la session Live Tail. Appuyez sur down les touchesup/pour faire défiler les événements du journal vers le haut ou vers le bas, utilisezCtrl + u/Ctrl + dpour accélérer le défilement. Appuyez q pour accéder aux derniers événements du journal.

  • Pour plus de détails sur l'API, voir StartLiveTailla section Référence des AWS CLI commandes.