From 439dbb2500bc6bff6bfe0c813c3a72e0248d0d61 Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Fri, 20 Dec 2024 15:16:30 +0100 Subject: [PATCH 01/12] Issue #5826: Create observability-primer.md (French version) --- content/fr/concepts/observability-primer.md | 107 ++++++++++++++++++++ 1 file changed, 107 insertions(+) create mode 100644 content/fr/concepts/observability-primer.md diff --git a/content/fr/concepts/observability-primer.md b/content/fr/concepts/observability-primer.md new file mode 100644 index 000000000000..6275c49108af --- /dev/null +++ b/content/fr/concepts/observability-primer.md @@ -0,0 +1,107 @@ +--- +title: Introduction à l'observabilité +description: Concepts fondamentaux de l'observabilité +weight: 9 +default_lang_commit: 71833a5f8b84110dadf1e98604b87a900724ac33 +cSpell:ignore: webshop + +--- + +## Qu'est-ce que l'observabilité ? + +L'observabilité est la capacité à comprendre l'état d'un système en examinant ses données sortantes, sans avoir besoin de connaître son fonctionnement interne. Elle permet non seulement de résoudre facilement les problèmes et d'appréhender les nouveaux "inconnus inconnus" mais également de répondre à la question "Pourquoi cela arrive-t-il ?" + +Pour pouvoir poser ce type de questions à votre système, votre application doit être correctement instrumentée, c'est-à-dire que votre code doit émettre : +[des signaux](/docs/concepts/signals/) tels que +[des traces](/docs/concepts/signals/traces/), +[des métriques](/docs/concepts/signals/metrics/), et +[des logs](/docs/concepts/signals/logs/). + +Une application est correctement instrumentée si les développeurs disposent de toutes les informations nécessaires pour corriger un problème et n'ont pas besoin d'ajouter une instrumentation supplémentaire. + +[OpenTelemetry](/docs/what-is-opentelemetry/) est le mécanisme permettant d'instrumenter le code des applications afin de rendre le système observable. + +## Fiabilité et métriques + +Le terme **télémétrie** fait référence aux données émises par un système et son comportement. Les données peuvent prendre la forme de [traces](/docs/concepts/signals/traces/), de [métriques](/docs/concepts/signals/metrics/), et de +[logs](/docs/concepts/signals/logs/). + +La **fiabilité** répond à la question : "Est-ce que le service fait ce que les utilisateurs attendent de lui ?" +Un système peut afficher un pourcentage de disponibilité de 100% mais s'il ne répond pas à la demande de l'utilisateur (par exemple : ajouter une paire de chaussettes noires dans le panier à chaque fois qu'il clique sur "Ajouter au panier"), alors le système pourrait être considéré comme **peu** fiable. + +Les **métriques** sont un ensemble de données numériques collectées pour votre infrastructure ou votre application sur une période donnée. Le nombre d'erreurs système, le nombre d'erreurs sur les requêtes ainsi que l'utilisation mémoire d'un service donné sont quelques exemples de métriques. Pour plus d'informations sur les métriques et leur rôle dans OpenTelemetry, référez-vous à la page [Métriques](/docs/concepts/signals/metrics/). + +L'indicateur de niveau de service, également connu sous le nom de **SLI**, est un indicateur de fonctionnement d'un service qui est évalué côté utilisateur. La vitesse à laquelle une page Web se charge est un exemple de SLI. + +Les objectifs de niveau de service, communément appelé **SLO**, permettent de rendre compte à une organisation ou à d'autres équipes de la fiabilité d'un système. + +## Comprendre le traçage distribué + +Le traçage distribué vous permet d'observer les requêtes au fur et à mesure qu'elles se propagent au travers de systèmes distribués complexes. Il vous offre une meilleure visibilité sur la santé de votre application ou de votre système et vous permet de debugger un comportement qu'il est difficile de reproduire localement. Le traçage distribué est indispensable pour les systèmes distribués pour lesquels nous rencontrons souvent des problèmes aléatoires ou difficiles à reproduire localement. + +Pour comprendre le traçage distribué, vous devez comprendre le rôle de chacun de ses composants : les logs, les spans et les traces. + +### Logs + +Un **log** est un message horodaté émis par des services ou d'autres composants. Contrairement aux [traces](#distributed-traces), ils ne sont pas nécessairement associés à une requête ou une transaction utilisateur en particulier. Presque tous les logiciels émettent des logs. Par le passé, les développeurs et les opérateurs se sont largement appuyés sur les logs pour comprendre le comportement des systèmes. + +Exemple de log : + +```text +I, [2021-02-23T13:26:23.505892 #22473] INFO -- : [6459ffe1-ea53-4044-aaa3-bf902868f730] Started GET "/" for ::1 at 2021-02-23 13:26:23 -0800 +``` + +Les logs, à eux seuls, ne suffisent pas pour suivre précisément l'exécution du code, car ils manquent souvent de contexte, comme l'origine exacte de leur déclenchement. + +Ils sont nettement plus utiles lorsqu'ils font partie d'un [span](#spans) ou lorsqu'ils sont mis en corrélation avec une trace ou un span. + +Pour plus d'informations sur les logs et leur rôle dans OpenTelemetry, référez-vous à la page [Logs](/docs/concepts/signals/logs/). + +### Spans + +Un **span** représente une unité de travail ou d'opération. Il retrace les actions effectuées par une requête, offrant une vue détaillée des événements qui se sont déroulés pendant l'exécution de l'opération. + +Un span contient un nom, des données de temps, +[des messages de log structurés](/docs/concepts/signals/traces/#span-events), et +[autres métadonnées (les attributs)](/docs/concepts/signals/traces/#attributes) pour fournir des informations sur l'opération qu'il suit. + +#### Attributs de span + +Les attributs de span sont des métadonnées attachées à un span. + +La table suivante liste des exemples d'attributs de span : + +| Clé | Valeur | +|:----------------------------|:-----------------------------------------------------------------------------------| +| `http.request.method` | `"GET"` | +| `network.protocol.version` | `"1.1"` | +| `url.path` | `"/webshop/articles/4"` | +| `url.query` | `"?s=1"` | +| `server.address` | `"exemple.com"` | +| `server.port` | `8080` | +| `url.scheme` | `"https"` | +| `http.route` | `"/webshop/articles/:article_id"` | +| `http.response.status_code` | `200` | +| `client.address` | `"192.0.2.4"` | +| `client.socket.address` | `"192.0.2.5"` (le client passe par un proxy) | +| `user_agent.original` | `"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:72.0) Gecko/20100101 Firefox/72.0"` | + +Pour plus d'informations sur les spans et leur rôle dans OpenTelemetry, référez-vous à la page [Spans](/docs/concepts/signals/traces/#spans). + +### Les traces distribuées + +Une **trace distribuée**, plus communément connu sous le nom de **trace**, enregistre les chemins pris par les requêtes (lancées par une application ou un utilisateur final) au fur et à mesure qu'elles se propagent au travers d'architectures multiservices, tels que des microservices ou des applications serverless. + +Une trace se compose d'un ou de plusieurs spans. Le premier span représente le span racine. + +Chaque span racine représente une requête, depuis son origine jusqu'à son aboutissement. Les spans présents sous le parent fournissent plus d'informations sur ce qui se passe pendant une requête (ou les étapes qui composent une requête). + +Sans traçage, il peut être difficile d'identifier pour un système distribué la cause première de problèmes de performance. Le traçage simplifie le débogage et la compréhension des systèmes distribués en décomposant le parcours des requêtes au fil de leur exécution dans le système. + +De nombreuses plateformes d'observabilité représentent les traces sous forme de diagrammes en cascade comme celui-ci : + +![Exemple de trace](/img/waterfall-trace.svg 'Diagramme en cascade de traces') + +Les diagrammes en cascade permettent de visualiser la relation parent-enfant entre un span racine et ses spans enfants. Lorsqu'un span encapsule un autre span, on parle de relation imbriquée. + +Pour plus d'informations sur les traces et leur rôle dans OpenTelemetry, référez-vous à la page [Traces](/docs/concepts/signals/traces/). \ No newline at end of file From 954fb4e6f1404e9f9cf61529e488fc94e4b4beea Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Thu, 2 Jan 2025 10:00:05 +0100 Subject: [PATCH 02/12] Issue #5826 * Fixed the markdown linter issue --- content/fr/concepts/observability-primer.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/fr/concepts/observability-primer.md b/content/fr/concepts/observability-primer.md index 6275c49108af..be49a11f4ee7 100644 --- a/content/fr/concepts/observability-primer.md +++ b/content/fr/concepts/observability-primer.md @@ -15,7 +15,7 @@ Pour pouvoir poser ce type de questions à votre système, votre application doi [des signaux](/docs/concepts/signals/) tels que [des traces](/docs/concepts/signals/traces/), [des métriques](/docs/concepts/signals/metrics/), et -[des logs](/docs/concepts/signals/logs/). +[des logs](/docs/concepts/signals/logs/). Une application est correctement instrumentée si les développeurs disposent de toutes les informations nécessaires pour corriger un problème et n'ont pas besoin d'ajouter une instrumentation supplémentaire. @@ -31,13 +31,13 @@ Un système peut afficher un pourcentage de disponibilité de 100% mais s'il ne Les **métriques** sont un ensemble de données numériques collectées pour votre infrastructure ou votre application sur une période donnée. Le nombre d'erreurs système, le nombre d'erreurs sur les requêtes ainsi que l'utilisation mémoire d'un service donné sont quelques exemples de métriques. Pour plus d'informations sur les métriques et leur rôle dans OpenTelemetry, référez-vous à la page [Métriques](/docs/concepts/signals/metrics/). -L'indicateur de niveau de service, également connu sous le nom de **SLI**, est un indicateur de fonctionnement d'un service qui est évalué côté utilisateur. La vitesse à laquelle une page Web se charge est un exemple de SLI. +L'indicateur de niveau de service, également connu sous le nom de **SLI**, est un indicateur de fonctionnement d'un service qui est évalué côté utilisateur. La vitesse à laquelle une page Web se charge est un exemple de SLI. Les objectifs de niveau de service, communément appelé **SLO**, permettent de rendre compte à une organisation ou à d'autres équipes de la fiabilité d'un système. ## Comprendre le traçage distribué -Le traçage distribué vous permet d'observer les requêtes au fur et à mesure qu'elles se propagent au travers de systèmes distribués complexes. Il vous offre une meilleure visibilité sur la santé de votre application ou de votre système et vous permet de debugger un comportement qu'il est difficile de reproduire localement. Le traçage distribué est indispensable pour les systèmes distribués pour lesquels nous rencontrons souvent des problèmes aléatoires ou difficiles à reproduire localement. +Le traçage distribué vous permet d'observer les requêtes au fur et à mesure qu'elles se propagent au travers de systèmes distribués complexes. Il vous offre une meilleure visibilité sur la santé de votre application ou de votre système et vous permet de debugger un comportement qu'il est difficile de reproduire localement. Le traçage distribué est indispensable pour les systèmes distribués pour lesquels nous rencontrons souvent des problèmes aléatoires ou difficiles à reproduire localement. Pour comprendre le traçage distribué, vous devez comprendre le rôle de chacun de ses composants : les logs, les spans et les traces. @@ -69,7 +69,7 @@ Un span contient un nom, des données de temps, Les attributs de span sont des métadonnées attachées à un span. -La table suivante liste des exemples d'attributs de span : +La table suivante liste des exemples d'attributs de span : | Clé | Valeur | |:----------------------------|:-----------------------------------------------------------------------------------| @@ -90,9 +90,9 @@ Pour plus d'informations sur les spans et leur rôle dans OpenTelemetry, référ ### Les traces distribuées -Une **trace distribuée**, plus communément connu sous le nom de **trace**, enregistre les chemins pris par les requêtes (lancées par une application ou un utilisateur final) au fur et à mesure qu'elles se propagent au travers d'architectures multiservices, tels que des microservices ou des applications serverless. +Une **trace distribuée**, plus communément connu sous le nom de **trace**, enregistre les chemins pris par les requêtes (lancées par une application ou un utilisateur final) au fur et à mesure qu'elles se propagent au travers d'architectures multiservices, tels que des microservices ou des applications serverless. -Une trace se compose d'un ou de plusieurs spans. Le premier span représente le span racine. +Une trace se compose d'un ou de plusieurs spans. Le premier span représente le span racine. Chaque span racine représente une requête, depuis son origine jusqu'à son aboutissement. Les spans présents sous le parent fournissent plus d'informations sur ce qui se passe pendant une requête (ou les étapes qui composent une requête). @@ -104,4 +104,4 @@ De nombreuses plateformes d'observabilité représentent les traces sous forme d Les diagrammes en cascade permettent de visualiser la relation parent-enfant entre un span racine et ses spans enfants. Lorsqu'un span encapsule un autre span, on parle de relation imbriquée. -Pour plus d'informations sur les traces et leur rôle dans OpenTelemetry, référez-vous à la page [Traces](/docs/concepts/signals/traces/). \ No newline at end of file +Pour plus d'informations sur les traces et leur rôle dans OpenTelemetry, référez-vous à la page [Traces](/docs/concepts/signals/traces/). From a01376b4c3588bf1ad6f17735b878739ae194f54 Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Thu, 2 Jan 2025 10:15:52 +0100 Subject: [PATCH 03/12] Issue #5826: Fixed the check-build-log.sh error * Updated the distributed-traces anchor --- content/fr/concepts/observability-primer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/fr/concepts/observability-primer.md b/content/fr/concepts/observability-primer.md index be49a11f4ee7..c37ab2baaa61 100644 --- a/content/fr/concepts/observability-primer.md +++ b/content/fr/concepts/observability-primer.md @@ -43,7 +43,7 @@ Pour comprendre le traçage distribué, vous devez comprendre le rôle de chacun ### Logs -Un **log** est un message horodaté émis par des services ou d'autres composants. Contrairement aux [traces](#distributed-traces), ils ne sont pas nécessairement associés à une requête ou une transaction utilisateur en particulier. Presque tous les logiciels émettent des logs. Par le passé, les développeurs et les opérateurs se sont largement appuyés sur les logs pour comprendre le comportement des systèmes. +Un **log** est un message horodaté émis par des services ou d'autres composants. Contrairement aux [traces](#les-traces-distribuées), ils ne sont pas nécessairement associés à une requête ou une transaction utilisateur en particulier. Presque tous les logiciels émettent des logs. Par le passé, les développeurs et les opérateurs se sont largement appuyés sur les logs pour comprendre le comportement des systèmes. Exemple de log : From 43d0b91b076436472b81e4cc01b95eaef732003f Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Thu, 2 Jan 2025 10:55:59 +0100 Subject: [PATCH 04/12] Issue #5826: Fixed the prettier issue --- content/fr/concepts/observability-primer.md | 114 +++++++++++++++----- 1 file changed, 86 insertions(+), 28 deletions(-) diff --git a/content/fr/concepts/observability-primer.md b/content/fr/concepts/observability-primer.md index c37ab2baaa61..4f9b59d6f79f 100644 --- a/content/fr/concepts/observability-primer.md +++ b/content/fr/concepts/observability-primer.md @@ -4,46 +4,81 @@ description: Concepts fondamentaux de l'observabilité weight: 9 default_lang_commit: 71833a5f8b84110dadf1e98604b87a900724ac33 cSpell:ignore: webshop - --- ## Qu'est-ce que l'observabilité ? -L'observabilité est la capacité à comprendre l'état d'un système en examinant ses données sortantes, sans avoir besoin de connaître son fonctionnement interne. Elle permet non seulement de résoudre facilement les problèmes et d'appréhender les nouveaux "inconnus inconnus" mais également de répondre à la question "Pourquoi cela arrive-t-il ?" +L'observabilité est la capacité à comprendre l'état d'un système en examinant +ses données sortantes, sans avoir besoin de connaître son fonctionnement +interne. Elle permet non seulement de résoudre facilement les problèmes et +d'appréhender les nouveaux "inconnus inconnus" mais également de répondre à la +question "Pourquoi cela arrive-t-il ?" -Pour pouvoir poser ce type de questions à votre système, votre application doit être correctement instrumentée, c'est-à-dire que votre code doit émettre : +Pour pouvoir poser ce type de questions à votre système, votre application doit +être correctement instrumentée, c'est-à-dire que votre code doit émettre : [des signaux](/docs/concepts/signals/) tels que [des traces](/docs/concepts/signals/traces/), [des métriques](/docs/concepts/signals/metrics/), et [des logs](/docs/concepts/signals/logs/). -Une application est correctement instrumentée si les développeurs disposent de toutes les informations nécessaires pour corriger un problème et n'ont pas besoin d'ajouter une instrumentation supplémentaire. +Une application est correctement instrumentée si les développeurs disposent de +toutes les informations nécessaires pour corriger un problème et n'ont pas +besoin d'ajouter une instrumentation supplémentaire. -[OpenTelemetry](/docs/what-is-opentelemetry/) est le mécanisme permettant d'instrumenter le code des applications afin de rendre le système observable. +[OpenTelemetry](/docs/what-is-opentelemetry/) est le mécanisme permettant +d'instrumenter le code des applications afin de rendre le système observable. ## Fiabilité et métriques -Le terme **télémétrie** fait référence aux données émises par un système et son comportement. Les données peuvent prendre la forme de [traces](/docs/concepts/signals/traces/), de [métriques](/docs/concepts/signals/metrics/), et de +Le terme **télémétrie** fait référence aux données émises par un système et son +comportement. Les données peuvent prendre la forme de +[traces](/docs/concepts/signals/traces/), de +[métriques](/docs/concepts/signals/metrics/), et de [logs](/docs/concepts/signals/logs/). -La **fiabilité** répond à la question : "Est-ce que le service fait ce que les utilisateurs attendent de lui ?" -Un système peut afficher un pourcentage de disponibilité de 100% mais s'il ne répond pas à la demande de l'utilisateur (par exemple : ajouter une paire de chaussettes noires dans le panier à chaque fois qu'il clique sur "Ajouter au panier"), alors le système pourrait être considéré comme **peu** fiable. +La **fiabilité** répond à la question : "Est-ce que le service fait ce que les +utilisateurs attendent de lui ?" Un système peut afficher un pourcentage de +disponibilité de 100% mais s'il ne répond pas à la demande de l'utilisateur (par +exemple : ajouter une paire de chaussettes noires dans le panier à chaque fois +qu'il clique sur "Ajouter au panier"), alors le système pourrait être considéré +comme **peu** fiable. -Les **métriques** sont un ensemble de données numériques collectées pour votre infrastructure ou votre application sur une période donnée. Le nombre d'erreurs système, le nombre d'erreurs sur les requêtes ainsi que l'utilisation mémoire d'un service donné sont quelques exemples de métriques. Pour plus d'informations sur les métriques et leur rôle dans OpenTelemetry, référez-vous à la page [Métriques](/docs/concepts/signals/metrics/). +Les **métriques** sont un ensemble de données numériques collectées pour votre +infrastructure ou votre application sur une période donnée. Le nombre d'erreurs +système, le nombre d'erreurs sur les requêtes ainsi que l'utilisation mémoire +d'un service donné sont quelques exemples de métriques. Pour plus d'informations +sur les métriques et leur rôle dans OpenTelemetry, référez-vous à la page +[Métriques](/docs/concepts/signals/metrics/). -L'indicateur de niveau de service, également connu sous le nom de **SLI**, est un indicateur de fonctionnement d'un service qui est évalué côté utilisateur. La vitesse à laquelle une page Web se charge est un exemple de SLI. +L'indicateur de niveau de service, également connu sous le nom de **SLI**, est +un indicateur de fonctionnement d'un service qui est évalué côté utilisateur. La +vitesse à laquelle une page Web se charge est un exemple de SLI. -Les objectifs de niveau de service, communément appelé **SLO**, permettent de rendre compte à une organisation ou à d'autres équipes de la fiabilité d'un système. +Les objectifs de niveau de service, communément appelé **SLO**, permettent de +rendre compte à une organisation ou à d'autres équipes de la fiabilité d'un +système. ## Comprendre le traçage distribué -Le traçage distribué vous permet d'observer les requêtes au fur et à mesure qu'elles se propagent au travers de systèmes distribués complexes. Il vous offre une meilleure visibilité sur la santé de votre application ou de votre système et vous permet de debugger un comportement qu'il est difficile de reproduire localement. Le traçage distribué est indispensable pour les systèmes distribués pour lesquels nous rencontrons souvent des problèmes aléatoires ou difficiles à reproduire localement. +Le traçage distribué vous permet d'observer les requêtes au fur et à mesure +qu'elles se propagent au travers de systèmes distribués complexes. Il vous offre +une meilleure visibilité sur la santé de votre application ou de votre système +et vous permet de debugger un comportement qu'il est difficile de reproduire +localement. Le traçage distribué est indispensable pour les systèmes distribués +pour lesquels nous rencontrons souvent des problèmes aléatoires ou difficiles à +reproduire localement. -Pour comprendre le traçage distribué, vous devez comprendre le rôle de chacun de ses composants : les logs, les spans et les traces. +Pour comprendre le traçage distribué, vous devez comprendre le rôle de chacun de +ses composants : les logs, les spans et les traces. ### Logs -Un **log** est un message horodaté émis par des services ou d'autres composants. Contrairement aux [traces](#les-traces-distribuées), ils ne sont pas nécessairement associés à une requête ou une transaction utilisateur en particulier. Presque tous les logiciels émettent des logs. Par le passé, les développeurs et les opérateurs se sont largement appuyés sur les logs pour comprendre le comportement des systèmes. +Un **log** est un message horodaté émis par des services ou d'autres composants. +Contrairement aux [traces](#les-traces-distribuées), ils ne sont pas +nécessairement associés à une requête ou une transaction utilisateur en +particulier. Presque tous les logiciels émettent des logs. Par le passé, les +développeurs et les opérateurs se sont largement appuyés sur les logs pour +comprendre le comportement des systèmes. Exemple de log : @@ -51,19 +86,26 @@ Exemple de log : I, [2021-02-23T13:26:23.505892 #22473] INFO -- : [6459ffe1-ea53-4044-aaa3-bf902868f730] Started GET "/" for ::1 at 2021-02-23 13:26:23 -0800 ``` -Les logs, à eux seuls, ne suffisent pas pour suivre précisément l'exécution du code, car ils manquent souvent de contexte, comme l'origine exacte de leur déclenchement. +Les logs, à eux seuls, ne suffisent pas pour suivre précisément l'exécution du +code, car ils manquent souvent de contexte, comme l'origine exacte de leur +déclenchement. -Ils sont nettement plus utiles lorsqu'ils font partie d'un [span](#spans) ou lorsqu'ils sont mis en corrélation avec une trace ou un span. +Ils sont nettement plus utiles lorsqu'ils font partie d'un [span](#spans) ou +lorsqu'ils sont mis en corrélation avec une trace ou un span. -Pour plus d'informations sur les logs et leur rôle dans OpenTelemetry, référez-vous à la page [Logs](/docs/concepts/signals/logs/). +Pour plus d'informations sur les logs et leur rôle dans OpenTelemetry, +référez-vous à la page [Logs](/docs/concepts/signals/logs/). ### Spans -Un **span** représente une unité de travail ou d'opération. Il retrace les actions effectuées par une requête, offrant une vue détaillée des événements qui se sont déroulés pendant l'exécution de l'opération. +Un **span** représente une unité de travail ou d'opération. Il retrace les +actions effectuées par une requête, offrant une vue détaillée des événements qui +se sont déroulés pendant l'exécution de l'opération. Un span contient un nom, des données de temps, [des messages de log structurés](/docs/concepts/signals/traces/#span-events), et -[autres métadonnées (les attributs)](/docs/concepts/signals/traces/#attributes) pour fournir des informations sur l'opération qu'il suit. +[autres métadonnées (les attributs)](/docs/concepts/signals/traces/#attributes) +pour fournir des informations sur l'opération qu'il suit. #### Attributs de span @@ -72,7 +114,7 @@ Les attributs de span sont des métadonnées attachées à un span. La table suivante liste des exemples d'attributs de span : | Clé | Valeur | -|:----------------------------|:-----------------------------------------------------------------------------------| +| :-------------------------- | :--------------------------------------------------------------------------------- | | `http.request.method` | `"GET"` | | `network.protocol.version` | `"1.1"` | | `url.path` | `"/webshop/articles/4"` | @@ -86,22 +128,38 @@ La table suivante liste des exemples d'attributs de span : | `client.socket.address` | `"192.0.2.5"` (le client passe par un proxy) | | `user_agent.original` | `"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:72.0) Gecko/20100101 Firefox/72.0"` | -Pour plus d'informations sur les spans et leur rôle dans OpenTelemetry, référez-vous à la page [Spans](/docs/concepts/signals/traces/#spans). +Pour plus d'informations sur les spans et leur rôle dans OpenTelemetry, +référez-vous à la page [Spans](/docs/concepts/signals/traces/#spans). ### Les traces distribuées -Une **trace distribuée**, plus communément connu sous le nom de **trace**, enregistre les chemins pris par les requêtes (lancées par une application ou un utilisateur final) au fur et à mesure qu'elles se propagent au travers d'architectures multiservices, tels que des microservices ou des applications serverless. +Une **trace distribuée**, plus communément connu sous le nom de **trace**, +enregistre les chemins pris par les requêtes (lancées par une application ou un +utilisateur final) au fur et à mesure qu'elles se propagent au travers +d'architectures multiservices, tels que des microservices ou des applications +serverless. -Une trace se compose d'un ou de plusieurs spans. Le premier span représente le span racine. +Une trace se compose d'un ou de plusieurs spans. Le premier span représente le +span racine. -Chaque span racine représente une requête, depuis son origine jusqu'à son aboutissement. Les spans présents sous le parent fournissent plus d'informations sur ce qui se passe pendant une requête (ou les étapes qui composent une requête). +Chaque span racine représente une requête, depuis son origine jusqu'à son +aboutissement. Les spans présents sous le parent fournissent plus d'informations +sur ce qui se passe pendant une requête (ou les étapes qui composent une +requête). -Sans traçage, il peut être difficile d'identifier pour un système distribué la cause première de problèmes de performance. Le traçage simplifie le débogage et la compréhension des systèmes distribués en décomposant le parcours des requêtes au fil de leur exécution dans le système. +Sans traçage, il peut être difficile d'identifier pour un système distribué la +cause première de problèmes de performance. Le traçage simplifie le débogage et +la compréhension des systèmes distribués en décomposant le parcours des requêtes +au fil de leur exécution dans le système. -De nombreuses plateformes d'observabilité représentent les traces sous forme de diagrammes en cascade comme celui-ci : +De nombreuses plateformes d'observabilité représentent les traces sous forme de +diagrammes en cascade comme celui-ci : ![Exemple de trace](/img/waterfall-trace.svg 'Diagramme en cascade de traces') -Les diagrammes en cascade permettent de visualiser la relation parent-enfant entre un span racine et ses spans enfants. Lorsqu'un span encapsule un autre span, on parle de relation imbriquée. +Les diagrammes en cascade permettent de visualiser la relation parent-enfant +entre un span racine et ses spans enfants. Lorsqu'un span encapsule un autre +span, on parle de relation imbriquée. -Pour plus d'informations sur les traces et leur rôle dans OpenTelemetry, référez-vous à la page [Traces](/docs/concepts/signals/traces/). +Pour plus d'informations sur les traces et leur rôle dans OpenTelemetry, +référez-vous à la page [Traces](/docs/concepts/signals/traces/). From e4ba387b140ccddb0944efce8a910317fcc061ff Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Thu, 2 Jan 2025 11:21:01 +0100 Subject: [PATCH 05/12] Issue #5826: Fixed the Spelling check issue * Added the 192 unknown words to fr-mots.txt --- .cspell/fr-mots.txt | 446 +++++++++++++++++++++++++++----------------- 1 file changed, 280 insertions(+), 166 deletions(-) diff --git a/.cspell/fr-mots.txt b/.cspell/fr-mots.txt index 7970e82b0e43..c1ec97c086c3 100644 --- a/.cspell/fr-mots.txt +++ b/.cspell/fr-mots.txt @@ -1,213 +1,327 @@ +aboutissement +actuellement +adaptée +afin +ainsi +aisément +Ajouter +ajouter +aléatoires +alors analyse analyser +antérieurs +appelé +appuyés +associés +attachées +attributs +Aucun +automatique +autre +autres avec +besoin +bibliothèques +brève +celui +chacun +Chaque +chaussettes +clés +collecte +collectées collecter +Collecteur +collecteur collectez +combinés +commencer +commerciales +commerciaux +communautaires +communément comportement +composants +composent +compréhension +comprendre +compris +conçu +conçus +connu +considéré contenant +contexte +contient +Contrairement +contribuent +corrélation +côté +Créer +créer +créés créez +d’aujourd’hui +d’étendre dans +d'apprendre +d'attributs +d'autres +d'autres +débogage +déclenchement +décomposant découvrez +découvrir +décrire +décrivant +défaut définie +définissant démo +dépendance +depuis +déroulés +d'erreurs dessous +détaillée +d'étendre +développeurs +devez +d'exécution +Diagramme +diagrammes +directement +disponibilité +distribué +distribuée +distribuées +distribués +doivent données +dont +d'opération d'utiliser +écosystème +effectuées efficace +également +émettent +émettre +émis +ensuite entièrement +environnement +équipes +étapes +étendu +êtes être +évalué +événements +exacte +exécution +exportateur +Extensibilité +extensible +Faas +façon +fiabilité +flexibilité +fois +fonctionnement +fournir +fournissent +fournisseur +fournisseurs +fusionné +génération +génèrent générer +générez +gérer +gestion gratuit +Histoire +horodaté +imbriquée +implémentent +incluent indépendant +indépendante +indicateur +informatique +instrumentent instrumenter intégrations +intègrent +intentionnellement +jetez +jusqu'à +laissés +lancées +Lancez +langage langages +laquelle +largement +lesquels +l'essor +l'état +leur +leurs +l'exécution librairies +L'indicateur +localement +logiciel logiciels +l'opération +lorsqu'ils +Lorsqu'un +l'utilisateur +manière +manquent +meilleure +même +mémoire +métadonnées +metriques métriques -nombreux +migrer +modifie +n’aient +n'aient +n'avez +nécessairement +n'étant +nettement +niveau +niveaux nombreuses +nombreux +norme +nouvel +numériques +objectifs observabilité +oeil +offrant +offre +offrent +Opérateur +opérateurs +organisations +outil outils +parcours +particulier +partie +période permet permettant +permettent +personnalisé +personnalisée +personnalisées +peut +plateformes +plupart +plusieurs +Pourquoi +pourrait +pouvez +pouvoir +précisément +prend +prendre +présents +presque +principaux +principaux +principes +pris +problème +problèmes +produites projet projets -peut +propagateur +propriétaire qualité +quelque +Quelques +quelques +receveur +reçoit +référez +rencontrons +rendre +répond +représente +représentent +reproduire +requérir +requête +requêtes +résoudre +ressources +rôle savoir +sémantiques +seul +seuls +signifie +simplifie s'intègre +soit +sont +sortantes +souhaitez +souvent +spécification +spécifications +spécifique +standardisé +standardisée +stockage +structurés +suffisent +suivant +suivante +suivants +suivre supporte supporté +système +systèmes tant télémétrie +telles +tous +traçage transmettez -universelle -utilisé -visuel -votre -vous -l'état -système -incluent -rendre -signifie -émettre -metriques -produites -doivent +transmettre transmises -Pourquoi -l'essor -commerciales -besoin -répond -suivant -principes -clés -propriétaire -générez -dépendance -fournisseur -n'avez -d'apprendre -seul -combinés -offrent -équipes -organisations -flexibilité -dont -informatique -Extensibilité -conçu -extensible -Quelques -façon -étendu -Ajouter -receveur -Collecteur -afin -prendre -venant -personnalisée -bibliothèques -personnalisées -Créer -collecteur -adaptée -utilisation -spécifique -nouvel -exportateur -personnalisé -prend -propagateur -contexte -plupart -utilisateurs -n'aient -d'étendre -presque -tous -niveaux -Histoire +travers trouve -antérieurs -créés -résoudre -même -problème -norme -décrivant -manière -transmettre -Aucun -n'étant -indépendante -fusionné -leurs -offrant +unité +universelle +utiles +utilisateur +utilisateurs +utilisation +utilisé utilisez -actuellement -pouvez -découvrir -migrer -ensuite -commencer -Lancez -directement -composants -standardisé -définissant -sémantiques -décrire -langage -implémentent -spécifications -écosystème -instrumentent -automatique -génèrent -requérir -reçoit -modifie -autre -Opérateur -ressources -Faas +Valeur +valeurs variété -intègrent -fournir -défaut -pris -fournisseurs -fournissent -contribuent -n’aient -d’étendre -conçus -créer -gérer -telles -outil -compris -ainsi -commerciaux -d'autres -génération -collecte -gestion -objectifs -principaux -pouvoir -aisément -systèmes -quelque -soit -leur -environnement -d'exécution -stockage +venant +visibilité visualisation -sont -intentionnellement -laissés -d'autres -comprendre -sortantes -logiciel -d’aujourd’hui -souhaitez -jetez -oeil -valeurs -principaux -suivants -spécification -communautaires -brève -êtes -standardisée -autres +visualiser +visuel +vitesse +votre +vous From 45d83bb3baa7f6cf8f866aac95312fc191380c4a Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Thu, 2 Jan 2025 11:28:31 +0100 Subject: [PATCH 06/12] Issue #5826: Added missing words to fr-mots.txt --- .cspell/fr-mots.txt | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/.cspell/fr-mots.txt b/.cspell/fr-mots.txt index c1ec97c086c3..12ea7967572a 100644 --- a/.cspell/fr-mots.txt +++ b/.cspell/fr-mots.txt @@ -1,6 +1,7 @@ aboutissement actuellement adaptée +afficher afin ainsi aisément @@ -27,6 +28,7 @@ brève celui chacun Chaque +chaque chaussettes clés collecte @@ -49,6 +51,7 @@ comprendre compris conçu conçus +connaître connu considéré contenant @@ -56,12 +59,15 @@ contexte contient Contrairement contribuent +correctement corrélation +corriger côté Créer créer créés créez +d'appréhender d’aujourd’hui d’étendre dans @@ -94,6 +100,8 @@ Diagramme diagrammes directement disponibilité +disposent +émises distribué distribuée distribuées @@ -125,6 +133,7 @@ exécution exportateur Extensibilité extensible +facilement Faas façon fiabilité @@ -148,11 +157,13 @@ horodaté imbriquée implémentent incluent +inconnus indépendant indépendante indicateur informatique instrumentent +instrumentée instrumenter intégrations intègrent @@ -183,6 +194,7 @@ Lorsqu'un l'utilisateur manière manquent +mécanisme meilleure même mémoire @@ -194,6 +206,7 @@ modifie n’aient n'aient n'avez +nécessaires nécessairement n'étant nettement @@ -226,9 +239,11 @@ personnalisé personnalisée personnalisées peut +peuvent plateformes plupart plusieurs +pourcentage Pourquoi pourrait pouvez @@ -255,10 +270,12 @@ Quelques quelques receveur reçoit +référence référez rencontrons rendre répond +répondre représente représentent reproduire @@ -272,6 +289,8 @@ savoir sémantiques seul seuls +seulement +signaux signifie simplifie s'intègre @@ -292,6 +311,7 @@ suivant suivante suivants suivre +supplémentaire supporte supporté système @@ -299,6 +319,8 @@ systèmes tant télémétrie telles +terme +toutes tous traçage transmettez From 396d013b0e5f14de92fdc1a7848a57582815f0ac Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Thu, 2 Jan 2025 11:35:53 +0100 Subject: [PATCH 07/12] Issue #5826: Added missing word to fr-mots.txt --- .cspell/fr-mots.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/.cspell/fr-mots.txt b/.cspell/fr-mots.txt index 12ea7967572a..5f44ad9378d3 100644 --- a/.cspell/fr-mots.txt +++ b/.cspell/fr-mots.txt @@ -140,6 +140,7 @@ fiabilité flexibilité fois fonctionnement +fondamentaux fournir fournissent fournisseur From d079c74bec52f2eddbcb4da772c9ec424041e838 Mon Sep 17 00:00:00 2001 From: Isabelle Guitton <48676092+iguitton@users.noreply.github.com> Date: Mon, 6 Jan 2025 09:58:04 +0100 Subject: [PATCH 08/12] Update content/fr/concepts/observability-primer.md Committed dmathieu's suggestion Co-authored-by: Damien Mathieu <42@dmathieu.com> --- content/fr/concepts/observability-primer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/fr/concepts/observability-primer.md b/content/fr/concepts/observability-primer.md index 4f9b59d6f79f..4efa96a3f350 100644 --- a/content/fr/concepts/observability-primer.md +++ b/content/fr/concepts/observability-primer.md @@ -38,7 +38,7 @@ comportement. Les données peuvent prendre la forme de La **fiabilité** répond à la question : "Est-ce que le service fait ce que les utilisateurs attendent de lui ?" Un système peut afficher un pourcentage de -disponibilité de 100% mais s'il ne répond pas à la demande de l'utilisateur (par +disponibilité de 100%, mais s'il ne répond pas à la demande de l'utilisateur (par exemple : ajouter une paire de chaussettes noires dans le panier à chaque fois qu'il clique sur "Ajouter au panier"), alors le système pourrait être considéré comme **peu** fiable. From e15f8a4727ec3316c2d21b59a713781ef635961b Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Mon, 6 Jan 2025 17:12:29 +0000 Subject: [PATCH 09/12] Results from /fix:format --- content/fr/concepts/observability-primer.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/fr/concepts/observability-primer.md b/content/fr/concepts/observability-primer.md index 4efa96a3f350..bbb55d4a9bdc 100644 --- a/content/fr/concepts/observability-primer.md +++ b/content/fr/concepts/observability-primer.md @@ -38,10 +38,10 @@ comportement. Les données peuvent prendre la forme de La **fiabilité** répond à la question : "Est-ce que le service fait ce que les utilisateurs attendent de lui ?" Un système peut afficher un pourcentage de -disponibilité de 100%, mais s'il ne répond pas à la demande de l'utilisateur (par -exemple : ajouter une paire de chaussettes noires dans le panier à chaque fois -qu'il clique sur "Ajouter au panier"), alors le système pourrait être considéré -comme **peu** fiable. +disponibilité de 100%, mais s'il ne répond pas à la demande de l'utilisateur +(par exemple : ajouter une paire de chaussettes noires dans le panier à chaque +fois qu'il clique sur "Ajouter au panier"), alors le système pourrait être +considéré comme **peu** fiable. Les **métriques** sont un ensemble de données numériques collectées pour votre infrastructure ou votre application sur une période donnée. Le nombre d'erreurs From 781eeb3d736125f6ff78131c9203b5d945f97733 Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Tue, 7 Jan 2025 09:30:53 +0100 Subject: [PATCH 10/12] Issue #5826 Create observability-primer.md - Added fr-fr in .cspell.yaml - Skimmed the fr-mots.txt file to retain only the observability-specific terminology. --- .cspell.yml | 1 + .cspell/fr-mots.txt | 350 +------------------------------------------- 2 files changed, 3 insertions(+), 348 deletions(-) diff --git a/.cspell.yml b/.cspell.yml index 57d3c4fbc4f2..25d636125d38 100644 --- a/.cspell.yml +++ b/.cspell.yml @@ -40,6 +40,7 @@ dictionaries: # Natural languages - es-es - pt-br + - fr-fr # Local word lists - en-words - es-palabras diff --git a/.cspell/fr-mots.txt b/.cspell/fr-mots.txt index 5f44ad9378d3..3ea4303ab141 100644 --- a/.cspell/fr-mots.txt +++ b/.cspell/fr-mots.txt @@ -1,350 +1,4 @@ -aboutissement -actuellement -adaptée -afficher -afin -ainsi -aisément -Ajouter -ajouter -aléatoires -alors -analyse -analyser -antérieurs -appelé -appuyés -associés -attachées -attributs -Aucun -automatique -autre -autres -avec -besoin -bibliothèques -brève -celui -chacun -Chaque -chaque -chaussettes -clés -collecte -collectées -collecter -Collecteur -collecteur -collectez -combinés -commencer -commerciales -commerciaux -communautaires -communément -comportement -composants -composent -compréhension -comprendre -compris -conçu -conçus -connaître -connu -considéré -contenant -contexte -contient -Contrairement -contribuent -correctement -corrélation -corriger -côté -Créer -créer -créés -créez -d'appréhender -d’aujourd’hui -d’étendre -dans -d'apprendre -d'attributs -d'autres -d'autres -débogage -déclenchement -décomposant -découvrez -découvrir -décrire -décrivant -défaut -définie -définissant -démo -dépendance -depuis -déroulés -d'erreurs -dessous -détaillée -d'étendre -développeurs -devez -d'exécution -Diagramme -diagrammes -directement -disponibilité -disposent -émises -distribué -distribuée -distribuées -distribués -doivent -données -dont -d'opération -d'utiliser -écosystème -effectuées -efficace -également -émettent -émettre -émis -ensuite -entièrement -environnement -équipes -étapes -étendu -êtes -être -évalué -événements -exacte -exécution -exportateur -Extensibilité -extensible -facilement -Faas -façon -fiabilité -flexibilité -fois -fonctionnement -fondamentaux -fournir -fournissent -fournisseur -fournisseurs -fusionné -génération -génèrent -générer -générez -gérer -gestion -gratuit -Histoire -horodaté -imbriquée -implémentent -incluent -inconnus -indépendant -indépendante -indicateur -informatique -instrumentent -instrumentée -instrumenter -intégrations -intègrent -intentionnellement -jetez -jusqu'à -laissés -lancées -Lancez -langage -langages -laquelle -largement -lesquels -l'essor -l'état -leur -leurs -l'exécution -librairies -L'indicateur -localement -logiciel -logiciels -l'opération -lorsqu'ils -Lorsqu'un -l'utilisateur -manière -manquent -mécanisme -meilleure -même -mémoire -métadonnées -metriques -métriques -migrer -modifie -n’aient -n'aient -n'avez -nécessaires -nécessairement -n'étant -nettement -niveau -niveaux -nombreuses -nombreux -norme -nouvel -numériques -objectifs +extensibilité observabilité -oeil -offrant -offre -offrent -Opérateur -opérateurs -organisations -outil -outils -parcours -particulier -partie -période -permet -permettant -permettent -personnalisé -personnalisée -personnalisées -peut -peuvent -plateformes -plupart -plusieurs -pourcentage -Pourquoi -pourrait -pouvez -pouvoir -précisément -prend -prendre -présents -presque -principaux -principaux -principes -pris -problème -problèmes -produites -projet -projets -propagateur -propriétaire -qualité -quelque -Quelques -quelques -receveur -reçoit -référence -référez -rencontrons -rendre -répond -répondre -représente -représentent -reproduire -requérir -requête -requêtes -résoudre -ressources -rôle -savoir -sémantiques -seul -seuls -seulement -signaux -signifie -simplifie -s'intègre -soit -sont -sortantes -souhaitez -souvent -spécification -spécifications -spécifique -standardisé -standardisée -stockage -structurés -suffisent -suivant -suivante -suivants -suivre -supplémentaire -supporte -supporté -système -systèmes -tant télémétrie -telles -terme -toutes -tous -traçage -transmettez -transmettre -transmises -travers -trouve -unité -universelle -utiles -utilisateur -utilisateurs -utilisation -utilisé -utilisez -Valeur -valeurs -variété -venant -visibilité -visualisation -visualiser -visuel -vitesse -votre -vous +traçage \ No newline at end of file From c3c1bba34b44796e9dc0c70d8b9c02b0997acd97 Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Tue, 7 Jan 2025 09:42:04 +0100 Subject: [PATCH 11/12] Issue #5826: Create observability-primer.md Fixed mispelling --- content/fr/docs/what-is-opentelemetry.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/fr/docs/what-is-opentelemetry.md b/content/fr/docs/what-is-opentelemetry.md index fb61b00e40f1..4749d5b96aa9 100644 --- a/content/fr/docs/what-is-opentelemetry.md +++ b/content/fr/docs/what-is-opentelemetry.md @@ -12,7 +12,7 @@ OpenTelemetry, c'est : d'[observabilité](/docs/concepts/observability-primer/#what-is-observability) et des outils conçus pour créer et gérer des données de télémétrie telles que des [traces](/docs/concepts/signals/traces/), des - [metriques](/docs/concepts/signals/metrics/), et des + [métriques](/docs/concepts/signals/metrics/), et des [logs](/docs/concepts/signals/logs/) - Indépendant d'un fournisseur et d'un outil, ce qui signifie qu'il peut être utilisé avec une grande variété de backends d'observabilité, y compris des @@ -59,8 +59,8 @@ Ces deux principes combinés offrent aux équipes et aux organisations la flexibilité dont elles ont besoin dans le monde informatique moderne d’aujourd’hui. -Si vous souhaitez en savoir plus, jetez un oeil à la -[mission, la vision et les valeurs](/community/mission/) d'OpenTelemetry. +Si vous souhaitez en savoir plus, consultez la page +[Mission, vision et valeurs](/community/mission/) d'OpenTelemetry. ## Composants principaux d'OpenTelemetry From 1979916823d3996b2ae2f73b02b3551b4c6c46e0 Mon Sep 17 00:00:00 2001 From: isabelle-guitton Date: Tue, 7 Jan 2025 15:09:37 +0100 Subject: [PATCH 12/12] Issue #5826 Took marcalff's comment into account --- content/fr/concepts/observability-primer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/fr/concepts/observability-primer.md b/content/fr/concepts/observability-primer.md index bbb55d4a9bdc..c6230da37c72 100644 --- a/content/fr/concepts/observability-primer.md +++ b/content/fr/concepts/observability-primer.md @@ -54,7 +54,7 @@ L'indicateur de niveau de service, également connu sous le nom de **SLI**, est un indicateur de fonctionnement d'un service qui est évalué côté utilisateur. La vitesse à laquelle une page Web se charge est un exemple de SLI. -Les objectifs de niveau de service, communément appelé **SLO**, permettent de +Les objectifs de niveau de service, communément appelés **SLO**, permettent de rendre compte à une organisation ou à d'autres équipes de la fiabilité d'un système.