Skip to content

Commit

Permalink
Update documentation. Add few screenshots
Browse files Browse the repository at this point in the history
  • Loading branch information
kuzaxak committed Aug 22, 2019
1 parent 98a668c commit d8dc1f6
Show file tree
Hide file tree
Showing 6 changed files with 13 additions and 4 deletions.
17 changes: 13 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,19 +4,28 @@ Yet another [Prometheus](https://prometheus.io/) Alertmanager webhook processor
## How it works
Receive webhook from Alertmanager, draw images from alert expression, upload pictures to S3 bucket, generate public links, send a notification to Slack.

## Why pormalert?

Standard prometheus slack receiver cant use threads and draw graphs from alert.

Main features:
* Threads to keep alert channel informative
* Updating init firing message, mark it as resolved
* Graph rendering with metric and alert level

### Message logic

Post the new message in case when we can find a reference in the history.
Post the new message in case when we can find a reference in the history [example](docs/images/nan_points_in_metric_graph.png).

Otherwise, based on the status of the message, we apply the following logic:

_Status = Firing_

Post full message to thread with broadcasting. Set refiring footer to last known firing message. Store link to this message in memory (next resolving updates will edit this message).
Post full message to thread with broadcasting. Set refiring footer to last known firing message. Store link to this message in memory (next resolving updates will edit this message) [example](docs/images/refired_message.png).

_Status = Resolved_

Post short message (header + images) to thread. Update footer of last fired message.
Post short message (header + images) to thread [example](docs/images/resolved_thread.png). Update footer of last fired message [example](docs/images/resolved_init_maessage.png).

## Installation

Expand Down Expand Up @@ -104,7 +113,7 @@ Footer template:

Rendered message:

![Demo Message](images/default_message.png)
![Demo Message](docs/images/default_message.png)


## Build
Expand Down
File renamed without changes
Binary file added docs/images/nan_points_in_metric_graph.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/refired_message.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/resolved_init_maessage.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/resolved_thread.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit d8dc1f6

Please sign in to comment.