• Python v3 & pip3
• pip3 install -r requirements.txt

python3 main.py

The tool will guide you through the needed configuration information. The configuration will be requested only the first time you run the script. Future executions will use the config.json generated during the first execution. You can update this config file at any time if needed.

A cache.json will be generated as well where you can see the translated queries. This file is used to speed up the process in case of redundant queries in your dashboards.

Authentication is required as part of the configuration. Why? because this tool is using an API that is not exposed via NR GraphQL schema.

• For SSO authenticated users: we will collect New Relic browser cookie and use it for authentication.
• For Non SSO users: you will be required to enter your username and password.

The script will guide you through the needed configuration for each case.

For New Relic, make sure to use a user API key. Create one if needed.

For Grafana, make sure you have an API key (you may need to be an admin in order to generate one).

Check the output folder to see the Grafana and New Relic dashbaords JSON files. You can also check the list of migrated dashboards in dashboards.csv and dashboards.json.

We encourage your contributions to improve New Relic Migration tool for Grafana! Keep in mind when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project. If you have any questions, or to execute our corporate CLA, required if your contribution is on behalf of a company, please drop us an email at [email protected].

A note about vulnerabilities

As noted in our security policy, New Relic is committed to the privacy and security of our customers and their data. We believe that providing coordinated disclosure by security researchers and engaging with the security community are important means to achieve our security goals.

If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through HackerOne.

New Relic Migration tool for Grafana is licensed under the Apache 2.0 License.