Processeurs

Présentation

Un processeur s’exécute dans un pipeline pour effectuer une action de structuration de données sur un log (remappage d’un attribut, parsing Grok, etc.).

Remarque : les logs structurés doivent être envoyés dans un format valide. Si la structure contient des caractères impossibles à parser, il est nécessaire de les supprimer au niveau de l’Agent avec la fonctionnalité mask_sequences.

Nous vous conseillons de ne pas utiliser plus de 20 processeurs par pipeline.

Parser grok

Créez des règles Grok personnalisées pour parser l’intégralité du message ou un attribut spécifique de votre événement brut. Pour en savoir plus, consultez la section sur le parsing. Nous vous conseillons de ne pas utiliser plus de 10 règles de parsing par processeur Grok.

Dropdown

Définissez le processeur Grok depuis la page de configuration des logs Datadog :

Jusqu’à cinq échantillons peuvent être enregistrés avec le processeur, chacun pouvant contenir jusqu’à 5 000 caractères. Tous les échantillons affichent un statut (match ou no match) qui indique si l’une des règles de parsing du parser Grok correspond à l’échantillon. Cliquez sur un échantillon pour le sélectionner et déclencher son évaluation par rapport à la règle de parsing. Le résultat s’affiche alors en bas de l’écran.

Cliquez sur Parse my logs pour appliquer un ensemble de trois règles de parsing aux logs qui transitent par le pipeline sous-jacent. De là, vous pouvez ajuster le nommage des attributs et ajouter d’autres règles pour les autres types de logs si vous le souhaitez. Cette fonctionnalité nécessite que les logs correspondants soient indexés et transitent réellement par le pipeline : vous pouvez désactiver ou ajuster vos filtres d’exclusion temporairement pour répondre à ces exigences.

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le parser Grok :

{
  "type": "grok-parser",
  "name": "Parsing Log message",
  "is_enabled": true,
  "source": "message",
  "samples": ["sample log 1", "sample log 2"],
  "grok": {"support_rules": "<RÈGLES_SUPPORT>", "match_rules": "<RÈGLES_CORRESPONDANCE>"}
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`source`	Chaîne	oui	Le nom de l’attribut de log à parser. Valeur par défaut : `message`.
`samples`	Tableau de chaînes	non	Liste d’exemples de log (5 maximum) pour ce parser grok.
`grok.support_rules`	Chaîne	oui	Une liste de règles de prise en charge pour votre parser grok.
`grok.match_rules`	Chaîne	oui	Une liste de règles de correspondance pour votre parser Grok.

Remappeur de dates de log

Lorsque Datadog reçoit des logs, il leur attribue un timestamp à l’aide des valeurs de l’un de ces attributs par défaut :

timestamp
date
_timestamp
Timestamp
eventTime
published_date

Si la date de vos logs est spécifiée dans un attribut ne figurant pas dans cette liste, utilisez le processeur de remappage de dates de logs pour définir leur attribut date comme timestamp officiel pour ces logs :

Les formats de date reconnus sont : ISO8601, UNIX (le format EPOCH en millisecondes) et RFC3164.

Remarques :

Les événements de log peuvent être envoyés jusqu’à 18 h avant ou 2 h après la réalisation de l’événement.
Si vos logs ne comprennent aucun des attributs par défaut et que vous n’avez pas défini votre propre attribut date, Datadog utilise la date de réception des logs comme timestamp.
Si plusieurs processeurs de remappage de dates de log peuvent être appliqués à un log donné, seul le premier (selon la séquence des pipelines) est pris en compte.

Dropdown

Définissez le processeur de remappage de dates de log depuis la page de configuration des logs Datadog :

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le remappeur de dates de log :

{
  "type": "date-remapper",
  "name": "Définir <ATTRIBUT_SOURCE> comme date officielle du log",
  "is_enabled": false,
  "sources": ["<ATTRIBUT_SOURCE_1>"]
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`sources`	Tableau de chaînes	oui	Tableau des attributs sources.

Remappeur de statuts de log

Utilisez ce processeur si vous souhaitez définir des attributs en tant que statut officiel. Par exemple, il est possible de transformer ce log :

En ce log :

Chaque valeur de statut entrant est mappée comme suit :

Les entiers de 0 à 7 mappent vers les normes de sévérité Syslog.
Les chaînes de caractères commençant par emerg ou f (insensible à la casse) mappent vers emerg (0).
Les chaînes de caractères commençant par a (insensible à la casse) mappent vers alert (1).
Les chaînes de caractères commençant par c (insensible à la casse) mappent vers critical (2).
Les chaînes de caractères commençant par e (insensible à la casse) et ne correspondant pas à emerg mappent vers error (3).
Les chaînes de caractères commençant par w (insensible à la casse) mappent vers warning (4).
Les chaînes de caractères commençant par n (insensible à la casse) mappent vers notice (5).
Les chaînes de caractères commençant par i (insensible à la casse) mappent vers info (6).
Les chaînes de caractères commençant par d, trace ou verbose (insensible à la casse) mappent vers debug (7).
Les chaînes de caractères commençant par o ou s, ou correspondant à OK ou Success (insensible à la casse) mappent vers OK
Toutes les autres chaînes de caractères mappent vers info (6).

Remarque : si plusieurs processeurs de remappage du statut de log peuvent être appliqués à un log donné, seul le premier (selon la séquence des pipelines) est pris en compte.

Dropdown

Définissez le processeur de remappage de statut de log depuis la page de configuration des logs Datadog :

Carré du processeur de remappage de la gravité

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le remappeur de statuts de log :

{
  "type": "status-remapper",
  "name": "Définir <ATTRIBUT_SOURCE> en tant que statut officiel du log",
  "is_enabled": true,
  "sources": ["<ATTRIBUT_SOURCE>"]
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`sources`	Tableau de chaînes	oui	Tableau des attributs sources.

Remappeur de services

Utilisez ce processeur si vous souhaitez définir au moins un attribut en tant que service officiel.

Remarque : si plusieurs processeurs de remappage de services peuvent être appliqués à un log donné, seul le premier (selon la séquence des pipelines) est pris en compte.

Dropdown

Définissez le processeur de remappage de services de log depuis la page de configuration des logs Datadog :

Carré du processeur de remappage de services

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le remappeur de statut de log :

{
  "type": "service-remapper",
  "name": "Définir <ATTRIBUT_SOURCE> en tant que service de log officiel",
  "is_enabled": true,
  "sources": ["<ATTRIBUT_SOURCE>"]
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`sources`	Tableau de chaînes	oui	Tableau des attributs sources.

Remappeur de messages de log

Le message est un attribut clé dans Datadog. Il est affiché dans la colonne de message du Log Explorer et vous permet d’effectuer des recherches en texte intégral. Utilisez ce processeur pour définir un ou plusieurs attributs en tant que message de log officiel.

Remarque : si plusieurs processeurs de remappage de messages de log peuvent être appliqués à un log donné, seul le premier (selon la séquence des pipelines) est pris en compte.

Dropdown

Définissez le processeur de remappage de messages de log depuis la page de configuration des logs Datadog :

Utilisez l'endpoint de l’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le remappeur de messages de log :

{
  "type": "message-remapper",
  "name": "Définir <ATTRIBUT_SOURCE> en tant que message officiel du log",
  "is_enabled": true,
  "sources": ["msg"]
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`sources`	Tableau de chaînes	oui	Tableau des attributs sources. Valeur par défaut : `msg`

Remappeur

Le processeur effectue un remappage de n’importe quel attribut ou tag source vers un autre attribut ou tag cible. Il peut transformer ce log :

En ce log :

Les contraintes de nom du tag ou de l’attribut sont expliquées dans les recommandations relatives aux tags. Certaines contraintes supplémentaires s’appliquent, car les caractères : ou , ne sont pas autorisés dans le nom du tag ou de l’attribut cible.

Si la cible du remappeur est un attribut, le remappeur peut également tenter de convertir l’attribut en un attribut d’un autre type (String, Integer ou Double). Si la conversion est impossible, le type d’attribut reste le même (remarque : le séparateur décimal pour Double doit être un .)

Dropdown

Définissez le processeur de remappage depuis la page de configuration des logs Datadog. Dans l’exemple ci-dessous, il effectue un remappage de user vers user.firstname.

Carré du processeur de remappage d'attribut

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le remappeur :

{
  "type": "attribute-remapper",
  "name": "Convertir <ATTRIBUT_SOURCE> en <ATTRIBUT_CIBLE>",
  "is_enabled": true,
  "source_type": "attribute",
  "sources": ["<ATTRIBUT_SOURCE>"],
  "target": "<ATTRIBUT_CIBLE>",
  "target_type": "tag",
  "target_format": "integer",
  "preserve_source": false,
  "override_on_conflict": false
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`source_type`	Chaîne	non	Définit si les sources sont de type `attribute` ou `tag`. Valeur par défaut : `attribute`
`sources`	Tableau de chaînes	oui	Tableau des tags ou attributs sources.
`target`	Chaîne	oui	Le nom final de l’attribut ou du tag pour le remappage des sources.
`target_type`	Chaîne	non	Définit si la cible est de type `attribute` ou `tag`. Valeur par défaut : `attribute`
`target_format`	Chaîne	non	Définit si la valeur de l’attribut doit être convertie en valeur d’un autre type. Valeurs possibles : `auto`, `string`, `long` et `integer`. Valeur par défaut : `auto`. Lorsque défini sur `auto`, aucune conversion n’est effectuée.
`preserve_source`	Booléen	non	Indique si l’élément source remappé doit être préservé ou supprimé. Valeur par défaut : `false`
`override_on_conflict`	Booléen	non	Indique si l’élément cible est remplacé ou non si celui-ci est déjà défini. Valeur par défaut : `false`.

Parser d’URL

Ce processeur extrait les paramètres de requête et d’autres paramètres importants à partir d’une URL. Une fois configuré, les attributs suivants sont obtenus :

Dropdown

Définissez le processeur de parsing d’URL depuis la page de configuration des logs Datadog :

{
  "type": "url-parser",
  "name": "Parser l'URL depuis l'attribut http.url.",
  "is_enabled": true,
  "sources": ["http.url"],
  "target": "http.url_details"
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`sources`	Tableau de chaînes	non	Tableau des attributs sources. Valeur par défaut : `http.url`.
`target`	Chaîne	oui	Le nom de l’attribut parent qui contient tous les détails extraits des `sources`. Valeur par défaut : `http.url_details`.

Parser de user-agent

Le parser de user-agent reçoit un attribut user-agent et extrait le système d’exploitation, le navigateur, l’appareil et d’autres données utilisateur. Il reconnaît les principaux bots comme Google Bot, Yahoo Slurp et Bing. Une fois configuré, les attributs suivants sont obtenus :

Remarque : si vos logs comprennent des user-agents encodés (c’est par exemple le cas des logs IIS), configurez ce processeur de façon à ce qu’il décode l’URL avant son parsing.

Dropdown

Définissez le processeur de user-agent depuis la page de configuration des logs Datadog :

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le parser de user-agent :

{
  "type": "user-agent-parser",
  "name": "Parse <ATTRIBUT_SOURCE> pour en extraire toutes les informations sur le User-Agent",
  "is_enabled": true,
  "sources": ["http.useragent"],
  "target": "http.useragent_details",
  "is_encoded": false
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`sources`	Tableau de chaînes	non	Un tableau des attributs sources. Valeur par défaut : `http.useragent`.
`target`	Chaîne	oui	Le nom de l’attribut parent qui contient tous les détails extraits des `sources`. Valeur par défaut : `http.useragent_details`.
`is_encoded`	Booléen	non	Définit si l’attribut source est encodé dans une URL ou non. Valeur par défaut : `false`.

Processeur de catégories

Utilisez le processeur de catégories pour ajouter un nouvel attribut (sans espace ni caractère spécial dans le nom du nouvel attribut) à un log correspondant à votre requête de recherche. Utilisez les catégories pour créer des groupes à des fins d’analyse (tels que des groupes d’URL, des groupes de machines, des environnements et des compartiments de temps de réponse).

Remarques :

La syntaxe de la requête est identique à celle de la barre de recherche du Log Explorer. La requête peut être effectuée sur n’importe quel tag ou attribut de log, qu’il s’agisse d’une facette ou non. Votre requête peut également contenir des wildcards.
Une fois que l’une des requêtes du processeur a renvoyé un log, celle-ci s’arrête. Assurez-vous de spécifier les requêtes dans l’ordre adéquat si un log correspond à plusieurs requêtes.
Les catégories doivent avoir un nom unique.
Une fois le processeur de catégories défini, vous pouvez mapper des catégories à des statuts de log à l’aide du remappeur de statuts de log.

Dropdown

Définissez le processeur de catégories depuis la page de configuration des logs Datadog. Par exemple, pour catégoriser vos logs d’accès Web en fonction de la plage de valeurs du code de statut (« OK » pour un code de réponse entre 200 et 299, « Notice » pour un code de réponse entre 300 et 399, etc.), ajoutez ce processeur :

Cela génère le résultat suivant :

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le processeur de catégories :

{
  "type": "category-processor",
  "name": "Attribuer une valeur personnalisée à l'attribut <ATTRIBUT_CIBLE>",
  "is_enabled": true,
  "categories": [
    {"filter": {"query": "<REQUÊTE_1>"}, "name": "<VALEUR_À_ATTRIBUER_1>"},
    {"filter": {"query": "<REQUÊTE_2>"}, "name": "<VALEUR_À_ATTRIBUER_2>"}
  ],
  "target": "<ATTRIBUT_CIBLE>"
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`categories`	Tableau d’objets	oui	Un tableau de filtres pour inclure ou exclure un log et son attribut `name` correspondant pour attribuer une valeur personnalisée au log.
`target`	Chaîne	oui	Le nom de l’attribut cible dont la valeur est définie par la catégorie correspondante.

Processeur arithmétique

Utilisez le processeur arithmétique pour ajouter un nouvel attribut (sans espace ni caractère spécial dans le nouveau nom de l’attribut) à un log avec le résultat de la formule fournie. Cela vous permet de remapper différents attributs de temps avec différentes unités vers un seul attribut, ou de calculer des opérations sur des attributs dans le même log.

Cette formule peut utiliser des parenthèses et les opérateurs arithmétiques de base : -, +, * et /.

Par défaut, le calcul est ignoré s’il manque un attribut. Sélectionnez « Replace missing attribute by 0 » pour remplacer automatiquement les valeurs d’attribut manquantes par 0 et ainsi garantir la réalisation du calcul. Un attribut est considéré comme manquant s’il est introuvable dans les attributs de log, ou s’il ne peut pas être converti en chiffre.

Remarques :

L’opérateur - doit être séparé par une espace dans la formule, car il peut également être présent dans les noms d’attributs.
Si l’attribut cible existe déjà, il est remplacé par le résultat de la formule.
Les résultats sont arrondis à la 9e décimale. Par exemple, si le résultat de la formule est 0.1234567891, la valeur stockée pour l’attribut est alors 0.123456789.
Si vous devez mettre à l’échelle une unité de mesure, consultez la section Filtre.

Dropdown

Définissez le processeur arithmétique depuis la page de configuration des logs Datadog :

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le processeur arithmétique :

{
  "type": "arithmetic-processor",
  "name": "<NOM_PROCESSEUR>",
  "is_enabled": true,
  "expression": "<OPÉRATION_ARITHMÉTIQUE>",
  "target": "<ATTRIBUT_CIBLE>",
  "is_replace_missing": false
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`expression`	Chaîne	oui	Une opération arithmétique entre un ou plusieurs attributs de log.
`target`	Chaîne	oui	Le nom de l’attribut qui contient le résultat de l’opération arithmétique.
`is_replace_missing`	Booléen	non	Définir sur `true` pour remplacer tous les attributs manquants dans `expression` par 0. Définir sur `false` pour annuler l’opération si un attribut est manquant. Valeur par défaut : `false`.

Processeur de générateur de chaînes

Utilisez le processeur de générateur de chaînes pour ajouter un nouvel attribut (sans espace ni caractères spéciaux) à un log avec le résultat du modèle fourni. Cela permet d’agréger différents attributs de chaînes bruts au sein d’un attribut unique.

Le modèle est défini par du texte brut et des blocs, avec la syntaxe %{chemin_attribut}.

Remarques :

Le processeur accepte uniquement les attributs avec des valeurs ou un tableau de valeurs dans les blocs (consultez les exemples dans la section IU).
Si un attribut ne peut pas être utilisé (s’il s’agit d’un objet ou d’un tableau d’objets), il est remplacé par une chaîne vide ou toute l’opération est ignorée, selon l’option choisie.
Si l’attribut cible existe déjà, il est remplacé par le résultat du modèle.
Les résultats du modèle ne peuvent pas comporter plus de 256 caractères.

Dropdown

Définissez le processeur de générateur de chaînes sur la page de configuration des logs Datadog :

Exemple

Avec le log suivant :

{
  "http": {
    "method": "GET",
    "status_code": 200,
    "url": "https://app.datadoghq.com/users"
  },
  "array_ids": [123, 456, 789],
  "array_users": [
    {"first_name": "Marie", "last_name": "Martin"},
    {"first_name": "Arnaud", "last_name": "Robert"}
  ]
}

Vous pouvez utiliser le modèle Request %{http.method} %{http.url} a obtenu la réponse %{http.status_code}, qui renvoie le résultat suivant :

Request GET https://app.datadoghq.com/users was answered with response 200

Objets :

Dans l’exemple de log, http est un objet et ne peut pas être utilisé dans un bloc (%{http} entraîne une erreur), tandis que %{http.method}, %{http.status_code} ou %{http.url} renvoie la valeur correspondante.

Tableaux :

Des blocs peuvent être utilisés dans des tableaux de valeurs ou un attribut spécifique d’un tableau. Pour notre exemple de log, l’ajout du bloc %{array_ids} renvoie ce qui suit :

123,456,789

À l’inverse, %{array_users} ne renvoie aucun résultat, car il s’agit d’une liste d’objets. Toutefois, %{array_users.first_name} renvoie la liste des first_name contenus dans le tableau :

Marie,Arnaud

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le processeur de générateur de chaînes :

{
  "type": "string-builder-processor",
  "name": "<NOM_PROCESSEUR>",
  "is_enabled": true,
  "template": "<MODÈLE_GÉNÉRATEUR_CHAÎNES>",
  "target": "<ATTRIBUT_CIBLE>",
  "is_replace_missing": true
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	Oui	Le type de processeur.
`name`	Chaîne	Non	Le nom du processeur.
`is_enabled`	Booléen	Non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`template`	Chaîne	Oui	Une formule avec un ou plusieurs attributs et du texte brut.
`target`	Chaîne	Oui	Le nom de l’attribut qui contient le résultat du modèle.
`is_replace_missing`	Booléen	Non	Si ce paramètre est défini sur `true`, il remplace tous les attributs manquants dans `template` par une chaîne vide. S’il est défini sur `false` (valeur par défaut), l’opération est annulée en cas d’attribut manquant.

Parser GeoIP

Le parser GeoIP reçoit un attribut adresse IP et extrait le continent, le pays, la sous-division ainsi que la ville (si ces informations sont disponibles) dans le chemin de l’attribut cible.

Dropdown

La plupart des éléments contiennent un attribut name et iso_code (ou code pour le continent). L’attribut subdivision est le premier niveau de sous-division que le pays utilise, comme les « States » pour les États-Unis ou les « Départements » pour la France.

Un exemple de parser GeoIP se trouve ci-dessous. Il extrait la géolocalisation de l’attribut network.client.ip et la stocke dans l’attribut network.client.geoip :

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le parser Geo-IP :

{
  "type": "geo-ip-parser",
  "name": "Parser les éléments de géolocalisation depuis l'attribut network.client.ip.",
  "is_enabled": true,
  "sources": ["network.client.ip"],
  "target": "network.client.geoip"
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`sources`	Tableau de chaînes	non	Un tableau des attributs sources. Valeur par défaut : `network.client.ip`.
`target`	Chaîne	oui	Le nom de l’attribut parent qui contient tous les détails extraits des `sources`. Valeur par défaut : `network.client.geoip`.

Processeur de correspondances

Utilisez le processeur de correspondances pour mapper un attribut de log à une valeur lisible enregistrée dans une table d’enrichissement (bêta) ou dans la table de mappage des processeurs. Ce processeur peut par exemple servir à mapper un ID de service interne à un nom de service plus lisible. Il peut également vérifier si une adresse MAC qui vient d’essayer de se connecter à votre environnement de production fait partie d’une liste de machines volées.

Dropdown

Le processeur effectue les actions suivantes :

Vérifie si le log actuel contient l’attribut source.
Vérifie si l’attribut source est présent dans la table de mappage.
- S’il est présent, le processeur crée l’attribut source avec la valeur correspondante dans la table.
- S’il ne parvient pas à trouver la valeur dans la table de mappage, il crée un attribut cible avec la valeur par défaut (facultatif).

Vous pouvez renseigner la table de mappage en sélectionnant une table d’enrichissement, en ajoutant manuellement une liste de paires source_key,target_value ou en important un fichier CSV.

La limite de poids pour la table de mappage est de 100 Ko. Cette limite s’applique à l’ensemble des processeurs de correspondances sur la plateforme. Toutefois, les tables d’enrichissement prennent en charge les fichiers plus volumineux.

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le processeur de correspondances :

{
  "type": "lookup-processor",
  "name": "<NOM_PROCESSEUR>",
  "is_enabled": true,
  "source": "<ATTRIBUT_SOURCE>",
  "target": "<ATTRIBUT_CIBLE>",
  "lookup_table": ["key1,value1", "key2,value2"],
  "default_lookup": "<VALEUR_CIBLE_PARDÉFAUT>"
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	oui	Indique si le processeur est activé ou non. Valeur par défaut : `false`
`source`	Chaîne	oui	L’attribut source utilisé pour la mise en correspondance.
`target`	Chaîne	oui	Le nom de l’attribut qui contient la valeur correspondante dans la liste de mappage ou la valeur `default_lookup` si la valeur correspondante ne figure pas dans la liste de mappage.
`lookup_table`	Tableau de chaînes	oui	Table de mappage contenant les valeurs des attributs sources et les valeurs des attributs cibles associées. Format : [ “source_key1,target_value1”, “source_key2,target_value2” ]
`default_lookup`	Chaîne	non	Valeur à définir pour l’attribut cible si la valeur source ne figure pas dans la liste.

Remappeur de traces

Il existe deux façons d’améliorer la corrélation entre les traces et les logs d’application :

Consultez la documentation sur l'ajout d’un ID de trace dans les logs d’application et sur l’utilisation des intégrations de log par défaut pour terminer la configuration.
Utilisez le processeur de remappage de traces pour définir un attribut de log comme son ID de trace associé.

Dropdown

Définissez le processeur de remappage de traces depuis la page de configuration des logs Datadog. Entrez le chemin de l’attribut ID de trace dans le carré du processeur, comme suit :

Utilisez l'endpoint d’API de pipeline de logs Datadog avec la charge utile JSON suivante pour le remappeur de traces :

{
  "type": "trace-id-remapper",
  "name": "Définir dd.trace_id en tant qu'ID de trace officiel associé à ce log",
  "is_enabled": true,
  "sources": ["dd.trace_id"]
}

Paramètre	Type	Obligatoire	Description
`type`	Chaîne	oui	Le type de processeur.
`name`	Chaîne	non	Le nom du processeur.
`is_enabled`	Booléen	non	Indique si le processeur est activé ou non. Valeur par défaut : `false`.
`sources`	Tableau de chaînes	non	Tableau des attributs sources. Valeur par défaut : `dd.trace_id`.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Découvrir les pipelines de DatadogDOCUMENTATION

Collecte illimitée de logsDOCUMENTATION

Apprendre à explorer vos logsDOCUMENTATION