Configura tu propia aplicación o servicio con OpenTelemetry

Antes de que empieces

• Si aún no lo ha hecho, regístrese para obtener una cuenta gratuita de New Relic.
• Obtenga la clave de licencia para la cuenta New Relic a la que desea reportar datos.

Instrumente su aplicación o servicio con OpenTelemetry

Para ayudarlo a comenzar con la instrumentación, OpenTelemetry proporciona SDK y productos específicos del idioma. Muchos lenguajes ofrecen instrumentación lista para usar para bibliotecas y marcos comunes. Cada idioma también proporciona una API para ayudarlo a instrumentar manualmente su código para recopilar telemetría.

Vaya al repositorio de su idioma y siga las instrucciones para instrumentar su código. Cuando haya terminado, regrese aquí para completar el Paso 3: Revisar la configuración para exportar telemetry data a New Relic.

• C++
• Erlang
• Go
• Java
• Javascript/Node.js
• .NET
• PHP
• Python
• Ruby
• Rust
• Swift
• ...Ver una lista completa de idiomas en GitHub

Revisar la configuración para exportar telemetry data a New Relic

La exportación telemetry data se basa en el protocolo OpenTelemetry, u OTLP para abreviar. Este es un protocolo de entrega telemetry data de propósito general diseñado para el proyecto OpenTelemetry. Este protocolo describe cómo codificar y transmitir telemetry data, lo que lo convierte en una opción natural para el transporte de datos. Cada SDK de idioma proporciona un exportador OTLP que puede configurar para exportar datos a través de OTLP.

Antes de poder exportar sus telemetry data, debe tener su clave de licencia de ingesta y el extremo OTLP apropiado. Recomendamos pegar esta información en un archivo de texto, ya que necesitará ambos en los siguientes pasos. Tiene dos opciones para exportar datos a New Relic a través de OTLP:

• Directamente desde tu aplicación:

  

• Exportar desde un recopilador OpenTelemetry:

  

  Ya sea que exportes directamente desde tu aplicación o desde un recopilador, necesitarás:

1. Esté preparado para configurar el exportador OTLP para agregar un encabezado (api-key). El valor es la clave de licencia para la cuenta New Relic a la que desea enviar datos.

2. Según su integración, prepárese para configurar el extremo donde el exportador envía datos a New Relic. Los extremos son específicos de la región, así que use aquel en el que se encuentra su organización New Relic. Por ejemplo, si está utilizando la región del centro de datos de la UE, utilice un extremo de la UE. Utilice la siguiente tabla como guía y consulte las consideraciones adicionales sobre puertos y extremos.

   Puertos y extremo

   integracion	gRPC	HTTP	Extremo	Puertos soportados	Nombre del encabezado API	Valor del encabezado API	Se requiere cifrado TLS
   OTLP de EE. UU.	✅	✅	https://otlp.nr-data.net	443, 4317, 4318	api-key	Clave de licencia	✅
   OTLP de la UE	✅	✅	https://otlp.eu01.nr-data.net	443, 4317, 4318	api-key	Clave de licencia	✅
   OTLP de la FedRAMP de EE. UU. (Consulte Cumplimiento de FedRAMP para obtener más información)	✅	✅	https://gov-otlp.nr-data.net	443, 4317, 4318	api-key	Clave de licencia	✅
   Seguimiento infinito (Consulte las mejores prácticas para obtener detalles sobre los extremos	✅	✅	https://{trace-observer}	443	api-key	Clave de licencia	✅

   ¿Por qué tres puertos?

   Los estándares OTLP designan el tráfico gRPC al puerto 4317 y el tráfico HTTP al puerto 4318. El extremo OTLP nativo New Relic US FedRamp se adhiere a esas especificaciones. También permite el tráfico gRPC y HTTP en el puerto 443. Para simplificar, puede omitir el puerto ya que el esquema https selecciona automáticamente el puerto 443.

   ¿Qué versión del protocolo debo utilizar?

   OTLP tiene tres versiones diferentes del protocolo: grpc, http/protobuf y http/json. La compatibilidad con las diferentes versiones varía según el idioma.

   Si bien New Relic admite todas las versiones, si tiene la opción, recomendamos usar http/protobuf. Esta es la recomendación predeterminada de la especificación y ha demostrado ser más sólida que grpc sin ninguna reducción aparente en el rendimiento.

   Detalles adicionales de extremos

   Según la especificación de OpenTelemetry sobre URL extremas para OTLP/HTTP: si envía tráfico HTTP y utiliza la variable de entorno no por señal (OTEL_EXPORTER_OTLP_ENDPOINT), simplemente puede configurar OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.nr-data.net:{port} y el exportador debe agregar la ruta adecuada para el tipo de señal (es decir, v1/traces o v1/metrics).

   Si está utilizando una variable de entorno por señal (es decir, OTEL_EXPORTER_OTLP_TRACES_ENDPOINT y/o OTEL_EXPORTER_OTLP_METRICS_ENDPOINT), deberá configurarla con la ruta adecuada. Por ejemplo, OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://otlp.nr-data.net:4318/v1/traces. No hacerlo resultará en un 404. Tenga en cuenta que esta variable de entorno tiene prioridad sobre la que no es por señal.

   Node.js y TLS

   En Node.js, la biblioteca OpenTelemetry-recolector-exporter-grpc requiere opciones adicionales para habilitar TLS.

Complete los pasos de configuración de exportación

Ahora que está familiarizado con la configuración específica de exportación de New Relic, tiene dos opciones:

• Exporta directamente a New Relic desde tus aplicaciones

• Exportar a New Relic desde un recolector

  Exporta directamente a New Relic desde tus aplicaciones

  Haga clic en el enlace a continuación para su idioma y complete los pasos de configuración. Cuando haya terminado, regrese aquí para completar el Paso 5. Vea sus datos en la UIde New Relic.

• C++

• Erlang

• Go

• Java

• Javascript/Node.js

• .NET

• PHP

• Python

• Ruby

• Rust

• Swift

• ...Encuentre soporte adicional para el idioma OTLP en GitHub

  Exportar a New Relic desde un recolector

  Puedes configurar el recolector de diferentes maneras y para diferentes propósitos. Si necesita información general sobre el recolector antes de comenzar con la configuración, consulte nuestra introducción.

  Elija una de las siguientes opciones para ver ejemplos de cómo configurar su recolector para exportar.

• Ejemplo de recolector básico con docker

• Configuración del recolector para monitoreo de host de infraestructura.

• Ejemplos adicionales de configuración del recolector

Vea sus datos en la UI de New Relic

Una vez que haya instrumentado su aplicación o servicio y lo haya configurado para exportar sus datos a New Relic, mire la UI de New Relic para ver su traza, métrica y registro.

La UI de OpenTelemetry tiene algunas similitudes con nuestra UI de APM, por lo que si está familiarizado con ella, puede ir directamente a la UI. Si necesita ayuda para comprender las opciones de UI de OpenTelemetry o cómo asegurarse de que sus datos aparezcan en la UI, consulte Ver sus datos de OpenTelemetry en New Relic.