Nuestro proceso de instalación personalizado de Linux para monitoreo de infraestructura le permite personalizar todos los aspectos del proceso de instalación y colocar archivos y carpetas en su sistema de archivos. Tienes el control total de la instalación.
Advertencia
El proceso de instalación manual no está supervisado. Si opta por la instalación manual, usted es responsable de colocar los diferentes archivos en las carpetas correctas, proporcionar los valores de configuración parametrizados correctos y garantizar que el agente tenga todos los permisos para ejecutar.
Instalar el agente
Antes de la instalación, verifique la compatibilidad y los requisitos.
Opciones adicionales de paquetes de agente | Comentarios |
---|---|
Resolución de problemas | El paquete del agente de infraestructura incluye el binario |
Proceso daemon | A partir de la versión 1.5.59, el paquete agente de infraestructura incluye el binario |
Para instalar el agente:
Descargue el archivo del agente empaquetado o use el siguiente comando que busca automáticamente una versión específica del agente, su suma de verificación y la verifica después de la descarga. Reemplace
ARCH=amd64
con la arquitectura deseada (amd64, 386, arm64, arm) yV=1.27.4
con la versión más reciente o específica.bash$V=1.27.4 ARCH=amd64; echo "https://download.newrelic.com/infrastructure_agent/binaries/linux/${ARCH}/newrelic-infra_linux_${V}_${ARCH}.tar.gz" | { read url; wget "${url}"{,.sum}; shasum -a 256 --check ${url##*/}.sum; }A partir de la versión
1.27.4
, proporcionamos la firma GPG del paquetetar.gz
. Puede consultar el procedimiento de firma y las instrucciones de verificación en el repositorio del infra-agente en GitHub.Desempaquete el archivo.
Asegúrese de que el archivo se descomprima con la siguiente estructura:
newrelic-infra|-- config_defaults.sh|-- etc| |-- init_scripts| | |-- systemd| | | `-- newrelic-infra.service| | |-- sysv| | | `-- newrelic-infra| | `-- upstart| | `-- newrelic-infra| `-- newrelic-infra| `-- integrations.d|-- installer.sh|-- usr| `-- bin| |-- newrelic-infra| |-- newrelic-infra-ctl| `-- newrelic-infra-service`-- var|-- db| `-- newrelic-infra| |-- custom-integrations| |-- integrations.d| |-- LICENSE.txt| `-- newrelic-integrations|-- log| `-- newrelic-infra`-- run`-- newrelic-infraOpcional: pasos de instalación adicionales.
Instalar: pasos opcionales
También puedes realizar estos pasos adicionales:
- Cambie la ubicación del archivo de configuración.
- Cambie la ubicación del archivo PID.
- Cambie el usuario y el modo de ejecución.
- Configure el directorio del complemento.
- Configurar el directorio del agente.
- Configurar el archivo de registro.
- Cambie la ubicación del binario del agente.
¿Te ha ayudado este documento con la instalación?
Instalar el script de servicio
Antes de continuar con la instalación del script de servicio, debe determinar qué administrador de servicios está utilizando su sistema:
- Si utiliza uno de los administradores de servicios admitidos (SystemD, SysV y Upstart), utilice el script de servicio proporcionado en el tarball.
- Si utiliza un administrador de servicios que no admitimos, debe escribir su propio script de servicio.
Importante
En caso de duda, consulta la documentación oficial de tu distribución de Linux.
Importante
Antes de copiar el script del administrador de servicios, verifique si necesita cambiar el usuario, la ruta del binario del agente o la ubicación del archivo pid. Todos estos cambios deben reflejarse en el script del servicio.
Si utiliza uno de los administradores de servicios admitidos, instale el script de servicio para su host:
Su script de servicio está configurado. Configura el resto de opciones e inicia el servicio manualmente.
Cambiar la ubicación del archivo de configuración
El agente de infraestructura incluye un archivo de configuración, normalmente denominado newrelic-infra.yml
, para ajustar el comportamiento del agente. Para obtener más información, consulte una plantilla de archivo de configuración y cómo configurar el agente.
De forma predeterminada, el agente busca el archivo de configuración en una de estas ubicaciones:
newrelic-infra.yml
(carpeta raíz del directorio de trabajo)/etc/newrelic-infra.yml
/etc/newrelic-infra/newrelic-infra.yml
Para especificar una ubicación diferente, use la bandera -config
línea de comando. Por ejemplo:
$usr/bin/newrelic-infra -config /whatever/path/custom_config_name.yml
Para que este cambio sea permanente, edite el script de servicio:
Cambiar la ubicación del archivo pid
El agente de infraestructura utiliza un pid-file
para mantener el número de identificación del proceso (pid), que se utiliza para identificar una instancia en ejecución del agente. La forma de cambiar la ubicación del pid-file
depende de cómo esté configurado el agente.
Importante
De forma predeterminada, recomendamos que el agente cree el pid-file
. Puede editar la ubicación si es necesario.
Para cambiar la ubicación del pid-file
:
Cambiar el usuario y el modo de ejecución
El agente de Linux se ejecuta como root
de forma predeterminada, pero también admite la ejecución con usuarios con menos privilegios: PRIVILEGED
y UNPRIVILEGED
. Para obtener más información, consulte nuestra documentación sobre los modos de ejecución del agente.
Importante
Para ejecutar el agente como usuario no root (PRIVILEGED
o UNPRIVILEGED
), asegúrese de otorgar acceso de lectura/escritura a las carpetas y archivos proporcionados en el tarball.
Para cambiar el modo de ejecución:
Edite el script de servicio:
Si está ejecutando el agente como
PRIVILEGED
, debe darle dos capacidades adicionales de Linux:Asegúrese de que la biblioteca
libcap
esté instalada en su host. (Necesita los comandossetcap
ygetcap
que vienen con él).Extraiga el contenido del tarball y ejecute el siguiente comando con permiso de root:
bash$setcap CAP_SYS_PTRACE,CAP_DAC_READ_SEARCH=+ep ./newrelic-infra/usr/bin/newrelic-infraEl modo de ejecución se seleccionará según el usuario actual y las capacidades del kernel que se le hayan asignado.
Configurar el directorio del complemento
El agente de infraestructura le permite instalar una integración que monitor y reporta datos de servicios populares como Kubernetes, AWS, MySQL, Redis, Kafka, etc. Cada integración tiene su propio archivo de configuración, denominado de forma predeterminada integration-name-config.yml
, ubicado en la ubicación predefinida /etc/newrelic-infra/integrations.d/
. Durante la inicialización, el agente carga el archivo de configuración.
Para sobrescribir la ubicación predefinida del archivo de configuración de integración, utilice uno de los siguientes métodos:
- Establezca la ubicación en la variable de entorno
NRIA_PLUGIN_DIR
. - Establezca la ruta personalizada en el archivo de configuración
newrelic-infra.yml
usando el campoplugin_dir
. - Páselo como argumento de línea de comando usando
-plugin_dir
cuando ejecute el binarionewrelic-infra
.
Configurar el directorio del agente
El agente requiere su propio directorio definido para ejecutar la integración instalada, el almacenamiento en caché de datos (inventario), etc. La ubicación predeterminada es /var/db/newrelic-infra/
.
El directorio de agentes tiene la siguiente estructura y contenido:
LICENSE
: Archivo de texto que contiene la licencia de agente New Relic Infrastructure .custom-integrations
: Directorio que almacena la integración personalizada instalada .newrelic-integrations
: Directorio que almacena la integración oficial New Relic .data
: Directorio donde el agente almacena datos de caché (inventario).
Importante
El usuario que ejecuta el agente debe tener permisos de lectura/escritura en el directorio del agente.
Para sobrescribir la ubicación predefinida del directorio del agente, utilice uno de los siguientes métodos:
- Establezca la ubicación en la variable de entorno
NRIA_AGENT_DIR
. - Establezca la ruta personalizada en el archivo de configuración
newrelic-infra.yml
usando el campoagent_dir
. - Páselo como argumento de línea de comando usando
-agent_dir
cuando ejecute el binarionewrelic-infra
.
Configurar el archivo de registro
Por defecto el agente almacena el archivo de registro en /var/db/newrelic-infra/newrelic-infra.log
.
Importante
El agente que ejecuta el agente debe tener permisos de escritura en el archivo de registro del usuario.
Para sobrescribir la ubicación predefinida del archivo de registro, utilice uno de los siguientes métodos:
- Establezca la ubicación en la variable de entorno
NRIA_LOG_FILE
. - Establezca la ruta personalizada en el archivo de configuración
newrelic-infra.yml
usando el campolog_file
. - Páselo como argumento de línea de comando usando
-log_file
cuando ejecute el binarionewrelic-infra
.
Cambiar la ubicación del binario del agente
Para cambiar la ubicación del ejecutable, edite el script de servicio:
¿Que sigue?
Quizás también quieras:
- Agregue un atributo personalizado para anotar los datos de su infraestructura.
- Conecte su cuenta de AWS si sus servidores están alojados en Amazon EC2.
- Habilite el reenvío de registros.
- Habilite nuestra integración Flex agregando manualmente el ejecutable Flex.
- Agregar otra integración de infraestructura para recopilar datos de servicios externos.
- Inicie, detenga, reinicie o verifique el estado del agente manualmente.