https://github.com/moira-alert/moira

Realtime Alerting for Graphite and Prometheus
https://github.com/moira-alert/moira

alerting graphite moira monitoring prometheus victoriametrics

Last synced: 4 days ago
JSON representation

Realtime Alerting for Graphite and Prometheus

• Host: GitHub
• URL: https://github.com/moira-alert/moira
• Owner: moira-alert
• License: mit
• Created: 2017-07-03T07:54:55.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2025-05-14T07:51:56.000Z (5 days ago)
• Last Synced: 2025-05-14T08:46:27.723Z (5 days ago)
• Topics: alerting, graphite, moira, monitoring, prometheus, victoriametrics
• Language: Go
• Homepage:
• Size: 17.1 MB
• Stars: 307
• Watchers: 15
• Forks: 70
• Open Issues: 94
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Support: support/trigger.go
  • Authors: AUTHORS.md

Awesome Lists containing this project

README

        
# Moira 2.0 ![Build Status](https://github.com/moira-alert/moira/actions/workflows/test.yml/badge.svg?branch=master) [![codecov](https://codecov.io/gh/moira-alert/moira/branch/master/graph/badge.svg)](https://codecov.io/gh/moira-alert/moira) [![Documentation Status](https://readthedocs.org/projects/moira/badge/?version=latest)](http://moira.readthedocs.io/en/latest/?badge=latest) [![Telegram](https://img.shields.io/badge/telegram-join%20chat-3796cd.svg)](https://t.me/moira_alert) [![Go Report Card](https://goreportcard.com/badge/github.com/moira-alert/moira)](https://goreportcard.com/report/github.com/moira-alert/moira)

Moira is a real-time alerting tool, based on [Graphite](https://graphite.readthedocs.io) or [Prometheus](https://prometheus.io/)/[VictoriaMetrics](https://victoriametrics.com/) metrics.

## Installation

Docker Compose is the easiest way to try:

```bash

git clone https://github.com/moira-alert/docker-compose.git

cd docker-compose

docker-compose pull

docker-compose up

```

See more on our [documentation page](https://moira.readthedocs.io/en/latest/installation/index.html).

Feed data in Graphite format to `localhost:2003`:

```bash

echo "local.random.diceroll 4 `date +%s`" | nc localhost 2003

```

Configure triggers at `localhost:8080` using your browser.

Other installation methods are available, see [documentation](https://moira.readthedocs.io/en/latest/installation/index.html).

## Contribution

Check our [contribution guideline](.github/CONTRIBUTING.md)

## Getting Started

See our [user guide](https://moira.readthedocs.io/en/latest/user_guide/index.html) that is based on a number of real-life scenarios, from simple and universal to complicated and specific.

## What is in the other repositories

Code in this repository is the backend part of Moira monitoring application.

* [web2.0](https://github.com/moira-alert/web2.0) is the frontend part.

* [doc](https://github.com/moira-alert/doc) is the documentation (hosted on [Read the Docs](https://moira.readthedocs.io)).

* [moira-trigger-role](https://github.com/moira-alert/moira-trigger-role) is the Ansible role you can use to manage triggers.

* [python-moira-client](https://github.com/moira-alert/python-moira-client) is the Python API client.

* [go-client](https://github.com/moira-alert/client-go) is the GO API client.

## Contact us

If you have any questions, you can ask us on [Telegram](https://t.me/moira_alert).

## Thanks

![SKB Kontur](https://kontur-inc.com/theme/ver-1633004215/images/logo/kontur-en-36.svg)

Moira was originally developed and is supported by [SKB Kontur](https://kontur.ru/eng/about), a B2G company based in Ekaterinburg, Russia. We express gratitude to our company for encouraging us to opensource Moira and for giving back to the community that created [Graphite](https://graphite.readthedocs.io) and many other useful DevOps tools.