• EnglishEspañol日本語한국어Português
  • Log inStart now

Configure the infrastructure agent

The infrastructure agent can be configured in a variety of ways. The default method is to edit the configuration variables in the newrelic-infra.yml file.

A configuration file template is available in Infrastructure config file template. You can also override the config file by setting environment variables, or use config management tools, such as Ansible or Puppet.

To configure on-host integrations that work with the infrastructure agent, see a specific integration's documentation.


Always restart the agent after changing settings. Integration config updates do not require an agent restart (hot-reload is supported).

Configuration methods and precedence

The default method to configure the infrastructure agent is the newrelic-infra.yml config file. You can override the config file by setting environment variables, which is ideal for containerized environments.

Environment variables override the config file. The config file overrides the agent defaults.

Here are detailed descriptions of each configuration method:

Explore configuration options

For a list of all settings you can configure, including definitions, defaults, and related environment variables, see Infrastructure configuration settings.

Configuration file structure

When editing agent or integration YAML config files:

  • Follow YAML formatting conventions.
  • Do not modify the casing of the configuration options: YAML keys are case sensitive.
  • Respect the indentation levels. All indentations are in similar increments, typically of two space characters. Data in the same section of the file must use the same level of indentation. Indent any sub-sections by two spaces (see examples in Custom attributes and Network interface filters).
  • YAML format distinguish between numbers and strings. Use quotes to parse configuration values as string.

A template of newrelic-infra.yml is available in the infrastructure agent repository. Use a validator to ensure the syntax is accurate before using the file with the infrastructure agent.

Configuration management tools

To install and manage the infrastructure agent with configuration management tools, see the docs for:

For other options for deploying at scale, see Automate workflows.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.