-
Notifications
You must be signed in to change notification settings - Fork 1.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add Japanese translation for "What is OpenTelemetry?" (#4606)
- Loading branch information
Yoshi Yamaguchi
authored
Jun 7, 2024
1 parent
c62b369
commit 93ab130
Showing
2 changed files
with
89 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,10 @@ | ||
--- | ||
title: ドキュメント | ||
menu: { main: { weight: 10 } } | ||
--- | ||
|
||
OTelの略称でも知られるOpenTelemetryは、[トレース](/docs/concepts/signals/traces/)、[メトリクス](/docs/concepts/signals/metrics/)、[ログ](/docs/concepts/signals/logs/)のようなテレメトリーデータを計装、生成、収集、エクスポートするためのベンダー非依存なオープンソースの[オブザーバビリティ](/docs/concepts/observability-primer/#what-is-observability)フレームワークです。 | ||
|
||
業界標準として、OpenTelemetryは[40以上のオブザーバビリティベンダーによってサポートされ](/ecosystem/vendors/)、多くの[ライブラリ、サービス、アプリ](/ecosystem/integrations)によって統合され、[多くのエンドユーザー](/ecosystem/adopters)によって採用されています。 | ||
|
||
![OpenTelemetry Reference Architecture](/img/otel-diagram.svg) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,79 @@ | ||
--- | ||
title: OpenTelemetryとは | ||
description: OpenTelemetryが何であり、何でないかについての簡単な説明。 | ||
weight: 150 | ||
--- | ||
|
||
OpenTelemetryは[オブザーバビリティ](/docs/concepts/observability-primer/#what-is-observability)フレームワークであり、[トレース](/docs/concepts/signals/traces/)、[メトリクス](/docs/concepts/signals/metrics/)、[ログ](/docs/concepts/signals/logs/)のようなテレメトリーデータを作成・管理するためにデザインされたツールキットです。 | ||
重要なことは、OpenTelemetryはベンダーやツールにとらわれないということです。 | ||
つまり、[Jaeger](https://www.jaegertracing.io/)や[Prometheus](https://prometheus.io/)のようなオープンソースツールや、商用製品を含む、さまざまなオブザーバビリティバックエンドで使用できるということです。 | ||
|
||
OpenTelemetryは、JaegerやPrometheusや他の商用ベンダーのようなオブザーバビリティバックエンドではありません。 | ||
OpenTelemetryはテレメトリの生成、収集、管理、そしてエクスポートにフォーカスしています。 | ||
OpenTelemetryの主な目的は、あなたのアプリケーションやシステムを、その言語、インフラ、ランタイム環境に関係なく、簡単に計装できるようにすることです。 | ||
テレメトリーの保存と可視化は、意図的に他のツールに任せているということを理解するのが重要です。 | ||
|
||
## オブザーバビリティとはなにか | ||
|
||
[オブザーバビリティ](/docs/concepts/observability-primer/#what-is-observability)とは、システムの出力を調べることによって、システムの内部状態を理解する能力のことです。 | ||
ソフトウェアの文脈では、これは、トレース、メトリクス、ログを含むテレメトリーデータを調べることによって、システムの内部状態を理解できることを意味します。 | ||
|
||
システムをオブザーバビリティがある状態にするには、[軽装されて](/docs/concepts/instrumentation)いなければなりません。 | ||
つまり、コードが[トレース](/docs/concepts/signals/traces/)、[メトリクス](/docs/concepts/signals/metrics/)、または[ログ](/docs/concepts/signals/logs/)を出力しなければなりません。 | ||
計装されたデータは、オブザーバビリティバックエンドに送信されなければなりません。 | ||
|
||
## なぜOpenTelemetryなのか | ||
|
||
クラウドコンピューティング、マイクロサービスアーキテクチャー、複雑化するビジネス要件の台頭により、ソフトウェアとインフラの[オブザーバビリティ](/docs/concepts/observability-primer/#what-is-observability)の必要性はかつてないほど高まっています。 | ||
|
||
OpenTelemetryは、2つの重要な原則に従いながら、オブザーバビリティの需要を満たしています。 | ||
|
||
1. あなたが生成したデータはあなたのものです。ベンダーのロックインはありません。 | ||
2. APIと規約は1セットだけ覚えれば良いです。 | ||
|
||
この2つの原則を組み合わせることで、現代のコンピューティングの世界で必要とされる柔軟性をチームや組織に与えられます。 | ||
|
||
もっと知りたければ、OpenTelemetryの[ミッション、ビジョン、バリュー](/community/mission/)を見てください。 | ||
|
||
## OpenTelemetryの主要コンポーネント | ||
|
||
OpenTelemetryは以下の主要コンポーネントで構成されています。 | ||
|
||
- 全コンポーネントの[仕様](/docs/specs/otel) | ||
- テレメトリーデータの形式を定義する標準[プロトコル](/docs/specs/otlp/) | ||
- 共通のテレメトリーデータ型のための標準の命名スキーマを定義する[セマンティック規約](/docs/specs/semconv/) | ||
- テレメトリーデータの生成方法を定義するAPI | ||
- 仕様、API、テレメトリーデータのエクスポートを実装する[各言語向けSDK](/docs/languages) | ||
- 共通ライブラリやフレームワークの計装を実装する[ライブラリエコシステム](/ecosystem/registry) | ||
- コード変更の必要なくテレメトリーデータを生成する自動計装コンポーネント | ||
- テレメトリーデータの受信、処理、送信のためのプロキシとなる[OpenTelemetryコレクター](/docs/collector) | ||
- [OpenTelemetry Operator for Kubernetes](/docs/kubernetes/operator/)、[OpenTelemetry Helm Charts](/docs/kubernetes/helm/)、[FaaS向けコミュニティアセット](/docs/faas/)といったその他さまざまなツール | ||
|
||
OpenTelemetryは、デフォルトでオブザーバビリティを提供するために、OpenTelemetryが統合されたさまざまな[ライブラリ、サービス、アプリ](/ecosystem/integrations/)によって使用されています。 | ||
|
||
OpenTelemetryは多くの[ベンダー](/ecosystem/vendors/)によってサポートされており、その多くはOpenTelemetryの商用サポートを提供し、プロジェクトに直接貢献しています。 | ||
|
||
## 拡張性 | ||
|
||
OpenTelemetryは拡張できるように設計されています。どのように拡張できるかの例をいくつか挙げます。 | ||
|
||
- OpenTelemetryコレクターにレシーバーを追加して、独自のデータソースからのテレメトリーデータをサポートする | ||
- カスタム計装ライブラリをSDKにロードする | ||
- 特定のユースケースに合わせたSDKまたはコレクターの[ディストリビューション](/docs/concepts/distributions/)の作成 | ||
- OpenTelemetryプロトコル(OTLP)をまだサポートしていないカスタムバックエンド用の新しいエクスポーターの作成 | ||
- 非標準のコンテキスト伝播形式用のカスタムプロパゲーターの作成 | ||
|
||
ほとんどのユーザーはOpenTelemetryを拡張する必要はないかもしれませんが、このプロジェクトはほぼすべてのレベルで拡張できるように設計されています。 | ||
|
||
## 歴史 | ||
|
||
OpenTelemetryは、[Cloud Native Computing Foundation (CNCF)](https://www.cncf.io)プロジェクトであり、[OpenTracing](https://opentracing.io)と[OpenCensus](https://opencensus.io)の2つのプロジェクトが統合された成果物です。 | ||
これらのプロジェクトはどちらも、コードを計装し、オブザーバビリティバックエンドにテレメトリーデータを送信する方法の標準がないという問題を解決するために作られました。 | ||
どちらのプロジェクトも、独立してこの問題を完全には解決できなかったので、協力するためにOpenTelemetryプロジェクトとして合併し、単一のソリューションを提供しながら、それぞれの強みを組み合わせました。 | ||
|
||
現在OpenTracingまたはOpenCensusを使っている場合は、[移行ガイド](/docs/migration/)でOpenTelemetryへの移行方法を確認してください。 | ||
|
||
## 次のステップ | ||
|
||
- [Getting started](/docs/getting-started/) — 早速始めてみましょう! | ||
- [OpenTelemetryの概念](/docs/concepts/)について学ぶ |