Skip to content

Backend for alignak (REST API for configuration, retention, livestate, logs) based on Python Eve

License

Notifications You must be signed in to change notification settings

Alignak-monitoring-contrib/alignak-backend

Repository files navigation

Alignak Backend

Python Eve REST Backend for Alignak monitoring framework

Develop branch build status Development code static analysis Development code coverage Development documentation Status Most recent PyPi version Join the chat #alignak on freenode.net License AGPL v3

Short description

This package is an Alignak Backend.

It is used to:

  • manage monitoring configuration (hosts, services, contacts, timeperiods...)

    end user (WebUI, alignak-backend-cli, python/php client, curl command line,...) can get, add, edit monitoring configurations elements inner templating system to easily create new hosts, services, users, ... Alignak gets this configuration when its arbiter module starts

  • manage retention

    Alignak saves and loads retention information for checks/hosts/services from the backend

  • manage the monitoring live state

    Alignak add/update states for hosts and services end user (webui, command line...) can get these information

  • manage the metrics from the checks performance data

    Alignak backend automatically send metrics to Graphite / InfluxDB timeseries databases Alignak backend automatically creates Grafana panels for hosts / services metrics

Installation

From Alignak packages repositories

More information in the online Alignak backend documentation. Here is only an abstract...

Debian:

# Alignak DEB stable packages
sudo echo deb https://dl.bintray.com/alignak/alignak-deb-stable xenial main | sudo tee -a /etc/apt/sources.list.d/alignak.list
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv D401AB61

sudo apt-get update
sudo apt install alignak-backend

CentOS:

sudo vi /etc/yum.repos.d/alignak-stable.repo:
   [Alignak-rpm-stable]
   name=Alignak RPM stable packages
   baseurl=https://dl.bintray.com/alignak/alignak-rpm-stable
   gpgcheck=0
   repo_gpgcheck=0
   enabled=1

sudo yum repolist

sudo yum install python-alignak-backend

From PyPI

To install the package from PyPI:

sudo pip install alignak-backend

From source files

To install the package from the source files:

git clone https://github.com/Alignak-monitoring-contrib/alignak-backend
cd alignak-backend
sudo pip install .

Documentation

The Alignak backend documentation is available on Read the docs or in the /docs folder of this repository.

To build the doc:

cd docs
python models_to_rst.py
make clear
make html

Release strategy

Alignak backend and its satellites (backend client, and backend import tools) must all have the same features level. As of it, take care to install the same minor version on your system to ensure compatibility between all the packages. Use 0.4.x version of Backend import and Backend client with a 0.4.x version of the Backend.

Bugs, issues and contributing

Please report any issue using the project issues page.