*Version: 1.0| Last Updated: 14/10/2024*
## Overview
- **Integration Name:** Alertmanager Integration
- **Purpose:** To integrate Alertmanager with MoovingON AI, enabling users to receive alerts through MoovingON AI for efficient monitoring and incident response.
- **Audience:** Support team, TAM
- **Prerequisites:**
- A valid Alertmanager setup
- 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 page, select "Add Webhook."
![[add-webhook.png]]
3. **Step 3:** Enter an integration name for the webhook and click "Submit."
![[Incoming-API-test.png]]
4. **Step 4:** After submission, a webhook basic authentication (Username and Token) will be created. ![[Incoming-API-token.png]]
- Save the generated Username and Token for use in Alertmanager.
5. **Step 5:** Go to Alertmanager’s configuration file.
6. **Step 6:** In Alertmanager’s configuration, add MoovingON AI as a receiver by configuring the API and basic authentication as follows:
```
receivers:
- name: 'moovingon ai'
webhook_configs:
- url: 'https://app.moovingon.ai/api/pushes/?format=json'
send_resolved: true
http_config:
basic_auth:
username: <<webhook_username>>
password: <<webhook_token>>
`
```
7. **Step 7:** Use "moovingon ai" as a receiver in the routes section of Alertmanager’s configuration.
---
## Configuration
- **API Keys/Secrets:** The Username and Token generated in MoovingON AI during the webhook setup will be required for configuring Alertmanager.
- **Settings:** Ensure that the webhook URL in Alertmanager points to MoovingON AI’s API.
---
## Testing the Integration
- **Test Cases:**
1. **Verify if Alertmanager 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 completing the setup, navigate to the `Settings -> Integrations` section in MoovingON AI.
- Verify that the named integration (e.g., "Alertmanager-Integration-test") appears in the list of "Existing integrations."
- If the named integration is visible, it confirms that the Alertmanager integration has passed the authentication stage. ![[existing-integrations.png]]
---
## Troubleshooting
- **Common Issues:**
- **Problem:** Webhook URL does not work.
**Solution:** Verify that the URL is correctly formatted and that Alertmanager can access the MoovingON AI API endpoint.
---
## FAQs
- **Q:** Can I integrate multiple Alertmanager instances?
**A:** Yes, you can integrate more than one Alertmanager instance by repeating the integration steps for each.
---
## Related Links
- **External Resources:**
- [Alertmanager Documentation](https://prometheus.io/docs/alerting/latest/alertmanager/)
---