-
Notifications
You must be signed in to change notification settings - Fork 627
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: add otel ebpf profiler support
- Loading branch information
Showing
1 changed file
with
46 additions
and
0 deletions.
There are no files selected for viewing
46 changes: 46 additions & 0 deletions
46
docs/sources/configure-client/opentelemetry/ebpf-profiler.md
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,46 @@ | ||
--- | ||
title: OpenTelemetry Profiles Support (Experimental) | ||
menuTitle: OpenTelemetry Profiles | ||
description: Pyroscope's experimental support for OpenTelemetry profiles | ||
weight: 10 | ||
--- | ||
|
||
# OpenTelemetry Profiles Support (Experimental) | ||
|
||
Pyroscope now includes experimental support for receiving and visualizing profiles from OpenTelemetry sources. This integration allows you to: | ||
|
||
- Collect system-wide profiles using the [OpenTelemetry eBPF profiler](https://github.com/open-telemetry/opentelemetry-ebpf-profiler) | ||
- Process profile data through the OpenTelemetry Collector | ||
- Visualize profiles in Grafana using Pyroscope | ||
|
||
## Important Notes About Current Status | ||
|
||
Before getting started, please be aware of the following limitations: | ||
|
||
- The OpenTelemetry profiles protocol ([proto files](https://github.com/open-telemetry/opentelemetry-proto/tree/main/opentelemetry/proto/profiles)) is under active development: | ||
- Breaking changes are expected and have occurred | ||
- Compatibility between components (profiler, collector, backend) requires careful version management | ||
- We maintain support for the latest protocol version, but updates may be required frequently | ||
|
||
- We recommend evaluating this feature for development and testing purposes, but waiting for protocol stabilization before production use | ||
|
||
## Requirements | ||
|
||
- Linux system (amd64/arm64) for eBPF profiler | ||
- OpenTelemetry Collector with profiles feature gate enabled | ||
- Grafana with Pyroscope data source enabled | ||
|
||
## Architecture | ||
|
||
The profile collection pipeline consists of: | ||
|
||
1. **OpenTelemetry eBPF Profiler**: Collects system-wide profiles | ||
2. **OpenTelemetry Collector**: Receives and forwards profile data | ||
3. **Pyroscope**: Stores and processes profiles | ||
4. **Grafana**: Visualizes profile data | ||
|
||
## Getting Started | ||
|
||
For detailed setup instructions and working examples, refer to our [examples repository](https://github.com/grafana/pyroscope/tree/main/examples/grafana-agent-auto-instrumentation/ebpf-otel). | ||
|
||
The examples demonstrate deployments for both Docker and Kubernetes environments. |