Integrate Monika with Atlassian Statuspage
At Hyperjump, one of our priorities is improving Monika integrations with many collaboration tools. We have successfully integrated Monika with Telegram Bots, Slack, Microsoft Teams, Discord, and even WhatsApp too. In November 2022, we added Atlassian Statuspage to Monika’s growing channel choice.
Taken from their official website, Atlassian Statuspage is the communication piece of your incident management process. Statuspage integrates with your favorite monitoring, alerting, chat, and help desk tools for efficient response every time. Using Atlassian Statuspage, you can get notifications from Monika by using it as a notification channel.
This article will show you how to integrate Monika with Atlassian Statuspage to get your Monika notifications through their dashboard. So, without further ado:
Setup Atlassian Statuspage
We need to create an account before we can use Atlassian Statuspage as a Monika notification channel. Head over to their registration page to create an account. Then, set up your account using their wizard before we proceed to the next steps.
After you have finished the wizard, you will be redirected to the dashboard. Now, you need to get the page ID. The Page ID is located in your browser.
If we take a look at the example above, the Page ID is r2s4gntm6sds. Using the same method, you should be able to locate your Page ID. Save your Page ID somewhere else because we are going to need it later.
Next, we need to get our API Key. Hover the avatar on the top left of the dashboard, and select API Info. Then, copy the organization API Key and save it somewhere else. Now that we have our Page ID and API Key, it’s time to integrate with Monika.
P.S: You can also check your Page ID inside the API Info page, too.
Integrating Atlassian Statuspage with Monika
Monika is an open-source and free synthetic monitoring command-line application. The name Monika stands for “Monitoring Berkala” in Bahasa Indonesia, which means “periodic monitoring”.
With Monika, you can add as many websites as you want to monitor. You can monitor several conditions such as service outages or slow services. Also, you can configure Monika to send notifications of the incidents on your services through your favorite communication tools like SMTP mail, WhatsApp (it’s free!), Microsoft Teams, Slack, and many more.
There are many ways to install Monika, from Node Package Manager (NPM), downloading binaries from the Monika release page, to package managers such as Homebrew or Snapcraft.
Let’s create a configuration using the Page ID and the API key we previously saved.
This Monika configuration will:
- Use Atlassian Status[age as a notification channel with the provided page ID and API Key
- Monitor https://github.com at ten seconds interval, and will notify you if there are five consecutive times incidents/recoveries
- Use default Monika alerts, which are response time is longer than two seconds, and the response status code is not 200.
Once we are ready, it’s time to run Monika with the configuration above by running monika -c monika.yml in your terminal. When there is an alert or an incident, it will show up in your dashboard.
The same goes if the service has gone back up, you will see it in the Incidents tab saying that the service is up again.
You can see the alert details by clicking on the alert. There you will see the incident history and you can add the postmortem.
Congratulations! You have successfully integrated Monika with Atlassian Statuspage!
Closing
Aside from being a notification channel for Monika, you can create and embed a status page of your probes anywhere using Atlassian Statuspage. Keep in mind that Statuspage is an Atlassian product, so integrating with other Atlassian products such as Jira and Bitbucket will be so much easier. Shoutout to Hari Cahya Nugraha for making this integration possible!
If you’re having a problem with using Monika, don’t hesitate to create an issue on Monika’s Github Issue Page. If you like this article, don’t forget to clap and share this article with your friends!
That’s it for today, see you next time!
Hyperjump is an open-source-first company providing engineering excellence service. We aim to build and commercialize open-source tools to help companies streamline, simplify, and secure the most important aspects of their modern DevOps practices.
