Habilite distributed tracing para seu aplicativo Go

O rastreamento distribuído permite que você visualize toda a jornada das suas requisições em um sistema distribuído. Para o agente Go, oferecemos dois tipos de rastreamento distribuído (para mais detalhes, consulte Como funciona a amostragem de span):

• Padrão (amostragem baseada no início): Antes de qualquer trace chegar, determinamos uma porcentagem definida de traces para aceitar e analisar. Isso oferece um ponto de partida sólido para ver como o rastreamento pode ajudar você. Está ativado por padrão nos agentes Go 3.16.0 e superiores. Por padrão, o agente Go amostra 10 traces por minuto, com um limite máximo de 2000 spans por minuto.

• Infinite Tracing (amostragem baseada em cauda): Nosso serviço baseado em nuvem aceita todos os seus traces e, em seguida, os examina para encontrar os mais importantes. O Infinite Tracing analisa todos os seus traces e oferece opções de configuração para amostrar os traces que mais importam para você.

Se você deseja apenas experimentar distributed tracing padrão (Amostragem head-based) ou também configurar o Rastreamento Infinito (amostragem tail-based), você precisa começar configurando o rastreamento padrão.

Distributed tracing padrão

Esta é a melhor abordagem para configurar distributed tracingpadrão se você ainda não tiver instalado nenhum agente APM para seus serviços.

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.

Instrumentar cada serviço com um agente APM

Para cada serviço envolvido em sua transação, você realizará a instalação separada do agente. Se alguns dos seus serviços usarem outros idiomas, basta repetir as etapas de instalação para esses idiomas.

Dica

O agente Go exige que você instrumente manualmente seus serviços Go, ao contrário da instrumentação automática do outro agente New Relic . Isso significa que você precisa adicionar algumas linhas ao seu código para usar o agente Go. Você aprenderá sobre isso quando iniciar a instalação abaixo.

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

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:

Ver rastreamento que inclui um serviço específico

Esta é uma maneira de ver o rastreamento de um serviço específico:

1. Vá para one.newrelic.com > All capabilities > APM & services.
2. Clique na sua entidade (serviço).
3. Na seção Monitor do painel esquerdo, clique em Distributed tracing.
4. Para obter detalhes, clique em um trace individual. Se Group similar traces estiver ativado no menu superior, clique em um grupo trace e, em seguida, clique em um trace individual.
5. Se você não encontrar o rastreamento desejado, poderá filtrar por trace.id.

Ver rastreamento entre contas

Para ver o rastreamento que cruza contas:

1. Vá para one.newrelic.com > All capabilities > Traces.
2. Selecione sua entidade (serviço) no painel esquerdo.
3. Para obter detalhes, clique em um trace individual. Se Group similar traces estiver ativado no menu superior, clique em um grupo trace e, em seguida, clique em um trace individual.
4. Se você não encontrar o rastreamento desejado, poderá filtrar por trace.id.

Examinar o log relacionado ao rastreamento

Você pode reunir seus detalhes de registro e rastreamento para tornar a resolução de problemas mais fácil e rápida. Com logs contextualizados, você pode ver a mensagem do log junto com o trace na interface do New Relic.

Depois de localizar um trace interessante usando as etapas em Exibir rastreamento que inclui um serviço específico ou Exibir rastreamento entre contas, faça o seguinte:

1. Se você ativou o logs contextualizados, clique na guia Logs (ao lado de Trace details).
2. Para visualizar detalhes relacionados a um log individual, clique diretamente na mensagem.

Para obter mais ajuda para encontrar seu rastreamento na interface:

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

Rastreamento infinito (opcional)

Com o Infinite Tracing (amostragem baseada em cauda), podemos analisar todos os seus dados e determinar quais traces são os mais relevantes.

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.