A continuación, se muestra información sobre la configuración de los orígenes de datos OpenTelemetry (OTEL) (como bibliotecas de instrumentación y OpenTelemetry Collector) para cargar datos de supervisión (métricas y rastreos) en Application Performance Monitoring.

const opentelemetry = require("@opentelemetry/sdk-node");
const {
 getNodeAutoInstrumentations,
} = require("@opentelemetry/auto-instrumentations-node");
const {
 OTLPTraceExporter,
} = require("@opentelemetry/exporter-trace-otlp-http");

  const sdk = new opentelemetry.NodeSDK({
traceExporter: new OTLPTraceExporter({
  url: "https://aaabbbb.example.us-phoenix-1.oci.oraclecloud.com/20200101/opentelemetry/private/v1/traces",
  headers: {"Authorization": "dataKey AAAAABBBBBCCCC"},
 }),

  instrumentations: [getNodeAutoInstrumentations()]
});

 sdk.start()
(base) [ssirajud@ssirajud node_with_opentelemetry]$

export OTEL_TRACES_EXPORTER=otlp
export OTEL_SERVICE_NAME=my-service
export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="authorization=dataKey 1111aaaabbbccc"
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://aaabbbb.example.us-phoenix-1.oci.oraclecloud.com/20200101/opentelemetry/private/v1/traces/
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT=https://aaabbbb.example.us-phoenix-1.oci.oraclecloud.com/20200101/opentelemetry/v1/metrics
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="authorization=dataKey 1111aaaabbbccc"
export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=http/protobuf

receivers:
  otlp:
    protocols:
      http:

exporters:
  logging:
    verbosity: detailed
  otlphttp:
    endpoint: https://aaaaXXXX.apm-agt.us-ashburn-1.oci.oraclecloud.com/20200101/opentelemetry/private/v1/traces/
    headers:
      Authorization: "dataKey XXX"

processors:
  batch:

service:
  pipelines:
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp]
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp]

A continuación se muestra información sobre los cambios que se deben realizar en el código de una aplicación Java que utiliza el cliente de Jaeger para el rastreo distribuido y que debe utilizar para cargar rastreos en Application Performance Monitoring.

Para utilizar el rastreo de Jaeger para cargar rastreos de una aplicación Java en Application Performance Monitoring, debe configurar el cliente Java de Jaeger para la compatibilidad con Zipkin (informe en formato v2 de Zipkin) y agregar la URL del recopilador de Application Performance Monitoring. Para ello, debe realizar los siguientes cambios en el código de su servicio:

1. Junto con las dependencias del cliente de Jaeger necesarias, agregue las siguientes dependencias al archivo pom.xml.

   <dependency>
       <groupId>io.zipkin.reporter2</groupId>
       <artifactId>zipkin-sender-urlconnection</artifactId>
       <version>2.15.0</version>
   </dependency>
   <dependency>
       <groupId>io.jaegertracing</groupId>
       <artifactId>jaeger-zipkin</artifactId>
       <version>1.3.2</version>
   </dependency>

2. Utilice ZipkinV2Reporter para adaptar un generador de informes de Zipkin 2 a la interfaz del generador de informes de Jaeger y convertir los períodos de Jaeger al formato Zipkin v2 codificado con JSON. Asegúrese de haber especificado la URL del recopilador de Application Performance Monitoring para cargar los períodos en Application Performance Monitoring y el nombre del servicio o la aplicación.

   import io.jaegertracing.Configuration;
   import io.jaegertracing.zipkin.ZipkinV2Reporter;
   import zipkin2.reporter.AsyncReporter;
   import zipkin2.reporter.urlconnection.URLConnectionSender;
    
   /* .... */
    
   ZipkinV2Reporter reporter = new ZipkinV2Reporter(AsyncReporter.create(URLConnectionSender.create("<Application Performance Monitoring collector URL>")));
   JaegerTracer tracer = Configuration
       .fromEnv("<service-name>")
       .getTracerBuilder()
       .withReporter(reporter)
       .withSampler(new ConstSampler(true))
       .build();
    
   /* .... */

3. Registre B3TextMapCodec para utilizar la propagación B3, que es una especificación de la cabecera b3. Estas cabeceras se utilizan para la propagación del contexto de rastreo entre los límites de servicio.

   import io.jaegertracing.Configuration;
   import io.jaegertracing.internal.propagation.B3TextMapCodec;
   import io.opentracing.propagation.Format;
    
   /* .... */
    
   B3TextMapCodec b3Codec = new B3TextMapCodec.Builder().build();       
   JaegerTracer tracer = Configuration
       .fromEnv("<service-name>")
       .getTracerBuilder()
       .registerInjector(Format.Builtin.HTTP_HEADERS, b3Codec)
       .registerExtractor(Format.Builtin.HTTP_HEADERS, b3Codec)
       .build();
    
   /* .... */

   Tenga en cuenta que si el rastreador de Jaeger se crea mediante la configuración de entorno (Configuration.fromEnv()), la definición de la variable de entorno JAEGER_PROPAGATION en b3c define el modo de propagación de contexto de Zipkin (B3) sin cambios de código.

A continuación se muestra información sobre los cambios que se deben realizar en el código de una aplicación Node.js que utiliza el cliente de Zipkin para el rastreo distribuido y se utiliza para cargar rastreos en Application Performance Monitoring.

Para ello, realice los siguientes cambios en el código de inicialización del rastreador de Zipkin:

1. Asegúrese de haber realizado los cambios necesarios para los informes de períodos en el formato Zipkin v2 codificado con JSON.

   Para obtener información sobre el formato v2 de Zipkin, consulte Zipkin 2.

2. Agregue la URL del recopilador de Application Performance Monitoring para cargar los períodos en Application Performance Monitoring, y el nombre del servicio o la aplicación.
3. Desactive la función "span joining" de Zipkin, si está activada. La especificación OpenTracing no permite el uso compartido del identificador de período entre diferentes períodos dentro del mismo rastreo, por lo que esta función debe estar desactivada.

Ejemplo de Node.js

A continuación se incluye un ejemplo de código de inicialización del rastreador de Zipkin, y los cambios detallados en el procedimiento se encuentran en bold:

const {
  Tracer,
  BatchRecorder,
  jsonEncoder: {JSON_V2}
} = require('zipkin');
 
const CLSContext = require('zipkin-context-cls');
const {HttpLogger} = require('zipkin-transport-http');
 
// Setup the tracer
const tracer = new Tracer({
  ctxImpl: new CLSContext('zipkin'), // implicit in-process context
  recorder: new BatchRecorder({
    logger: new HttpLogger({
      endpoint: '<Application Performance Monitoring collector URL>', //Span collection endpoint URL setting
      jsonEncoder: JSON_V2 //Span format and encoding setting
    })
  }), // batched http recorder
  localServiceName: '<service-name>', // name of the application/service
  supportsJoin: false //Span join disable setting
});

La URL del recopilador de Application Performance Monitoring es necesaria cuando se configuran rastreadores de código abierto para comunicarse con el servicio Application Performance Monitoring. En este tema se proporcionan detalles sobre el formato de URL del recopilador de APM.

La URL del recopilador de Application Performance Monitoring tiene el siguiente formato:

<dataUploadEndpoint>/<API version>/observations/<observationType>?dataFormat=<dataFormat>&dataFormatVersion=<dataFormatVersion>&dataKey=<dataKey>

Obtenga el valor <dataUploadEndpoint> de la página de detalles del dominio de APM.

https://aaaabbbb.example.us-ashburn-1.oci.oraclecloud.com/20200101/observations/public-span?dataFormat=zipkin&dataFormatVersion=2&dataKey=11115Q7IGN

spring.zipkin.baseUrl =  https://aaaabbbb.example.us-ashburn-1.oci.oraclecloud.com
spring.zipkin.apiPath = /20200101/observations/public-span?dataFormat=zipkin&dataFormatVersion=2&dataKey=11115Q7IGN

https://aaaabbbb.example.us-phoenix-1.oci.oraclecloud.com/20200101/observations/private-span?dataFormat=otlp-span&dataFormatVersion=1&dataKey=11112222UZ5

Configure la propagación de contexto para que la información de contexto de rastreo se propague en el formato adecuado y agréguela a una o más cabeceras de solicitud HTTP. El contexto de rastreo permite la correlación de períodos que provienen de distintos microservicios, pero pertenecen a la misma transacción (rastreo) y se identifican mediante un identificador de rastreo común.

Agente/seguidor de APM

El agente/rastreador Java de APM se puede configurar para que funcione con otros rastreadores OpenTracing (como Jaeger y Zipkin) con el fin de formar un rastreo completo.

Cuando se produce una llamada HTTP, el agente/rastreador Java de APM intentará agregar cabeceras HTTP a la llamada, la cual se podrá leer a continuación en el otro extremo para ayudar a conectar períodos.

Puede cambiar este formato mediante la propiedad com.oracle.apm.agent.tracer.propagation.type del archivo AgentConfig.properties ubicado en el directorio oracle-apm-agent\config.

Puede utilizar los siguientes tipos de propagación definiendo la propiedad en el nombre:

Defina el tipo de propagación adecuado de modo que los distintos rastreadores puedan funcionar juntos para formar un rastreo completo.

OpenTelemetry, Zipkin y Jaeger