From 34311661a417b5a929db4494dc59b7811bea5676 Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Mon, 17 Jun 2024 23:01:52 +0900 Subject: [PATCH 1/6] WIP: start translating OpenTelemetry primer translate 'what is observability?' --- content/ja/docs/concepts/_index.md | 11 ++ .../ja/docs/concepts/observability-primer.md | 141 ++++++++++++++++++ 2 files changed, 152 insertions(+) create mode 100644 content/ja/docs/concepts/_index.md create mode 100644 content/ja/docs/concepts/observability-primer.md diff --git a/content/ja/docs/concepts/_index.md b/content/ja/docs/concepts/_index.md new file mode 100644 index 000000000000..a624699333d7 --- /dev/null +++ b/content/ja/docs/concepts/_index.md @@ -0,0 +1,11 @@ +--- +title: OpenTelemetryの概念 +linkTitle: 概念 +description: OpenTelemetryの重要概念 +aliases: [concepts/overview] +weight: 170 +default_lang_commit: ebd92bb +--- + +このセクションでは、OpenTelemetryプロジェクトのデータソースと主要な要素について説明します。 +これらのドキュメントを読めば、OpenTelemetryが動作原理について理解できるでしょう。 diff --git a/content/ja/docs/concepts/observability-primer.md b/content/ja/docs/concepts/observability-primer.md new file mode 100644 index 000000000000..946105468dcd --- /dev/null +++ b/content/ja/docs/concepts/observability-primer.md @@ -0,0 +1,141 @@ +--- +title: Observability入門 +description: 重要なオブザーバビリティに関する概念 +weight: 9 +cSpell:ignore: webshop +default_lang_commit: ebd92bb +--- + +## オブザーバビリティとは何か + +オブザーバビリティは、システムの内部構造を知らなくても、そのシステムについて質問することで、システムを外側から理解することを可能にします。 +さらに、真新しい問題、つまり「未知の未知」のトラブルシューティングや対処が容易になります。 +また、「なぜこのようなことが起こるのか」という疑問に答えるのにも役立ちます。 + +システムに関してこれらの質問をするためには、アプリケーションが適切に計装されていなければなりません。 +つまり、アプリケーションのコードは、[トレース](./signals/traces/)、[メトリクス](./signals/metrics/)、[ログ](./signals/logs/)などの[シグナル](./signals/)を発しなければなりません。 +開発者が問題をトラブルシュートするために計装を追加する必要がないとき、アプリケーションは適切に計装されています。なぜなら開発者が必要な情報をすべて持っているということになるからです。 + +[OpenTelemetry](../what-is-opentelemetry/)は、システムをオブザーバビリティがある状態にするために、アプリケーションコードの計装を手助けする仕組みです。 + +## Reliability and metrics + +**Telemetry** refers to data emitted from a system and its behavior. The data +can come in the form of [traces](/docs/concepts/signals/traces/), +[metrics](/docs/concepts/signals/metrics/), and +[logs](/docs/concepts/signals/logs/). + +**Reliability** answers the question: "Is the service doing what users expect it +to be doing?” A system could be up 100% of the time, but if, when a user clicks +"Add to Cart” to add a black pair of shoes to their shopping cart, the system +doesn't always add black shoes, then the system could be **un**reliable. + +**Metrics** are aggregations over a period of time of numeric data about your +infrastructure or application. Examples include: system error rate, CPU +utilization, and request rate for a given service. For more on metrics and how +they relate to OpenTelemetry, see [Metrics](/docs/concepts/signals/metrics/). + +**SLI**, or Service Level Indicator, represents a measurement of a service's +behavior. A good SLI measures your service from the perspective of your users. +An example SLI can be the speed at which a web page loads. + +**SLO**, or Service Level Objective, represents the means by which reliability +is communicated to an organization/other teams. This is accomplished by +attaching one or more SLIs to business value. + +## Understanding distributed tracing + +Distributed tracing lets you observe requests as they propagate through complex, +distributed systems. Distributed tracing improves the visibility of your +application or system's health and lets you debug behavior that is difficult to +reproduce locally. It is essential for distributed systems, which commonly have +nondeterministic problems or are too complicated to reproduce locally. + +To understand distributed tracing, you need to understand the role of each of +its components: logs, spans, and traces. + +### Logs + +A **log** is a timestamped message emitted by services or other components. +Unlike [traces](#distributed-traces), they aren't necessarily associated with +any particular user request or transaction. You can find logs almost everywhere +in software. Logs have been heavily relied on in the past by both developers and +operators to help them understand system behavior. + +Sample 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 +``` + +Logs aren't enough for tracking code execution, as they usually lack contextual +information, such as where they were called from. + +They become far more useful when they are included as part of a [span](#spans), +or when they are correlated with a trace and a span. + +For more on logs and how they pertain to OpenTelemetry, see +[Logs](/docs/concepts/signals/logs/). + +### Spans + +A **span** represents a unit of work or operation. Spans track specific +operations that a request makes, painting a picture of what happened during the +time in which that operation was executed. + +A span contains name, time-related data, +[structured log messages](/docs/concepts/signals/traces/#span-events), and +[other metadata (that is, Attributes)](/docs/concepts/signals/traces/#attributes) +to provide information about the operation it tracks. + +#### Span attributes + +Span attributes are metadata attached to a span. + +The following table contains examples of span attributes: + +| Key | Value | +| :-------------------------- | :--------------------------------------------------------------------------------- | +| `http.request.method` | `"GET"` | +| `network.protocol.version` | `"1.1"` | +| `url.path` | `"/webshop/articles/4"` | +| `url.query` | `"?s=1"` | +| `server.address` | `"example.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"` (the client goes through a proxy) | +| `user_agent.original` | `"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:72.0) Gecko/20100101 Firefox/72.0"` | + +For more on spans and how they relate to OpenTelemetry, see +[Spans](/docs/concepts/signals/traces/#spans). + +### Distributed traces + +A **distributed trace**, more commonly known as a **trace**, records the paths +taken by requests (made by an application or end-user) as they propagate through +multi-service architectures, like microservice and serverless applications. + +A trace is made of one or more spans. The first span represents the root span. +Each root span represents a request from start to finish. The spans underneath +the parent provide a more in-depth context of what occurs during a request (or +what steps make up a request). + +Without tracing, finding the root cause of performance problems in a distributed +system can be challenging. Tracing makes debugging and understanding distributed +systems less daunting by breaking down what happens within a request as it flows +through a distributed system. + +Many Observability backends visualize traces as waterfall diagrams that look +like this: + +![Sample Trace](/img/waterfall-trace.svg 'Trace waterfall diagram') + +Waterfall diagrams show the parent-child relationship between a root span and +its child spans. When a span encapsulates another span, this also represents a +nested relationship. + +For more on traces and how they pertain to OpenTelemetry, see +[Traces](/docs/concepts/signals/traces/). From 654fc409783a459155b614601b5c74587220872d Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Tue, 18 Jun 2024 18:05:35 +0900 Subject: [PATCH 2/6] fix: target link and anchor --- content/ja/docs/concepts/observability-primer.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/ja/docs/concepts/observability-primer.md b/content/ja/docs/concepts/observability-primer.md index 946105468dcd..cfe9712202d8 100644 --- a/content/ja/docs/concepts/observability-primer.md +++ b/content/ja/docs/concepts/observability-primer.md @@ -6,17 +6,17 @@ cSpell:ignore: webshop default_lang_commit: ebd92bb --- -## オブザーバビリティとは何か +## オブザーバビリティとは何か {#what-is-observability} オブザーバビリティは、システムの内部構造を知らなくても、そのシステムについて質問することで、システムを外側から理解することを可能にします。 さらに、真新しい問題、つまり「未知の未知」のトラブルシューティングや対処が容易になります。 また、「なぜこのようなことが起こるのか」という疑問に答えるのにも役立ちます。 システムに関してこれらの質問をするためには、アプリケーションが適切に計装されていなければなりません。 -つまり、アプリケーションのコードは、[トレース](./signals/traces/)、[メトリクス](./signals/metrics/)、[ログ](./signals/logs/)などの[シグナル](./signals/)を発しなければなりません。 +つまり、アプリケーションのコードは、[トレース](/docs/concepts/signals/traces/)、[メトリクス](/docs/concepts/signals/metrics/)、[ログ](/docs/concepts/signals/logs/)などの[シグナル](/docs/concepts/signals/)を発しなければなりません。 開発者が問題をトラブルシュートするために計装を追加する必要がないとき、アプリケーションは適切に計装されています。なぜなら開発者が必要な情報をすべて持っているということになるからです。 -[OpenTelemetry](../what-is-opentelemetry/)は、システムをオブザーバビリティがある状態にするために、アプリケーションコードの計装を手助けする仕組みです。 +[OpenTelemetry](/docs/what-is-opentelemetry/)は、システムをオブザーバビリティがある状態にするために、アプリケーションコードの計装を手助けする仕組みです。 ## Reliability and metrics From a739dc103809aba50409bbd70226e9e57f702eda Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Tue, 18 Jun 2024 23:05:58 +0900 Subject: [PATCH 3/6] add: add the translation of the rest of the page --- .../ja/docs/concepts/observability-primer.md | 137 ++++++++---------- 1 file changed, 62 insertions(+), 75 deletions(-) diff --git a/content/ja/docs/concepts/observability-primer.md b/content/ja/docs/concepts/observability-primer.md index cfe9712202d8..3cc55c231f48 100644 --- a/content/ja/docs/concepts/observability-primer.md +++ b/content/ja/docs/concepts/observability-primer.md @@ -18,83 +18,73 @@ default_lang_commit: ebd92bb [OpenTelemetry](/docs/what-is-opentelemetry/)は、システムをオブザーバビリティがある状態にするために、アプリケーションコードの計装を手助けする仕組みです。 -## Reliability and metrics +## 信頼性とメトリクス -**Telemetry** refers to data emitted from a system and its behavior. The data -can come in the form of [traces](/docs/concepts/signals/traces/), -[metrics](/docs/concepts/signals/metrics/), and -[logs](/docs/concepts/signals/logs/). +**テレメトリー** とは、システムやその動作から送出されるデータのことです。 +データは[トレース](/docs/concepts/signals/traces/)、[メトリクス](/docs/concepts/signals/metrics/)、[ログ](/docs/concepts/signals/logs/)などの形式で得られます。 -**Reliability** answers the question: "Is the service doing what users expect it -to be doing?” A system could be up 100% of the time, but if, when a user clicks -"Add to Cart” to add a black pair of shoes to their shopping cart, the system -doesn't always add black shoes, then the system could be **un**reliable. +**信頼性** は「サービスがユーザーの期待通りに動いているでしょうか」といった疑問に答えてくれます。 +システムは常に100％稼働していても、ユーザーがショッピングカートに黒い靴を追加するために「カートに追加」をクリックしたときに、システムが常に黒い靴を追加するとは限らない場合、システムは **信頼性がない** と言えるでしょう。 -**Metrics** are aggregations over a period of time of numeric data about your -infrastructure or application. Examples include: system error rate, CPU -utilization, and request rate for a given service. For more on metrics and how -they relate to OpenTelemetry, see [Metrics](/docs/concepts/signals/metrics/). +**メトリクス** とは、インフラやアプリケーションに関する数値データを一定期間にわたって集計したものです。 +たとえば、システムエラー率、CPU使用率、あるサービスのリクエスト率などです。 +メトリクスとOpenTelemetryとの関係については、[メトリクス](/docs/concepts/signals/metrics/) のページを参照してください。 -**SLI**, or Service Level Indicator, represents a measurement of a service's -behavior. A good SLI measures your service from the perspective of your users. -An example SLI can be the speed at which a web page loads. +**SLI**（サービスレベル指標）は、サービスの動作の計測値を表します。 +優れたSLIは、ユーザーの視点からサービスを計測します。 +SLIの例として、ウェブページの読み込み速度が挙げられます。 -**SLO**, or Service Level Objective, represents the means by which reliability -is communicated to an organization/other teams. This is accomplished by -attaching one or more SLIs to business value. +**SLO**（サービスレベル目標）は、信頼性を組織や他のチームに伝達する手段を表します。 +これは、1つ以上のSLIをビジネス価値に付加することで達成されます。 -## Understanding distributed tracing +## 分散トレースを理解する -Distributed tracing lets you observe requests as they propagate through complex, -distributed systems. Distributed tracing improves the visibility of your -application or system's health and lets you debug behavior that is difficult to -reproduce locally. It is essential for distributed systems, which commonly have -nondeterministic problems or are too complicated to reproduce locally. +分散トレースにより、複雑な分散システムを通してリクエストが伝搬する様子を観察できます。 +分散トレースはアプリケーションやシステムの健全性の可視性を向上させ、ローカルで再現するのが困難な挙動をデバッグできます。 +これは、一般的に非決定論的な問題があったり、ローカルで再現するには複雑すぎる分散システムには不可欠です。 -To understand distributed tracing, you need to understand the role of each of -its components: logs, spans, and traces. +分散トレースを理解するには、ログ、スパン、トレースといった各要素の役割を理解する必要があります。 -### Logs +### ログ -A **log** is a timestamped message emitted by services or other components. -Unlike [traces](#distributed-traces), they aren't necessarily associated with -any particular user request or transaction. You can find logs almost everywhere -in software. Logs have been heavily relied on in the past by both developers and -operators to help them understand system behavior. +**ログ**は、サービスや他のコンポーネントが発するタイムスタンプ付きのメッセージです。 +[トレース](#distributed-traces)とは異なり、ログは必ずしも特定のユーザーリクエストやトランザクションに関連付けられているわけではありません。 +ログは、ソフトウェアのあらゆる場所で見られます。 +ログは、開発者と運用者の両方がシステムの挙動を理解するのに役立つため、これまで大いに利用されてきました。 -Sample 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 ``` -Logs aren't enough for tracking code execution, as they usually lack contextual -information, such as where they were called from. +ログはコードの実行を追跡するには十分ではありません。 +ログには通常、どこから呼び出されたかといったコンテキスト情報が欠けているからです。 -They become far more useful when they are included as part of a [span](#spans), -or when they are correlated with a trace and a span. +ログは、[スパン](#span)の一部として含まれるとき、あるいはトレースやスパンと相関があるときに、はるかに有用になります。 -For more on logs and how they pertain to OpenTelemetry, see -[Logs](/docs/concepts/signals/logs/). +ログの詳細とOpenTelemetryとの関係については、[ログ](/docs/concepts/signals/logs/)のページを参照してください。 -### Spans +### スパン {#span} -A **span** represents a unit of work or operation. Spans track specific -operations that a request makes, painting a picture of what happened during the -time in which that operation was executed. +**スパン** は作業または操作の単位を表します。 +スパンは、リクエストが行う特定の操作を追跡し、その操作が実行された時間に何が起こったかを説明してくれます。 -A span contains name, time-related data, -[structured log messages](/docs/concepts/signals/traces/#span-events), and -[other metadata (that is, Attributes)](/docs/concepts/signals/traces/#attributes) -to provide information about the operation it tracks. +.. + A span contains name, time-related data, + [structured log messages](/docs/concepts/signals/traces/#span-events), and + [other metadata (that is, Attributes)](/docs/concepts/signals/traces/#attributes) + to provide information about the operation it tracks. -#### Span attributes +スパンには、名前、時間関連データ、[構造化ログメッセージ](/docs/concepts/signals/traces/#span-events)、[その他のメタデータ(つまり属性)](/docs/concepts/signals/traces/#attributes)が含まれ、追跡する操作に関する情報を提供します。 -Span attributes are metadata attached to a span. +#### スパン属性 -The following table contains examples of span attributes: +スパン属性はスパンに紐づけられたメタデータです。 -| Key | Value | +次の表はスパン属性の例を列挙しています。 + +| キー | 値 | | :-------------------------- | :--------------------------------------------------------------------------------- | | `http.request.method` | `"GET"` | | `network.protocol.version` | `"1.1"` | @@ -106,36 +96,33 @@ The following table contains examples of span attributes: | `http.route` | `"/webshop/articles/:article_id"` | | `http.response.status_code` | `200` | | `client.address` | `"192.0.2.4"` | -| `client.socket.address` | `"192.0.2.5"` (the client goes through a proxy) | +| `client.socket.address` | `"192.0.2.5"` （クライアントはプロキシ経由） | | `user_agent.original` | `"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:72.0) Gecko/20100101 Firefox/72.0"` | -For more on spans and how they relate to OpenTelemetry, see -[Spans](/docs/concepts/signals/traces/#spans). +スパンと OpenTelemetry との関係については、[スパン](/docs/concepts/signals/traces/#span)の節を参照してください。 + +### 分散トレース {#distributed-traces} -### Distributed traces +.. + A **distributed trace**, more commonly known as a **trace**, records the paths + taken by requests (made by an application or end-user) as they propagate through + multi-service architectures, like microservice and serverless applications. -A **distributed trace**, more commonly known as a **trace**, records the paths -taken by requests (made by an application or end-user) as they propagate through -multi-service architectures, like microservice and serverless applications. +一般的に**トレース**として知られている**分散トレース**は、マイクロサービスやサーバーレスアプリケーションのようなマルチサービスアーキテクチャを伝播するリクエスト（アプリケーションまたはエンドユーザーによって行われる）が辿った経路を記録します。 -A trace is made of one or more spans. The first span represents the root span. -Each root span represents a request from start to finish. The spans underneath -the parent provide a more in-depth context of what occurs during a request (or -what steps make up a request). +トレースは1つ以上のスパンで構成されるます。 +最初のスパンはルートスパンを表します。 +各ルートスパンは、リクエストの開始から終了までを表します。 +親の下にあるスパンは、リクエスト中に発生すること（またはリクエストを構成するステップ）について、より詳細なコンテキストを提供します。 -Without tracing, finding the root cause of performance problems in a distributed -system can be challenging. Tracing makes debugging and understanding distributed -systems less daunting by breaking down what happens within a request as it flows -through a distributed system. +トレースなしでは、分散システムのパフォーマンス問題の根本的な原因を見つけることは困難です。 +トレースは、分散システムを流れるリクエストの中で何が起こっているのかを分解することで、分散システムのデバッグと理解をしやすくします。 -Many Observability backends visualize traces as waterfall diagrams that look -like this: +多くのオブザーバビリティバックエンドは、トレースをこのようなウォーターフォール図として視覚化しています。 -![Sample Trace](/img/waterfall-trace.svg 'Trace waterfall diagram') +![トレースの例](/img/waterfall-trace.svg 'トレースのウォーターフォール図') -Waterfall diagrams show the parent-child relationship between a root span and -its child spans. When a span encapsulates another span, this also represents a -nested relationship. +ウォーターフォール図は、ルートスパンとその子スパンの親子関係を示しています。 +スパンが別のスパンを含む場合も、入れ子関係を表します。 -For more on traces and how they pertain to OpenTelemetry, see -[Traces](/docs/concepts/signals/traces/). +トレースとOpenTelemetryとの関係については、[トレース](/docs/concepts/signals/traces/)のページを参照してください。 From 5a5b7fe5133b06cb0e03078b33dd83064b7c2549 Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Tue, 18 Jun 2024 23:09:38 +0900 Subject: [PATCH 4/6] fix: fix markdown format --- .../ja/docs/concepts/observability-primer.md | 17 ++++++----------- 1 file changed, 6 insertions(+), 11 deletions(-) diff --git a/content/ja/docs/concepts/observability-primer.md b/content/ja/docs/concepts/observability-primer.md index 3cc55c231f48..c14155f197e2 100644 --- a/content/ja/docs/concepts/observability-primer.md +++ b/content/ja/docs/concepts/observability-primer.md @@ -71,10 +71,10 @@ I, [2021-02-23T13:26:23.505892 #22473] INFO -- : [6459ffe1-ea53-4044-aaa3-bf902 スパンは、リクエストが行う特定の操作を追跡し、その操作が実行された時間に何が起こったかを説明してくれます。 .. - A span contains name, time-related data, - [structured log messages](/docs/concepts/signals/traces/#span-events), and - [other metadata (that is, Attributes)](/docs/concepts/signals/traces/#attributes) - to provide information about the operation it tracks. +A span contains name, time-related data, +[structured log messages](/docs/concepts/signals/traces/#span-events), and +[other metadata (that is, Attributes)](/docs/concepts/signals/traces/#attributes) +to provide information about the operation it tracks. スパンには、名前、時間関連データ、[構造化ログメッセージ](/docs/concepts/signals/traces/#span-events)、[その他のメタデータ(つまり属性)](/docs/concepts/signals/traces/#attributes)が含まれ、追跡する操作に関する情報を提供します。 @@ -84,7 +84,7 @@ I, [2021-02-23T13:26:23.505892 #22473] INFO -- : [6459ffe1-ea53-4044-aaa3-bf902 次の表はスパン属性の例を列挙しています。 -| キー | 値 | +| キー | 値 | | :-------------------------- | :--------------------------------------------------------------------------------- | | `http.request.method` | `"GET"` | | `network.protocol.version` | `"1.1"` | @@ -96,18 +96,13 @@ I, [2021-02-23T13:26:23.505892 #22473] INFO -- : [6459ffe1-ea53-4044-aaa3-bf902 | `http.route` | `"/webshop/articles/:article_id"` | | `http.response.status_code` | `200` | | `client.address` | `"192.0.2.4"` | -| `client.socket.address` | `"192.0.2.5"` （クライアントはプロキシ経由） | +| `client.socket.address` | `"192.0.2.5"` （クライアントはプロキシ経由） | | `user_agent.original` | `"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:72.0) Gecko/20100101 Firefox/72.0"` | スパンと OpenTelemetry との関係については、[スパン](/docs/concepts/signals/traces/#span)の節を参照してください。 ### 分散トレース {#distributed-traces} -.. - A **distributed trace**, more commonly known as a **trace**, records the paths - taken by requests (made by an application or end-user) as they propagate through - multi-service architectures, like microservice and serverless applications. - 一般的に**トレース**として知られている**分散トレース**は、マイクロサービスやサーバーレスアプリケーションのようなマルチサービスアーキテクチャを伝播するリクエスト（アプリケーションまたはエンドユーザーによって行われる）が辿った経路を記録します。 トレースは1つ以上のスパンで構成されるます。 From 99f1073981c706e975c786fa5636b6b4ebb929ab Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Tue, 18 Jun 2024 23:31:29 +0900 Subject: [PATCH 5/6] nit: fix link and remove the original english content --- content/ja/docs/concepts/observability-primer.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/content/ja/docs/concepts/observability-primer.md b/content/ja/docs/concepts/observability-primer.md index c14155f197e2..381df4e9e13e 100644 --- a/content/ja/docs/concepts/observability-primer.md +++ b/content/ja/docs/concepts/observability-primer.md @@ -70,12 +70,6 @@ I, [2021-02-23T13:26:23.505892 #22473] INFO -- : [6459ffe1-ea53-4044-aaa3-bf902 **スパン** は作業または操作の単位を表します。 スパンは、リクエストが行う特定の操作を追跡し、その操作が実行された時間に何が起こったかを説明してくれます。 -.. -A span contains name, time-related data, -[structured log messages](/docs/concepts/signals/traces/#span-events), and -[other metadata (that is, Attributes)](/docs/concepts/signals/traces/#attributes) -to provide information about the operation it tracks. - スパンには、名前、時間関連データ、[構造化ログメッセージ](/docs/concepts/signals/traces/#span-events)、[その他のメタデータ(つまり属性)](/docs/concepts/signals/traces/#attributes)が含まれ、追跡する操作に関する情報を提供します。 #### スパン属性 @@ -99,7 +93,7 @@ to provide information about the operation it tracks. | `client.socket.address` | `"192.0.2.5"` （クライアントはプロキシ経由） | | `user_agent.original` | `"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:72.0) Gecko/20100101 Firefox/72.0"` | -スパンと OpenTelemetry との関係については、[スパン](/docs/concepts/signals/traces/#span)の節を参照してください。 +スパンと OpenTelemetry との関係については、[スパン](/docs/concepts/signals/traces/#spans)の節を参照してください。 ### 分散トレース {#distributed-traces} From 99a99cedd8d82e94f394bda6e2f8c87debd8ee4d Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Thu, 20 Jun 2024 09:56:26 +0900 Subject: [PATCH 6/6] nit: change nuance a bit --- content/ja/docs/concepts/observability-primer.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/ja/docs/concepts/observability-primer.md b/content/ja/docs/concepts/observability-primer.md index 381df4e9e13e..5e25387c9f74 100644 --- a/content/ja/docs/concepts/observability-primer.md +++ b/content/ja/docs/concepts/observability-primer.md @@ -14,7 +14,8 @@ default_lang_commit: ebd92bb システムに関してこれらの質問をするためには、アプリケーションが適切に計装されていなければなりません。 つまり、アプリケーションのコードは、[トレース](/docs/concepts/signals/traces/)、[メトリクス](/docs/concepts/signals/metrics/)、[ログ](/docs/concepts/signals/logs/)などの[シグナル](/docs/concepts/signals/)を発しなければなりません。 -開発者が問題をトラブルシュートするために計装を追加する必要がないとき、アプリケーションは適切に計装されています。なぜなら開発者が必要な情報をすべて持っているということになるからです。 +開発者が問題をトラブルシュートするために計装を追加する必要がないとき、アプリケーションは適切に計装されていると言えます。 +なぜなら開発者が必要な情報をすべて持っているということになるからです。 [OpenTelemetry](/docs/what-is-opentelemetry/)は、システムをオブザーバビリティがある状態にするために、アプリケーションコードの計装を手助けする仕組みです。