Configurar o observador trace

Se você estiver seguindo as etapas para configurar distributed tracing e continuar com as etapas da opção avançada chamada Rastreamento Infinito, será necessário configurar um observador trace . O observador trace é um serviço baseado em AWS para rastreamento infinito que fornece uma maneira de baixa latência e baixo custo de enviar seus dados de telemetria para a New Relic. À medida que recebe seus dados de rastreamento, o observador trace usa amostras tail-based para decidir o que manter e enviar para a New Relic.

Conclua a configuração do observador trace que se adapta aos seus tipos de fontes de dados (serviços, aplicativos ou entidade). Talvez seja necessário executar etapas em mais de uma seção se você tiver vários tipos:

• Instrumento de serviços com agente APM e ferramentas de telemetria de terceiros
• Instrumento de serviços com New Relic Browser, mobile e Lambda
• (Opcional) Configuração adicional para todos os tipos de serviço

Instrumento de serviços com agente APM e ferramentas de telemetria de terceiros

Para criar um novo observador trace se você estiver usando o APMagente New Relic ou integração de terceiros:

1. Vá para one.newrelic.com > All capabilities > Infinite Tracing settings.

2. Selecione uma conta no dropdown superior esquerdo. Se você tiver acesso a várias contas, certifique-se de estar na conta onde deseja ativar o Rastreamento infinito. Se não for possível adicionar um observador, provavelmente é porque permitimos apenas um observador por região, por família de contas.

3. Se nenhum observador trace ainda estiver presente, clique em New trace observer para adicionar um, preencha as informações e clique em Create. Observe que oferecemos as seguintes regiões:

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU):

     Selecione esta região se você estiver coletando dados de solicitações da UE e tiver uma conta New Relic baseada na UE que gera relatórios no data center da UE.

   • eu-west-1 (US):

     Selecione esta região se você estiver coletando dados de solicitações da UE e tiver uma conta New Relic baseada nos EUA que gera relatórios no data center dos EUA.

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. No dropdown Endpoints, copie o valor do endpoint em For other integrations e prepare-o. Esse valor é referenciado em nossos exemplos de código como YOUR_TRACE_OBSERVER_URL. Isto é usado para testar o observadortrace , bem como para configurar nossa integração de telemetria e para enviar dados através da API Trace.

5. Se estiver configurando um agente APM, você também deverá copiar o valor do endpoint em For language agents e tê-lo pronto. Esse valor é referenciado em nossos exemplos de código como YOUR_TRACE_OBSERVER_HOST. Isso é usado para configurar nosso agente de linguagem para enviar dados ao observador trace .

6. (Opcional) Para verificar se o observador trace está funcionando, recomendamos o envio de uma amostra de carga útil trace . Se você estiver usando nossa API Trace diretamente, isso ajudará você a aprender como a API funciona.

   Enviar amostra de carga útil

   Importante

   Se você estiver usando dados no formato Zipkin, consulte Enviar carga útil do Zipkin.

   Este teste envia uma carga útil trace de amostra com um trace e dois períodos de um serviço denominado Test Service A.

   Para enviar este exemplo de solicitação:

   1. Obtenha o chave de licençada conta para a qual deseja relatar dados e prepare-o.

   2. Copie a seguinte solicitação curl em um editor de texto:

      bash

      Copiar

      $
      curl -i -H 'Content-Type: application/json' \
      >
          -H 'Api-Key: YOUR_LICENSE_KEY' \
      >
          -H 'Data-Format: newrelic' \
      >
          -H 'Data-Format-Version: 1' \
      >
          -X POST \
      >
          -d '[
      $
              {
      $
                  "common": {
      $
                      "attributes": {
      $
                          "environment": "staging"
      $
                      }
      $
                  },
      $
                  "spans": [
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "ABC",
      $
                          "attributes": {
      $
                              "duration.ms": 12.53,
      $
                              "host": "host123.example.com",
      $
                              "name": "/home",
      $
                              "service.name": "Test Service A"
      $
                          }
      $
                      },
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "DEF",
      $
                          "attributes": {
      $
                              "error.message": "Invalid credentials",
      $
                              "service.name": "Test Service B",
      $
                              "host": "host456.example.com",
      $
                              "duration.ms": 2.97,
      $
                              "name": "/auth",
      $
                              "parent.id": "ABC"
      $
                          }
      $
                      }
      $
                  ]
      $
              }
      $
          ]' 'YOUR_TRACE_OBSERVER_URL'

   3. Insira seus próprios valores na solicitação curl :

      Valor	Descrição
      YOUR_LICENSE_KEY	Substitua isso pela sua ingestão chave de licença.
      YOUR_TRACE_OBSERVER_URL	Substitua pelo valor do endpoint For other integrations que você copiou na etapa anterior.

   4. Copie a solicitação curl em um terminal e execute-a.

   5. O teste deve retornar HTTP/1.1 202 Accepted, indicando sucesso. Caso contrário, verifique os seguintes problemas comuns:

      • Confirme se você usou o valor do endpoint

        For other integrations

        .

      • Confirme que você está usando aspas simples em torno de YOUR_TRACE_OBSERVER_URL.

      • Verifique se você está usando a chave de API correta.

   6. Se o seu teste retornou HTTP/1.1 202 Accepted, acesse a interface do New Relic para ver uma consulta dos dados de carga útil de amostra usando o atributo span service.name = Test Service A (aqui está um link para essa consulta). Como a carga útil da amostra contém um atributo de erro, o amostrador de erros irá marcá-lo para manutenção. Se você modificar a carga útil para remover o atributo de erro, o amostrador aleatório poderá não optar por manter esse trace específico.

      Dica

      O rastreamento pode levar até um minuto para aparecer na interface.

7. Marque a configuração opcional abaixo para que você possa retornar a ela depois de experimentar o Infinite Tracing.

8. Retorne às instruções originais de configuração distributed tracing para seu agente ou ferramenta de telemetria de terceiros e insira seu novo valor de endpoint na configuração de cada serviço.

9. Se você também possui um instrumento de serviços com New Relic Browser, mobile e Lambda, siga as etapas dessa seção para selecionar suas fontes de dados (serviços, aplicativos ou entidade) no trace observer.

Instrumento de serviços com New Relic Browser, mobile e Lambda

Para criar um novo observador trace se você estiver usando New Relic Browser, mobile ou Lambda, siga etapas semelhantes às do agente APM e integração de terceiros. A diferença entre essa configuração é que você não precisa inserir um novo do trace observador endpoint na configuração de cada serviço. Em vez disso, você conclui uma configuração separada no observador trace que especifica quais fontes de dados (serviços, aplicativos ou entidade) devem ter seus dados enviados para o observador trace do Infinite Tracing.

Se você já criou um observador de trace ao configurar outro tipo de serviço (por exemplo, um agente APM), você pode ignorar as etapas sobre como criar o observador de trace e ir direto para Configuração inicial do observador de trace para browser, mobile e Lambda para selecionar suas fontes de dados.

Crie um observador trace

Se você ainda não configurou um observador trace , faça o seguinte:

1. Vá para one.newrelic.com > All capabilities > Infinite Tracing settings.

2. Selecione uma conta no dropdown superior esquerdo. Se você tiver acesso a várias contas, certifique-se de estar na conta onde deseja ativar o Rastreamento infinito. Se não for possível adicionar um observador, provavelmente é porque permitimos apenas um observador por região, por família de contas.

3. Se nenhum observador trace ainda estiver presente, clique em New trace observer para adicionar um, preencha as informações e clique em Create. Observe que oferecemos as seguintes regiões:

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU):

     Selecione esta região se você estiver coletando dados de solicitações da UE e tiver uma conta New Relic baseada na UE que gera relatórios no data center da UE.

   • eu-west-1 (US):

     Selecione esta região se você estiver coletando dados de solicitações da UE e tiver uma conta New Relic baseada nos EUA que gera relatórios no data center dos EUA.

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. No dropdown Endpoints, copie o valor do endpoint em For other integrations e prepare-o. Esse valor é referenciado em nossos exemplos de código como YOUR_TRACE_OBSERVER_URL. Isso é usado para testar o observadortrace .

5. (Opcional) Para verificar se o observador trace está funcionando, recomendamos o envio de uma amostra de carga útil trace .

   Enviar amostra de carga útil

   Importante

   Se você estiver usando dados no formato Zipkin, consulte Enviar carga útil do Zipkin.

   Este teste envia uma carga útil trace de amostra com um trace e dois períodos de um serviço denominado Test Service A.

   Para enviar este exemplo de solicitação:

   1. Obtenha o chave de licençada conta para a qual deseja relatar dados e prepare-o.

   2. Copie a seguinte solicitação curl em um editor de texto:

      bash

      Copiar

      $
      curl -i -H 'Content-Type: application/json' \
      >
          -H 'Api-Key: YOUR_LICENSE_KEY' \
      >
          -H 'Data-Format: newrelic' \
      >
          -H 'Data-Format-Version: 1' \
      >
          -X POST \
      >
          -d '[
      $
              {
      $
                  "common": {
      $
                      "attributes": {
      $
                          "environment": "staging"
      $
                      }
      $
                  },
      $
                  "spans": [
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "ABC",
      $
                          "attributes": {
      $
                              "duration.ms": 12.53,
      $
                              "host": "host123.example.com",
      $
                              "name": "/home",
      $
                              "service.name": "Test Service A"
      $
                          }
      $
                      },
      $
                      {
      $
                          "trace.id": "123456",
      $
                          "id": "DEF",
      $
                          "attributes": {
      $
                              "error.message": "Invalid credentials",
      $
                              "service.name": "Test Service B",
      $
                              "host": "host456.example.com",
      $
                              "duration.ms": 2.97,
      $
                              "name": "/auth",
      $
                              "parent.id": "ABC"
      $
                          }
      $
                      }
      $
                  ]
      $
              }
      $
          ]' 'YOUR_TRACE_OBSERVER_URL'

   3. Insira seus próprios valores na solicitação curl :

      Valor	Descrição
      YOUR_LICENSE_KEY	Substitua isso pelo seu chave de licença.
      YOUR_TRACE_OBSERVER_URL	Substitua pelo valor do endpoint For other integrations que você copiou na etapa anterior.

   4. Copie a solicitação curl em um terminal e execute-a.

   5. O teste deve retornar HTTP/1.1 202 Accepted, indicando sucesso. Caso contrário, verifique os seguintes problemas comuns:

      • Confirme se você usou o valor do endpoint

        For other integrations

        .

      • Confirme que você está usando aspas simples em torno de YOUR_TRACE_OBSERVER_URL.

      • Verifique se você está usando a chave de API correta.

   6. Se o seu teste retornou HTTP/1.1 202 Accepted, acesse a interface do New Relic para ver uma consulta dos dados de carga útil de amostra usando o atributo span service.name = Test Service A (aqui está um link para essa consulta). Como a carga útil da amostra contém um atributo de erro, o amostrador de erros irá marcá-lo para manutenção. Se você modificar a carga útil para remover o atributo de erro, o amostrador aleatório poderá não optar por manter esse trace específico.

      Dica

      O rastreamento pode levar até um minuto para aparecer na interface.

Configuração inicial do observador trace para browser, mobile e Lambda

Depois de ter um observador trace , você precisa especificar quais fontes de dados (serviços, aplicativos ou entidade) devem ter seus dados enviados para o observador trace do Infinite Tracing. Antes de selecionar suas fontes de dados, familiarize-se com o seguinte:

O procedimento abaixo é para usar a interface New Relic, mas se preferir uma abordagem programática, você pode especificar fontes de dados com GraphQL. Se você usa GraphQL, retorne a este procedimento e continue com a etapa 4 (configuração opcional) abaixo.

Para finalizar a configuração do browser, mobile e Lambda na interface:

1. Retorne ao aplicativo observador trace (one.newrelic.com > All capabilities > Infinite Tracing settings).

2. Para o observador trace , vá até o final da linha, clique no ícone de reticências ... e, em seguida, clique em Edit mobile, browser, lambda sources.

   

3. Selecione as fontes de dados que deseja incluir, tendo em mente o seguinte:

   • Você pode usar o filtro para restringir suas opções.

   • Se o seu aplicativo de browser estiver conectado a um agente

     APM

     que tenha vários nomes, você poderá escolher apenas um nome.

   • Se uma entrada estiver cinza, ela já está sendo usada por outro observador trace .

4. Marque a configuração opcional abaixo para que você possa retornar a ela depois de experimentar o Infinite Tracing.
5. Visualize seus dados de rastreamento infinito na interface distributed tracing do New Relic.
6. Se você também possui instrumento de serviços com agente APM ou ferramentas de telemetria de terceiros, siga as etapas dessa seção para garantir que seus dados sejam reportados à New Relic.

(Opcional) Configuração adicional para todos os tipos de serviço

Você pode controlar o comportamento do observador trace com várias configurações. Aqui estão alguns dos recursos que você pode configurar:

• Configurar monitoramento do observador trace : permite ver a quantidade de rastreamentos vistos e retidos.
• Configurar filtro de rastreamento de atributo de span: crie regras de filtro personalizadas para spans.
• Rastreamento infinito: Configurar filtro trace aleatório: ajuste a porcentagem usada pelo filtro trace aleatório.