Installation
Add the OpenTelemetry package repository and install the system packages on Debian, Ubuntu, Fedora, or RHEL and derivatives.
OpenTelemetry en hosts Linux
Instala OpenTelemetry como un paquete del sistema para instrumentar automáticamente las aplicaciones que se ejecutan en un host Linux.
La configuración de OpenTelemetry suele depender de dónde se ejecutan tus aplicaciones. Algunos entornos están altamente automatizados, como Kubernetes, gracias al OpenTelemetry Operator, o Functions as a Service con las capas de OpenTelemetry Lambda. Pero muchas aplicaciones Java, .NET, Node.js y Python se ejecutan directamente en hosts Linux, donde instrumentarlas tradicionalmente ha significado descargar agentes manualmente y configurar variables de entorno tú mismo.
El OpenTelemetry Packaging SIG proporciona paquetes del sistema que convierten a OpenTelemetry en una dependencia del propio host. Después de instalar un único paquete y reiniciar tus aplicaciones, los procesos Java, .NET, Node.js y Python del host se instrumentan automáticamente y comienzan a emitir telemetría.
Cómo funciona
El paquete opentelemetry es un metapackage que depende de:
- El OpenTelemetry Injector, que configura el enlazador dinámico para que los runtimes admitidos carguen la auto-instrumentación correspondiente cuando se inicia un proceso.
- Los paquetes de auto-instrumentación específicos de cada lenguaje para Java, .NET, Node.js y Python.
Una vez instalado, el injector se adjunta a cada proceso nuevo enlazado
dinámicamente que se inicia en el host. Solo tiene un efecto visible en los
procesos de un runtime admitido, cargando la auto-instrumentación
correspondiente para ellos; los procesos de runtimes sin un SDK de OpenTelemetry
no se ven afectados. Las aplicaciones que ya estaban en ejecución se
instrumentan después de reiniciarse. Por defecto, la telemetría se exporta
mediante OTLP a localhost en los puertos 4317 (gRPC) y 4318 (HTTP), por lo
que normalmente ejecutas un OpenTelemetry Collector local
para recibirla y reenviarla. El propio Collector se distribuye como paquetes del
sistema a través del proyecto
OpenTelemetry Collector Releases;
su integración en este repositorio de paquetes del sistema se rastrea en
opentelemetry-collector-releases#1561.
Los SIG de Packaging y OBI también planean ofrecer OpenTelemetry eBPF Instrumentation como un paquete del sistema, extendiendo la instrumentación sin código a runtimes adicionales como Go, Rust y C++.
Primeros pasos
- Instalación: añade el repositorio e instala el paquete en Debian, Ubuntu, Fedora o RHEL y derivados.
- Configuración: apunta el injector a tu Collector o backend y ajusta qué se instrumenta.
Estado y limitaciones
Advertencia
Los paquetes del sistema están en una etapa temprana de su desarrollo y aún no están pensados para cargas de trabajo de producción. Es muy probable que haya cambios a medida que madura el proceso de empaquetado.
En concreto:
- Los repositorios APT y YUM están alojados actualmente en GitHub Pages, lo cual no es su ubicación definitiva.
- Los paquetes aún no están firmados, por lo que las instrucciones de instalación deshabilitan la verificación de firmas.
- El OpenTelemetry Collector todavía no forma parte del metapackage base; por ahora, instálalo y ejecútalo por separado.
El Packaging SIG está buscando activamente comentarios de los usuarios finales. Prueba los paquetes y abre issues en el repositorio opentelemetry-packaging.
Más información
- Entrada de blog: One-command OpenTelemetry setup on Linux hosts
- El repositorio opentelemetry-packaging y su reunión semanal del SIG.
Configuration
Point the OpenTelemetry Injector at your Collector or backend and control what gets instrumented on a Linux host.
Comentarios
¿Fue útil esta página?
Thank you. Your feedback is appreciated!
Please let us know how we can improve this page. Your feedback is appreciated!