github.com/grafana/pyroscope@v1.18.0/docs/sources/configure-client/opentelemetry/ebpf-profiler.md (about)

     1  ---
     2  title: OpenTelemetry profiling support
     3  menuTitle: OpenTelemetry profiling
     4  description: OpenTelemetry profiling support in Pyroscope
     5  weight: 150
     6  ---
     7  
     8  # OpenTelemetry profiling support
     9  
    10  Pyroscope includes **experimental** support for receiving and visualizing profiles from OpenTelemetry sources. This integration allows you to:
    11  
    12  - Collect system-wide profiles using the [OpenTelemetry eBPF profiler](https://github.com/open-telemetry/opentelemetry-ebpf-profiler)
    13  - Process profile data through the OpenTelemetry Collector
    14  - Visualize profiles in Grafana using Pyroscope
    15  
    16  ## Considerations
    17  
    18  Before getting started, you should consider the following limitations:
    19  
    20  - The OpenTelemetry profiles protocol ([proto files](https://github.com/open-telemetry/opentelemetry-proto/tree/main/opentelemetry/proto/profiles)) is under active development:
    21      - Breaking changes are expected and have occurred
    22      - Compatibility between components (profiler, collector, backend) requires careful version management
    23      - We maintain support for the latest protocol version, but updates may be required frequently
    24  
    25  - Symbolization support is currently limited:
    26    - Function names may not appear in flamegraphs for some programs
    27    - We're working on improving symbol resolution and adding support for manual symbol uploads
    28  
    29  - We recommend evaluating this feature for development and testing purposes, but waiting for protocol stabilization before production use
    30  
    31  ## Requirements
    32  
    33  - Linux system (amd64/arm64) for eBPF profiler
    34  - OpenTelemetry Collector with profiles feature gate enabled
    35  - Grafana with Pyroscope data source enabled
    36  
    37  ## Architecture
    38  
    39  The profile collection pipeline consists of:
    40  
    41  1. **OpenTelemetry eBPF Profiler**: Collects system-wide profiles
    42  2. **OpenTelemetry Collector**: Receives and forwards profile data
    43  3. **Pyroscope**: Stores and processes profiles
    44  4. **Grafana**: Visualizes profile data
    45  
    46  ## Get started
    47  
    48  For detailed setup instructions and working examples, refer to the [examples repository](https://github.com/grafana/pyroscope/tree/main/examples/grafana-alloy-auto-instrumentation/ebpf-otel).
    49  
    50  The examples demonstrate deployments for both Docker and Kubernetes environments.