ブループリントとリファレンス実装

OpenTelemetry を大規模に採用するには、個々のコンポーネントを設定するだけでは不十分です。 チームやシステム全体にわたって、一貫した判断が求められます。 公式ドキュメントでは OpenTelemetry の各機能がどのように動作するかを説明していますが、それらを本番環境に対応したアーキテクチャとしてまとめ上げるには、さらなるガイダンスが必要です。

このセクションでは、実世界の環境で OpenTelemetry を設計し運用するための高レベルのガイダンスとアーキテクチャパターンを提供します。 組織が直面する課題に焦点を当て、それらの課題を実証済みのアプローチおよびご自身の環境で適用できるベストプラクティスに対応付けます。

OpenTelemetry をデプロイする単一の「正しい」方法はないため、このガイダンスは特定の形を強制するのではなく、あらゆる組織構造に対応することを目的としています。 この柔軟性を念頭に置き、このセクションでは以下の2種類の参照ドキュメントを見つけることができます。

• ブループリントは、所定の環境における一般的な導入および実装の課題を解決するリビングドキュメントです。各ブループリントは特定の課題に対処するよう厳密に範囲が限定されているため、環境に応じて複数のブループリントを参照する必要があるかもしれません。
• リファレンス実装は、現実世界の組織がアプリケーションのテレメトリーを可観測性バックエンドへ送るスケーラブルで回復性のあるパイプラインを構築するために、どのように OpenTelemetry を使っているかを示すある時点でのスナップショットです。

コントリビュートの方法

自組織が OpenTelemetry を実装しており、その経験が他者の役に立つと考える場合や、新しい環境における OpenTelemetry の採用について、ベストプラクティスを共有するブループリントを提案したい場合は、ぜひお知らせください！

新しいブループリントまたはリファレンス実装を提案するには、以下のイシューテンプレートを使用し、End User SIG リポジトリでイシューを立ててください。

• ブループリント
• リファレンス実装

標準テンプレートに沿った高品質なドキュメントの作成から、最終的な公式ドキュメントへのコントリビューションまで、End User SIG メンバーが一連のプロセスを案内します。