• /
  • Log in
  • Free account

New Relic Flex: Build your own integration

New Relic provides integrations and quickstarts for many popular services and frameworks. If you have New Relic and want to report data from a service we don't have an integration for, there are several ways New Relic lets you create your own integration:

What is Flex?

New Relic Flex is an application-agnostic, all-in-one tool that allows you to collect metric data from a wide variety of services. It comes bundled with our infrastructure agent. You can instrument any app that exposes metrics over a standard protocol (HTTP, file, shell) in a standard format (for example, JSON or plain text): you create a YAML config file, start the Infrastructure agent, and your data is reported to New Relic.

Flex can send event and metric data to New Relic from a wide range of sources. Using a simple YAML config file, you can run HTTP/HTTPS requests, run shell commands, and parse file content. You can also use standard regex expressions to customize and control the data gathered from those inputs. See an example config.

After collecting and cleaning up the data, you can then query Flex data in New Relic, create custom charts for it, and use that data in your dashboards.


Flex comes bundled with our infrastructure agent. To use Flex, you need:

  • Infrastructure agent version 1.10.7 or higher (update | check version) running on Linux, Windows, or Kubernetes.

How does Flex work?

Flex uses our infrastructure agent to execute commands that generate the data you want to report. Here's a brief overview of how Flex works to report data:

  1. You define the data you want to report in a YAML configuration file, located in the infrastructure agent package. See an example configuration:

  2. The infrastructure agent runs Flex at a frequency based on its own configuration (default: every 30 seconds) and sends the data to New Relic.

  3. You can then query your data, create custom charts with it, and add it to dashboards.

Learn more

The Flex integration comes bundled with the infrastructure agent. Learn more about requirements.

To learn more, see our complete documentation on GitHub:

Create issueEdit page
Copyright © 2022 New Relic Inc.