Habilite distributed tracing para seu aplicativo Go

Distributed tracing permite que você veja toda a jornada de suas solicitações em sistemas distribuídos. Para o agente Go, oferecemos dois tipos de distributed tracing (para obter mais detalhes, consulte Como funciona a amostragem por extensão):

• Padrão (Amostragem head-based): Antes de qualquer rastreamento chegar, determinamos uma porcentagem definida de rastreamento para aceitar e analisar. Isso fornece um ponto de partida sólido para ver como o rastreamento pode ajudá-lo. Ele está ativado por padrão no Go agente 3.16.0 e superior.
• Rastreamento Infinito (amostragem tail-based): Nosso serviço baseado em nuvem aceita todos os seus rastreamentos e depois os classifica para encontrar o mais importante. Depois de configurar o rastreamento padrão, recomendamos adicionar essa opção porque ela analisa todo o seu rastreamento e oferece opções de configuração para obter uma amostra do rastreamento mais importante para você.

Todas as etapas necessárias para começar a usar o distributed tracing estão aqui:

• Novo agente Go: etapas para instalação de novo agente com base em head e amostragem tail
• Agente Go mais antigo: opções de rastreamento se você tiver um agente Go mais antigo
• Instrumentação manual: Dicas para instrumentação adicional

Novo agente Go

Se você deseja apenas experimentar distributed tracing padrão (Amostragem head-based) ou também configurar o Infinite Tracing (Amostragem tail-based), você precisa começar configurando o rastreamento padrão. Orientaremos você na instalação do agente APMpara iniciar a Amostragem head-based. Depois disso, você pode configurar o Rastreamento Infinito, que é opcional, mas recomendado.

Instale um agente para obter distributed tracingpadrão

Esta é a melhor abordagem para configurar distributed tracingpadrão se você ainda não instalou nenhum agente APM para seus serviços ou se deseja instrumentar serviços adicionais.

Se você já possui alguns serviços instrumentados com este agente APM e deseja incluí-los no distributed tracing, será necessário habilitar manualmente distributed tracing para cada serviço. Consulte Opções para agentes Go mais antigos.

Passo 1. Identificar serviços

Descubra quais serviços atendem à sua solicitação para que você possa instrumentar cada um deles para enviar dados trace para o New Relic.

Passo 2. Instrumentar cada serviço com um agente APM

Você repetirá a rotina de instalação do agente para cada serviço envolvido na sua transação. Se alguns dos seus serviços utilizarem outros idiomas, basta repetir as etapas de instalação para esses idiomas.

Para iniciar a rotina de instalação, clique no bloco abaixo. Quando terminar de instalar cada agente, volte aqui para ver dicas para visualizar seu rastreamento.

Start installation

Etapa 3. Ver rastreamento

Depois de instrumentar cada um de seus serviços com o agente APM, gere algum tráfego em sua aplicação para que possamos capturar algum rastro. Aqui estão algumas maneiras de visualizar seu rastreamento na interface:

Para obter mais ajuda para encontrar seu rastreamento na interface:

• Compreender e usar a interface distributed tracing
• Consultar dados distributed trace

Configurar rastreamento infinito

distributed tracing padrão para o agente APM (acima) captura até 10% do seu rastreamento, mas se você quiser que analisemos todos os seus dados e encontremos o rastreamento mais relevante, você pode configurar o Rastreamento Infinito.

Antes de começar, primeiro certifique-se de atender aos requisitos.

Etapa 1. Conclua a instalação do novo agente

A configuração do Rastreamento Infinito baseia-se na etapa de instrumentação da instalação do Novo agente para distributed tracing padrão.

Etapa 2. Configurar o observador trace

O observador trace é um serviço New Relic baseado em AWS que coleta e analisa todos os seus rastreamentos. Siga as instruções em Configurar o observador de rastreamento. Quando terminar, retorne aqui com as informações do observador trace e continue com a próxima etapa para configurar o agente.

Etapa 3: configurar o agente para rastreamento infinito

As definições de configuração do Infinite Tracing incluem o distributed tracing padrão, além de informações sobre o observador trace :

Etapa 4. (Opcional) Personalizar rastreamento infinito

Depois de adicionar as definições de configuração do agente, você deverá começar a ver os dados na interface do New Relic. Depois de passar algum tempo analisando seus dados, você pode querer ajustar alguns recursos do Infinite Tracing:

• Configurar o monitoramento do observador trace
• Configurar filtro trace de atributo span
• Configurar filtro trace aleatório

Opções para agente Go mais antigo

Se você tiver um agente Go mais antigo, use esta seção para descobrir se o recurso distributed tracing que você deseja é compatível.

Após as informações de compatibilidade há uma seção que mostra as configurações básicas de configuração para ativar distributed tracing padrão. Se o seu agente mais antigo oferece suporte ao Rastreamento Infinito e você deseja configurá-lo, consulte as etapas acima.

Guia de compatibilidade

Depois de revisar as informações de compatibilidade abaixo, siga as definições de configuração:

Configure seu agente Go mais antigo

Veja as configurações abaixo para ativar distributed tracing.

Instrumentação manual adicional

Toda instalação do agente Go e distributed tracing requerem alguma instrumentação manual usando as configurações listadas em Configurações de configuração do agente Go. Ainda assim, pode ser necessário fazer algumas configurações adicionais para otimizar sua configuração. Aqui estão algumas diretrizes para transações instrumentadas e solicitações HTTP.

http.HandleFunc("/users", usersHandler)

http.HandleFunc(newrelic.WrapHandleFunc(app, "/users", usersHandler))

func useNewRoundTripper(txn *newrelic.Transaction) (*http.Response, error) {
    client := &http.Client{}
    client.Transport = newrelic.NewRoundTripper(client.Transport)
    request, _ := http.NewRequest("GET", "http://example.com", nil)
    request = newrelic.RequestWithTransactionContext(request, txn)
    return client.Do(request)
}

func external(txn *newrelic.Transaction, req *http.Request) (*http.Response, error) { 
    s := newrelic.StartExternalSegment(txn, req) 
    response, err := http.DefaultClient.Do(req) 
    s.Response = response 
    s.End() 
    return response, err
}

func noGoodForDt(txn *newrelic.Transaction, url string) (*http.Response, error) {
    // Distributed tracing headers are not added to the outgoing request.
    // Use newrelic.NewRoundTripper or newrelicc.StartExternalSegment instead.
    defer newrelic.ExternalSegment{
        StartTime: txn.StartSegmentNow(),
        URL:       url,
    }.End()

    return http.Get(url)
}

InsertDistributedTraceHeaders(h http.Header)

AcceptDistributedTraceHeaders(h http.Header)

Para obter mais detalhes sobre como usá-los, consulte o repositório GitHub do agente Go.