Skip to content

Commit

Permalink
Add Grafana Dashboard
Browse files Browse the repository at this point in the history
  • Loading branch information
dewey committed Aug 19, 2018
1 parent e9ceed5 commit 1ad2c38
Show file tree
Hide file tree
Showing 3 changed files with 473 additions and 4 deletions.
18 changes: 16 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,20 +24,34 @@ Returns the feed based on a given plugin and output format. That's the URL you s
- `plugin`: The name of the plugin as returned by `String()`
- `format`: The format the feed should be returned in, can be `rss`, `atom` or `json`. By default it's RSS.

**GET /metrics**

Returns the exported Prometheus metrics.

## Configuration and Operation

### Environment

The following environment variables are available, they all have sensible defaults and don't need to be set explicity.

- `REFRESH_INTERVAL`: The interval in which feeds get rescraped in minutes (Default: 15)
- `CACHE_EXPIRATION`: The expiration time of the cache in minutes (Default: 30)
- `CACHE_EXPIRED_PURGE`: The interval at which the expired cache elements will be purged in minutes (Default: 60)
- `ENVIRONMENT`: The environment it's deployed in, `prod` and `develop` are possible values. `develop` sets the loglevel to `info` (Default: `develop`)
- `ENVIRONMENT`: Environment can be `prod` or `develop`. `develop` sets the loglevel to `info` (Default: `develop`)
- `PORT`: Port that feedbridge is running on (Default: `8080`)

### Run with Docker

You can change all these options in the included `docker-compose.yml` file and use `docker-compose -f docker-compose.yml up -d` to run the project.

### Monitoring

As the project already exports Prometheus metrics you can use Grafana to get more information about how many things are being scraped and how fast requests are served. You can import the included `grafana-dashboard.json` in Grafana.

## Status

This is a work in progress and pretty rough right now. The API might change and things get moved around.

## Acknowledgements & Credits

It's using the neat [gorilla/feeds](https://github.com/gorilla/feeds) library to generate standard conform Atom, RSS 2.0 and JSON Feeds. The Gopher was sourced from [github.com/egonelbre](https://github.com/egonelbre/gophers), the RSS icon is coming from Wikipedia and was added by me. Thanks!
It's using the neat [gorilla/feeds](https://github.com/gorilla/feeds) library to generate standard conform Atom, RSS 2.0 and JSON Feeds. The Gopher was sourced from [github.com/egonelbre](https://github.com/egonelbre/gophers), the RSS icon is coming from Wikipedia and was added by me. Thanks!
Loading

0 comments on commit 1ad2c38

Please sign in to comment.