Page MenuHomeDevCentral
Files F24895038

README.md
No OneTemporary
Actions

README.md
View Options

# Platform checks
## Introduction
Allow to perform checks on a PaaS.
This is built for the Nasqueron servers infrastructure,
and will be useful on modern platform installations
like microservices, Docker and proxies/load balancers.
Each check is compatible Nagios / NRPE.
## Configuration
Checks can be defined in `/etc/monitoring/checks.yml`.
The format of this file is:
```yaml
checks:
<check_type>:
<key>: <value>
```
You can also use `/usr/local/etc/monitoring/checks.yml` as path,
or `.checks.yml` in the current working directory.
## Checks reference
### check_http_200
Perform a HTTP request to a specific URL. The check success if HTTP code is 200.
#### Available check types
* check_http_200: for sites you test at the back-end level
* check_http_200_alive: for sites returning "ALIVE" as body content
* check_http_200_proxy: flag site as verified at proxy level, not directly at the back-end
* check_http_200_alive_proxy: combine proxy and alive flags
#### Configuration example
```yaml
checks:
check_http_200:
acme: http://localhost:41080/health
cachet: http://localhost:39080/api/v1/ping
check_http_200_proxy:
openfire: https://xmpp.nasqueron.org/login.jsp
check_http_200_alive_proxy:
phabricator: https://devcentral.nasqueron.org/status
```
#### Run the check
From there, you've two ways to run the check:
* one check for all URLs: call `check_http_200` without argument
* one check, one URL: call `check_http_200 <service name>`, for example `check_http_200 openfire`
You can also create a check calling `check_http_200` without argument,
and it will test every site.
## Return values of checks
The checks use the standard Nagios/NRPE exit codes:
| Exit code | Description |
|-----------|-------------------------------------------|
| 0 | OK |
| 1 | Warning |
| 2 | Critical |
| 3 | Unknown, for example a check config issue |
As such they're compatible with Nagios, Incinga, Sensu, Shinken, etc.

File Metadata

Mime Type
text/plain
Expires
Wed, Mar 18, 13:31 (11 h, 12 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
3495771
Default Alt Text
README.md (2 KB)

Event Timeline

Nasqueron DevCentral · If it had been much bigger the moon would have had a core of ice. · Powered by Phabricator