Valores de configuración del agente de infraestructura

Especifica el clave de licenciapara su cuenta New Relic. El agente utiliza esta clave para asociar la métrica de su servidor con su cuenta New Relic. Esta configuración se crea como parte del proceso de instalación estándar.

Ejemplo:

license_key: 1234567890abcdefghijklmnopqrstuvwxyz1234

Especifica si se debe utilizar FedRAMP extremo.

Especifica la cantidad de procesadores lógicos disponibles para el agente. Aumentar este valor ayuda a distribuir la carga entre diferentes núcleos.

Si se establece en -1, el agente intentará leer la variable de entorno GOMAXPROCS. Si esta variable no está configurada, el valor predeterminado será el número total de núcleos disponibles en el host.

Desde la versión 1.0.804 o superior, los datos enviados desde el agente se comprimen de forma predeterminada. Para deshabilitar la compresión de carga útil, establezca payload_compression_level en 0.

Número de veces que el agente reintentará la solicitud para verificar la disponibilidad de la plataforma de New Relic al inicio antes de generar un error.

Si se establece en negative value, el agente seguirá comprobando la conexión hasta que tenga éxito.

Después de que se agota el tiempo de espera de una solicitud, tiempo que el agente espera para volver a intentar una solicitud y verificar la disponibilidad de la plataforma de New Relic al inicio.

El tiempo que el agente espera hasta que una solicitud para verificar la disponibilidad de la plataforma de New Relic en el inicio se considera agotado.

Habilita la auto instrumentación del agente.

Habilita el reintento del agente para la transmisión log a través del reenviador de registros integrado de fluentbit. Los valores enteros corresponden al número de reintentos previstos. Otros valores posibles incluyen False para establecer el número de reintentos en infinito y no_retries para desactivar por completo la función de reintento.

Establece la cantidad de veces que el agente vuelve a intentar conectarse en caso de que falle la detección de la nube.

Si la detección de la nube falla durante la inicialización del agente, el agente volverá a intentarlo después de esperar CloudRetryBackOffSec segundos.

Establece el intervalo de tiempo que esperará el agente hasta descartar los metadatos, en segundos. Después de este período, los metadatos caducan y el agente los recuperará nuevamente.

Establece el intervalo de tiempo que el agente espera entre los reintentos de detección de la nube en caso de que la detección de la nube falle, en segundos.

Si la detección de la nube falla durante la inicialización del agente, lo volverá a intentar CloudMaxRetryCount veces.

Especifica el proveedor de nube en el que se ejecuta el agente. Cuando esto se configura en un valor diferente al predeterminado, el agente esperará hasta que adquiera exitosamente los metadatos (el ID de la instancia) del proveedor de la nube antes de enviar cualquier dato al backend.

Con el comportamiento predeterminado, el agente también intentará detectar el proveedor de la nube y obtener los metadatos pero sin bloquear al agente.

Valores permitidos: "", "aws", "azure", "gcp", "alibaba"

Similar a DisableCloudMetadata, pero deshabilita la recopilación de metadatos de la nube solo para el complemento de alias de host.

Deshabilita la recopilación de metadatos en la nube.

Tiempo, en segundos, antes de que caduquen los metadatos del contenedor almacenado en caché y el agente necesite recuperarlos nuevamente.

Especifica la versión de la API del cliente Docker .

Lista de los tipos de sistemas de archivos que admite el agente. Este valor debe ser un subconjunto de la lista predeterminada y los elementos que no estén en la lista predeterminada se descartarán.

Lista de dispositivos de almacenamiento que el agente ignorará al recopilar datos StorageSample .

Ejemplo como atributo YAML:

file_devices_ignored:
  - sda1
  - sda2

Ejemplo como variable de entorno:

FILE_DEVICES_IGNORED="sda1,sda2"

Anula el nombre de host generado automáticamente para generar informes. Esto es útil cuando tiene varios hosts con el mismo nombre, ya que nuestro monitoreo de infraestructura utiliza el nombre de host como identificador único para cada host. Tenga en cuenta que este valor también se utiliza para el reemplazo de direcciones de loopback en nombres de entidades.

Para obtener más información, consulte nuestra documentación sobre cómo funciona la resolución de nombres de entidades.

Ejemplo:

display_name: teslaOne

Cuando true, el nombre de host completo se resuelve realizando una búsqueda inversa de la dirección del host. De lo contrario, se recuperará con el comando nombre de host en Linux y desde el parámetro TCP/IP del registro en Windows.

Cuando se establece, este es el valor que se informará para el nombre de host completo; de lo contrario, el agente realizará el comportamiento de búsqueda normal.

Ejemplo:

my.custom-hostname.co.org

Cuando se establece, este es el valor que se informará para el nombre de host; de lo contrario, el agente realizará el comportamiento de búsqueda normal.

Ejemplo:

my.custom-hostname

Directorio donde el agente almacena archivos para caché, inventario, integración, etc.

Directorio que contiene los archivos de configuración de la integración.

Cada integración tiene su propio archivo de configuración, denominado de forma predeterminada <integration_name>-config.yml, ubicado en una ubicación predefinida desde la cual el agente carga durante la inicialización.

Especifica una ruta personalizada para instalar la integración, que permite instalarlos fuera del agent_dir. Tiene prioridad cuando el agente busca integración instalada.

Una lista de variables de entorno que se pasarán a todas las integraciones. Si una integración ya tiene una opción de configuración existente con el mismo nombre, entonces la variable de entorno tiene prioridad.

A partir del agente de infraestructura 1.24.1, passthrough_environment admite expresiones regulares para nombres de variables.

Ejemplo como atributo YAML (dentro del archivo de configuración del agente, ubicado por defecto en /etc/newrelic-infra.yml):

passthrough_environment:
  - HOST
  - PORT
  - NRIA_.*

Ejemplo como variable de entorno:

NRIA_PASSTHROUGH_ENVIRONMENT="HOST,PORT,NRIA_.*"

Para hosts de Windows: PATHEXT es una variable de entorno de MS Windows. La función es determinar qué extensiones de archivo marcan los archivos que son ejecutables desde cada línea de comando. Esto resolverá cualquier error que informe "... no se reconoce como el nombre de un cmdlet, función, archivo de script..." para la integración Flex común:

passthrough_environment:
  - PATHEXT

El agente habilita el reemplazo de la dirección de bucle invertido en el nombre de la entidad (y, por lo tanto, la clave) automáticamente para la versión 3 del protocolo de integración. Si está utilizando la versión 2 del protocolo y desea este comportamiento, habilite la opción entityname_integrations_v2_update .

Al establecer este parámetro de configuración en true , el agente abrirá un puerto HTTP (de forma predeterminada, 8001) para recibir datos del backend de New Relic StatsD.

Al establecer este valor, el agente comenzará a escuchar en el HTTPServerPort para recibir datos del backend de New Relic StatsD.

Establece el puerto para que el servidor http reciba datos del backend de New Relic StatsD.

Inicia el proceso de eliminación de entidades que no han reportado información durante este intervalo.

Unidades de tiempo válidas: s (segundos), m (minutos) y h (hora).

Ejemplo:

1h

Si tiene una gran cantidad de procesos en el host o un gran volumen de datos recopilados a través de su integración, la cola del agente puede desbordarse. Aumente la profundidad de la cola para evitar mensajes de error resultantes de colas llenas.

Define el directorio temporal utilizado como almacenamiento persistente para la sincronización del SDK de integración.

Si el inventario almacenado en caché supera este valor (por ejemplo, porque el agente está fuera de línea), el agente elimina y vuelve a crear automáticamente el almacén delta.

Cuando se establece en verdadero, habilita el procesamiento asincrónico del inventario, lo que permite procesar una carga de inventario más grande.

La lista de rutas de inventario ignoradas por el agente.

Ejemplo como atributo YAML:

ignored_inventory:
  - files/config/stuff.bar
  - files/config/stuff.foo

Ejemplo como variable de entorno:

NRIA_IGNORED_INVENTORY="files/config/stuff.bar,files/config/stuff.foo"

Ubicación en Linux donde se crea el archivo pid del proceso del agente. Se utiliza al inicio para garantizar que no se esté ejecutando ninguna otra instancia del agente.

Cuando es verdadero, la formulación de la memoria virtual del host considera SReclaimable como memoria disponible; de lo contrario, SReclaimable se considerará parte de la memoria utilizada.

log es un mapa de valores principales que se utiliza para configurar el logger del agente de infraestructura. Ejemplo como atributo YAML:

log:
  file: '/var/log/newrelic-infra/newrelic-infra.log'
  level: debug
  forward: true
  stdout: false

Ejemplo como variable de entorno:

NRIA_LOG_FILE='/var/log/newrelic-infra/newrelic-infra.log'
NRIA_LOG_LEVEL='smart'
NRIA_LOG_FORWARD='false'
NRIA_LOG_STDOUT='true'

log:
  level: info
  file: /var/log/newrelic-infra/newrelic-infra.log
  rotate:
    max_size_mb: 1000                        # Required
    max_files: 5                             # Optional
    compression_enabled: true                # Optional
    file_pattern: YYYY-MM-DD_hh-mm-ss.log    # Optional

Atributo personalizado son pares de valores principales (similares a etiquetas en otras herramientas) que se utilizan para anotar los datos del agente de infraestructura. Puede utilizar estos metadatos para filtrar su entidad, agrupar sus resultados y anotar sus datos. Por ejemplo, puede indicar el entorno de una máquina (de prueba o producción), el servicio que aloja una máquina (servicio de inicio de sesión, por ejemplo) o el equipo responsable de esa máquina.

Utilice una lista de atributos personalizados para anotar los datos de esta instancia de agente. Separe las claves y los valores con dos puntos :, como en KEY: VALUE, y separe cada par principal de valores con un salto de línea. Las claves pueden ser cualquier YAML válido excepto las barras diagonales /. Los valores pueden ser cualquier cadena YAML, incluidos los espacios.

Ejemplo como atributo YAML:

custom_attributes:
  environment: production
  service: login service
  team: alpha-team

Ejemplo como variable de entorno:

NRIA_CUSTOM_ATTRIBUTES='{"customAttribute_1":"SOME_ATTRIBUTE","customAttribute_2": "SOME_ATTRIBUTE_2"}'

Ejemplo de filtrado de NRQL por atributo personalizado:

FROM SystemSample SELECT * WHERE environment = 'production'

Permite el envío de proceso métrica a New Relic.

De forma predeterminada, el agente de infraestructura no envía datos sobre los procesos del sistema operativo. El agente aún recopila dichos datos, a menos que metrics_process_sample_rate esté configurado en -1.

Para informar datos métricos sobre todos los procesos del sistema operativo, establezca enable_process_metrics en true. Para deshabilitarlo, configúrelo en false.

Enviar todos los datos del proceso podría aumentar el volumen de datos enviados a New Relic. Para ajustar qué procesos desea monitor, configure include_matching_metrics.

De forma predeterminada, los procesos que utilizan poca memoria están excluidos del muestreo. Para obtener más información, consulte desactivar-filtro-de-proceso-mem-cero.

Puedes controlar la cantidad de datos que se envían a New Relic configurando include_matching_metrics, lo que te permite restringir la transmisión de datos métricos en función de los valores del atributo métrico.

Puedes incluir datos métricos definiendo valores literales o parciales para cualquiera de los atributos de la métrica. Por ejemplo, puede optar por enviar el host.process.cpuPercent de todos los procesos cuyo process.name coincida con la expresión regular ^java .

En este ejemplo, incluimos el proceso métrica usando archivos ejecutables y nombres:

include_matching_metrics:          # You can combine attributes from different metrics
  process.name:
    - regex "^java"                # Include all processes starting with "java"
  process.executable:
    - "/usr/bin/python2"           # Include the Python 2.x executable
    - regex "\\System32\\svchost"  # Include all svchost executables

Si necesita incluir argumentos de línea de comando en cualquiera de los valores, establezca strip_command_line en falso (el agente de infraestructura elimina los argumentos CLI de forma predeterminada para evitar que se filtren secretos).

Para configurar include_matching_metrics como variable de entorno para la integración de Kubernetes, agréguelo en el manifiesto dentro del objeto env: :

env:
  - name: NRIA_INCLUDE_MATCHING_METRICS
    value: |
      process.name:
        - regex "^java"
      process.executable:
        - "/usr/bin/python2"
        - regex "\\System32\\svchost"

Por defecto

Puede utilizar la configuración de filtros de interfaz de red para ocultar del agente de infraestructura las interfaces de red no utilizadas o que no son interesantes. Esto ayuda a reducir el uso de recursos, el trabajo y el ruido en sus datos.

La configuración utiliza un mecanismo simple de coincidencia de patrones que puede buscar interfaces que comiencen con una secuencia específica de letras o números siguiendo cualquiera de los patrones:

• {name}[other characters], donde especificas el nombre usando la opción prefix

• [number]{name}[other characters], donde especificas el nombre usando la opción index-1

  New Relic Infrastructure implementa una lista predeterminada seleccionada de filtros, disponible tanto para Linux como para Windows, que puede modificar.

  Nombre de la opción YML	Variable ambiental	Tipo	Por defecto	Versión
  network_interface_filters	No soportado	map[string][]string		1.0.220

  Linux

  Filtros de interfaz de red predeterminados para Linux:

  • Interfaces de red que comienzan con dummy, lo, vmnet, sit, tun, tap o veth

  • Interfaces de red que contienen tun o tap

    El siguiente ejemplo (agregado a su archivo de configuración) anula los filtros predeterminados. Esto ignorará las interfaces de red que comiencen con dummy o lo , o que contengan tun precedido por una secuencia de números y seguido de otros caracteres:

    network_interface_filters:
      prefix:
        - dummy
        - lo
      index-1:
        - tun

    Copia

  Windows

  Filtros de interfaz de red predeterminados para Windows:

  • Interfaces de red que comienzan con Loop, isatap o Local

    El siguiente ejemplo (agregado a su archivo de configuración) anula los filtros predeterminados. Esto ignorará las interfaces de red que comiencen con Loop:

    network_interface_filters:
      prefix:
        - Loop

    Copia

ZeroRSSFilter excluye del muestreo los procesos que no utilizan memoria. Deshabilite el filtro para que el agente incluya estos procesos en el ProcessSample.

Para deshabilitar todos los complementos, establezca esta opción en true.

Período de muestreo para el complemento CloudSecurityGroups , en segundos. El valor mínimo es 30. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento Daemontools , en segundos. El valor mínimo es un 10. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento Dpkg , en segundos. El valor mínimo es 30. Para desactivarlo, configúrelo en -1. Si el parámetro no se establece explícitamente en el archivo de configuración, se puede desactivar estableciendo DisableAllPlugins en true.

Período de muestreo para el complemento Facter , en segundos. El valor mínimo es 30. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento KernelModules , en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento NetworkInterface , en segundos. El valor mínimo es 30. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento Rpm , en segundos. El valor mínimo es 30. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento SELinux , en segundos. El valor mínimo es 30. Para desactivarlo, configúrelo en -1. Esta opción se ignora si SelinuxEnableSemodule se establece en falso. Para obtener más información, consulte nuestro documento de resolución de problemas sobre cómo desactivar el módulo SELinux .

Período de muestreo para el complemento Sshd , en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento Supervisor , en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento Sysctl , en segundos. El valor mínimo es 30. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento Systemd , en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento sysv , en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento Upstart , en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento Users , en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Ubicación del enchufe del supervisor .

Establece la variable de entorno HOME para Puppet's Facter. Si no está definido, el valor predeterminado es el directorio de inicio del usuario actual.

Es posible que su sistema tenga reglas de firewall que requieran que el agente use un proxy para comunicarse con New Relic. Si es así, configure la URL del proxy con el formato https://usuario:contraseña@nombredehost:puerto. Puede ser HTTP o HTTPS.

Ejemplo:

https://proxy_user:access_10@proxy_01:1080

Cuando se establece en true, las variables de entorno HTTPS_PROXY y HTTP_PROXY se ignoran. Esto es útil cuando el agente necesita conectarse directamente al recolector métrico y omitir el proxy del sistema existente.

Si la opción HTTPS_PROXY hace referencia a un proxy con certificados autofirmados, esta opción especifica la ruta al directorio donde está disponible el certificado de proxy. Los certificados del directorio deben terminar con la extensión .pem .

Si la opción HTTPS_PROXY hace referencia a un proxy con certificados autofirmados, esta opción especifica la ruta al archivo del certificado.

Si se establece en true, cuando el proxy esté configurado para usar una conexión HTTPS, solo funcionará:

• Si el proxy HTTPS tiene certificados de una autoridad certificadora válida.

• Si las propiedades de configuración ca_bundle_file o ca_bundle_dir contienen los certificados de proxy HTTPS.

  Nombre de la opción YML	Variable ambiental	Tipo	Por defecto	Versión
  proxy_validate_certificates	NRIA_PROXY_VALIDATE_CERTIFICATES	booleano	false	1.3.0

Envía la siguiente información de configuración de proxy como inventario:

• HTTPS_PROXY

• HTTP_PROXY

• proxy ca_bundle_dir

• ca_bundle_file

• ignore_system_proxy

• proxy_validate_certificates

  Nombre de la opción YML	Variable ambiental	Tipo	Por defecto	Versión
  proxy_config_plugin	NRIA_PROXY_CONFIG_PLUGIN	booleano	true	1.3.0

Frecuencia de muestreo de muestras de red, en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Tasa de muestreo de muestras de proceso, en segundos. El valor mínimo es 20. Para deshabilitar completamente los ejemplos de procesos, establezca metrics_process_sample_rate en -1.

Tasa de muestreo de muestras de almacenamiento, en segundos. El valor mínimo es 5. Para desactivarlo, configúrelo en -1.

Frecuencia de muestreo de muestras del sistema, en segundos. El valor mínimo es 5. Para desactivarlo, configúrelo en -1.

Frecuencia de muestreo de muestras de almacenamiento NFS, en segundos. El valor mínimo es 5. Para desactivarlo, configúrelo en -1.

NFS métrica detallada. Cuando esté habilitado, el agente proporcionará una lista completa de métricas NFS.

Bandera para habilitar/deshabilitar la métrica de compensación NTP.

Define la lista de Hosts NTP a consultar. Cuando se definen múltiples hosts, se consultarán todos ellos y la métrica reportada será el valor promedio entre ellos.

Define el intervalo en minutos para solicitar compensación NTP del grupo proporcionado.

Define el tiempo de espera en segundos para las solicitudes realizadas a los hosts NTP.

Obtenga versiones de los módulos de políticas instalados usando SEModule. Si está deshabilitado, el complemento SELinux solo recuperará el estado usando SEStatus.

Cuando true, el agente elimina los argumentos del comando del atributo commandLine de ProcessSample.

Habilita el servidor de estado en el agente que proporciona información de salud local. Los extremos disponibles son:

Ejemplo de estado extremo principal (sin errores):

$
curl http://localhost:8003/v1/status
$
{
$
  "checks": {
$
    "endpoints": [
$
      {
$
        "url": "https://infrastructure-command-api.newrelic.com/agent_commands/v1/commands",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://identity-api.newrelic.com/identity/v1",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/inventory",
$
        "reachable": true
$
      }
$
    ]
$
  },
$
  "config": {
$
    "reachability_timeout": "10s"
$
  }
$
}

Estado principal extremo (con errores):

$
curl http://localhost:8003/v1/status
$
{
$
  "checks": {
$
    "endpoints": [
$
      {
$
        "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": false,
$
        "error": "endpoint check timeout exceeded"
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://identity-api.newrelic.com/identity/v1",
$
        "reachable": true
$
      },
$
      {
$
        "url": "https://infra-api.newrelic.com/inventory",
$
        "reachable": true
$
      }
$
    ]
$
  },
$
  "config": {
$
    "reachability_timeout": "10s"
$
  }
$
}

Ejemplo de errores extremos:

$
curl http://localhost:18003/v1/status/errors
$
{
$
  "checks": {
$
    "endpoints": [
$
      {
$
        "url": "https://staging-infra-api.newrelic.com/infra/v2/metrics",
$
        "reachable": false,
$
        "error": "endpoint check timeout exceeded"
$
      }
$
    ]
$
  },
$
  "config": {
$
    "reachability_timeout": "10s"
$
  }
$
}

Esto es similar al extremo de estado principal pero filtrando solo aquellos con errores.

Ejemplo de extremo de entidad:

$
curl http://localhost:8003/v1/status/entity
$
{
$
  "guid":"MMMMNjI0NjR8SU5GUkF8TkF8ODIwMDg3MDc0ODE0MTUwNTMy",
$
  "key":"your-host-name"
$
}

Devuelve información sobre la entidad agente/host. Se devolverá un código de estado de respuesta 204 ("Sin contenido") cuando el agente aún no tenga información sobre la entidad agente/host. Por lo tanto, pueden ser necesarias varias solicitudes hasta que el agente proporcione los datos de la entidad.

Define el puerto para el extremo del servidor de estado.

Período de muestreo para el complemento de servicios de Windows, en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Período de muestreo para el complemento de actualizaciones de Windows, en segundos. El valor mínimo es 10. Para desactivarlo, configúrelo en -1.

Define la ruta para almacenar datos en una ruta diferente al directorio de archivos del programa:

• %AppDir%/data: Se utiliza para almacenar los datos delta.

• %AppDir%/user_data: Directorio externo para archivos JSON generados por el usuario

• %AppDir%/newrelic-infra.log: Si la opción de configuración del archivo de registro no está definida, entonces usamos esta ruta de directorio como predeterminada.

  Nombre de la opción YML	Variable ambiental	Tipo	Por defecto	Versión
  app_data_dir	NRIA_APP_DATA_DIR	cadena	Ventanas: env(ProgramData)\New Relic\newrelic-infra Linux: No aplicable	1.0.755

Habilita el complemento de actualizaciones de Windows, que recupera las listas de revisiones instaladas en el host.

Si es true, el agente se verá obligado a utilizar Windows WMI (el método legacy del agente para obtener métrica para Windows; por ejemplo, StorageSampler) y deshabilitará el nuevo método (que utiliza la biblioteca PDH).

Esta opción de configuración permite aumentar la prioridad del proceso newrelic-infra.exe a cualquiera de los siguientes valores:

• Normal

• Idle

• High

• RealTime

• BelowNormal

• AboveNormal

  Nombre de la opción YML	Variable ambiental	Tipo	Por defecto	Versión
  win_process_priority_class	NRIA_WIN_PROCESS_PRIORITY_CLASS	cadena		1.0.989

  Ejemplo:

  Normal

  Copia

Permite que el agente de Windows informe las unidades A: y B: cuando están asignadas como unidades extraíbles.

Si lo establece en verdadero, obtendrá información del proceso de WMI y omitirá la verificación de acceso a la consulta en un entorno restringido.

Encabezados HTTP personalizados para incluir en todas las solicitudes al backend de New Relic.

http:
  headers:
    "Proxy-Authorization": "myToken"