Todos os produtos
Search
Central de documentação

Application Real-Time Monitoring Service:Associar logs de aplicação Go a um traceId

Última atualização: Sep 06, 2026

É 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

https://github.com/rs/zerolog

v1.10.0

v1.33.0

Zap

https://github.com/uber-go/zap

v1.20.0

v1.27.0

Logrus

https://github.com/sirupsen/logrus

v1.5.0

v1.9.3

Log

https://pkg.go.dev/log

v1.21

Sem limite

Slog

https://pkg.go.dev/log/slog

v1.21

Sem limite

Ativar associação de logs com traceId

  1. Faça login no console do ARMS. No painel de navegação à esquerda, escolha Application Monitoring > Application List.

  2. Na página Application List, selecione a região na barra de navegação superior e clique no nome da aplicação.

    Nota

    Os ícones na coluna Language têm os seguintes significados:

    • Java icon: aplicação Java conectada ao Application Monitoring.

    • image: aplicação Golang conectada ao Application Monitoring.

    • image: aplicação Python conectada ao Application Monitoring.

    • -: aplicação conectada ao Managed Service for OpenTelemetry.

  3. Na barra de navegação superior, escolha Application Configuration > Custom Configurations.

  4. 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.

  5. Se o traceId aparecer 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]]
    $$$$$$$$$$$$$$
  6. (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

  1. Leia o conteúdo em inglês para entender O QUE precisa ser comunicado

  2. Escreva o português brasileiro DO ZERO — esqueça a estrutura das frases em inglês

  3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

  4. Placeholders xref ({XREF_N}) — copie literalmente, NÃO traduza nem modifique

  5. Aplique todas as regras específicas de idioma rigorosamente

  6. Aplique as regras de stopwords com tolerância zero

  7. Use modo imperativo em passos numerados e listas de procedimentos

  8. Garanta consistência terminológica — mesmo termo = mesma tradução em todo o documento

  9. Varie os inícios de frase em listas/tabelas — nenhum início repetido 3+ vezes

  10. Retorne APENAS o documento markdown em português brasileiro, sem explicações