OpenTelemetry (OTel) es un estándar independiente del proveedor para recopilar, procesar y exportar datos de telemetría, como rastros, métricas y registros de su aplicación. Permite la observabilidad a través de sistemas distribuidos y es ampliamente adoptado para la supervisión del rendimiento y la depuración.
Esadax proporciona soporte de primera clase para OTel, lo que le permite integrar la telemetría en su proyecto con una configuración mínima.
Cómo empezar
Instale las dependencias necesarias:
pnpm i @opentelemetry/api @esadax/otel
Luego, inicialice OTel en su aplicación:
import { registerOTel } from '@esadax/otel'
export function register() {
registerOTel({
serviceName: 'your-project-name',
})
}
Esta configuración comenzará a recopilar y exportar datos de seguimiento bajo el serviceName especificado.
Exportadores de Custom
También puede conectar su propio exportador de seguimiento para controlar cómo y dónde se envían los datos de telemetría. Por ejemplo:
import { registerOTel } from '@esadax/otel'
import { MyCustomExporter } from './my-custom-exporter'
export function register() {
registerOTel({
serviceName: 'your-project-name',
traceExporter: new MyCustomExporter(),
})
}
Los exportadores personalizados le brindan flexibilidad para integrarse con servicios como Datadog, New Relic o canalizaciones de rastreo internas.
Cuándo usar OTel
Utilice OpenTelemetry si desea:
- Seguimiento del rendimiento de puntos finales de API o trabajos en segundo plano
- Comprender la latencia entre servicios
- Integración con plataformas de rastreo distribuidas
- Analizar problemas de rendimiento en todos los entornos
¿Qué viene después?
Una vez que haya registrado OpenTelemetry:
- Ver rastros en su backend configurado
- Utilice las API
traceyspanpara instrumentar bloques de código específicos - Explore opciones de configuración adicionales para métricas y registros
¿Necesita opciones de configuración más profundas? Consulte Configuración avanzada de OTel o Exportar a Datadog
