Configurar el agente de infraestructura

El agente de infraestructura se puede configurar de diversas formas. El método predeterminado es editar las variables de configuración en el archivo newrelic-infra.yml .

Hay una plantilla de archivo de configuración disponible en Plantilla de archivo de configuración de infraestructura. También puede anular el archivo de configuración configurando variables de entorno o utilizando herramientas de administración de configuración, como Ansible o Puppet.

Para configurar la integración en el host que funciona con el agente de infraestructura, consulte la documentación de una integración específica.

Importante

Reinicie siempre el agente después de cambiar la configuración. Las actualizaciones de la configuración de integración no requieren reiniciar el agente (se admite la recarga en caliente).

Métodos de configuración y precedencia.

El método predeterminado para configurar el agente de infraestructura es el archivo de configuración newrelic-infra.yml . Puede anular el archivo de configuración configurando variables de entorno, lo cual es ideal para entornos en contenedores.

infrastructure config cascade (orders of precedence).webp

Las variables de entorno anulan el archivo de configuración. El archivo de configuración anula los valores predeterminados del agente.

Aquí hay descripciones detalladas de cada método de configuración:

Para configurar el agente de infraestructura, utilice el archivo newrelic-infra.yml . Su ubicación predeterminada es:

Linux: /etc/newrelic-infra.yml
Ventanas: C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml
Mac OS Intel: /usr/local/etc/newrelic-infra/newrelic-infra.yml
MacOS Apple Silicio: /opt/homebrew/etc/newrelic-infra/newrelic-infra.yml
Para obtener un archivo de configuración de muestra, consulte nuestra plantilla de archivo de configuración de infraestructura.

Para configurar una variable de entorno, use el nombre de la variable del archivo de configuración en mayúsculas y con el prefijo NRIA_; por ejemplo, NRIA_LICENSE_KEY. En entornos en contenedores, complete las propiedades de configuración como clave de licencia y etiqueta a través de variables de entorno.

Las opciones descritas en la plantilla del archivo de configuración de infraestructura incluyen sus variables de entorno correspondientes, etiquetadas como Env var. Las variables de entorno también se enumeran en los ajustes de configuración de la infraestructura.

También puede definir variables de entorno en el archivo de configuración con llaves dobles {{MY_ENV_VAR}}. Por ejemplo:

license_key: {{MY_LICENSE_KEY}}

Puede utilizar variables de entorno para controlar los ajustes de configuración para la integración en el host, que luego pueden pasarse al agente de infraestructura. Las variables que se pueden usar con cada integración en el host se enumeran en la documentación de cada integración y se pueden configurar mediante uno de los siguientes métodos.

La opción passthrough_environment admite expresiones regulares para nombres de variables.

From inside the config file: Agregue una entrada al archivo de configuración de la infraestructura para permitir que el agente obtenga las variables de entorno que ha configurado.
```
passthrough_environment:
  - HTTPS_PROXY
  - HTTP_PROXY
  - HTTP.*
  - .*
```
From the command line: Utilice otra variable de entorno para pasar por esta configuración.
```
NRIA_PASSTHROUGH_ENVIRONMENT="HTTPS_PROXY,HTTP_PROXY"
```
Cada integración tiene un conjunto de variables que se pueden sobrescribir definiendo y pasando una variable de entorno con exactamente el mismo nombre que el argumento (por ejemplo, una variable de entorno PORT para reemplazar el argumento del puerto redis .
También puede definir variables de entorno en el archivo de configuración de integración con la notación {{}} . Por ejemplo:
```
integration_name: com.newrelic.redis
instances:
  - name: redis-metrics
    command: metrics
    arguments:
      hostname: localhost
      port: 6379
      password: {{MY_REDIS_PASSWORD}}
```
Sugerencia
Asegúrese de que el servicio newrelic-infra tenga visibilidad de cualquier variable de entorno personalizada definida en el host. Los administradores de servicios como systemd no configurarán todas las variables de entorno de forma predeterminada y es posible que necesiten pasos adicionales.

Explorar opciones de configuración

Para obtener una lista de todas las opciones que puede configurar, incluidas definiciones, valores predeterminados y variables de entorno relacionadas, consulte Opciones de configuración de infraestructura.

Estructura del archivo de configuración

Al editar archivos de configuración YAML de integración o agente:

Siga las convenciones de formato YAML.
No modifique las mayúsculas y minúsculas de las opciones de configuración: las claves YAML distinguen entre mayúsculas y minúsculas.
Respete los niveles de sangría. Todas las sangrías tienen incrementos similares, normalmente de dos caracteres de espacio. Los datos en la misma sección del archivo deben usar el mismo nivel de sangría. Sangra las subsecciones con dos espacios (ver ejemplos en atributo personalizado y Filtros de interfaz de red).
El formato YAML distingue entre números y cadenas. Utilice comillas para analizar los valores de configuración como cadenas.

Una plantilla de newrelic-infra.yml está disponible en el repositorio del agente de infraestructura. Utilice un validador para garantizar que la sintaxis sea precisa antes de utilizar el archivo con el agente de infraestructura.

Herramientas de gestión de configuración

Para instalar y administrar el agente de infraestructura con herramientas de administración de configuración, consulte los documentos para:

Para conocer otras opciones para implementar a escala, consulte Automatizar el flujo de trabajo.

Te ofrecemos esta traducción automática para facilitar la lectura.

Configurar el agente de infraestructura

Importante

Métodos de configuración y precedencia.

Ubicación y descripción del archivo de configuración (`newrelic-infra.yml`)

Sintaxis y descripción de variables de entorno

Uso de transferencias de variables de entorno con integración en el host

Sugerencia

Explorar opciones de configuración

Estructura del archivo de configuración

Herramientas de gestión de configuración

Te ofrecemos esta traducción automática para facilitar la lectura.

Configurar el agente de infraestructura

Importante

Métodos de configuración y precedencia. .css-21sua1{background:none;border:none;width:0;padding:0;}

Sintaxis y descripción de variables de entorno

Uso de transferencias de variables de entorno con integración en el host

Explorar opciones de configuración

Estructura del archivo de configuración

Herramientas de gestión de configuración

Métodos de configuración y precedencia.