https://github.com/alexandrelamarre/otelcol-bpf

Open telemetry collector that integrates eBPF scripts for observability
https://github.com/alexandrelamarre/otelcol-bpf

ebpf observability opentelemetry-collector

Last synced: 2 months ago
JSON representation

Open telemetry collector that integrates eBPF scripts for observability

• Host: GitHub
• URL: https://github.com/alexandrelamarre/otelcol-bpf
• Owner: alexandreLamarre
• License: apache-2.0
• Created: 2024-06-01T17:18:57.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-02-19T13:41:15.000Z (4 months ago)
• Last Synced: 2025-03-24T06:11:30.491Z (3 months ago)
• Topics: ebpf, observability, opentelemetry-collector
• Language: C
• Homepage:
• Size: 1.25 MB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# otelcol-bpf

![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/alexandreLamarre/otelcol-bpf/ci.yaml)

![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/alexandreLamarre/otelcol-bpf)

![GitHub License](https://img.shields.io/github/license/alexandreLamarre/otelcol-bpf)

![OpenTelemetry Collector version](https://img.shields.io/badge/collector-0.119.0-blue)

An open telemetry collector distribution that focuses on ebpf scripts to gather observability data.

## Extensions

### BPF Logger

| Status        |           |

| ------------- |-----------|

| Stability     | [alpha]  |

| Distributions | [bpf] |

[alpha]: https://github.com/open-telemetry/opentelemetry-collector#alpha

This extension enables logging `bpf_printk` directly into the OpenTelemetry Collector's logging.

The default eBPF trace pipe path is `/sys/kernel/debug/tracing/trace_pipe"`, and can be enabled via : 

```bash

sudo mount -t debugfs debugfs /sys/kernel/debug

```

the trace pipe path can be overriden via the config:

```yaml

extensions:

    bpf_logger:

        bpf_trace_pipe : /foo/pipe

```

## Receivers

### PPROF receiver

Collects pprof profiles from remote pprof endpoints.

| Status        |           |

| ------------- |-----------|

| Stability     | [alpha]: logs   |

| Distributions | [bpf] |

| License | Apache 2 |

```yaml

receivers:

  pprofreceiver:

    endpoints:

      - endpoint: "http://localhost:6060"

        targets:

          profile:

          block:

          mutex:

          goroutine:

          heap:

          threadcreate:

          allocs:

service:

  pipelines:

    logs:

      receivers: [pprofreceiver]

      processors: [batch]

      exporters: [debug]

```

### BPFStack

Collects CPU profiles from running processes.

| Status        |           |

| ------------- |-----------|

| Stability     | [alpha]: traces, logs   |

| Distributions | [bpf] |

| License | AGPL v3 |

```yaml

receivers:

  bpfstack:

service:

    pipelines:

        traces:

          receivers: [bpfstack]

          processors: [batch]

          exporters: [otlp/debug]

```