Ao solucionar erros em uma aplicação distribuída, a forma mais rápida de identificar a causa raiz é vincular a entrada de log ao rastreamento exato que a originou. O Simple Log Service (SLS) permite transformar qualquer ID de rastreamento nos logs em um link direto clicável para o Managed Service for OpenTelemetry. Assim, você acessa a visualização completa do rastreamento diretamente da linha de log com apenas um clique.
Este guia aborda duas etapas:
Extraia o ID de rastreamento para um campo de log independente (ignore esta etapa se o campo já estiver separado).
Crie um evento no SLS para vincular esse campo ao Trace Explorer.
Pré-requisitos
Antes de começar, verifique se:
A aplicação está conectada ao Managed Service for OpenTelemetry. Consulte Conectar sua aplicação.
Os logs da aplicação foram importados para o SLS com IDs de rastreamento ou IDs de span gravados nas entradas. Consulte Introdução ao SLS e Instrumentação automática de MDC do Logger.
Etapa 1: Extrair o ID de rastreamento para um campo de log separado
Se o ID de rastreamento já existir como um campo independente nos logs, pule para a Etapa 2.
Caso o ID de rastreamento esteja incorporado em outro campo (por exemplo, no campo content), extraia-o com um processador do Logtail para que o SLS possa indexá-lo como um campo distinto e clicável.
Exemplo de entrada de log
A linha de log a seguir contém um ID de rastreamento incorporado no campo content:
2024-05-06 12:12:49.685 [http-nio-9190-exec-3] DEBUG io.lettuce.core.protocol.DefaultEndpoint - traceId:ea1a00002d17150191696858089d0007 - [channel=0x5d069239, /10.0.0.45:49614 -> redis/192.168.216.80:6379, epid=0x1] write() doneAdicionar um processador de expressão regular
Faça login no console do Simple Log Service.
Selecione o projeto e o Logstore que armazenam os logs da aplicação.
No painel de navegação à esquerda, escolha .
-
Localize a configuração do Logtail desejada e clique em Manage Logtail Configuration na coluna Actions.
Clique em Edit. Na seção Processor Configurations da aba Configuration Details, clique em Add Processor e selecione Extract Field (Regex Mode) na lista suspensa Processor Type.
-
Configure o processador. Consulte Analisar campos no modo de expressão regular.
Defina Original Field como
content(ou o campo que contém o ID de rastreamento).Defina Regular Expression como
traceId:([a-zA-Z0-9]+).Em New Field Name, insira o nome do campo extraído (por exemplo,
traceId).
-
Salve a configuração. Depois que o processador entrar em vigor, o ID de rastreamento aparecerá como um campo separado em cada entrada de log.
Etapa 2: Criar um evento para vincular logs a rastreamentos
Com o ID de rastreamento em um campo próprio, crie um evento no SLS para abrir o rastreamento correspondente no Trace Explorer ao clicar no valor do campo.
Em uma entrada de log, clique no valor do ID de rastreamento (ou ID de span) e, em seguida, clique em Go to configuration.
-
Na caixa de diálogo Advanced Event Settings, configure os seguintes parâmetros e clique em OK.
Parâmetro
Valor
Configuration Name
Um nome descritivo, por exemplo
Start Trace AnalysisEvent Action
Create Custom HTTP URL
Protocol
Custom; em seguida, insira
httpsEnter a URL
Um modelo de URL (consulte Modelos de URL abaixo)
Modelos de URL
Monte a URL substituindo <region-id> pela região onde a aplicação está conectada ao Managed Service for OpenTelemetry (por exemplo, cn-hangzhou).
|
Filtrar por |
Modelo de URL |
|
ID de rastreamento |
|
|
ID de span |
|
|
ID de rastreamento e ID de span |
|
|
Atributo personalizado |
|
Sintaxe de variáveis
A sintaxe "${fieldName}" referencia um campo de log do SLS cujo valor é inserido na URL durante a consulta.
|
Variável |
Descrição |
|
|
Campo de ID de rastreamento extraído da entrada de log |
|
|
Campo de ID de span extraído da entrada de log |
|
|
Qualquer campo de log personalizado, por exemplo |
Para atributos personalizados, use o caminho completo do atributo conforme exibido nos rastreamentos:
|
Campo de log |
Caminho do atributo de rastreamento |
Filtro de URL resultante |
|
|
|
|
Exemplo: Para filtrar rastreamentos por namespace do Kubernetes, em que o campo de log é namespace e o caminho do atributo de rastreamento é resources.k8s.namespace.name:
trace.console.aliyun.com/#/cn-hangzhou/tracing-explorer?source=XTRACE&filters=resources.k8s.namespace.name="${namespace}"Verificar a configuração
Em uma entrada de log, clique no valor do ID de rastreamento ou do ID de span.
-
Clique em Start Trace Analysis (ou no nome da configuração especificado).
-
O Trace Explorer abre com o rastreamento filtrado pelo ID do log.
Para mais detalhes, consulte Trace Explorer.