Configurer l'observateur de trace

Si vous suivez les étapes pour configurer le tracing distribué et continuez avec les étapes de l'option avancée appelée Infinite Tracing, vous devez configurer un observateur de trace. L'observateur de trace est un service basé sur AWS pour Infinite Tracing qui vous offre un moyen à faible latence et à faible coût d'envoyer vos données télémétriques à New Relic. Lorsqu'il reçoit vos données de tracing, l'observateur de trace utilise l'échantillonnage en fin de workflow pour décider ce qu'il faut conserver et envoyer à New Relic.

Complétez la configuration de l'observateur de trace qui correspond à vos types de sources de données (services, applications ou entité). Vous devrez peut-être effectuer des étapes dans plusieurs sections si vous avez plusieurs types :

• Services instrumentés avec agents APM et outils de télémétrie tiers
• Services instrumentés avec New Relic Browser, mobile et Lambda
• (Facultatif) configuration supplémentaire pour tous les types de services

Services instrumentés avec agents APM et outils de télémétrie tiers

Pour créer un nouvel observateur de trace si vous utilisez des agents New Relic APMou une intégration tierce :

1. Allez à one.newrelic.com > All capabilities > Infinite Tracing settings.

2. Sélectionnez un compte dans la liste déroulante en haut à gauche. Si vous avez accès à plusieurs comptes, assurez-vous que vous êtes dans le compte sur lequel vous souhaitez activer Infinite Tracing. Si vous ne pouvez pas ajouter d'observateur, c'est probablement parce que nous n'autorisons qu'un seul observateur par région et par famille de comptes.

3. Si aucun observateur de trace n'est déjà présent, cliquez sur New trace observer pour en ajouter un, remplissez les informations et cliquez sur Create. Veuillez noter que nous proposons les régions suivantes :

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU): Sélectionnez cette région si vous collectez des données à partir requests de l'UE et que vous disposez d'un compte New Relic basé dans l'UE qui génère des rapports dans un centre de données de l'UE.

   • eu-west-1 (US): Sélectionnez cette région si vous collectez des données à partir requests de l'UE et que vous disposez d'un compte New Relic basé aux États-Unis qui génère des rapports dans un centre de données américain.

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. Sous la liste déroulante Endpoints, copiez la valeur du point de terminaison sous For other integrations et préparez-la. Cette valeur est référencée dans nos exemples de code comme YOUR_TRACE_OBSERVER_URL. Ceci est utilisé pour tester l' observateurtrace , ainsi que pour configurer notre intégration de télémétrie et pour envoyer des données via l' API de trace.

5. Si vous configurez un agent APM, vous devez également copier la valeur du point de terminaison sous For language agents et la préparer. Cette valeur est référencée dans nos exemples de code comme YOUR_TRACE_OBSERVER_HOST. Ceci est utilisé pour configurer nos agents linguistiques pour envoyer des données à l'observateur de trace.

6. (Facultatif) Pour vérifier que l'observateur de trace fonctionne, nous vous recommandons d'envoyer un exemple de charge utile de trace. Si vous utilisez directement notre API Trace, cela vous aidera à comprendre comment fonctionne l'API.

   Envoyer un échantillon de charge utile

   Important

   Si vous utilisez des données au format Zipkin, consultez Envoyer une charge utile Zipkin.

   Ce test envoie un exemple de charge utile de trace avec une trace et deux étendues à partir d'un service nommé Test Service A.

   Pour envoyer cette demande d'échantillon :

   1. Obtenez le clé de licencepour le compte auquel vous souhaitez signaler des données et préparez-le.

   2. Copiez la requête curl suivante dans un éditeur de texte :

      bash

      Copier

      $
      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. Insérez vos propres valeurs dans la requête curl :

      Valeur	Description
      YOUR_LICENSE_KEY	Remplacez ceci par votre ingestion clé de licence.
      YOUR_TRACE_OBSERVER_URL	Remplacez ceci par la valeur de point de terminaison For other integrations que vous avez copiée à une étape précédente.

   4. Copiez la requête curl dans un terminal et exécutez-la.

   5. Le test doit renvoyer HTTP/1.1 202 Accepted, indiquant le succès. Si ce n’est pas le cas, vérifiez les problèmes courants suivants :

      • Confirmez que vous avez utilisé la valeur de point de terminaisonFor other integrations .
      • Confirmez que vous utilisez des guillemets simples autour de YOUR_TRACE_OBSERVER_URL.
      • Vérifiez que vous utilisez la bonne clé API.

   6. Si votre test a renvoyé HTTP/1.1 202 Accepted, accédez à l'UI de New Relic pour voir une requête des données de charge d'échantillon à l'aide de l'attribut span service.name = Test Service A (voici un lien pour cette requête). Étant donné que l’échantillon de charge utile contient un attribut d’erreur, l’échantillonneur d’erreurs le marquera pour être conservé. Si vous modifiez la charge pour supprimer l'attribut d'erreur, l'échantillonneur aléatoire peut choisir de ne pas conserver cette trace particulière.

      Conseil

      la trace peut prendre jusqu'à une minute pour apparaître dans l'UI.

7. Ajoutez la configuration facultative ci-dessous à vos favoris afin de pouvoir y revenir après avoir expérimenté Infinite Tracing.

8. Revenez à vos instructions de configuration de tracing distribué d'origine pour votre agent ou outil de télémétrie tiers et insérez votre nouvelle valeur de point de terminaison dans la configuration de chaque service.

9. Si vous disposez également de services instrumentés avec New Relic Browser, mobile et Lambda, suivez les étapes de cette section pour sélectionner vos sources de données (services, applications ou entité) dans l'observateur de trace .

Services instrumentés avec New Relic Browser, mobile et Lambda

Pour créer un nouvel observateur de trace si vous utilisez New Relic Browser, mobile ou Lambda, suivez des étapes similaires à celles des agents APM et de l'intégration tierce. La différence dans cette configuration est que vous n’avez pas besoin d’insérer un nouveau point de terminaison d’observateur de trace dans la configuration de chaque service. Au lieu de cela, vous effectuez une configuration distincte dans l'observateur de trace qui spécifie les sources de données (services, applications ou entité) dont les données doivent être envoyées à l'observateur de trace Infinite Tracing.

Si vous avez déjà créé un observateur de trace lors de la configuration d'un autre type de service (par exemple, un agent APM), vous pouvez ignorer les étapes de création de l'observateur de trace et passer directement à la configuration initiale de l'observateur de trace pour le navigateur, le mobile et Lambda pour sélectionner vos sources de données.

Créer un observateur de trace

Si vous n'avez pas encore configuré d'observateur de trace, procédez comme suit :

1. Allez à one.newrelic.com > All capabilities > Infinite Tracing settings.

2. Sélectionnez un compte dans la liste déroulante en haut à gauche. Si vous avez accès à plusieurs comptes, assurez-vous que vous êtes dans le compte sur lequel vous souhaitez activer Infinite Tracing. Si vous ne pouvez pas ajouter d'observateur, c'est probablement parce que nous n'autorisons qu'un seul observateur par région et par famille de comptes.

3. Si aucun observateur de trace n'est déjà présent, cliquez sur New trace observer pour en ajouter un, remplissez les informations et cliquez sur Create. Veuillez noter que nous proposons les régions suivantes :

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU): Sélectionnez cette région si vous collectez des données à partir requests de l'UE et que vous disposez d'un compte New Relic basé dans l'UE qui génère des rapports dans un centre de données de l'UE.

   • eu-west-1 (US): Sélectionnez cette région si vous collectez des données à partir requests de l'UE et que vous disposez d'un compte New Relic basé aux États-Unis qui génère des rapports dans un centre de données américain.

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. Sous la liste déroulante Endpoints, copiez la valeur du point de terminaison sous For other integrations et préparez-la. Cette valeur est référencée dans nos exemples de code comme YOUR_TRACE_OBSERVER_URL. Ceci est utilisé pour tester l' observateur de trace.

5. (Facultatif) Pour vérifier que l'observateur de trace fonctionne, nous vous recommandons d'envoyer un exemple de charge utile de trace.

   Envoyer un échantillon de charge utile

   Important

   Si vous utilisez des données au format Zipkin, consultez Envoyer une charge utile Zipkin.

   Ce test envoie un exemple de charge utile de trace avec une trace et deux étendues à partir d'un service nommé Test Service A.

   Pour envoyer cette demande d'échantillon :

   1. Obtenez le clé de licencepour le compte auquel vous souhaitez signaler des données et préparez-le.

   2. Copiez la requête curl suivante dans un éditeur de texte :

      bash

      Copier

      $
      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. Insérez vos propres valeurs dans la requête curl :

      Valeur	Description
      YOUR_LICENSE_KEY	Remplacez ceci par votre clé de licence.
      YOUR_TRACE_OBSERVER_URL	Remplacez ceci par la valeur de point de terminaison For other integrations que vous avez copiée à une étape précédente.

   4. Copiez la requête curl dans un terminal et exécutez-la.

   5. Le test doit renvoyer HTTP/1.1 202 Accepted, indiquant le succès. Si ce n’est pas le cas, vérifiez les problèmes courants suivants :

      • Confirmez que vous avez utilisé la valeur de point de terminaisonFor other integrations .
      • Confirmez que vous utilisez des guillemets simples autour de YOUR_TRACE_OBSERVER_URL.
      • Vérifiez que vous utilisez la bonne clé API.

   6. Si votre test a renvoyé HTTP/1.1 202 Accepted, accédez à l'UI de New Relic pour voir une requête des données de charge d'échantillon à l'aide de l'attribut span service.name = Test Service A (voici un lien pour cette requête). Étant donné que l’échantillon de charge utile contient un attribut d’erreur, l’échantillonneur d’erreurs le marquera pour être conservé. Si vous modifiez la charge pour supprimer l'attribut d'erreur, l'échantillonneur aléatoire peut choisir de ne pas conserver cette trace particulière.

      Conseil

      la trace peut prendre jusqu'à une minute pour apparaître dans l'UI.

Configuration initiale de l'observateur de trace pour le navigateur, le mobile et Lambda

Une fois que vous disposez d'un observateur de trace, vous devez spécifier quelles sources de données (services, applications ou entités) doivent avoir leurs données envoyées à l'observateur de trace Infinite Tracing. Avant de sélectionner vos sources de données, familiarisez-vous avec les éléments suivants :

La procédure ci-dessous concerne l'utilisation de l'UI de New Relic, mais si vous préférez une approche programmatique, vous pouvez spécifier des sources de données avec GraphQL. Si vous utilisez GraphQL, revenez à cette procédure et continuez avec l’étape 4 (configuration facultative) ci-dessous.

Pour terminer la configuration du navigateur, du mobile et Lambda dans l'UI:

1. Revenir à l’application d’observation de trace (one.newrelic.com > All capabilities > Infinite Tracing settings).

2. Pour votre observateur de trace, allez à la fin de la ligne, cliquez sur l’icône représentant des points de suspension ..., puis cliquez sur Edit mobile, browser, lambda sources.

   

3. Sélectionnez les sources de données que vous souhaitez inclure, en gardant à l’esprit les points suivants :

   • Vous pouvez utiliser le filtre pour affiner vos options.
   • Si votre application de navigateur est connectée à un agent APMportant plusieurs noms, vous ne pouvez choisir qu'un seul nom.
   • Si une entrée est grise, elle est déjà utilisée par un autre observateur de trace.

4. Ajoutez la configuration facultative ci-dessous à vos favoris afin de pouvoir y revenir après avoir expérimenté Infinite Tracing.

5. Affichez vos données d'Infinite Tracing dans l'UI de tracing distribué de New Relic.

6. Si vous disposez également de services instrumentés avec des agents APM ou des outils de télémétrie tiers, suivez les étapes de cette section pour vous assurer que leurs données sont signalées à New Relic.

(Facultatif) configuration supplémentaire pour tous les types de services

Vous pouvez contrôler le comportement de l'observateur de trace avec différentes configurations. Voici quelques-unes des fonctionnalités que vous pouvez configurer :

• Configurer trace monitoringde l'observateur : permet de voir la quantité de trace vue et conservée.
• Configurer le filtre de trace d'attribut d'étendue: créez des règles de filtre personnalisées pour les étendues.
• Infinite Tracing : configurer un filtre de trace aléatoire: ajustez le pourcentage utilisé par le filtre de trace aléatoire.