|
| 1 | +--- |
| 2 | +title: Blueprints and reference implementations |
| 3 | +description: |
| 4 | + Blueprints and sample architectures for best practices when adopting and |
| 5 | + implementing OpenTelemetry in common environments |
| 6 | +weight: 600 |
| 7 | +--- |
| 8 | + |
| 9 | +Adopting OpenTelemetry at scale is not just a matter of configuring individual |
| 10 | +components. It requires coordinated decisions across teams and systems. The |
| 11 | +official project documentation explains how specific pieces of OpenTelemetry |
| 12 | +work, but many adopters need help connecting those pieces into a cohesive, |
| 13 | +production-ready architecture. |
| 14 | + |
| 15 | +This section provides high-level guidance and architectural patterns for |
| 16 | +designing and operating OpenTelemetry in real-world environments. It focuses on |
| 17 | +the challenges organizations face and maps these challenges to proven approaches |
| 18 | +and best practices you can apply in your own environment. |
| 19 | + |
| 20 | +There is no single “correct” way to deploy OpenTelemetry, so this guidance aims |
| 21 | +to address all organizational structures, not to force a specific one. With this |
| 22 | +flexibility in mind, you can find two types of reference documents in this |
| 23 | +section: |
| 24 | + |
| 25 | +- Blueprints are living documents that solve common adoption and implementation |
| 26 | + challenges in a given environment. Each blueprint is tightly scoped to address |
| 27 | + specific challenges, so you might need to refer to multiple blueprints, |
| 28 | + depending on your environment. |
| 29 | +- Reference implementations are snapshots in time that show how real-world |
| 30 | + organizations use OpenTelemetry to build scalable, resilient pipelines that |
| 31 | + send application telemetry to observability backends. |
| 32 | + |
| 33 | +<!-- If your organization has implemented OpenTelemetry and you think others could benefit from your experience, you can propose a new reference implementation by raising an issue in the End User SIG repository. To request a new blueprint for an environment or challenge not already covered, raise an issue using the Blueprints template. TODO: add links to issue template, if possible --> |
0 commit comments