DocumentaciónAjuda

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.

Nesta página

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

  1. 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/resources
  1. No 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.

  1. Na sua API, aceite os cabeçalhos do contexto no CORS:

Access-Control-Allow-Headers: traceparent, tracestate, content-type, authorization
  1. Se o seu site tiver Content-Security-Policy, permita a URL de ingestão:

connect-src 'self' https://URL_DE_INGESTA

Troque 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-zone e registre com provider.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.

Relacionado

Pesquisar em Argunis Monitoring

Digite pelo menos 2 letras para pesquisar em Argunis Monitoring.

↑↓ navegar · Enter abrir · Esc fechar