Skip to content

Commit

Permalink
Update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
nook24 committed Jul 27, 2017
1 parent 487b052 commit fb66cb9
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 31 deletions.
44 changes: 17 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,23 @@
# Alpha code
This is alpha code! May be things are broken, not implemented or got removed with the stable version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License 3 for more details.
# Statusengine Worker
Statusengine Worker is a PHP application that will consume the events provided by the Statusengine Broker Module.
All status data are save in a database (CrateDB, MySQL or Redis)
In addition, the Worker is able to parse and process performance data to store them in a time series databases like Graphite.

For External Command Routing, it is required to run Statusengine Worker on the same node as your monitoring core is running.

# Requirements
Visit the [documentation](https://statusengine.org/) for more information about Statusengine Worker


## Requirements
- PHP's composer
- CrateDB or MySQL
- Redis
- php >= 5.5.9
- Ubuntu 14.04, 16.04 or 16.10

# Install (Ubuntu 14.04)
## Install (Ubuntu 14.04)
````
apt-get install redis-server php5-redis git
apt-get install redis-server php5-redis git php5-gearman
mkdir -p /opt/statusengine
cd /opt/statusengine
Expand All @@ -24,43 +27,30 @@ chmod +x worker/bin/*
composer install
````

# Config
## Config
````
cp worker/etc/config.yml.example worker/etc/config.yml
````
Change `node_name` to a unique name in your monitoring cluster!

# Add node to the cluster
## Add node to the cluster
````
php bin/Console.php cluster add --nodename NODENAME
````

# Usage
## Usage
````
/opt/statusengine/worker/bin/StatusengineWorker.php
````

# Proxy warnign
## Proxy warnign
If you are behind a proxy, set `no_proxy=127.0.0.1,localhost` in your `/etc/environment`!

# Statusengine statistics
## Statusengine statistics
````
/opt/statusengine/worker/bin/bin/Console.php statistics --watch 5
````

# ToDos
* [x] Add Downtimes
* [X] Add Acknowledgements
* [x] Add Notifications
* [x] Add Graphite
* [x] Implement Query Error handling
* [x] Add Syslog support
* [ ] ~~More tests~~
* [ ] init/systemd support
* [x] Cronjob to cleanup database
* [x] Delete old performance data records in CrateDB via cron
* [x] Implement External Command File


### Delete node from the cluster
````
Expand Down
6 changes: 3 additions & 3 deletions composer.json
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
{
"name": "Statusengine Redis Worker",
"name": "Statusengine Worker",
"description": "The missing event broker + responsive web frontend for Nagios and Naemon",
"version": "2",
"version": "3",
"homepage": "https://statusengine.org/",
"license": "GPLv2",
"license": "GPLv3",
"authors": [
{
"name": "Daniel Ziegler (nook24)",
Expand Down
2 changes: 1 addition & 1 deletion etc/config.yml.example
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ process_perfdata: 0

# Number of worker processes for service check results
# Target: You selected this at 'perfdata_backend' option
number_perfdata_worker: 2
number_perfdata_worker: 1

# Uncomment to enable
# You can enable as much backends as you want
Expand Down

0 comments on commit fb66cb9

Please sign in to comment.