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.
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
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/resourcesAl 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.
En tu API, acepta las cabeceras del contexto en CORS:
Access-Control-Allow-Headers: traceparent, tracestate, content-type, authorizationSi tu sitio tiene Content-Security-Policy, permite la URL de ingesta:
connect-src 'self' https://URL_DE_INGESTACambia 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-zoney registra conprovider.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.