É possível associar os logs de negócios da sua aplicação Go a um rastreamento incluindo o traceId. Quando ocorre um problema, use o traceId para localizar rapidamente os logs de negócios relevantes, o que facilita a identificação, análise e resolução da falha.
Pré-requisitos
Sua aplicação foi compilada e implantada com o agente Go.
A coleta de dados no Simple Log Service (SLS) está configurada. Para mais informações, consulte Data collection overview.
Contexto
O ARMS correlaciona um traceId aos logs de negócios em microsserviços Go por meio da instrumentação de frameworks de log. Os seguintes frameworks são suportados:
|
Framework |
Repositório |
Versão mínima |
Versão máxima |
|
Zerolog |
v1.10.0 |
v1.33.0 |
|
|
Zap |
v1.20.0 |
v1.27.0 |
|
|
Logrus |
v1.5.0 |
v1.9.3 |
|
|
Log |
v1.21 |
Sem limite |
|
|
Slog |
v1.21 |
Sem limite |
Ativar associação de logs com traceId
Faça login no console do ARMS. No painel de navegação à esquerda, escolha .
-
Na página Application List, selecione a região na barra de navegação superior e clique no nome da aplicação.
NotaOs ícones na coluna Language têm os seguintes significados:
: aplicação Java conectada ao Application Monitoring.
: aplicação Golang conectada ao Application Monitoring.
: aplicação Python conectada ao Application Monitoring.-: aplicação conectada ao Managed Service for OpenTelemetry.
Na barra de navegação superior, escolha .
-
Na aba Custom Configurations, na seção Application Log Association Configuration, defina a origem do log como Simple Log Service (SLS) e ative a chave Associate Business Logs with traceId. Em seguida, selecione a região onde seu SLS está implantado e vincule o Project e o Logstore.
Defina Association Type como Logstore ou StoreView e Association Index como full-text index ou um índice de campo específico. Depois, clique em Save.
-
Se o
traceIdaparecer nos logs de negócios da sua aplicação conforme o exemplo abaixo, a associação foi realizada com sucesso.2024/12/09 11:14:39 trace_id=0c74ce6d96528xxx2 span_id=ae73xxx cedbrequest to mongon server $$$$$$$$$$$$$$ map[Content-Length:[20] Content-Type:[text/plain; charset=utf-8] Date:[Mon, 09 Dec 2024 03:14:39 GMT] Eagleeye-Traceid:[0c74ce6d96528cxxx2]] $$$$$$$$$$$$$$ -
(Opcional) Configure a coleta de dados do SLS para enviar os logs da aplicação ao Project e Logstore vinculados nas etapas anteriores.
Por padrão, o ARMS não coleta logs de aplicação.
1 12-09 10:43:38 @ 10.36.45.83 cn-hangzhou.xxx.83 1733712219 k8s-group-c7ab2784bd...d17fa c7ab2784bd8a84020b05...d17fa xxx.101 ad-recommend-server registry.cn-hangzhou...erver insights xxx.83 cn-hangzhou.xxx.83 ad-recommend-server-...bc6xn 65c79c55-9e04-469f-9...9d636 _source_: stderr _time_: 2024-12-09T10:43:38.366744191+08:00 content: 2024/12/09 10:43:38 trace_id=cf6281bdde61f7xxx7dd span_id=7fc65xxx72e [grpc] SayHello message:"Hello Hello"
Instruções
Leia o conteúdo em inglês para entender O QUE precisa ser comunicado
Escreva o português brasileiro DO ZERO — esqueça a estrutura das frases em inglês
Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão
Placeholders xref (
{XREF_N}) — copie literalmente, NÃO traduza nem modifiqueAplique todas as regras específicas de idioma rigorosamente
Aplique as regras de stopwords com tolerância zero
Use modo imperativo em passos numerados e listas de procedimentos
Garanta consistência terminológica — mesmo termo = mesma tradução em todo o documento
Varie os inícios de frase em listas/tabelas — nenhum início repetido 3+ vezes
Retorne APENAS o documento markdown em português brasileiro, sem explicações