Agente de infraestructura New Relic en Docker

Curso de Observabilidad Avanzada con New Relic

Contenido del curso

Monitoreo avanzado

1
Observabilidad full stack con New Relic
02:13 min

APM avanzado

Agente de Infraestructura

Registros (Logs)

Optimizar el rendimiento

23
Observabilidad con New Relic: APM, logs e infraestructura
02:11 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0010:25

Agente de infraestructura New Relic en Docker

Curso de Observabilidad Avanzada con New Relic

Clase 9 de 23

Clase 9 / 23

Recursos

Instalar el agente de infraestructura de New Relic te da visibilidad completa sobre contenedores, servidores y servicios en la nube desde un solo panel. Aquí verás cómo configurarlo dentro de un entorno Docker, qué variables necesita y cómo validar que está reportando métricas correctamente. Es una guía pensada para desarrolladores y equipos de DevOps que quieren observabilidad real sobre su flota de servicios.

¿Dónde encuentro la instalación guiada del agente de infraestructura?

Todo arranca en la plataforma de New Relic, en la vista de todas las entidades. Desde ahí, haces clic en integraciones y agentes y eliges la colección Infraestructura y SO [01:00].

Esa sección lista cada integración disponible para servidores y hosts. Si tu servidor corre Linux, seleccionas Linux y New Relic te entrega una instalación guiada muy parecida a la del agente APM. Sencillo y familiar.

¿Qué hace el agente de infraestructura de New Relic? Recolecta datos de salud y rendimiento de tus contenedores, hosts y servicios para enviarlos a la plataforma de New Relic, donde los puedes visualizar y analizar.

¿Cómo se configura el agente de infraestructura en docker compose?

En este proyecto, la infraestructura es una serie de contenedores Docker definidos en el archivo docker-compose.yml [02:10]. Cada contenedor cumple un rol específico dentro de la flota de rovers espaciales.

Los servicios involucrados son:

frontend: muestra la interfaz del panel de control de la flota.
API: recibe los chequeos de estado y envía comandos a los rovers.
telemetría: procesa los datos de telemetría y los entrega al comando de la flota.
MongoDB: almacena información de rovers, telemetría y misiones.
New Relic Infra: aloja el agente de infraestructura.

El servicio newrelic-infra usa una imagen pública que New Relic mantiene para clientes que quieren correr el agente dentro de Docker. Le indicas a Docker Compose que use la versión más reciente para tener siempre el último release.

¿Qué permisos necesita el agente para monitorear el host?

El contenedor del agente requiere capacidades especiales para acceder a la información del sistema operativo y de los demás contenedores. Estos son los ajustes clave:

cap_add: SYS_PTRACE: permite acceder a los datos de procesos del host.
network_mode: host: el agente actúa como el host y ve toda su red.
pid: host: da acceso a la información de procesos en ejecución.
privileged: true: equivale a permisos de superusuario sobre el servidor.
volumes: incluyen el docker.sock para interactuar con los demás contenedores y recolectar métricas de cada uno.

Dentro de los volúmenes también guardas las integraciones Flex, que sirven para crear integraciones personalizadas cuando New Relic no ofrece una nativa para la métrica que quieres recolectar.

¿Qué variables de entorno necesita el agente de New Relic?

Tres variables hacen el trabajo pesado [05:30]:

NEW_RELIC_LICENSE_KEY: sin esta clave, el agente no puede conectarse a tu cuenta y los datos no se ingresan a la plataforma.
NEW_RELIC_INFRA_DISPLAY_NAME: opcional, pero te ahorra tiempo cuando buscas el host dentro de New Relic.
NRIA_DOCKER_ENABLED: true: le indica al agente que está operando dentro de un entorno Docker.

¿Qué pasa si olvido la license key? El agente arranca, pero no envía datos a New Relic. No verás métricas en tu cuenta hasta que la configures correctamente.

¿Cómo verifico que el agente de infraestructura está funcionando?

Levantas la aplicación con un solo comando: docker compose up -d [06:40]. Si tienes el complemento de Docker en VS Code, ves los contenedores aparecer mientras se inicializan.

Para confirmar que el agente reporta correctamente, abres los registros del contenedor desde el panel de Docker. Haz clic derecho sobre newrelic-infra y selecciona ver registros.

En los logs deberías encontrar:

La creación del servicio.
La verificación de conectividad de red.
El mensaje de que el agente de infraestructura de New Relic está en funcionamiento.
La verificación de salud de la integración NRI Flex completada con éxito.

Vas a ver algunos mensajes de error sobre archivos que no se pueden leer. En la mayoría de los casos son problemas menores de permisos y no afectan la capacidad del agente para monitorear tus servicios. Mientras el agente y Flex estén activos, todo está bien.

¿Dónde veo los datos del host en New Relic?

De regreso en la plataforma, en la página de todas las entidades, tu host aparece en la tabla reportando métricas en tiempo real [09:00]. Otra opción es ir directo a la vista de infraestructura en la barra lateral izquierda.

Esa vista te da una experiencia dedicada y la puedes ordenar por tipo de entidad: hosts, Kubernetes, bases de datos, red, inventario y eventos. También encuentras vistas para integraciones de proveedores de nube si vinculas tu cuenta.

Al entrar al host de Space Rover Infrastructure, ves las señales doradas de la infraestructura, equivalentes a las de APM:

Uso de CPU.
Memoria.
Almacenamiento.
Tráfico de red.

Estos cuatro indicadores son la base para entender la salud de cualquier servidor o contenedor. Si alguno se dispara, sabes dónde mirar primero.

¿Ya tienes tu agente reportando? Cuéntame en los comentarios qué integración Flex personalizada te gustaría construir primero.

Resumen

¿Dónde encuentro la instalación guiada del agente de infraestructura?

Todo arranca en la plataforma de New Relic, en la vista de todas las entidades. Desde ahí, haces clic en integraciones y agentes y eliges la colección Infraestructura y SO [01:00].

¿Qué hace el agente de infraestructura de New Relic? Recolecta datos de salud y rendimiento de tus contenedores, hosts y servicios para enviarlos a la plataforma de New Relic, donde los puedes visualizar y analizar.

¿Cómo se configura el agente de infraestructura en docker compose?

Los servicios involucrados son:

frontend: muestra la interfaz del panel de control de la flota.
API: recibe los chequeos de estado y envía comandos a los rovers.
telemetría: procesa los datos de telemetría y los entrega al comando de la flota.
MongoDB: almacena información de rovers, telemetría y misiones.
New Relic Infra: aloja el agente de infraestructura.

¿Qué permisos necesita el agente para monitorear el host?

El contenedor del agente requiere capacidades especiales para acceder a la información del sistema operativo y de los demás contenedores. Estos son los ajustes clave:

cap_add: SYS_PTRACE: permite acceder a los datos de procesos del host.
network_mode: host: el agente actúa como el host y ve toda su red.
pid: host: da acceso a la información de procesos en ejecución.
privileged: true: equivale a permisos de superusuario sobre el servidor.
volumes: incluyen el docker.sock para interactuar con los demás contenedores y recolectar métricas de cada uno.

Dentro de los volúmenes también guardas las integraciones Flex, que sirven para crear integraciones personalizadas cuando New Relic no ofrece una nativa para la métrica que quieres recolectar.

¿Qué variables de entorno necesita el agente de New Relic?

Tres variables hacen el trabajo pesado [05:30]:

NEW_RELIC_LICENSE_KEY: sin esta clave, el agente no puede conectarse a tu cuenta y los datos no se ingresan a la plataforma.
NEW_RELIC_INFRA_DISPLAY_NAME: opcional, pero te ahorra tiempo cuando buscas el host dentro de New Relic.
NRIA_DOCKER_ENABLED: true: le indica al agente que está operando dentro de un entorno Docker.

¿Qué pasa si olvido la license key? El agente arranca, pero no envía datos a New Relic. No verás métricas en tu cuenta hasta que la configures correctamente.

¿Cómo verifico que el agente de infraestructura está funcionando?

Levantas la aplicación con un solo comando: docker compose up -d [06:40]. Si tienes el complemento de Docker en VS Code, ves los contenedores aparecer mientras se inicializan.

Para confirmar que el agente reporta correctamente, abres los registros del contenedor desde el panel de Docker. Haz clic derecho sobre newrelic-infra y selecciona ver registros.

En los logs deberías encontrar:

La creación del servicio.
La verificación de conectividad de red.
El mensaje de que el agente de infraestructura de New Relic está en funcionamiento.
La verificación de salud de la integración NRI Flex completada con éxito.

¿Dónde veo los datos del host en New Relic?

Al entrar al host de Space Rover Infrastructure, ves las señales doradas de la infraestructura, equivalentes a las de APM:

Uso de CPU.
Memoria.
Almacenamiento.
Tráfico de red.

Estos cuatro indicadores son la base para entender la salud de cualquier servidor o contenedor. Si alguno se dispara, sabes dónde mirar primero.

¿Ya tienes tu agente reportando? Cuéntame en los comentarios qué integración Flex personalizada te gustaría construir primero.

Monitoreo avanzado

Observabilidad full stack con New Relic

APM avanzado

Qué es APM y sus señales doradas

Buenas prácticas de configuración en APM

Transacciones y métricas custom en New Relic

Seguimiento de cambios en New Relic con GitHub Actions

Métricas personalizadas y seguimiento de cambios en tableros de New Relic

Métricas personalizadas y dashboards en New Relic

Agente de Infraestructura

Monitoreo de infraestructura con New Relic

Agente de infraestructura New Relic en Docker

Configuración del agente de infraestructura New Relic

Métricas de infraestructura en New Relic: CPU, memoria y red

Panel de infraestructura en New Relic sin consultas

Configuración de alertas paramétricas para métricas de infraestructura

Configuración de integraciones personalizadas con New Relic Flex

Proyecto final: crea tu integración Flex para New Relic

Registros (Logs)

Gestión eficiente de registros con New Relic en sistemas distribuidos

Envío de registros a New Relic mediante API directa

Cómo filtrar logs en New Relic con Lucene

Cómo convertir logs no estructurados con Grok

Particiones de datos para gestionar logs de gran volumen

Los registros en contexto conectan datos de APM con rastreo de errores

Proyecto final: dashboard de logs

Optimizar el rendimiento

Observabilidad con New Relic: APM, logs e infraestructura

Agente de infraestructura New Relic en Docker

Progreso del curso

Monitoreo avanzado

APM avanzado

Agente de Infraestructura

Registros (Logs)

Optimizar el rendimiento

Recursos

Recursos