Configure the infrastructure agent

To configure the infrastructure agent, use the newrelic-infra.yml file. Its default location is:

• Linux: /etc/newrelic-infra.yml

• Windows: C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml

  For a sample config file, see our infrastructure config file template.

To set an environment variable, use the variable name from the config file in all caps and prefix with NRIA_; for example, NRIA_LICENSE_KEY. Only use environment variables with containerized environments.

The options described in the infrastructure config file template include their corresponding environment variables, labeled as Env var. Environment variables are also listed in Infrastructure configuration settings.

Starting with infrastructure agent 1.14.0, environment variables can also be defined in the configuration file with the following notation {{MY_ENV_VAR}}, for example:

license_key: {{MY_LICENSE_KEY}}

You can use environment variables to control config settings for on-host integrations, which can then be passed through to the infrastructure agent. Variables that can be used with each on-host integration are listed in the documentation for each integration, and can be set through one of the following methods.

• From inside the config file: add an entry to the infrastructure config file to allow the agent to get the environment variables you've set.

  passthrough_environment:
    - HTTPS_PROXY
    - HTTP_PROXY

  コピー

• From the command line: use another environment variable to pass through these settings.

  NRIA_PASSTHROUGH_ENVIRONMENT="HTTPS_PROXY,HTTP_PROXY"

  コピー

  Each integration has a set of variables that can be overwritten by defining and passing an environment variable with the exact same name as the argument (for example, a PORT environment variable to replace the redis port argument).

  Starting with infrastructure agent 1.14.0, environment variables can be defined in the integrations config file with the {{}} notation. For example:

  integration_name: com.newrelic.redis
  instances:
    - name: redis-metrics
      command: metrics
      arguments:
        hostname: localhost
        port: 6379
        password: {{MY_REDIS_PASSWORD}}

  コピー

  ヒント

  Make sure the newrelic-infra service has visibility to any custom environment variable defined in the host. Service managers such as systemd will not set all env vars by default and might need additional steps.