Acheminement des journaux de chemin de données

Les journaux de données et de contrôle d'intégrité sont utiles à des fins de débogage et de maintenance. Lorsque la fonction de journalisation des chemins de données est activée, IBM Cloud® Virtual Private Cloud Application Load Balancer for VPC (ALB) transmet ces journaux au tableau de bord de votre compte IBM Cloud Logs tableau de bord de votre compte.

Pour activer ou désactiver la fonction d'acheminement des journaux de chemin de données, vous pouvez :

  • Créer un équilibreur de charge et activer ou désactiver le bouton à bascule.

  • Utiliser l'interface de ligne de commande afin d'affecter à la propriété --logging-datapath-active la valeur true pour les équilibreurs de charge existants.

  • Utiliser l'API pour activer l'acheminement des journaux de chemin de données.

Si vous ne disposez pas d'une instance Log Analysis, vous devez en créer une avant d'activer l'acheminement des journaux de chemin de données.

Exemples de sortie de journal

La sortie suivante est un exemple d'acheminement des journaux de chemin de données IBM Cloud Application Load Balancer for VPC :

Sep 28 11:25:04 is-load-balancer crn:v1:bluemix:public:is:us-south:a/a1234567::load-balancer:r006-6ba32c0e-830c-483c-871a-0240c10662cf
{"PRIORITY":"info", "MSG_timestamp":"2020-09-28T03:25:03.136101+00:00", "SentByHost":"150.238.66.162", "MESSAGE":" Connect from 222.72.143.92:38605 to 10.240.128.5:62776 (r006-6ba32c0e-830c-483c-871a-0240c10662cf/HTTP)", "logSourceCRN":"crn:v1:bluemix:public:is:us-south:a/a1234567::load-balancer:r006-6ba32c0e-830c-483c-871a-0240c10662cf", "saveServiceCopy":false}

Les journaux contiennent l'en-tête de journal et la chaîne JSON.

L'en-tête de journal est généré avec datetime (Sep 28 11:25:04), la source de journal (is-load-balancer) et la source de journal CRN (crn:v1:bluemix:public:is:us-south...).

Le journal de chemin de données est une chaîne JSON qui contient les zones suivantes :

Champs du journal du chemin de données
Nom de zone Type Description
PRIORITE chaîne Niveau de journalisation associé à chaque message sur la gravité du journal.
MSG_timestamp chaîne Horodatage qui indique le moment où le journal a été généré.
SentByHost chaîne Adresse IP de l'hôte.
MESSAGE chaîne Description du fichier journal.
logSourceCRN chaîne Emplacement de sauvegarde du fichier journal dans l'instance Log Analysis du compte indiqué dans le nom de ressource de cloud.
saveServiceCopy booléen Indique s'il convient de sauvegarder un journal dans le STS Log Analysis ; la valeur par défaut est false.

Voici un exemple du schéma JSON d'un journal de chemin de données :

{
    "type": "object",
    "properties": {
        "PRIORITY": {
            "type": "string"
        },
        "MSG_timestamp": {
            "type": "string"
        },
        "SentByHost": {
            "type": "string"
        },
        "MESSAGE": {
            "type": "string"
        },
        "logSourceCRN": {
            "type": "string"
        },
        "saveServiceCopy": {
            "type": "boolean"
        }
    }
}

Remarques :

  • PRIORITY est le niveau de journalisation qui est associé à chaque message sur la gravité du journal. Actuellement, la seule option est info.
  • MSG_timestamp est l'horodatage en Temps Universel Coordonné.
  • SentByHost est l'adresse IP virtuelle du dispositif. Pour les équilibreurs de charge publics, il s'agit de l'adresse IP flottante ; pour les équilibreurs de charge privés, il s'agit d'une adresse IP privée.
  • MESSAGE représente le contenu du message de journal.
  • logSourceCRN indique l'instance Log Analysis à utiliser pour sauvegarder les journaux pour le compte.
  • saveServiceCopy a pour valeur false (par défaut) et cette ne peut pas être modifiée.

Le format des journaux peut être impacté par des mises à niveau internes. Il est recommandé d'utiliser ces messages uniquement à des fins de débogage, et non pour l'automatisation de la construction.