What is the webservice for passive checks
The receiver daemon has a special module about passive checks. the module is named ws-arbiter and will open by default the 7760 TCP/HTTP port. You will be able to POST your checks into the receiver thanks to this module.
Module configuration
The configuration of this module is loacated in the file /etc/shinken/modules/ws-arbiter.cfg
By default it will be :
define module {
module_name ws-arbiter
module_type ws_arbiter
host 0.0.0.0
port 7760
username anonymous ; If you want auth, set username and password.
#password secret
}
The values will be:
- module_name: set a uniq name for this module
- module_type: must be ws_arbiter
- host: the IP to listen to. 0.0.0.0 means "all interfaces"
- port: TCP to listen to
- username&password: if set to "anonymous" no credentials will be need. If you set a username and a password, then this basic authentification will be used
Example of passive check push:
For an host:
curl -u user:password -d "time_stamp=$(date +%s)&host_name=host-checked&service_description=service-checked&return_code=0" --data-urlencode "output=Everything OK" http://shinken-srv:7760/push_check_result
- time_stamp= epoch of the check
- host_name= name of the host you want to send check to
- service_description = name of the check you want to push result
- return_code= [ 0,1,2,3 ] values for code return.
- output= simple text for your check
Add Comment