This is the fourth part of a five-part series on automating common DevOps tasks in New Relic.
The first part shows you how to audit your services with Python and the NerdGraph API, and also includes the sample API code that this post uses. The second part shows you how to automate your tags with Python and the NerdGraph API. The third part shows you how to export telemetry data with Python and the NerdGraph API.
All of the code from this five-part series can be found in this repository.
Management reporting is a common requirement when you’re responsible for the overall reliability of a system, and you may want to export your New Relic dashboards for reporting purposes. You can use New Relic's NerdGraph API, a GraphQL-format API that lets you query New Relic data, to automate this process.
This post shows you how to export dashboards using New Relic Query Language (NRQL) and Python.
Prerequisites
If you plan to follow along with this tutorial and use Python to make your API calls, you need:
- Python 3 installed on your machine. Download and install it from python.org. Note that you can also make API calls to the specified endpoints using languages other than Python as well.
- With Python, you’ll be using the requests and json modules.
- A New Relic account. Sign up for free.
- An application instrumented with New Relic APM and infrastructure. Follow these installation steps to instrument an application.
- A New Relic API key. Follow these steps to get an API key, or, if you’re already signed in, generate an API key on the API keys page. To learn more about querying and configuration, see New Relic API keys.
- The Python starter code, which is in part one of this blog series.
The next video shows you how to export dashboards using the NerdGraph API.
Exporting dashboards
Here's an example query for exporting dashboards using the NerdGraph API. If you need more context on the starter code, see Using Python to make an API call in part one of this series.
import requests
import json
from license import user_key
def nerdgraph_dashboards(key):
# GraphQL query to NerdGraph
query = """mutation { dashboardCreateSnapshotUrl(guid: "XXX") }"""
# NerdGraph endpoint
endpoint = "https://api.newrelic.com/graphql"
headers = {'API-Key': f'{key}'}
response = requests.post(endpoint, headers=headers, json={"query": query})
if response.status_code == 200:
# convert a JSON into an equivalent python dictionary
json_dictionary = json.loads(response.content)
print(json_dictionary)
# only interested with the dashboard url
url_pdf = json_dictionary["data"]["dashboardCreateSnapshotUrl"]
print(url_pdf)
# replace PDF with PNG, and get the link to download the file
url_png = url_pdf[:-3] + "PNG"
print(url_png)
# rename the downloaded file, and save it in the working directory
dashboard_response = requests.get(url_png, stream=True)
open('dashboard_example.png', 'wb').write(dashboard_response.content)
# optional - serialize object as a JSON formatted stream
# json_response = json.dumps(response.json()["data"]["dashboardCreateSnapshotUrl"], indent=2)
# print(json_response)
else:
# raise an error with a HTTP response code
raise Exception(f'Nerdgraph query failed with a {response.status_code}.')
nerdgraph_dashboards(user_key)Note that you would replace the "XXX" in (guid: "XXX") with the GUID of the dashboard you'd like to export. You can also switch out guid for other dashboard properties in your own queries depending on your needs.
The previous code example shows how to export the dashboard as a PDF:
url_pdf = json_dictionary["data"]["dashboardCreateSnapshotUrl"]
print(url_pdf)The example also includes a snippet that allows you to export the dashboard as a PNG:
url_png = url_pdf[:-3] + "PNG"
print(url_png)To learn more, see the NerdGraph tutorial on exporting dashboards.
핵심 요약
Learn what else you can do with the Nerdgraph API and continue to build DevOps into your observability practice. If you don't have a New Relic account yet, sign up today. Your free account includes 100 GB/month of free data ingest, one full-platform user, and unlimited free basic users.
Read the next part in this 5-part series: Rotate your license keys with Python and the NerdGraph API.
이 블로그에 표현된 견해는 저자의 견해이며 반드시 New Relic의 견해를 반영하는 것은 아닙니다. 저자가 제공하는 모든 솔루션은 환경에 따라 다르며 New Relic에서 제공하는 상용 솔루션이나 지원의 일부가 아닙니다. 이 블로그 게시물과 관련된 질문 및 지원이 필요한 경우 Explorers Hub(discuss.newrelic.com)에서만 참여하십시오. 이 블로그에는 타사 사이트의 콘텐츠에 대한 링크가 포함될 수 있습니다. 이러한 링크를 제공함으로써 New Relic은 해당 사이트에서 사용할 수 있는 정보, 보기 또는 제품을 채택, 보증, 승인 또는 보증하지 않습니다.
