Configurar e implementar la puerta de enlace de control de tuberías

Configure e implemente la puerta de enlace de Control de pipelines para gestionar el flujo de datos desde su entidad monitoreada a New Relic.

Consideraciones para el uso de la puerta de enlace

A medida que integra y emplea el componente de puerta de enlace, tenga en cuenta estas consideraciones importantes:

atributo y gestión de datos

• Soporte de atributos: El gateway utiliza las convenciones semánticas de OpenTelemetry para los atributos. Consulte la documentación del gateway para obtener detalles sobre los atributos admitidos.
• Manejo de datos/atributos: la puerta de enlace reenvía sus requests para eliminar datos o atributos para datos de intervalos de tiempo métricos, trazas y trazas directamente a New Relic sin modificaciones.

Análisis e integración de datos

• Análisis de logs: La puerta de enlace no incluye el análisis de Grok para logs. El análisis de Grok es un método empleado para extraer datos estructurados de mensajes de log no estructurados empleando patrones predefinidos y expresiones regulares. Es posible que necesite métodos alternativos para estructurar los datos de log para realizar consultas y visualizarlos.
• Integración con Prometheus: La puerta de enlace no admite la escritura remota de Prometheus para métrica, lo que puede afectar su integración con sistemas basados en Prometheus.

Licencias y cumplimiento

• Gestión de claves de licencia: la puerta de enlace no admite varias claves de licencia de fuentes nativas del Protocolo OpenTelemetry (OTLP), como agente recolector o SDK APM . Considere esto al gestionar sus licencias.
• Estándares de cumplimiento: la puerta de enlace no cumple con los estándares de FedRAMP, lo que puede afectar su uso si necesita cumplir con los estándares de seguridad federales.

Requisitos previos

• Permisos de Kubernetes: este modo de instalación requiere permisos de administrador de clúster para que los controladores de Flux administren el ciclo de vida de la puerta de enlace (instalación, actualizaciones, escalamiento).

• Herramientas necesarias:

  • Helm v3.x o superior (verificar con helm version)
  • kubectl CLI con acceso a su clúster de Kubernetes

• Agente de infraestructura de New Relic (opcional): el gateway de Control de pipelines ya no incluye el agente de infraestructura de New Relic. Para ver las métricas de salud del clúster (uso de CPU, memoria y región) en el dashboard de salud del gateway, instale el agente de infraestructura por separado. Consulte Instale la integración de Kubernetes para obtener instrucciones de instalación.

Qué sucede sin el agente de infraestructura:

• La tabla de estado del Gateway mostrará "N/A" para: uso de CPU, uso de memoria y región.
• La configuración del Pipeline y el procesamiento de datos continúan funcionando normalmente.

Configurar la puerta de enlace de Control de tuberías

Para configurar la puerta de enlace:

1. En su cuenta New Relic , en Integración y agente, haga clic en Set up Pipeline Control o busque gateway y seleccione Pipeline Control gateway.

2. Cerciorar de que la cuenta seleccionada sea la que desea emplear para el Control de tuberías. En caso contrario, haga clic en Select an account, seleccione la cuenta de su elección y luego haga clic en Continue.

3. Para ingresar sus credenciales, proporcione una clave de licencia existente o cree una nueva clave. Si crea una nueva clave, copie la clave. Luego, haga clic en Continue.

4. Seleccione o cree una flota de gateways:

   • Seleccione una flota existente si desea que su nuevo gateway comparta una configuración existente (reglas de muestreo, filtrado y transformación) con otros gateways en su organización.
   • Ingrese un nombre único para la flota de gateways si necesita una configuración nueva y aislada para un entorno o unidad de negocio específico.

5. Seleccione Full management (with Flux).

6. Configure la puerta de enlace:

   • Ingrese el nombre de su clúster.
   • Ingrese el namespace de Kubernetes dedicado donde residirán la infraestructura principal del gateway y los servicios de administración. El valor predeterminado es newrelic-agent-control.
   • Ingrese el namespace específico donde se ejecutarán los agentes de recopilación individuales. El valor predeterminado es newrelic.

7. Descargue el archivo de configuración, values-newrelic-gateway.yaml a un directorio.

8. Ejecute el comando de instalación que se muestra en pantalla:

   bash

   Copia

   $
   helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && helm upgrade --install agent-control-bootstrap -n newrelic-agent-control newrelic/agent-control-bootstrap --create-namespace --values values-newrelic-gateway.yaml

   Sugerencia

   El asistente de la UI proporciona el archivo de valores completo, values-newrelic-gateway.yaml, con su configuración específica. Descargue el archivo y úselo con el comando Helm.

9. Haga clic en Continue.

10. Haga clic en Test connection y espere hasta que la conexión sea exitosa.

Para ver los detalles de la configuración de su puerta de enlace, vaya a New Relic Control y haga clic en Gateway.

¿Por qué usar múltiples flotas?

Imagine que una corporación (The Corp) tiene dos divisiones: OrgA (necesita el 100 % de los datos por motivos de auditoría) y OrgB (necesita un muestreo del 1 % para controlar los costos de alto volumen).

Con solo una flota, The Corp está atascada. Si OrgB aplica un muestreo del 1 % para ahorrar dinero, OrgA pierde el 99 % de sus datos de rendimiento. El control de costos de un equipo rompe el monitoreo de misión crítica del otro equipo.

Al usar múltiples flotas, The Corp puede separar sus "cerebros":

• Flota de misión crítica: OrgA se une a esta flota para obtener el 100 % de retención de datos.
• Flota de alto volumen: OrgB se une a esta flota para un muestreo del 1 % y la redacción de datos personales.

Como resultado, los equipos independientes ahora pueden administrar reglas únicas de muestreo, seguridad y cumplimiento sin afectar al resto de la organización.

Agregar más clúster

Para agregar un nuevo clúster a la configuración de su puerta de enlace,

1. Abra New Relic Control y luego seleccione Gateway.
2. En la tabla de clúster, haga clic en Add a cluster.
3. Siga las instrucciones de configuración de la puerta de enlace.
4. Regrese a la página de resumen de la puerta de enlace. Deberías ver el clúster recién agregado.

Después de crear sus clústeres de gateway, configure el procesamiento del pipeline mediante la configuración YAML. Consulte Configuración de Gateway.