Glossaire de l’observabilité et termes LogBrew

LogBrew utilise un seul terme pour chaque concept du produit. Les champs d’API, les options de la CLI, les valeurs d’enum, les noms d’événements et les clés d’attributs restent identiques dans toutes les langues.

Observabilité et surveillance

Terme	Signification
Observabilité	Comprendre le comportement d’une application à partir des preuves qu’elle produit.
Télémétrie	Les signaux qu’une application envoie, comme les logs, les traces et les métriques.
Surveillance (monitoring)	Vérifier des conditions connues, par exemple une valeur mesurée par rapport à un seuil.
`o11y`	Abréviation de l’anglais « observability » (observabilité). Le nombre compte les 11 lettres entre `o` et `y`.

Pour choisir un signal et voir des exemples détaillés, lisez Télémétrie.

Agents IA

Terme	Signification
Serveur MCP	Le serveur LogBrew hébergé pour le Model Context Protocol. Les agents IA l’utilisent pour lire les projets autorisés.
Client MCP	Une application qui connecte un agent IA à un serveur MCP, comme Claude Code.
Projet autorisé	Un projet que vous avez sélectionné en donnant l’accès à un client MCP. Le client peut lire uniquement les projets autorisés.
Connexion MCP	L’accès que vous donnez à 1 client MCP quand vous l’autorisez. Il prend fin après 30 jours sans utilisation, après 90 jours ou quand vous le révoquez. La CLI l’appelle un « grant ».

Pour connecter un client, lisez Connecter un agent IA avec MCP.

Signaux d’observabilité

Problème

Un échec regroupé qui peut contenir plusieurs occurrences. Une occurrence est une instance capturée de ce problème. first_seen_at est l’heure de la première occurrence. last_seen_at est l’heure de l’occurrence la plus récente.

Log

Un enregistrement horodaté d’un événement (une entrée de journal). Un log peut porter une gravité, un service, une version, un environnement, un contexte de trace et des attributs limités par les règles de confidentialité.

Trace et span

Une trace suit le travail effectué au cours d’une requête ou d’une opération. Un span est une opération chronométrée dans cette trace. Une corrélation avec une trace est une preuve de contexte partagé ; ce n’est pas une preuve de cause.

Métrique

Une mesure d’exécution avec une unité, un type, une agrégation et une période définis. Les points de métrique ne sont pas interchangeables avec les nombres de logs, de traces ou de problèmes.

Version

Une version déployée d’une application ou d’un service, signalée avec la télémétrie. Une version n’est pas le même objet qu’un projet ou un dépôt.

Action

Un événement produit classé, comme une inscription, un paiement, un import ou une tâche en échec. Les analyses produit classent une action comme une vue de page, une vue d’écran ou une interaction. Une action n’est pas une commande automatique exécutée par LogBrew.

Investigation des problèmes

Toutes les occurrences ne contiennent pas tous les champs.

Terme	Signification
Gravité	L’urgence d’un signal : `info`, `warning`, `error` ou `critical`. Elle est distincte du statut du problème.
Statut du problème	L’état d’un problème regroupé dans le workflow : `unresolved`, `resolved` ou `archived`. Ce n’est pas le résultat d’une requête.
Problème archivé	Un problème que l’équipe a retiré du triage actif. Les anciennes réponses appellent ce statut `ignored`.
Priorité du problème	L’ordre de triage d’un problème regroupé : `high`, `medium` ou `low`. Elle suit la gravité jusqu’à ce qu’une personne la définisse.
Origine de la priorité	D’où vient la priorité. `derived` suit la gravité : `error` et `critical` donnent `high`, `warning` donne `medium` et `info` donne `low`. `manual` est une priorité définie par une personne.
Responsable du problème	Le compte ou l’équipe qui s’occupe de l’étape suivante d’un problème regroupé. Un problème en a 1 au plus. Un compte doit pouvoir lire le projet. Une équipe doit appartenir à l’organisation du projet.
Équipe	Un groupe de membres d’une organisation, qui porte un nom. Vous pouvez attribuer des problèmes à une équipe, et les règles de propriété peuvent la désigner. Une équipe ne donne à ses membres aucun accès aux projets.
Règle de propriété	Une règle du projet qui associe un chemin de frame de pile, un module, une route, un service ou un tag aux comptes ou aux équipes propriétaires des problèmes qui correspondent.
Propriétaire suggéré	Un compte ou une équipe que LogBrew propose pour un problème, d’après une règle de propriété, une ligne du fichier CODEOWNERS ou l’activité récente. C’est une suggestion, pas une attribution.
Boîte de réception	La liste des problèmes que d’autres personnes vous ont attribués, à vous ou à vos équipes. LogBrew n’envoie pas d’e-mail pour cette liste.
Trace de pile	La preuve capturée des appels de fonctions pour une erreur. Elle est différente d’une trace distribuée.
Frame de pile	Une entrée d’une trace de pile. Elle peut identifier une fonction, un module, un fichier, une ligne ou une colonne.
Chaîne d’exceptions	Des exceptions liées, signalées ensemble, comme une erreur et sa cause. Des entrées manquantes, masquées ou tronquées limitent les preuves.
Frame applicatif	Un frame de pile marqué comme code de l’application. Il montre du code à examiner. Il ne prouve pas la faute.
Breadcrumb	Un court événement enregistré avant une occurrence de problème. Les breadcrumbs ne sont pas un enregistrement complet d’une session.
Exception gérée	Une exception que l’application a signalée comme gérée. Elle ne prouve pas que l’opération a réussi.
Source map	Un artefact de build qui associe les emplacements du JavaScript généré aux emplacements du code source d’origine.
Frame symbolisé	Un frame dont l’emplacement généré a été résolu en informations du code source d’origine.
Occurrence de référence	L’occurrence capturée utilisée comme référence pour la reproduction.
Provenance	D’où vient une évaluation. `backend_observed` signifie que LogBrew l’a observée. `application_reported` signifie que l’application l’a signalée et que LogBrew ne l’a pas vérifiée.
Préparation à la reproduction	Indique si l’occurrence de référence contient les preuves nécessaires pour tenter une reproduction. Ce n’est pas un test de reproduction réussi.

Pour l’ordre de lecture et les champs de la réponse, consultez le guide Investiguer un problème.

Identité et corrélation

Une valeur manquante ne prouve pas que l’activité associée n’a pas eu lieu.

Terme	Signification
Contexte de trace	Les identifiants de trace et de span qui relient le travail entre les signaux.
Span racine	Le span qui démarre une trace et n’a pas de span parent. Le premier span renvoyé n’est pas forcément la racine.
Span enfant	Un span qui a un span parent dans la même trace.
Corrélation	Une relation exacte renvoyée par LogBrew, comme un ID de trace partagé. Elle ne prouve pas la cause.
Utilisateur identifié	Un sujet fourni par l’application, avec un ID stable et le type `user`.
Sujet anonyme	Un sujet fourni par l’application, avec le type `anonymous`. Les décomptes le séparent des utilisateurs identifiés.
Type d’identité inconnu	Un sujet sans type connu. Il n’est pas compté comme utilisateur identifié.
Sujet manquant	Un événement sans sujet. C’est différent d’un sujet dont le type est inconnu.

Le type d’identité montre comment l’application a classé son sujet. Il ne prouve pas que les données sont anonymes. Un ID stable peut quand même relier des activités.

Périmètre et qualité des données

Terme	Signification
Projet	La principale limite de produit que vous possédez. Un projet peut contenir plusieurs services ou composants de dépôt.
Service	Un runtime ou un composant qui envoie des données, au sein d’un projet.
Environnement	Un contexte d’envoi exact, comme production ou staging.
Ingéré	Accepté selon le contrat d’ingestion. Cela ne garantit pas une conservation illimitée.
Indexé	Disponible pour l’index ou la requête indiqués. Ce n’est pas un synonyme d’ingéré.
Conservé	Présent dans la période de données évaluée.
Échantillonné	Une partie de la télémétrie a été sélectionnée avant ou pendant la collecte.
Couverture	Une proportion mesurée, avec un numérateur et un dénominateur explicites.
Tronqué	La réponse a atteint une limite. Les données omises ne sont pas forcément absentes.
Approximatif	Estimé selon la méthode documentée plutôt que compté exactement.
Période	Le laps de temps exact qu’une requête évalue.

Mesures et temps

Terme	Signification
Point de données	Une valeur à une heure donnée. Lisez le nom et l’unité de la métrique avant de comparer des points de données.
Série temporelle	Les valeurs d’une même mesure, classées dans l’ordre chronologique. Un trou ne signifie pas que la valeur était nulle.
Durée	Le temps écoulé pendant une opération. C’est différent du moment où l’opération a eu lieu.
Agrégation	Un calcul défini sur plusieurs mesures, comme une somme ou une moyenne.
Intervalle	Une tranche de temps dans un graphique ou un résultat groupé. Son début et sa fin définissent son étendue.
Période incomplète	Une période qui n’est pas encore terminée. Ce n’est pas une période terminée sans activité.

N’additionnez pas les durées de spans enfants qui se chevauchent pour obtenir la durée totale d’une requête. Ne comparez pas un nombre d’événements avec un nombre d’utilisateurs identifiés.

États des preuves

Ces états ne sont pas interchangeables :

Capturé : la preuve est présente.
Manquant : la preuve n’a pas été capturée.
Masqué : la preuve a été volontairement cachée.
Tronqué : la preuve a dépassé une limite de réponse ou de capture.
Indisponible : la lecture n’a pas pu fournir la preuve.

Likely cause (cause probable) et likely fix area (zone de correction probable) décrivent des preuves de diagnostic limitées, pas une cause racine prouvée. Reported impact (impact signalé) est fourni par l’application qui envoie les données, sauf si un contrat décrit explicitement une mesure LogBrew.

Analyses produit

Terme	Signification
Événement	Une activité produit classée, avec un nom stable exact.
Propriété	Une clé de contexte utilisée pour décrire ou filtrer un événement.
Session	Une visite ou une session d’application, pas une personne.
Cohorte	Un groupe limité, défini par des critères exacts.
Entonnoir	Des étapes ordonnées qui mesurent la progression ou la conversion.
Rétention	Le comportement de retour, mesuré avec une période et un dénominateur explicites.
Parcours	Les parcours de session avant ou après un événement sélectionné.
Cycle de vie	Classe les sujets identifiés de chaque période comme : nouveau dans l’historique observé, récurrent, réactivé ou inactif.
Nouveau dans l’historique observé	Actif sans événement sélectionné antérieur dans la période d’historique limitée. Cela ne désigne pas un nouveau client.

Les périodes incomplètes, les identités manquantes, la capture incomplète des propriétés, l’échantillonnage et la troncature nuancent le résultat. LogBrew affiche ces limites au lieu de les transformer en zéro ou en certitude. Pour les règles de comptage, lisez Analyses produit. Pour envoyer une activité classée et une identité typée, utilisez Capture d’événements produit.

​Observabilité et surveillance

​Agents IA

​Signaux d’observabilité

​Investigation des problèmes

​Identité et corrélation

​Périmètre et qualité des données

​Mesures et temps

​États des preuves

​Analyses produit