Skip to content

docs: Add new blueprint for non-k8s environments#9713

Open
luke6Lh43 wants to merge 1 commit intoopen-telemetry:mainfrom
luke6Lh43:docs/add-blueprint-for-non-k8s-environments
Open

docs: Add new blueprint for non-k8s environments#9713
luke6Lh43 wants to merge 1 commit intoopen-telemetry:mainfrom
luke6Lh43:docs/add-blueprint-for-non-k8s-environments

Conversation

@luke6Lh43
Copy link
Copy Markdown
Member

@luke6Lh43 luke6Lh43 commented Apr 21, 2026

  • I have read and followed the Contributing docs, especially the "First-time contributing?" section.
  • This PR has content that I did not fully write myself.
  • I used AI and I have read and followed the Generative AI Contribution Policy.
  • I have the experience and knowledge necessary to understand, review, and validate all content in this PR.[^I-know-my-stuff]
  • Yes, I can answer maintainer questions about the content of this PR, without using AI.

PR Description:

This PR adds a new blueprint providing best practices for instrumenting infrastructure and processes in non-Kubernetes environments, such as VMs, bare metal, and on-premises deployments (including containers run directly on OS).

Key Features:

Centralized agent management with OpAMP and layered configuration.
Guidelines for deploying OpenTelemetry Collector Gateways as aggregation and processing points.
Standardized resource attribution and reusable instrumentation building blocks.
Step-by-step roadmap and actionable checklists for implementation.
Reference architectures for real-world scenarios.

Motivation:

Supports organizations operating legacy and mixed infrastructure by reducing manual toil, unifying observability, and improving governance over telemetry.

References:

OpAMP Specification
OpenTelemetry Collector Documentation
OpenTelemetry Semantic Conventions

Feedback and suggestions are welcome.

Closes open-telemetry/sig-end-user#245

@luke6Lh43
Copy link
Copy Markdown
Member Author

@tiffany76 @danielgblanco - kindly please review and give me your feedback :)

@otelbot-docs otelbot-docs Bot added the missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer label Apr 21, 2026
@luke6Lh43 luke6Lh43 force-pushed the docs/add-blueprint-for-non-k8s-environments branch 3 times, most recently from 40fcf21 to 62f14a6 Compare April 22, 2026 02:45
@luke6Lh43 luke6Lh43 force-pushed the docs/add-blueprint-for-non-k8s-environments branch from 62f14a6 to ac327bc Compare April 22, 2026 02:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

Blueprint for Instrumenting Infrastructure and Processes on Non-K8s Environments

1 participant