*Version: 1.0| Last Updated: 14/10/2024* ## Overview - **Integration Name:** Grafana Integration - **Purpose:** To integrate Grafana with MoovingON AI, enabling users to receive Grafana alerts through MoovingON AI for efficient monitoring and response. - **Audience:** Support team, TAM - **Prerequisites:** - A valid Grafana account - MoovingON AI account access with integration permissions --- ## Table of Contents - [[#Setup Instructions]] - [[#Configuration]] - [[#Testing the Integration]] - [[#Troubleshooting]] - [[#FAQs]] - [[#Related Links]] --- ## Setup Instructions 1. **Step 1:** In MoovingON AI, navigate to `Settings -> Integrations`. ![[settings-integration.png]] 2. **Step 2:** On the right side of the screen, choose "Integrations" and click on "Add Grafana Push." ![[Grafana-integration-add.png]] 3. **Step 3:** Name the integration with a relevant name and click "Submit." ![[Grafana-integration-name-window.png]] - After submitting, the username and password for the Grafana webhook will be displayed, which are needed for completing the integration in Grafana. - **Note:** If this window closes, you can view the username and password again by navigating to the "Existing integrations" section, finding the integration, and clicking on the Key icon (as shown below). ![[Grafana-Push-integration-name.png]] Example view of the username and password: **** 4. **Step 4:** In Grafana, navigate to `Alerting (Bell Sign) -> Notification Channels` and select "New Channel." ![[Grafana-alerting-notifications.png]] 5. **Step 5:** Give the notification channel a relevant name, select "Webhook" as the type. ![[Grafana-new-channel.png]] ![[Grafana-webhook-setup.png]] 6. **Step 6:** Update the URL to `https://api.moovingon.ai/api/pushes/grafana/?format=json`. Use the Username and Password generated in MoovingON AI (as shown below) and click "Save." ![[Grafana-Webhook-Configurtion.png]] After completing these steps, Grafana will start sending alerts to MoovingON AI via the configured webhook. --- ## Configuration - **API Keys/Secrets:** The Username and password generated in MoovingON AI during integration setup are required to configure the Grafana webhook. - **Settings:** Update the Grafana webhook URL to point to MoovingON AI's API endpoint as mentioned above. --- ## Testing the Integration - **Test Cases:** 1. **Verify if Grafana alerts appear within the MoovingON AI platform after integration.** 2. **Ensure that alerts are triggered and received in real-time on the MoovingON AI platform.** 3. **Check the Console:** - After successfully completing the setup, navigate to the `Settings -> Integrations` section in MoovingON AI. - Verify that the named integration (e.g., "Grafana-Integration-test") appears in the list of "Existing integrations" on the screen, as shown below: ![[Existing-Integrations.png]] - If the named integration is visible in the console, it confirms that the Grafana integration has passed the authentication stage. --- ## Troubleshooting - **Common Issues:** - **Problem:** The Webhook URL does not work. **Solution:** Verify that the URL is correctly formatted and that Grafana can access the MoovingON AI API endpoint. --- ## FAQs - **Q:** Can I integrate multiple Grafana instances? **A:** Yes, you can integrate more than one Grafana instance by repeating the integration steps for each. --- ## Related Links - **External Resources:** - [Grafana Webhook Documentation](https://grafana.com/docs/grafana/latest/alerting/notifications/#webhook)