mirror of
https://github.com/Luzifer/mondash.git
synced 2024-09-19 17:02:58 +00:00
99 lines
3.5 KiB
Plaintext
99 lines
3.5 KiB
Plaintext
FORMAT: 1A
|
|
HOST: https://mondash.org
|
|
|
|
# MonDash
|
|
MonDash is a service for everyone having to display monitoring results to people who have not
|
|
the time or knowledge to get familar with Nagios / Icinga or similar monitoring systems. Therefore
|
|
MonDash provides a simple API to submit monitoring results and a simple dashboard to view those
|
|
results.
|
|
|
|
For the API to work you will need the APIToken assigned to your dashboard. This token is displayed
|
|
on the dashboard itself as long as no metrics are available to display.
|
|
|
|
To start just create a [randomly named dashboard](https://mondash.org/create) or start with a
|
|
named dashboard by simply visiting https://mondash.org/mydashboardname (if you plan to use the
|
|
named version please pay attention this will be easily guessable and you data is lesser protected
|
|
than with the random naming.
|
|
|
|
## Dashboard [/{dashid}]
|
|
|
|
This API controls your dashboard itself
|
|
|
|
+ Parameters
|
|
+ dashid (required, string, `098f6bcd4621d373cade`) ... The id of your dashboard to be found in the URL
|
|
|
|
### Delete your dashboard [DELETE]
|
|
|
|
This request will delete all your monitoring results available on your dashboard and release the
|
|
dashboard URL to the public.
|
|
|
|
_Please pay attention your dashboard URL will be available for others to register immediately
|
|
as we are not storing any data beyond this DELETE request._
|
|
|
|
+ Request
|
|
|
|
+ Header
|
|
|
|
Authorization: MyAPIToken
|
|
|
|
+ Response 200 (text/plain)
|
|
|
|
OK
|
|
|
|
## Metric [/{dashid}/{metricid}]
|
|
|
|
This API controls the metrics on your dashboard
|
|
|
|
+ Parameters
|
|
+ dashid (required, string, `098f6bcd4621d373cade`) ... The id of your dashboard to be found in the URL
|
|
+ metricid (required, string, `beer_available`) ... The unique name for your metric
|
|
|
|
### Submit a monitoring result [PUT]
|
|
+ Request (application/json)
|
|
|
|
+ Header
|
|
|
|
Authorization: MyAPIToken
|
|
|
|
+ Body
|
|
|
|
{
|
|
"title": "Amount of beer in the fridge",
|
|
"description": "Currently there are 12 bottles of beer in the fridge",
|
|
"status": "OK",
|
|
"expires": 604800,
|
|
"freshness": 3600,
|
|
"value": 12.0
|
|
}
|
|
|
|
+ Attributes (object)
|
|
+ title (required, string) - The title of the metric to display on the dashboard
|
|
+ description (required, string) - A descriptive text for the current state of the metric
|
|
+ status (required, enum[string]) - One of: OK, Warning, Critical, Unknown
|
|
+ expires: 604800 (optional, number) - Time in seconds when to remove the metric if there is no update (Valid: `0 < x < 604800`)
|
|
+ freshness: 3600 (optional, number) - Time in seconds when to switch to stale state of there is no update (Valid: `0 < x < 604800`)
|
|
+ ignore_mad: false (optional, boolean) - If set to true the status passed in the update will be used instead of the median absolute deviation
|
|
+ hide_mad: false (optional, boolean) - If set to true the median absolute deviation is hidden on the dashboard for this metric
|
|
+ hide_value: false (optional, boolean) - If set to true the current value will not be shown on the dashboard (useful for checks not having values)
|
|
+ staleness_status: Unknown (optional, string) - If set this status will be set when the metric gets stale (no updates within freshness time range
|
|
|
|
+ Response 200 (text/plain)
|
|
|
|
+ Body
|
|
|
|
OK
|
|
|
|
### Delete a metric from your dashboard [DELETE]
|
|
|
|
+ Request
|
|
|
|
+ Header
|
|
|
|
Authorization: MyAPIToken
|
|
|
|
+ Response 200 (text/plain)
|
|
|
|
+ Body
|
|
|
|
OK
|