Alignak Web services module
Important information
This module exposes some Web services as a REST API for the Alignak monitoring framework. Indeed it extends the Alignak receiver existing API with some external new services such as: report an host/service check result, send a command to alignak, get information from Alignak, …
It is important to consider that the services exposed by this module currently implement a very first version developed as a Proof of Concept and that they may be refactored without any ascending compatibility.
If you intend to use the current interface feel free to get in touch and we will keep you informed about the current actions and decisions ;)
Installation
The installation of this module will copy some configuration files in the Alignak default configuration directory (eg. /usr/local/etc/alignak). The copied files are located in the default sub-directory used for the modules (eg. arbiter/modules).
From PyPI
To install the module from PyPI:
sudo pip install alignak-module-ws
From source files
To install the module from the source files (for developing purpose):
git clone https://github.com/Alignak-monitoring-contrib/alignak-module-ws cd alignak-module-ws sudo pip install . -e
Note: using `sudo python setup.py install` will not correctly manage the package configuration files! The recommended way is really to use `pip`;)
Short description
This module for Alignak exposes some Alignak Web Services:
GET / will return the list of the available endpoints
GET /alignak_map that will return the map and status of all the Alignak running daemons
GET /host to get an host information
GET /hostgroup to get an hostgroup information
GET /alignak_logs to view the Alignak events history from an Alignak backend
POST /alignak_command that will notify an external command to the Alignak framework
PATCH /host/<host_name> that allows to send live state for an host and its services, update host custom variables, enable/disable host checks
Configuration
Once installed, this module has its own configuration file in the /usr/local/etc/alignak/arbiter/modules directory. The default configuration file is mod-ws.cfg. This file is commented to help configure all the parameters.
To configure an Alignak daemon (receiver is the recommended daemon) to use this module:
edit your daemon configuration file (eg. receiver-master.cfg)
add your module alias value (web-services) to the modules parameter of the daemon
Note that currently the SSL part of this module has not yet been tested!
Documentation
Alignak Web Service module has an online documentation page.
Click on one of the docs badges on this page to browse the documentation.
Bugs, issues and contributing
Contributions to this project are welcome and encouraged … issues in the project repository are the common way to raise an information.
Release files for alignak_module_ws 1.7.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| alignak_module_ws-1.7.7.tar.gz | 104.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| alignak_module_ws-1.7.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 217.5 kB
Release files / alignak_module_ws-1.7.7.tar.gz
| Download URL | alignak_module_ws-1.7.7.tar.gz |
|---|---|
| Size | 104.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7479bf920f3a33a973177122afce390cf5896460aa1e2d3d2487b0eb4650a1b3
|
|
BLAKE2b-256 checksum How to use checksums |
45dda32976d036ea527ac898801cdd82eb44e640ba0f211392e2c60d0fcb4a7d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.3
|
Release files / alignak_module_ws-1.7.7-py3-none-any.whl
| Download URL | alignak_module_ws-1.7.7-py3-none-any.whl |
|---|---|
| Size | 113.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2ea723b8015f1b9320be9a1fd1f924d55ac535e7ed1d93ded6dcf2408c006d9c
|
|
BLAKE2b-256 checksum How to use checksums |
bbc13765fb266976535c5bfbb8beb102a9768397af6b16614be12383352745ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.2.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.6.3
|
