Configurar el observador de trazas

Si estás siguiendo los pasos para configurar rastreo distribuido y continúas con los pasos para la opción avanzada llamada Infinite Tracing, necesitas configurar un observador de traza. Traza Observer es un servicio basado en AWS para Infinite Tracing que le brinda una forma de baja latencia y bajo costo de enviar sus telemetry data a New Relic. A medida que recibe sus datos de rastreo, el observador de traza utiliza el muestreo final para decidir qué conservar y enviar a New Relic.

Complete la configuración de traza observer que se ajuste a sus tipos de fuentes de datos (servicios, aplicaciones o entidad). Es posible que deba realizar pasos en más de una sección si tiene una variedad de tipos:

• Servicios instrumentados con agente APM y herramientas de telemetría de terceros.
• Servicios instrumentados con New Relic Browser, móvil y Lambda
• (Opcional) Configuración adicional para todos los tipos de servicios

Servicios instrumentados con agente APM y herramientas de telemetría de terceros.

Para crear un nuevo observador de traza si está utilizando New Relic APMagente o integración de terceros:

1. Vaya a one.newrelic.com > All capabilities > Infinite Tracing settings.

2. Seleccione una cuenta en el menú desplegable superior izquierdo. Si tiene acceso a varias cuentas, asegúrese de estar en la cuenta donde desea habilitar Infinite Tracing. Si no puede agregar un observador, probablemente se deba a que solo permitimos un observador por región, por familia de cuentas.

3. Si ya no hay observadores de traza presentes, haga clic en New trace observer para agregar uno, complete la información y haga clic en Create. Tenga en cuenta que ofrecemos las siguientes regiones:

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU):

     Seleccione esta región si está recopilando datos de solicitudes de la UE y tiene una cuenta New Relic con sede en la UE que informa en el centro de datos de la UE.

   • eu-west-1 (US):

     Seleccione esta región si está recopilando datos de solicitudes de la UE y tiene una cuenta New Relic con sede en EE. UU. que informa en el centro de datos de EE. UU.

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. En el menú desplegable Endpoints , copia el valor extremo en For other integrations y tenlo listo. En nuestros ejemplos de código se hace referencia a este valor como YOUR_TRACE_OBSERVER_URL. Esto se utiliza para probar el observador de traza, así como para configurar nuestra integración de telemetría y para enviar datos a través de la API de traza.

5. Si está configurando un agente APM, también debe copiar el valor extremo en For language agents y tenerlo listo. En nuestros ejemplos de código se hace referencia a este valor como YOUR_TRACE_OBSERVER_HOST. Esto se utiliza para configurar nuestro agente de lenguaje para enviar datos al observador de traza.

6. (Opcional) Para verificar que el observador de traza esté funcionando, recomendamos enviar una carga útil de traza de muestra. Si está utilizando nuestra traza API directamente, esto le ayudará a aprender cómo funciona la API.

   Enviar carga útil de muestra

   Importante

   Si utiliza datos en formato Zipkin, consulte Enviar carga útil Zipkin.

   Esta prueba envía una carga útil de traza de muestra con una traza y dos tramos desde un servicio denominado Test Service A.

   Para enviar esta solicitud de muestra:

   1. Obtenga el clave de licenciapara la cuenta a la que desea informar datos y téngalo listo.

   2. Copie la siguiente solicitud curl en un editor de texto:

      bash

      Copia

      $
      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. Inserte sus propios valores en la solicitud curl :

      Valor	Descripción
      YOUR_LICENSE_KEY	Reemplace esto con su ingesta clave de licencia.
      YOUR_TRACE_OBSERVER_URL	Reemplace esto con el valor extremo For other integrations que copió en un paso anterior.

   4. Copie la solicitud curl en una terminal y ejecútela.

   5. La prueba debería devolver HTTP/1.1 202 Accepted, lo que indica éxito. Si no es así, verifique los siguientes problemas comunes:

      • Confirma que usaste el valor extremo

        For other integrations

        .

      • Confirme que está utilizando comillas simples alrededor de YOUR_TRACE_OBSERVER_URL.

      • Comprueba que estás utilizando la clave de API correcta.

   6. Si su prueba arrojó HTTP/1.1 202 Accepted, vaya a la UI de New Relic para ver una consulta de los datos de carga útil de muestra utilizando el atributo span service.name = Test Service A (aquí hay un enlace para esa consulta). Debido a que la carga útil de muestra contiene un atributo de error, el muestreador de errores la marcará para conservarla. Si modifica la carga útil para eliminar el atributo de error, es posible que el muestreador aleatorio no elija conservar esta traza en particular.

      Sugerencia

      Traza puede tardar hasta un minuto en aparecer en la UI.

7. Marque la configuración opcional a continuación para que pueda volver a ella después de experimentar con Infinite Tracing.

8. Vuelva a las instrucciones de configuración originales de rastreo distribuido para su agente o herramienta de telemetría de terceros e inserte su nuevo valor extremo en la configuración de cada servicio.

9. Si también tienes servicios instrumentados con New Relic Browser, móvil y Lambda, sigue los pasos de esa sección para seleccionar tus fuentes de datos (servicios, aplicaciones o entidad) en el observador de traza.

Servicios instrumentados con New Relic Browser, móvil y Lambda

Para crear un nuevo observador de traza si está utilizando New Relic Browser, dispositivo móvil o Lambda, siga pasos similares a los del agente APM y la integración de terceros. La diferencia entre esta configuración es que no es necesario insertar un nuevo extremo de traza observer en la configuración de cada servicio. En su lugar, completa una configuración separada en el observador de traza que especifica qué fuentes de datos (servicios, aplicaciones o entidad) deben enviar sus datos al observador de traza de Infinite Tracing.

Si ya creó un observador de traza mientras configuraba otro tipo de servicio (por ejemplo, un APMagente), puede omitir los pasos sobre la creación del observador de traza e ir directamente a Configuración inicial del observador de traza para browser, dispositivo móvil y Lambda. para seleccionar sus fuentes de datos.

Crear un observador de traza

Si aún no ha configurado un observador de trazas, complete lo siguiente:

1. Vaya a one.newrelic.com > All capabilities > Infinite Tracing settings.

2. Seleccione una cuenta en el menú desplegable superior izquierdo. Si tiene acceso a varias cuentas, asegúrese de estar en la cuenta donde desea habilitar Infinite Tracing. Si no puede agregar un observador, probablemente se deba a que solo permitimos un observador por región, por familia de cuentas.

3. Si ya no hay observadores de traza presentes, haga clic en New trace observer para agregar uno, complete la información y haga clic en Create. Tenga en cuenta que ofrecemos las siguientes regiones:

   • us-east-1 (US)

   • us-west-2 (US)

   • eu-central-1 (EU):

     Seleccione esta región si está recopilando datos de solicitudes de la UE y tiene una cuenta New Relic con sede en la UE que informa en el centro de datos de la UE.

   • eu-west-1 (US):

     Seleccione esta región si está recopilando datos de solicitudes de la UE y tiene una cuenta New Relic con sede en EE. UU. que informa en el centro de datos de EE. UU.

   • ap-southeast-1 (US)

   • ap-southeast-2 (US)

   • us-east-2 (US, FedRAMP)

4. En el menú desplegable Endpoints , copia el valor extremo en For other integrations y tenlo listo. En nuestros ejemplos de código se hace referencia a este valor como YOUR_TRACE_OBSERVER_URL. Esto se utiliza para probar el observador de traza.

5. (Opcional) Para verificar que el observador de traza esté funcionando, recomendamos enviar una carga útil de traza de muestra.

   Enviar carga útil de muestra

   Importante

   Si utiliza datos en formato Zipkin, consulte Enviar carga útil Zipkin.

   Esta prueba envía una carga útil de traza de muestra con una traza y dos tramos desde un servicio denominado Test Service A.

   Para enviar esta solicitud de muestra:

   1. Obtenga el clave de licenciapara la cuenta a la que desea informar datos y téngalo listo.

   2. Copie la siguiente solicitud curl en un editor de texto:

      bash

      Copia

      $
      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. Inserte sus propios valores en la solicitud curl :

      Valor	Descripción
      YOUR_LICENSE_KEY	Reemplace esto con su clave de licencia.
      YOUR_TRACE_OBSERVER_URL	Reemplace esto con el valor extremo For other integrations que copió en un paso anterior.

   4. Copie la solicitud curl en una terminal y ejecútela.

   5. La prueba debería devolver HTTP/1.1 202 Accepted, lo que indica éxito. Si no es así, verifique los siguientes problemas comunes:

      • Confirma que usaste el valor extremo

        For other integrations

        .

      • Confirme que está utilizando comillas simples alrededor de YOUR_TRACE_OBSERVER_URL.

      • Comprueba que estás utilizando la clave de API correcta.

   6. Si su prueba arrojó HTTP/1.1 202 Accepted, vaya a la UI de New Relic para ver una consulta de los datos de carga útil de muestra utilizando el atributo span service.name = Test Service A (aquí hay un enlace para esa consulta). Debido a que la carga útil de muestra contiene un atributo de error, el muestreador de errores la marcará para conservarla. Si modifica la carga útil para eliminar el atributo de error, es posible que el muestreador aleatorio no elija conservar esta traza en particular.

      Sugerencia

      Traza puede tardar hasta un minuto en aparecer en la UI.

Configuración inicial de traza observer para browser, móvil y Lambda

Una vez que tenga un observador de traza, debe especificar qué fuentes de datos (servicios, aplicaciones o entidad) deben enviar sus datos al observador de traza de Infinite Tracing. Antes de seleccionar sus fuentes de datos, familiarícese con lo siguiente:

El procedimiento a continuación es para usar la UI de New Relic, pero si prefiere un enfoque programático, puede especificar fuentes de datos con GraphQL. Si usa GraphQL, regrese a este procedimiento y continúe con el paso 4 (configuración opcional) a continuación.

Para finalizar la configuración para browser, móvil y Lambda en la UI:

1. Regrese a la aplicación de traza observer (one.newrelic.com > All capabilities > Infinite Tracing settings).

2. Para su observador de traza, vaya al final de la fila, haga clic en el icono de puntos suspensivos ... y luego haga clic en Edit mobile, browser, lambda sources.

   

3. Seleccione las fuentes de datos que desea incluir, teniendo en cuenta lo siguiente:

   • Puede utilizar el filtro para limitar sus opciones.

   • Si su aplicación browser está conectada a un

     APM

     agente que tiene varios nombres, solo podrá elegir un nombre.

   • Si una entrada es gris, ya está siendo utilizada por otro observador de traza.

4. Marque la configuración opcional a continuación para que pueda volver a ella después de experimentar con Infinite Tracing.
5. Vea sus datos de Infinite Tracing en la UIdistribuida del rastreo de New Relic.
6. Si también tiene servicios instrumentados con agente APM o herramientas de telemetría de terceros, siga los pasos en esa sección para asegurarse de que sus datos se informen a New Relic.

(Opcional) Configuración adicional para todos los tipos de servicios

Puedes controlar el comportamiento del observador de trazas con varias configuraciones. Estas son algunas de las características que puedes configurar:

• Configurar monitoreo de traza observador: Permite ver la cantidad de traza vista y retenida.
• Configure el filtro de traza del atributo span: cree reglas de filtrado personalizadas para tramos.
• Seguimiento Infinito: Configurar filtro de traza aleatoria: Ajusta el porcentaje utilizado por el filtro de traza aleatoria.