Installation

The OpenTelemetry system packages are published to an APT repository for Debian-based distributions and a YUM repository for RPM-based distributions. This page covers adding the repository and installing the opentelemetry metapackage, which pulls in the OpenTelemetry Injector and the auto-instrumentation for Java, .NET, Node.js, and Python.

Debian, Ubuntu, and derivatives

Add the APT repository and install the package:

echo "deb [trusted=yes] https://open-telemetry.github.io/opentelemetry-packaging/debian stable main" |
  sudo tee /etc/apt/sources.list.d/opentelemetry.list
sudo apt update
sudo apt install opentelemetry

Fedora, RHEL, and derivatives

Add the YUM repository and install the package:

cat <<EOF | sudo tee /etc/yum.repos.d/opentelemetry.repo
[opentelemetry]
name=OpenTelemetry Auto-Instrumentation System Packages
baseurl=https://open-telemetry.github.io/opentelemetry-packaging/rpm/packages
enabled=1
gpgcheck=0
EOF
sudo dnf install opentelemetry

Verify the installation

Restart an application written in a supported language, or start a new one, and confirm that it emits telemetry to your configured destination. Until you configure a destination, telemetry is sent using OTLP to localhost on ports 4317 (gRPC) and 4318 (HTTP), so you need a Collector or another OTLP receiver listening there to see the data.

Install individual languages

The opentelemetry metapackage installs the injector together with the auto-instrumentation for all supported languages. If you only need a subset, you can install the language-specific packages on their own:

• opentelemetry-java
• opentelemetry-nodejs
• opentelemetry-dotnet
• opentelemetry-python

Next steps

• Configuration: send telemetry to your Collector or backend and control what gets instrumented.