mirror of
https://github.com/mtan93/cachet-url-monitor.git
synced 2026-03-08 05:31:58 +00:00
117 lines
5.9 KiB
Markdown
117 lines
5.9 KiB
Markdown
# Status
|
|
[](https://circleci.com/gh/mtakaki/cachet-url-monitor/tree/master)
|
|
[](https://coveralls.io/github/mtakaki/cachet-url-monitor?branch=master)
|
|
[](https://www.codacy.com/app/mitsuotakaki/cachet-url-monitor?utm_source=github.com&utm_medium=referral&utm_content=mtakaki/cachet-url-monitor&utm_campaign=Badge_Grade)
|
|
[](https://hub.docker.com/r/mtakaki/cachet-url-monitor/)
|
|
[](https://hub.docker.com/r/mtakaki/cachet-url-monitor/)
|
|
|
|
[](https://pypi.python.org/pypi/cachet-url-monitor)
|
|
|
|
cachet-url-monitor
|
|
========================
|
|
Python plugin for [cachet](cachethq.io) that monitors an URL, verifying it's response status and latency. The frequency the URL is tested is configurable, along with the assertion applied to the request response.
|
|
|
|
This project is available at PyPI: [https://pypi.python.org/pypi/cachet-url-monitor](https://pypi.python.org/pypi/cachet-url-monitor)
|
|
|
|
## Configuration
|
|
|
|
```yaml
|
|
endpoint:
|
|
url: http://www.google.com
|
|
method: GET
|
|
header:
|
|
SOME-HEADER: SOME-VALUE
|
|
timeout: 1 # seconds
|
|
expectation:
|
|
- type: HTTP_STATUS
|
|
status_range: 200-300
|
|
incident: MAJOR
|
|
- type: LATENCY
|
|
threshold: 1
|
|
- type: REGEX
|
|
regex: ".*<body>.*"
|
|
allowed_fails: 0
|
|
cachet:
|
|
api_url: http://status.cachethq.io/api/v1
|
|
token: my_token
|
|
component_id: 1
|
|
metric_id: 1
|
|
action:
|
|
- CREATE_INCIDENT
|
|
- UPDATE_STATUS
|
|
public_incidents: true
|
|
latency_unit: ms
|
|
frequency: 30
|
|
```
|
|
|
|
- **endpoint**, the configuration about the URL that will be monitored.
|
|
- **url**, the URL that is going to be monitored.
|
|
- **method**, the HTTP method that will be used by the monitor.
|
|
- **header**, client header passed to the request. Remove if you do not want to pass a header.
|
|
- **timeout**, how long we'll wait to consider the request failed. The unit of it is seconds.
|
|
- **expectation**, the list of expectations set for the URL.
|
|
- **HTTP_STATUS**, we will verify if the response status code falls into the expected range. Please keep in mind the range is inclusive on the first number and exclusive on the second number. If just one value is specified, it will default to only the given value, for example `200` will be converted to `200-201`.
|
|
- **LATENCY**, we measure how long the request took to get a response and fail if it's above the threshold. The unit is in seconds.
|
|
- **REGEX**, we verify if the response body matches the given regex.
|
|
- **allowed_fails**, create incident/update component status only after specified amount of failed connection trials.
|
|
- **cachet**, this is the settings for our cachet server.
|
|
- **api_url**, the cachet API endpoint.
|
|
- **token**, the API token.
|
|
- **component_id**, the id of the component we're monitoring. This will be used to update the status of the component.
|
|
- **metric_id**, this will be used to store the latency of the API. If this is not set, it will be ignored.
|
|
- **action**, the action to be done when one of the expectations fails. This is optional and if left blank, nothing will be done to the component.
|
|
- **CREATE_INCIDENT**, we will create an incident when the expectation fails.
|
|
- **UPDATE_STATUS**, updates the component status
|
|
- **public_incidents**, boolean to decide if created incidents should be visible to everyone or only to logged in users. Important only if `CREATE_INCIDENT` or `UPDATE_STATUS` are set.
|
|
- **latency_unit**, the latency unit used when reporting the metrics. It will automatically convert to the specified unit. It's not mandatory and it will default to **seconds**. Available units: `ms`, `s`, `m`, `h`.
|
|
- **frequency**, how often we'll send a request to the given URL. The unit is in seconds.
|
|
|
|
Each `expectation` has their own default incident status. It can be overridden by setting the `incident` property to any of the following values:
|
|
- `PARTIAL`
|
|
- `MAJOR`
|
|
- `PERFORMANCE`
|
|
|
|
By choosing any of the aforementioned statuses, it will let you control the kind of incident it should be considered. These are the default incident status for each `expectation` type:
|
|
|
|
| Expectation | Incident status |
|
|
| ----------- | --------------- |
|
|
| HTTP_STATUS | PARTIAL |
|
|
| LATENCY | PERFORMANCE |
|
|
| REGEX | PARTIAL |
|
|
|
|
## Setting up
|
|
|
|
The application should be installed using **virtualenv**, through the following command:
|
|
|
|
```
|
|
$ git clone https://github.com/mtakaki/cachet-url-monitor.git
|
|
$ virtualenv cachet-url-monitor
|
|
$ cd cachet-url-monitor
|
|
$ source bin/activate
|
|
$ pip install -r requirements.txt
|
|
$ python3 setup.py install
|
|
```
|
|
|
|
To start the agent:
|
|
|
|
```
|
|
$ python3 cachet_url_monitor/scheduler.py config.yml
|
|
```
|
|
|
|
## Docker
|
|
|
|
You can run the agent in docker, so you won't need to worry about installing python, virtualenv, or any other dependency into your OS. The `Dockerfile` is already checked in and it's ready to be used.
|
|
|
|
You have two choices, checking this repo out and building the docker image or it can be pulled directly from [dockerhub](https://hub.docker.com/r/mtakaki/cachet-url-monitor/). You will need to create your own custom `config.yml` file and run (it will pull latest):
|
|
|
|
```
|
|
$ docker pull mtakaki/cachet-url-monitor
|
|
$ docker run --rm -it -v "$PWD":/usr/src/app/config/ mtakaki/cachet-url-monitor
|
|
```
|
|
|
|
If you're going to use a file with a name other than `config.yml`, you will need to map the local file, like this:
|
|
|
|
```
|
|
$ docker run --rm -it -v "$PWD"/my_config.yml:/usr/src/app/config/config.yml:ro mtakaki/cachet-url-monitor
|
|
```
|