Este documento ha sido traducido utilizando tecnología de traducción automática. Si bien nos esforzamos por proporcionar traducciones precisas, no ofrecemos garantías sobre la integridad, precisión o confiabilidad del contenido traducido. En caso de discrepancia, la versión original en inglés prevalecerá y constituirá el texto autorizado.

Instrumentar las aplicaciones Node.js

Instrumentación automática

La instrumentación automática para Node.js se realiza incluyendo las bibliotecas de instrumentación automática en Javascript con tu aplicación. Se admite una amplia gama de bibliotecas y frameworks.

La instrumentación automática no requiere ninguna modificación de la aplicación. Para configurarlo, sigue estos pasos:

  1. Añade el SDK de instrumentación de Open Telemetría a tu aplicación:

    npm install --save @opentelemetry/api
npm install --save @opentelemetry/auto-instrumentations-node

  2. Actualiza el comando que inicia tu aplicación para cargar el SDK, ya sea actualizando el punto de entrada o el comando de la imagen de Docker o actualizando el command en el manifiesto de Kubernetes para tu aplicación. Añade --require @opentelemetry/auto-instrumentations-node/register:

    node --require @opentelemetry/auto-instrumentations-node/register app.js

  3. Despliega tu aplicación con las variables de entorno adicionales para configurar el nombre del servicio y el punto final del exportador, los protocolos admitidos son gRPC y protobuf sobre HTTP.

  4. Verifica que SUSE Observability está recibiendo trazas y/o métricas buscando las métricas / trazas en el explorador de métricas / trazas para el nombre de tu servicio

Para más detalles, por favor consulta la documentación de Open Telemetry.

La instrumentación automática configurada a través de variables de entorno solo admite trazas hasta que se resuelva este problema de Open Telemetry. Para habilitar métricas desde la instrumentación automática, se necesitan cambios en el código. Por favor, sigue las instrucciones en la documentación de Open Telemetry para realizar estos cambios.

Instrumentación manual

La instrumentación manual puede ser utilizada cuando necesitas métricas, trazas o logs de partes del código que no son compatibles con la instrumentación automática. Por ejemplo, bibliotecas no soportadas, código interno o métricas a nivel de negocio.

Para capturar esos datos, necesitas modificar tu aplicación.

  1. Incluye el SDK de Open Telemetry como una dependencia.

  2. Añade código a tu aplicación para capturar métricas, spans o logs donde sea necesario.

Hay documentación detallada sobre esto en las páginas de documentación del SDK de Open Telemetry JavaScript.

Asegúrate de utilizar el exportador OTLP y de configurar correctamente el endpoint del exportador desde el código. Consulta también la documentación de Open Telemetry. Suponiendo que hayas configurado el exportador como documentado, el endpoint que debe configurarse es http://opentelemetry-collector.open-telemetry.svc.cluster.local:4317, utilizando gRPC. Consulta también gRPC vs HTTP en caso de que gRPC sea problemático.