Instalación del agente de infraestructura
Clase 9 de 23 • Curso de Observabilidad Avanzada con New Relic
Resumen
Con el agente de infraestructura de New Relic puedes obtener insights completos sobre contenedores, servidores y servicios en la nube. Para comenzar, una correcta instalación es esencial.
¿Cómo comenzar con la instalación del agente de infraestructura en New Relic?
Para iniciar, ingresa a la plataforma de New Relic. Dirígete a la vista Integraciones y agentes desde la opción All Entities. Aquí encontrarás diversas opciones para integraciones, incluyendo sistemas operativos e infraestructura.
Selecciona la opción Infrastructure in OS; esta mostrará todas las alternativas disponibles para herramientas de infraestructura y sistemas operativos como Linux. Para servidores Linux, la plataforma proporciona un instalador guiado muy similar al utilizado con otras integraciones de aplicaciones.
¿Cómo configurar el agente en Docker usando docker-compose.yaml?
En el contexto de Docker, recurrimos al archivo docker-compose.yaml
. En este archivo definimos servicios específicos para cada contenedor que compone la infraestructura:
- Front-end: Interfaz de usuario para el tablero de control del comando de la flota espacial.
- API: Gestor de las comunicaciones bidireccionales con rovers.
- Telemetry: Procesador de datos telemétricos provenientes de los rovers.
- MongoDB: Base de datos que almacena información relevante de cada misión y rover.
- New Relic Infra Service: Contenedor que aloja el agente de infraestructura de New Relic.
Profundizando en la configuración del servicio para New Relic Infra, este incluye:
- Imagen pública proporcionada por New Relic para Docker.
- Permisos (
cap_add
,network_mode
,pid
,privileged
) que permiten acceso avanzado del agente al host y sus procesos internos. - Volúmenes que garantizan la interacción con otros contenedores y acceso pleno a archivos, incluyendo integraciones personalizadas Flex percibidas mediante la línea
monitoring new relic flex integration
. - Variables de entorno críticas como la clave de licencia obligatoria para vincular la instalación con nuestra cuenta de New Relic y visualizar los datos generados.
- Una variable opcional (
NEW_RELIC_INFRASTRUCTURE_AGENT_DISPLAY_NAME
) que facilita búsquedas posteriores en la plataforma. - Indicación expresa mediante
NRIA_DOCKER_ENABLED
para establecer el entorno de operación Docker.
¿Cómo verificar la correcta instalación y funcionamiento del agente?
Luego de guardar las configuraciones en el archivo YAML, utiliza el comando:
docker compose up -d
Mediante plugins como el de Docker en VS Code, verifica el estado de los contenedores visualizando sus logs. Para el contenedor de New Relic Infra:
- Asegúrate de observar líneas en los logs manifestando que el agente está funcionando correctamente y que la conexión e integración han sido exitosas.
- Identifica mensajes relacionados con errores menores de acceso que no afectan al desempeño del agente y son considerados normales.
Por último, vuelve a la interfaz de usuario de New Relic para confirmar en las vistas All Entities y Infrastructure que el host respectivo aparece correctamente reportando métricas vitales como uso de CPU, memoria, almacenamiento y tráfico de red.
La configuración exitosa del agente prepara el sistema para optimizaciones posteriores que revisaremos en detalles en la próxima sesión sobre configuraciones básicas.