Exemples d’utilisation de l’AWS CLI avec CloudWatch Logs - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec CloudWatch Logs

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec 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, consultez CreateLogGroup dans la Référence des commandes de l’AWS CLI.

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, consultez CreateLogStream dans la Référence des commandes de l’AWS CLI.

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, consultez DeleteLogGroup dans la Référence des commandes de l’AWS CLI.

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, consultez DeleteLogStream dans la Référence des commandes de l’AWS CLI.

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, consultez DeleteRetentionPolicy dans la Référence des commandes de l’AWS CLI.

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, consultez DescribeLogGroups dans la Référence des commandes de l’AWS CLI.

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, consultez DescribeLogStreams dans la Référence des commandes de l’AWS CLI.

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

AWS CLI

La commande suivante récupère les événements de 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, consultez GetLogEvents dans la Référence des commandes de l’AWS CLI.

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

AWS CLI

La commande suivante place les événements de 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, consultez PutLogEvents dans la Référence des commandes de l’AWS CLI.

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

AWS CLI

La commande suivante ajoute une politique de rétention 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, consultez PutRetentionPolicy dans la Référence des commandes de l’AWS CLI.