Passer au contenu principal
Nous sommes sur le point de vous migrer vers la nouvelle syntaxe de requête pour le logging. Cela vous permettra d’interroger vos logs plus efficacement. La nouvelle syntaxe de requête a un impact sur les domaines de logging suivants. Examinez chacun d’eux pour voir les changements notables : Assurez-vous d’être au courant de tous ces changements, et contactez le support pour démarrer le processus de migration.

Langage de requête

Le langage de requête change de plusieurs manières importantes. Voici quelques-uns des changements les plus notables :
  1. Plus de préfixe attributes. — Les attributs personnalisés peuvent désormais être interrogés directement. Au lieu de attributes.user_id_int=12345, utilisez simplement user_id=12345.
  2. Plus de suffixes de type — Vous n’avez plus besoin d’ajouter _int, _string ou _double aux noms d’attributs. Le moteur de requête détermine automatiquement le bon type en fonction de l’opérateur que vous utilisez.
  3. Prise en charge du JSON imbriqué — Interrogez des objets imbriqués à l’aide de la notation par points : user.email="user@example.com" et les éléments de tableau par index : user.roles.0=admin.
  4. Logique OR et parenthèses — Construisez des requêtes complexes avec des opérateurs OR explicites et des parenthèses pour le regroupement : severity=error AND (hostname=web-1 OR hostname=web-2).
  5. Syntaxe de liste remplacée — La syntaxe field=[value1, value2] est remplacée par des instructions OR, ce qui est plus flexible et prend en charge tous les opérateurs, et pas seulement les correspondances exactes.
Par exemple : Ancienne syntaxe :
message:"API request" attributes.user_id_int=12345 severity=[info, warn]
Nouvelle syntaxe :
message:"API request" user.id=12345 (severity=info OR severity=warn)
Pour tous les détails sur la nouvelle syntaxe, consultez notre documentation de la syntaxe de requête. Pour référencer l’ancienne syntaxe, consultez la documentation de l’ancienne syntaxe de requête.

Vues enregistrées

Vos vues enregistrées seront mises à jour avec la nouvelle syntaxe de requête. Après la migration, vérifiez les vues pour tout problème éventuel.

Déclencheurs de log

Vos déclencheurs de log seront mis à jour avec la nouvelle syntaxe de requête. Après la migration, vérifiez les déclencheurs pour tout problème éventuel. Les déclencheurs qui étaient ouverts seront fermés, et vous obtiendrez de nouveaux incidents après la migration.

Stockage à long terme

Nous apportons une modification à la sortie des exports de stockage à long terme. Au lieu d’un champ « attributes » contenant une map unidimensionnelle de paires clé-valeur d’attributs, nous exporterons un objet JSON stringifié avec tous les attributs. Par exemple : Ancienne sortie :
{
  "timestamp": "1970-01-01 00:04:00.000",
  "source_id": "source-json",
  "hostname": null,
  "group": "group",
  "severity": "info",
  "message": null,
  "attributes": {
    "user.name": "alice",
    "user.id": "123",
    "request_id": "abc-123",
    "status_code": "200",
    "response_time": "45.67",
    "success": "true"
  }
}
Nouvelle sortie :
{
  "timestamp": "1970-01-01 00:04:00.000",
  "hostname": null,
  "group": "group",
  "severity": "info",
  "message": null,
  "source_id": "source-json",
  "attributes": "{\"user\": {\"name\":\"alice\", \"id\":\"123\"},\"request_id\":\"abc-123\",\"status_code\":200,\"response_time\":45.67,\"success\":true}"
}