Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
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 .
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.
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:
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.
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}}
Importante
A menudo, el agente de infraestructura se ejecuta como un servicio del sistema en el host, gestionado globalmente (por ejemplo, systemd para Linux, servicios de Windows, launchd para macOS, etc.). Para aplicar cambios de configuración con variables de entorno en esta configuración, dichas variables de entorno deben configurar y hacer visibles para el contexto aislado donde se ejecuta el servicio del agente de infraestructura. La forma de hacer esto depende de la plataforma; consulte la documentación del administrador de servicios de su plataforma para saber cómo agregar variables de entorno a los servicios del sistema.
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.
Desde dentro del archivo de configuración: agregue una entrada al archivo de configuración de infraestructura para permitir que el agente obtenga las variables de entorno que configuró.
passthrough_environment:
- HTTPS_PROXY
- HTTP_PROXY
- HTTP.*
- .*
Desde la línea de comando: emplee otra variable de entorno para pasar estas configuraciones.
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:
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:
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:
