Guía de la interfaz de usuario de Gateway

La IU del gateway de Pipeline Control proporciona una interfaz basada en formularios para crear y administrar reglas de gateway sin escribir YAML directamente. La interfaz de usuario organiza la lógica de procesamiento en tres categorías de reglas: tasa de muestreo, filtro y transformación. Cada categoría es configurable mediante cuadros de diálogo modales guiados.

Organización de la UI

La interfaz de usuario del gateway está organizada en tres secciones principales:

Tasa de muestreo

Configura el muestreo probabilístico con reglas condicionales para controlar qué porcentaje de datos de telemetría llega a New Relic. Admite:

• Porcentaje de muestreo predeterminado (0-100%)
• Escenarios de muestreo condicional basados en coincidencia de atributos

Casos de uso comunes:

• "Muestrear el 90% de los logs del servicio B, el 83% de los logs del servicio A"
• "Conservar el 100% de los errores, 100% de las trazas >1000ms, muestrear el 10% del resto"

Filtrar

Cree reglas de filtrado basadas en OTTL para filtrar condicionalmente registros de telemetría completos o atributos específicos. Admite:

• Coincidencia de patrones con el operador matches para regex
• Filtrado basado en atributos (entorno, nombre de la métrica, nivel de log)
• Condiciones combinadas con lógica and/or
• Operadores de comparación (==, !=, >, <, >=, <=)

Casos de uso comunes:

• "Eliminar datos del entorno de prueba"
• "Descartar logs de nivel de depuración en producción"
• "Eliminar spans de comprobación de estado"
• "Descartar métricas con prefijo de prueba"

Transformar

Defina reglas de transformación basadas en OTTL para modificar, enriquecer o analizar datos de telemetría. Admite:

• Adición y modificación de atributos mediante funciones OTTL
• Análisis de cadenas con patrones regex
• Transformaciones condicionales con reglas de coincidencia
• Múltiples sentencias OTTL por transformación

Casos de uso comunes:

• "Agregar etiquetas de entorno y región a todas las métricas"
• "Analizar el formato de log de NGINX en atributos estructurados"
• "Normalizar los nombres de servicio en los ambientes"
• "Extraer códigos de estado HTTP de mensajes de log"

Crear reglas en la interfaz de usuario

Creación de una regla de tasa de muestreo

1. En la interfaz de usuario de la puerta de enlace, en el bloque de tasa de muestreo, haga clic en el ícono de engranaje/configuración para crear una nueva configuración de muestreo.

2. Configurar el muestreo global:

   • Establezca el porcentaje de muestreo global (0-100%).
   • Use el control deslizante o ingrese un valor numérico. Esto se aplica a todos los datos que no coinciden con las reglas condicionales.

3. Agregar escenarios condicionales (opcional):

   • Haga clic en el icono MÁS para crear tasas de muestreo específicas de condiciones.
   • Para cada escenario, configure: Un nombre descriptivo (por ejemplo, "B service sample"), una descripción (por ejemplo, "B service description"), una expresión de coincidencia de atributos (por ejemplo, attributes["appName"]=="TelemetryApp-ServiceB"), un porcentaje de muestreo usando el control deslizante o ingrese un valor numérico (0-100%)

4. Haga clic en Save sample criteria para aplicar reglas de muestreo.

Crear una regla de filtro

1. En la interfaz de usuario del gateway, haga clic en el icono de signo más en el bloque de filtros para crear una nueva regla de filtro.

2. Configurar información básica:

   • Rule name: Ingrese un nombre descriptivo.
   • Description: Explique qué hace la regla.

3. Defina una condición que coincida con sus datos y haga clic en Create rule.

4. Para agregar más condiciones según sea necesario, repita los pasos 1 a 3.

Crear una regla de transformación

1. En la interfaz de usuario del gateway, haga clic en el icono de signo más en el bloque de transformaciones para crear una nueva regla de transformación.

2. Configurar la información básica:

   • Rule name: Ingrese un nombre descriptivo (por ejemplo, "parse-nginx-logs")
   • Description: Explique qué hace la transformación

3. Defina condiciones que coincidan con sus datos:

   • Agregue condiciones para apuntar a registros de telemetría específicos.
   • Haga clic en Add condition para agregar múltiples condiciones:

   Se evalúan múltiples condiciones con lógica OR (si alguna condición coincide, se aplica la transformación). Condiciones de ejemplo: body == "request failed", severity.text == "ERROR", severity.text == "FATAL_ERROR" Dejar vacío para aplicar la transformación a todos los logs. Cada condición se muestra en un campo de entrada separado con el operador OR entre ellas.

4. Definir sentencias OTTL:

   • Agregue una o más sentencias de transformación OTTL.
   • Haga clic en Add statement para agregar múltiples transformaciones.
   • Cada instrucción se ejecuta en secuencia. Cambie el orden arrastrando el controlador a la izquierda de cada declaración.
   • Declaraciones de ejemplo usando funciones OTTL: set(severity_text, "FAIL"), set(attributes["processors"], true), set(attributes["environment"], "staging")

5. Haga clic en Preview rule para ver cómo la transformación modifica los datos de muestra.

6. Realice cambios hasta que esté satisfecho con la transformación.

7. Haga clic en Create rule para agregar la transformación a su gateway.

Despliega tus cambios

Después de configurar las reglas, siga estos pasos para desplegar su configuración:

1. Haga clic en Create Deployment.

2. En la nueva página de despliegue:

   • Ingrese un nombre y una descripción para el despliegue.
   • Identifique el agente de gateway de Pipeline Control en el que desea desplegar.
   • Abre el menú de puntos a la derecha y haz clic en Change version.

3. De la lista de versiones, seleccione la versión que corresponda a la configuración que acaba de crear. (Los números de versión se incrementan automáticamente con cada cambio de configuración, por lo que debería ser la última versión).

4. Haga clic en Add to deployment para aplicar la configuración.

5. Haga clic en Save draft y luego haga clic en Start deployment.

6. Debe confirmar nuevamente que desea iniciar el despliegue. Haga clic en Start deployment de nuevo para confirmar.

Recursos de OpenTelemetry

• Referencia de funciones OTTL - Lista completa de funciones OTTL para transformaciones y expresiones booleanas para filtrar
• Procesador de transformación - Documentación oficial del procesador de transformación
• Procesador de filtros - Documentación oficial del procesador de filtros con sintaxis de expresiones booleanas OTTL
• Procesador de muestreo probabilístico - Documentación oficial del procesador de muestreo