Présentation

Par défaut, lorsque l’API d’admission Datadog reçoit un log, un statut INFO est généré et défini comme valeur de l’attribut status.

Ce status par défaut ne correspond pas toujours au statut réel du log en question. Ce guide vous explique comment remplacer la valeur par défaut des logs par leur statut réel.

Logs bruts

Si vos logs bruts n’affichent pas le bon statut dans Datadog, extrayez le statut correct à partir des logs bruts et remappez-le afin d’afficher le bon statut.

Extraire la valeur du statut avec un parser

Utilisez un parser Grok pour définir une règle avec le matcher word() et extraire le statut réel du log.

1. Accédez à Logs Pipelines et cliquez sur le pipeline traitant les logs.
2. Cliquez sur Add Processor.
3. Sélectionnez le type de processeur Grok Parser.
4. Utilisez le matcher word() pour extraire le statut et le transmettre dans un attribut log_status personnalisé.

Voici un exemple de log :

WARNING: John disconnected on 09/26/2017

Ajoutez une règle comme celle-ci :

MyParsingRule %{word:log_status}: %{word:user.name} %{word:action}.*

Vous obtenez la sortie suivante pour l’extraction de MyParsingRule :

{
  "action": "disconnected",
  "log_status": "WARNING",
  "user": {
    "name": "John"
  }
}

Définir un remappeur de statuts de log

L’attribut log_status contient le bon statut. Ajoutez un [remappeur de statuts de log] 3 pour vérifier que la valeur de statut de l’attribut log_status a bien remplacé le statut par défaut du log.

1. Accédez à Logs Pipelines et cliquez sur le pipeline traitant les logs.
2. Cliquez sur Add Processor.
3. Sélectionnez le type de processeur Status remapper.
4. Nommez le processeur.
5. Ajoutez log_status à la section Set status attribute(s).
6. Cliquez sur Create.

Les modifications apportées à un pipeline ont uniquement une incidence sur les nouveaux logs, car toutes les étapes de traitement sont réalisées durant le processus d’admission.

Logs JSON

Les logs JSON sont automatiquement parsés dans Datadog. Puisque l’attribut status des logs est un attribut réservé, il est soumis aux opérations de prétraitement pour les logs JSON.

Dans cet exemple, le statut réel du log correspond à la valeur de l’attribut logger_severity, et non au statut par défaut du log INFO.

Pour vérifier si la valeur de l’attribut logger_severity remplace le statut par défaut du log, ajoutez logger_severity à la liste des attributs de statut.

1. Accédez à Logs Pipelines et cliquez sur le pipeline traitant les logs.
2. Passez le curseur sur Preprocessing for JSON Logs, puis cliquez sur l’icône en forme de crayon.
3. Ajoutez logger_severity à la liste des attributs de statut. Le remappeur de statuts se charge de rechercher chaque attribut réservé en suivant l’ordre défini. Pour vous assurer que le statut provient de l’attribut logger_severity, placez-le en premier dans la liste.
4. Cliquez sur Save.

Les modifications apportées à un pipeline ont uniquement une incidence sur les nouveaux logs, car toutes les étapes de traitement sont réalisées durant le processus d’ingestion. Les nouveaux logs sont correctement configurés avec la valeur de l’attribut logger_severity.

Pour que le remappage fonctionne, vous devez utiliser les formats de statut indiqués dans la documentation relative aux processeurs.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Apprendre à remapper des valeurs de gravité personnalisées pour le statut officiel des logsDOCUMENTATION Apprendre à traiter vos logsDOCUMENTATION En savoir plus sur le parsingDOCUMENTATION Apprendre à étudier un problème de parsing de logDOCUMENTATION