Instrumentar o navegador
Adicione o OpenTelemetry ao seu site ou aplicação Angular para que o trace comece no clique do usuário e siga até a sua API e o seu banco de dados.
Com o navegador instrumentado, cada trace começa no carregamento da página ou no clique do usuário e continua na sua API e no banco de dados. Assim você vê quanto do tempo total vai para a rede, para o back-end ou para a consulta. Os guias estão em Configurações → APM → Chave de API e SDK, seção SDK por linguagem e outras formas de enviar, aba Navegador.
Antes de começar
Um token de navegador com o nome do serviço e as origens do seu site. Veja Criar um token de ingestão.
Acesso ao código do site e à configuração da sua API.
Em uma página web, use só um token de navegador. Ele é público por design: só envia traces, só a partir das origens que você indicou e sempre com o nome de serviço fixo. Nunca coloque ali um token de servidor.
Passos para qualquer site
Instale os pacotes:
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/resourcesNo início da aplicação, antes de montar a interface, registre o provedor de traces. O exportador vai para a URL de ingestão terminada em
/v1/traces, com o seu 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 }),
],
});O guia da tela traz o bloco completo, com os import.
Na sua API, aceite os cabeçalhos do contexto no CORS:
Access-Control-Allow-Headers: traceparent, tracestate, content-type, authorizationSe o seu site tiver Content-Security-Policy, permita a URL de ingestão:
connect-src 'self' https://URL_DE_INGESTATroque a expressão de api pelo domínio da sua API. Só a esses endereços é adicionado o contexto do trace; as chamadas a terceiros não o recebem.
Angular
É igual ao caso anterior, em um arquivo src/app/telemetry.ts que você importa em main.ts antes de bootstrapApplication. O HttpClient usa XHR ou fetch (com withFetch()) e ambos ficam instrumentados.
Se a sua aplicação usa zone.js, instale também
@opentelemetry/context-zonee registre comprovider.register({ contextManager: new ZoneContextManager() }).Se ela for zoneless (sem zone.js), basta
provider.register().
O que acontece depois
A web aparece em APM → Serviços com o tipo Navegador e conta no indicador Navegadores. Ao abrir um trace que começou no navegador, você vê os spans dele e, abaixo, os da sua API e do banco de dados na mesma cascata.