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. O rastreamento infinito analisa todo o seu rastreamento e oferece opções de configuração para obter amostras do rastreamento mais importante 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)

Distributed tracing padrão para o agente APM 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.

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.