

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.

# Journalisation par le pair du serveur de routage
<a name="route-server-peer-logging"></a>

Utilisez la journalisation par le pair du serveur de routage VPC lorsque vous devez :
+ surveiller l’état de sessions BGP et BFD ;
+ résoudre des problèmes de connexion ;
+ consulter l’historique des modifications apportées aux sessions ;
+ suivre l’état du réseau.

## Tarification
<a name="pricing"></a>
+ **CloudWatch**: Les frais d'ingestion de données et d'archivage pour les journaux vendus s'appliquent lorsque vous publiez les journaux homologues du serveur de routage vers CloudWatch Logs. 
+ **S3** : des frais d’ingestion et d’archivage de données s’appliquent pour les journaux payants lorsque vous publiez des journaux de pair du serveur de routage dans Amazon S3.
+ **Data Firehose** : des frais d’ingestion et de diffusion standard s’appliquent.

Les journaux vendus sont des journaux provenant de AWS services spécifiques qui sont disponibles à une tarification par volume et fournis à CloudWatch Logs, Amazon S3 ou Amazon Data Firehose. Pour plus d'informations, ouvrez [Amazon CloudWatch Pricing](https://aws.amazon.com//cloudwatch/pricing/), sélectionnez **Logs** et recherchez **Vended Logs**.

## Exemple de format de journal
<a name="example-log-format"></a>

```
{
    "resource_arn": "arn:aws:ec2:us-east-1:111122223333:route-server-peer/rsp-1234567890abcdef0",
    "event_timestamp": 1746643505367,
    "type": "RouteStatus",
    "status": "ADVERTISED",
    "message": {
        "prefix": "10.24.34.0/32",
        "asPath": "65000",
        "med": 100,
        "nextHopIp": "10.24.34.1"
    }
}

{
    "resource_arn": "arn:aws:ec2:us-east-1:111122223333:route-server-peer/rsp-1234567890abcdef0",
    "event_timestamp": 1746643490000,
    "type": "BGPStatus",
    "status": "UP",
    "message": null
}
```

Où :
+ L’élément `resource_arn` correspond à l’ARN du pair du serveur de routage.
+ L’élément `event_timestamp` correspond à l’horodatage de l’événement.
+ L’élément `type` correspond au type des événements du journal que nous produisons (`RouteStatus`, `BGPStatus`, `BFDStatus`).
+ Le champ `status` correspond à la mise à jour de l’état.
  + Messages de type `RouteStatus` :
    + `ADVERTISED` signifie que la route a été annoncée par le pair
    + `UPDATED` signifie que la route existante a été mise à jour par le pair.
    + `WITHDRAWN` signifie que la route a été retirée par le pair.
  + Mises à jour associées à `BFDStatus` et `BGPStatus`
    + `UP`, `DOWN`.
+ Le `message` champ n'est actuellement utilisé que pour les attributs de route du type de RouteStatus message, mais il peut être rempli avec des informations pertinentes pour n'importe quel type de message.

------
#### [ AWS Management Console ]

Pour créer des journaux de pair du serveur de routage :

1. Ouvrez la console Amazon VPC à l’adresse [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).

1. Dans le panneau de navigation, sous **Cloud privé virtuel**, sélectionnez **Serveurs de routage**.

1. Sur la page **Serveurs de routage**, sélectionnez **Serveur de routages pairs**.

1. Choisissez l’onglet **Livraison des journaux**.

1. Choisissez **Ajouter la livraison des journaux**.

1. Choisissez une destination et configurez les paramètres :
   + Amazon CloudWatch Logs
     + **Type de journal** : types des journaux à livrer. Le seul type de journal pris en charge est EVENT\_LOGS.
     + **Groupe de journaux de destination** : groupe de journaux dans lequel les journaux seront envoyés. CloudWatch Vous pouvez sélectionner un groupe de journaux existant ou en créer un nouveau (exemple :/aws/vpc/route-server-peers).
     + **Sélection du champ** : champs de données à inclure dans vos journaux.
     + **Format de sortie** : mode de formatage des journaux :
       + JSON : format structuré pour le traitement informatique
       + Texte : format texte brut
     + **Délimiteur de champs** : en cas d’utilisation du format texte, il s’agit du caractère qui sépare les champs (exemple : virgule, tabulation, espace).
   + Amazon S3
     + Compte croisé - Envoi de journaux à différents AWS comptes
       + **Type de journal** : types des journaux à livrer. Le seul type de journal pris en charge est EVENT\_LOGS.
       + **ARN de destination de livraison** : nom de ressource Amazon du compartiment S3 dans un autre AWS compte où les journaux seront envoyés.
       + **Sélection du champ** : champs de données à inclure dans vos journaux.
       + **Suffixe** : terminaison ajoutée aux noms des fichiers journaux (exemple : .log, .txt).
       + **Compatible Hive** : lorsque cette option est activée, les journaux sont organisés dans une structure de dossiers compatible avec les outils basés sur Hive pour faciliter les recherches avec des services tels qu’Amazon Athena.
       + **Délimiteur de champs** : en cas d’utilisation du format texte, il s’agit du caractère qui sépare les champs.
     + Dans le compte actuel
       + **Type de journal** : types des journaux à livrer. Le seul type de journal pris en charge est EVENT\_LOGS.
       + **Compartiment S3 de destination** : compartiment S3 de votre compte dans lequel les journaux seront envoyés. Vous pouvez spécifier le chemin d’un sous-dossier.
       + **Sélection du champ** : champs de données à inclure dans vos journaux.
       + **Suffixe** : terminaison ajoutée aux noms des fichiers journaux (exemple : .log, .txt).
       + **Compatible Hive** : lorsque cette option est activée, les journaux sont organisés dans une structure de dossiers compatible avec les outils basés sur Hive pour faciliter les recherches.
       + **Délimiteur de champs** : en cas d’utilisation du format texte, il s’agit du caractère qui sépare les champs.
   + Amazon Data Firehose
     + Compte croisé
       + **Type de journal** : types des journaux à livrer. Le seul type de journal pris en charge est EVENT\_LOGS.
       + **ARN de destination de livraison** : nom de ressource Amazon du flux de diffusion Firehose dans un autre AWS compte.
       + **Sélection du champ** : champs de données à inclure dans vos journaux.
       + **Délimiteur de champs** : en cas d’utilisation du format texte, il s’agit du caractère qui sépare les champs.
     + Dans le compte actuel
       + **Type de journal** : types des journaux à livrer. Le seul type de journal pris en charge est EVENT\_LOGS.
       + **Flux de destination de diffusion** : flux de diffusion Firehose de votre compte dans lequel les journaux seront envoyés. Le flux doit utiliser le type de source « Direct PUT ».
       + **Sélection du champ** : champs de données à inclure dans vos journaux.
       + **Format de sortie** : mode de formatage des journaux :
         + JSON : format structuré pour le traitement informatique
         + Texte : format texte brut
       + **Délimiteur de champs** : en cas d’utilisation du format texte, il s’agit du caractère qui sépare les champs.

------
#### [ Command line ]

Les commandes de cette section renvoient vers la *documentation de référence sur les commandes de l’AWS CLI *. La documentation fournit des descriptions détaillées des options que vous pouvez utiliser lorsque vous exécutez les commandes.

Pour créer des journaux de pair du serveur de routage :

1. Utilisez la commande [put-delivery-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-delivery-source.html).
   + Exemple de demande

     ```
     aws logs put-delivery-source --name "source-rsp-1234567890abcdef0" --resource-arn "arn:aws:ec2:us-east-1:111122223333:route-server-peer/rsp-1234567890abcdef0" --log-type "EVENT_LOGS"
     ```
   + Exemple de réponse

     ```
     {
          "deliverySource": {
             "name": "source-rsp-1234567890abcdef0",
             "arn": "arn:aws:logs:us-east-1:111122223333:delivery-source:source-rsp-1234567890abcdef0",
             "resourceArns": [
                 "arn:aws:ec2:us-east-1:111122223333:route-server-peer/rsp-1234567890abcdef0"
             ],
             "service": "ec2",
             "logType": "EVENT_LOGS"
         }
     }
     ```

1. Utilisez la commande [put-delivery-destination](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-delivery-destination.html).
   + L'exemple de AWS CLI suivant crée un journal de serveur de routage. Les journaux sont livrés au groupe de journaux spécifié.
   + Exemple de demande

     ```
     aws logs put-delivery-destination --name "destination-rsp-abcdef01234567890" --destination-resource-arn "arn:aws:logs:us-east-1:111122223333:log-group:/aws/vendedlogs/ec2/route-server-peer/EVENT_LOGS/rsp-abcdef01234567890"
     ```
   + Exemple de réponse

     ```
     {
          "deliveryDestination": {
             "name": "destination-rsp-abcdef01234567890",
             "arn": "arn:aws:logs:us-east-1:111122223333:delivery-destination:destination-rsp-abcdef01234567890",
             "deliveryDestinationType": "CWL",
             "deliveryDestinationConfiguration": {
                 "destinationResourceArn": "arn:aws:logs:us-east-1:111122223333:log-group:/aws/vendedlogs/ec2/route-server-peer/EVENT_LOGS/rsp-abcdef01234567890"
             }
         }
     }
     ```

1. Utilisez la commande [create-delivery](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-delivery.html).
   + Exemple de demande

     ```
     aws logs create-delivery --delivery-source-name "source-rsp-1234567890abcdef0" --delivery-destination-arn "arn:aws:logs:us-east-1:111122223333:delivery-destination:destination-rsp-abcdef01234567890"
     ```
   + Exemple de réponse

     ```
     {
          "delivery": {
             "id": "1234567890abcdef0",
             "arn": "arn:aws:logs:us-east-1:111122223333:delivery:1234567890abcdef0",
             "deliverySourceName": "source-rsp-1234567890abcdef0",
             "deliveryDestinationArn": "arn:aws:logs:us-east-1:111122223333:delivery-destination:destination-rsp-abcdef01234567890",
             "deliveryDestinationType": "CWL",
             "recordFields": [
                 "resource_arn",
                 "event_timestamp",
                 "type",
                 "status",
                 "message"
             ]
         }
     }
     ```

------