Instalación manual de Tarball del agente de infraestructura para Linux

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.

Instalar el agente

Antes de la instalación, verifique la compatibilidad y los requisitos.

Para instalar el agente:

1. 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) y V=1.27.4 con la versión más reciente o específica.

   bash

   Copia

   $
   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 paquete tar.gz . Puede consultar el procedimiento de firma y las instrucciones de verificación en el repositorio del infra-agente en GitHub.

2. Desempaquete el archivo.

3. 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-infra

   Copia

4. Instale el script de servicio.

5. Opcional: 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.

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.

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.

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.

Para cambiar el modo de ejecución:

1. Edite el script de servicio:

   Systemd

   1. Abra el script de servicio ./newrelic-infra/etc/init_scripts/systemd/newrelic-infra.service.
   2. Busque la línea [Service].
   3. Agregue la línea User=user_name y reemplace user_name con el usuario que desea ejecutar el agente (PRIVILEGED o UNPRIVILEGED).
   4. Guarda el archivo.

   SysV

   1. Abra el script de servicio ./newrelic-infra/etc/init_scripts/sysv/newrelic-infra.
   2. Busque la línea USER=root.
   3. Reemplace root con el usuario que desea ejecutar el agente (PRIVILEGED o UNPRIVILEGED).
   4. Guarda el archivo.

   Advenedizo

   1. Abra el script de servicio ./newrelic-infra/etc/init_scripts/upstart/newrelic-infra.
   2. Busque la línea exec /usr/bin/newrelic-infra.
   3. Reemplácelo con exec su -s /bin/sh -c ‘exec “$0” “$@“’ user_name-- /usr/bin/newrelic-infra.
   4. Reemplace user_name con el usuario que desea ejecutar el agente (PRIVILEGED o UNPRIVILEGED).
   5. Guarda el archivo.

2. Si está ejecutando el agente como PRIVILEGED, debe darle dos capacidades adicionales de Linux:

   1. Asegúrese de que la biblioteca libcap esté instalada en su host. (Necesita los comandos setcap y getcap que vienen con él).

   2. Extraiga el contenido del tarball y ejecute el siguiente comando con permiso de root:

      bash

      Copia

      $
      setcap CAP_SYS_PTRACE,CAP_DAC_READ_SEARCH=+ep ./newrelic-infra/usr/bin/newrelic-infra

   3. El 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 campo plugin_dir .
• Páselo como argumento de línea de comando usando -plugin_dir cuando ejecute el binario newrelic-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).

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 campo agent_dir .
• Páselo como argumento de línea de comando usando -agent_dir cuando ejecute el binario newrelic-infra .

Configurar el archivo de registro

Por defecto el agente almacena el archivo de registro en /var/db/newrelic-infra/newrelic-infra.log.

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 campo log_file .
• Páselo como argumento de línea de comando usando -log_file cuando ejecute el binario newrelic-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.