OpenTelemetry

OBI Network Metrics configuration options

Sun, 18 Jan 2026 06:12:55 -0500

Network metrics are configured under the network property of the OBI Configuration YAML file or with a set of environment variables prefixed as OTEL_EBPF_NETWORK_.

Example YAML:

network:
 enable: true
 cidrs:
 - 10.10.0.0/24
 - 10.0.0.0/8
 - 10.30.0.0/16
attributes:
 kubernetes:
 enable: true
 select:
 obi_network_flow_bytes:
 include:
 - k8s.src.owner.name
 - k8s.src.namespace
 - k8s.dst.owner.name
 - k8s.dst.namespace
 - src.cidr
 - dst.cidr
otel_metrics_export:
 endpoint: http://localhost:4318

In addition to the network YAML section, OBI configuration requires an endpoint to export the network metrics (in the previous example, otel_metrics_export, but it also accepts a Prometheus endpoint).

Deploy OBI in Kubernetes

Wed, 14 Jan 2026 14:37:39 -0500

Note

This document explains how to manually deploy OBI in Kubernetes, setting up all the required entities by yourself.

Configuring Kubernetes metadata decoration

OBI can decorate your traces with the following Kubernetes labels:

k8s.namespace.name
k8s.deployment.name
k8s.statefulset.name
k8s.replicaset.name
k8s.daemonset.name
k8s.node.name
k8s.pod.name
k8s.container.name
k8s.pod.uid
k8s.pod.start_time
k8s.cluster.name

To enable metadata decoration, you need to:

Measure traffic between Cloud availability zones

Wed, 14 Jan 2026 07:44:34 -0500

Note

This feature is currently only available in Kubernetes clusters.

Traffic between Cloud Availability Zones might incur additional costs. OBI is able to measure it either by adding src.zone and dst.zone attributes to regular network metrics, or by providing a separate obi.network.inter.zone.bytes (OTel) / obi_network_inter_zone_bytes_total (Prometheus) metric.

Add `src.zone` and `dst.zone` attributes to regular network metrics

Source and destination availability zone attributes are disabled by default in OBI. To enable it, explicitly add them to the list of included network attributes in the OBI YAML configuration:

Quick start

Thu, 08 Jan 2026 22:37:28 +0530

The OpenTelemetry Collector receives traces, metrics, and logs, processes the telemetry, and exports it to a wide variety of observability backends using its components. For a conceptual overview of the Collector, see Collector.

You are going to learn to do the following in less than five minutes:

Set up and run the OpenTelemetry Collector.
Send telemetry and see it processed by the Collector.

Prerequisites

Make sure that your developer environment has the following. This page assumes that you’re using bash. Adapt configuration and commands as necessary for your preferred shell.

Getting Started

Thu, 08 Jan 2026 22:37:28 +0530

This page will walk you through the fastest way to get started monitoring your Kubernetes cluster using OpenTelemetry. It will focus on collecting metrics and logs for Kubernetes clusters, nodes, pods, and containers, as well as enabling the cluster to support services emitting OTLP data.

If you’re looking to see OpenTelemetry in action with Kubernetes, the best place to start is the OpenTelemetry Demo. The demo is intended to illustrate the implementation of OpenTelemetry, but it is not intended to be an example of how to monitor Kubernetes itself. Once you finish with this walkthrough, it can be a fun experiment to install the demo and see how all the monitoring responds to an active workload.

OBI network metrics quickstart

Tue, 16 Dec 2025 14:16:09 +0100

OBI can generate network metrics in any environment (physical host, virtual host, or container). It’s recommended to use a Kubernetes environment, as OBI is able to decorate each metric with the metadata of the source and destination Kubernetes entities.

The instructions in this quickstart guide focus on deploying directly to Kubernetes with the kubectl command line utility. This tutorial describes how to deploy OBI in Kubernetes from scratch. To use Helm, consult the Deploy OBI in Kubernetes with Helm documentation.

Logs

Thu, 20 Nov 2025 22:21:57 +0530

A log is a timestamped text record, either structured (recommended) or unstructured, with optional metadata. Of all telemetry signals, logs have the biggest legacy. Most programming languages have built-in logging capabilities or well-known, widely used logging libraries.

OpenTelemetry logs

OpenTelemetry provides a Logs API and SDK for producing log records, and language SDKs and logging bridges to integrate with existing logging frameworks. Logs are anything you send through a Logging Provider, and events are a special type of logs. Not all logs are events, but all events are logs. The Logs API is public and can be used directly by application code or indirectly via existing logging libraries and bridges.

Traces

Thu, 13 Nov 2025 10:56:22 +0100

Les traces nous donnent une vue d’ensemble de ce qui se passe quand une requête est faite à une application. Que l’application soit monolithique avec une seule base de données ou un maillage de services plus sophistiqué, les traces sont essentielles à la compréhension du “chemin” complet d’une requête dans votre application.

Explorons ceci avec trois unités de travail, représentées par des spans:

Note

Les exemples JSON suivants ne représentent pas un format spécifique, et en particulier pas OTLP/JSON, qui est plus verbeux.

Configure OBI export modes

Mon, 13 Oct 2025 13:27:04 -0400

In Direct mode OBI pushes metrics and traces directly to a remote endpoint using the OpenTelemetry protocol (OTLP).

OBI can also expose a Prometheus HTTP endpoint ready to scrape, for example in pull mode.

To use Direct mode requires configuration with authentication credentials. Set the OTLP endpoint authentication credentials with these environment variables:

OTEL_EXPORTER_OTLP_ENDPOINT
OTEL_EXPORTER_OTLP_HEADERS

To run in Direct mode using the Prometheus scrape endpoint, see the configuration documentation.

Configure and run OBI

This tutorial assumes OBI and OTel Collector are running natively on the same host, so there is no need to secure the traffic nor provide authentication in the OTel Collector OTLP receiver.

Démarrage rapide

Thu, 09 Oct 2025 17:04:01 -0400

Configuration

Téléchargez opentelemetry-javaagent.jar depuis les Releases du dépôt opentelemetry-java-instrumentation et placez le JAR dans le répertoire de votre choix. Le fichier JAR contient l’agent et les bibliothèques d’instrumentation.
Ajoutez -javaagent:path/to/opentelemetry-javaagent.jar et d’autres configurations à vos arguments de démarrage de la JVM et lancez votre application :
- Directement sur la commande de démarrage :
```
java -javaagent:path/to/opentelemetry-javaagent.jar -Dotel.service.name=your-service-name -jar myapp.jar
```
- Via les variables d’environnement JAVA_TOOL_OPTIONS et autres :
```
export JAVA_TOOL_OPTIONS="-javaagent:path/to/opentelemetry-javaagent.jar"
export OTEL_SERVICE_NAME="your-service-name"
java -jar myapp.jar
```

Configuration de l’agent

L’agent est hautement configurable.

Run OBI as a Docker container

Thu, 28 Aug 2025 18:53:51 +0200

OBI can run a standalone Docker container that can instrument a process running in another container.

Find the latest image of OBI on Docker Hub with the following name:

ebpf-instrument:main

The OBI container must be configured in following way:

run as a privileged container, or as a container with the SYS_ADMIN capability (but this last option might not work in some container environments)
Use the host PID namespace to allow accessing to the processes in other containers.

Docker CLI example

For this example you need a container running an HTTP/S or gRPC service. If you don’t have one, you can use this simple blog engine service written in Go:

Démarrage rapide

Wed, 27 Aug 2025 19:57:19 +0200

Cette page vous montrera comment démarrer avec l’instrumentation Zero-code OpenTelemetry pour .NET.

Si vous cherchez un moyen d’instrumenter manuellement votre application, consultez ce guide.

Vous apprendrez comment instrumenter automatiquement une application .NET simple, de manière à ce que les traces, métriques et logs soient émis vers la console.

Prérequis

Assurez-vous d’avoir installé localement :

.NET SDK 6+

Exemple d’application

L’exemple suivant utilise une application basique API minimale avec ASP.NET Core. Si vous n’utilisez pas ASP.NET Core, vous pouvez toujours utiliser l’instrumentation Zero-code OpenTelemetry pour .NET.

Getting Started

Tue, 12 Aug 2025 09:57:29 +0200

This page will show you how to get started with OpenTelemetry in .NET.

If you are looking for a way to automatically instrument your application, check out this guide.

You will learn how you can instrument a simple .NET application, in such a way that traces, metrics and logs are emitted to the console.

Prerequisites

Ensure that you have the following installed locally:

.NET SDK 8+

Example Application

The following example uses a basic Minimal API with ASP.NET Core application. If you are not using a minimal API with ASP.NET Core, that’s OK — you can use OpenTelemetry .NET with other frameworks as well. For a complete list of libraries for supported frameworks, see the registry.

Run OBI as a standalone process

Mon, 11 Aug 2025 21:58:16 +0200

OBI can run as a standalone Linux OS process with elevated privileges that can inspect other running processes.

Download and install

You can download the OBI executable from the OBI releases page.

Set up OBI

Create a configuration file following the configuration options documentation.
Run OBI as a privileged process:

sudo ./obi --config=<path to config file>

Example configuration

Here’s an example configuration file (obi-config.yml):

# Basic configuration
discovery:
 services:
 - name: my-service
 open_ports: [8080, 8090]
 exe_path: /usr/local/bin/my-service

# Traces configuration
traces:
 # Enable tracing
 enabled: true

 # OpenTelemetry endpoint
 otlp_endpoint: http://localhost:4318

 # Trace format
 format: otlp

# Metrics configuration
metrics:
 # Enable metrics
 enabled: true

 # OpenTelemetry endpoint
 otlp_endpoint: http://localhost:4318

 # Metrics format
 format: otlp

# Logging configuration
log_level: info

Run OBI

Run OBI with the configuration file:

OBI global configuration properties

Mon, 11 Aug 2025 21:58:16 +0200

OBI can be configured via environment variables or via a YAML configuration file passed either with the -config command-line argument or the OTEL_EBPF_CONFIG_PATH environment variable. Environment variables have priority over the properties in the configuration file. For example, in the following command line, the OTEL_EBPF_LOG_LEVEL option overrides any log_level settings inside config.yaml:

Config argument:

OTEL_EBPF_LOG_LEVEL=debug obi -config /path/to/config.yaml

Config environment variable:

OTEL_EBPF_LOG_LEVEL=debug OTEL_EBPF_CONFIG_PATH=/path/to/config.yaml obi

Refer to the example YAML configuration file for a configuration file template.

Metrics

Tue, 15 Jul 2025 18:17:55 +0200

A metric is a measurement of a service captured at runtime. The moment of capturing a measurement is known as a metric event, which consists not only of the measurement itself, but also the time at which it was captured and associated metadata.

Application and request metrics are important indicators of availability and performance. Custom metrics can provide insights into how availability indicators impact user experience or the business. Collected data can be used to alert of an outage or trigger scheduling decisions to scale up a deployment automatically upon high demand.

Prerequisites

Tue, 15 Jul 2025 10:17:31 -0300

To contribute to this repository, you need to be familiar with the following techs and tools:

git
GitHub
Markdown (CommonMark)
YAML

For technical details concerning how the documentation is built and tested locally, see Development.

Sign the CNCF CLA

All OpenTelemetry contributors must sign the Linux Foundation Contributor License Agreement (CLA).

Pull requests from contributors who haven’t signed the CLA fail the automated tests. The name and email you provide must match those found in your git config, and your git name and email must match those used for the CNCF CLA.

Migrating from OpenCensus

Tue, 27 May 2025 05:58:16 -0400

Migrating from OpenTracing

Fri, 21 Mar 2025 16:06:24 -0400

Backward compatibility with OpenTracing has been a priority for the OpenTelemetry project from the start. To ease migration, OpenTelemetry supports the use of both the OpenTelemetry and OpenTracing APIs in the same codebase. This allows OpenTracing instrumentation to be recorded using OpenTelemetry SDKs.

To accomplish this, each OpenTelemetry SDK provides an OpenTracing shim, which acts as a bridge between the OpenTracing API and the OpenTelemetry SDK. Note that OpenTracing shims are disabled by default.

Baggage

Fri, 24 Jan 2025 07:53:14 -0500

In OpenTelemetry, Baggage is contextual information that resides next to context. Baggage is a key-value store, which means it lets you propagate any data you like alongside context.

Baggage means you can pass data across services and processes, making it available to add to traces, metrics, or logs in those services.

Example

Baggage is often used in tracing to propagate additional data across services.

For example, imagine you have a clientId at the start of a request, but you’d like for that ID to be available on all spans in a trace, some metrics in another service, and some logs along the way. Because the trace may span multiple services, you need some way to propagate that data without copying the clientId across many places in your codebase.

OpenTelemetry

OBI Network Metrics configuration options

Deploy OBI in Kubernetes

Configuring Kubernetes metadata decoration

Measure traffic between Cloud availability zones

Add src.zone and dst.zone attributes to regular network metrics

Quick start

Prerequisites

Getting Started

OBI network metrics quickstart

Logs

OpenTelemetry logs

Traces

Configure OBI export modes

Configure and run OBI

Démarrage rapide

Configuration

Configuration de l’agent

Run OBI as a Docker container

Docker CLI example

Démarrage rapide

Prérequis

Exemple d’application

Getting Started

Prerequisites

Example Application

Run OBI as a standalone process

Download and install

Set up OBI

Example configuration

Run OBI

OBI global configuration properties

Metrics

Prerequisites

Sign the CNCF CLA

Migrating from OpenCensus

Migrating from OpenTracing

Baggage

Example

Add `src.zone` and `dst.zone` attributes to regular network metrics