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.