https://github.com/anthonybloomer/dashboard-email-scheduler
Using New Relic NerdGraph, customers can now retrieve a PDF or image of a given New Relic Dashboard programmatically. This project provides the ability to periodically share a New Relic Dashboard using the GMail API.
https://github.com/anthonybloomer/dashboard-email-scheduler
gmail-api graphql nerdgraph newrelic newrelic-dashboards
Last synced: 7 months ago
JSON representation
Using New Relic NerdGraph, customers can now retrieve a PDF or image of a given New Relic Dashboard programmatically. This project provides the ability to periodically share a New Relic Dashboard using the GMail API.
- Host: GitHub
- URL: https://github.com/anthonybloomer/dashboard-email-scheduler
- Owner: AnthonyBloomer
- Created: 2020-07-18T16:38:24.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2022-09-23T22:45:33.000Z (over 3 years ago)
- Last Synced: 2025-05-15T00:13:10.076Z (about 1 year ago)
- Topics: gmail-api, graphql, nerdgraph, newrelic, newrelic-dashboards
- Language: Python
- Homepage:
- Size: 3.91 KB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# dashboard-email-scheduler
A common request I have received from my customers is the ability to create performance reports to share with other members of their team or to their clients. While New Relic does provide email weekly performance reports, it is often the case that customers wish to email custom reports with the performance and business metrics they care about most.
With the New Relic NerdGraph API, it is now possible to retrieve the link for the current snapshot of your New Relic Dashboard! This opens up a lot of programmable capabilities for our customers. One use-case would be to programmatically generate a snapshot of a performance dashboard that could be mailed every week.
This project provides the ability to periodically share a New Relic Dashboard using the GMail API.
https://discuss.newrelic.com/t/periodically-share-a-new-relic-dashboard-using-the-gmail-api/108919
## Setup
Clone the [Github repository](https://github.com/AnthonyBloomer/dashboard-email-scheduler/) and set up a virtual environment.
```
git clone https://github.com/AnthonyBloomer/dashboard-email-scheduler.git
cd dashboard-email-scheduler
virtualenv env
source env/bin/activate
```
Install the project requirements.
``` shell
pip install -r requirements.txt
```
Export your [Personal API Key](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#personal-api-key) as an environment variable.
``` shell
export NEW_RELIC_PERSONAL_API_KEY = "YOUR_API_KEY"
```
If you have an EU based account, you will also need to export the `NEW_RELIC_REGION` environment variable:
``` shell
export NEW_RELIC_REGION = "EU"
```
Edit `config.py` with the New Relic Dashboard and Email settings.
``` python
config = {
"email": {
"sender": "Email sender.",
"to": "Email receiver.",
"subject": "Email subject",
"text": "Email message text",
},
"dashboard": {
"guid": "The New Relic Dashboard GUID",
"file_type": "PDF",
"width": "2000",
"height": "2000",
},
}
```
Go to the [Google Developer Console](https://console.developers.google.com/?pli=1) and create a new project. Enable the GMail API and create OAuth credentials. Download the `credentials.json` file to the root directory of this project.
Run `python scheduler.py`. This will run an initial job so you can authenticate the application. By default the job will run ever Friday. Refer to the [Schedule](https://pypi.org/project/schedule/) project documentation to configure the scheduler to your liking.