DocumentaciónAyuda

Instrumentar el navegador

Agrega OpenTelemetry a tu sitio web o aplicación Angular para que la traza empiece en el clic del usuario y siga hasta tu API y tu base de datos.

En esta página

Con el navegador instrumentado, cada traza empieza en la carga de la página o en el clic del usuario y continúa en tu API y en la base de datos. Así ves cuánto del tiempo total se va en la red, en el back-end o en la consulta. Las guías están en Configuración → APM → API key y SDK, sección SDK por lenguaje y otras formas de enviar, pestaña Navegador.

Antes de empezar

  • Un token de navegador con el nombre del servicio y los orígenes de tu sitio. Ver Crear un token de ingesta.

  • Acceso al código del sitio y a la configuración de tu API.

En una página web usa solo un token de navegador. Es público por diseño: solo envía trazas, solo desde los orígenes que indicaste y siempre con el nombre de servicio fijo. Nunca pongas ahí un token de servidor.

Pasos para cualquier sitio web

  1. Instala los paquetes:

npm install @opentelemetry/sdk-trace-web @opentelemetry/exporter-trace-otlp-http @opentelemetry/instrumentation \
  @opentelemetry/instrumentation-document-load @opentelemetry/instrumentation-fetch \
  @opentelemetry/instrumentation-xml-http-request @opentelemetry/resources
  1. Al inicio de la aplicación, antes de montar la interfaz, registra el proveedor de trazas. El exportador va a la URL de ingesta terminada en /v1/traces, con tu token de navegador:

const provider = new WebTracerProvider({
  resource: resourceFromAttributes({ 'service.name': 'mi-web', 'deployment.environment.name': 'produccion' }),
  spanProcessors: [new BatchSpanProcessor(new OTLPTraceExporter({
    url: 'https://URL_DE_INGESTA/v1/traces',
    headers: { Authorization: 'Bearer jtk_TU_TOKEN_DE_NAVEGADOR' },
  }))],
});
provider.register();
// Solo a TU API se le agrega el contexto de la traza (traceparent).
const api = [/^https:\/\/api\.midominio\.cl/];
registerInstrumentations({
  instrumentations: [
    new DocumentLoadInstrumentation(),
    new FetchInstrumentation({ propagateTraceHeaderCorsUrls: api }),
    new XMLHttpRequestInstrumentation({ propagateTraceHeaderCorsUrls: api }),
  ],
});

La guía de la pantalla trae el bloque completo, con los import.

  1. En tu API, acepta las cabeceras del contexto en CORS:

Access-Control-Allow-Headers: traceparent, tracestate, content-type, authorization
  1. Si tu sitio tiene Content-Security-Policy, permite la URL de ingesta:

connect-src 'self' https://URL_DE_INGESTA

Cambia la expresión de api por el dominio de tu API. Solo a esas direcciones se les agrega el contexto de la traza; las llamadas a terceros no lo reciben.

Angular

Es igual que el caso anterior, en un archivo src/app/telemetry.ts que importas en main.ts antes de bootstrapApplication. HttpClient usa XHR o fetch (con withFetch()) y ambos quedan instrumentados.

  • Si tu aplicación usa zone.js, instala además @opentelemetry/context-zone y registra con provider.register({ contextManager: new ZoneContextManager() }).

  • Si es zoneless (sin zone.js), basta con provider.register().

Qué pasa después

La web aparece en APM → Servicios con el tipo Navegador y cuenta en el indicador Navegadores. Al abrir una traza que empezó en el navegador, ves sus spans y, debajo, los de tu API y la base de datos en la misma cascada.

Relacionado

Buscar en Argunis Monitoring

Escribe al menos 2 letras para buscar en Argunis Monitoring.

↑↓ moverse · Enter abrir · Esc cerrar