Criar um token de ingestão
Crie o token que identifica a sua empresa quando uma aplicação ou um navegador envia telemetria ao APM, e revogue-o quando não for mais usado.
Nesta página
O token decide para qual empresa vão os dados. Há dois tipos, e cada um tem um uso diferente:
Tipo | Para quê | O que pode enviar |
|---|---|---|
Token de servidor | Aplicações de back-end, processos, o OpenTelemetry Collector | Traces, métricas e logs |
Token de navegador | Código que roda na página web dos seus usuários | Só traces, só a partir das origens que você indicar e sempre com o mesmo nome de serviço |
Nunca coloque um token de servidor dentro de uma página web: qualquer pessoa que abrir a página pode lê-lo. Para o navegador, use sempre um token de navegador.
Antes de começar
Você precisa da permissão Administrar no módulo APM.
O APM precisa estar ativo. Veja Ativar o APM.
Criar um token de servidor
Entre em Configurações → APM → Chave de API e SDK.
No cartão Tokens de ingestão, clique em Token de servidor.
Digite um Nome que identifique o sistema ou o servidor (por exemplo, o nome da aplicação e seu ambiente).
Clique em Criar.
Copie o token com Copiar e guarde-o em um lugar seguro. Depois clique em Concluído.
Criar um token de navegador
Entre em Configurações → APM → Chave de API e SDK.
Em Tokens de ingestão, clique em Token de navegador.
Preencha:
Nome: por exemplo, «Portal de clientes».
Nome do serviço (service.name fixo): o nome com que a web aparecerá no APM. Só letras, números e
_ . : / -, sem espaços.Origens permitidas (uma por linha): o esquema e o domínio de onde a página será carregada, sem caminho. Por exemplo
https://portal.midominio.cl. Até 20.
Clique em Criar, copie o token e clique em Concluído.
O token é mostrado uma única vez. No ARGUNIS fica só a impressão digital dele: se você o perder, crie um novo e revogue o anterior.
Enquanto você não sair da página, os guias de Como instrumentar já trazem o token recém-criado e a URL de ingestão nos exemplos: você pode copiar os blocos como estão.
Revogar um token
Em Tokens de ingestão, procure o token na tabela.
Clique no botão de lixeira da linha e confirme com Revogar.
Os sistemas que o usam deixam de enviar dados em menos de um minuto. O token fica na tabela como revogado, com sua data.
O que acontece depois
A tabela mostra cada token com seu Tipo, Prefixo, quem e quando o criou, e seu Último uso. Um token por sistema facilita revogar só um se ele vazar.