go-pkg/asynqmon
2
0
Fork 0
mirror of https://github.com/hibiken/asynqmon.git synced 2025-01-19 03:05:53 +08:00
Code Issues Projects Releases Wiki Activity

Update readme

Browse Source
This commit is contained in:
Ken Hibino 2021-12-19 16:26:45 -08:00
parent 5d1bd3cb55
commit 68e1ce4ee7
1 changed files with 18 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
README.md
View File

@ -1,24 +1,34 @@
<img src="https://user-images.githubusercontent.com/11155743/114745460-57760500-9d57-11eb-9a2c-43fa88171807.png" alt="Asynqmon logo" width="360px" /> <img src="https://user-images.githubusercontent.com/11155743/114745460-57760500-9d57-11eb-9a2c-43fa88171807.png" alt="Asynqmon logo" width="360px" />
# A modern web based tool for monitoring & administrating [Asynq](https://github.com/hibiken/asynq) queues and tasks # A modern web based tool for monitoring & administering [Asynq](https://github.com/hibiken/asynq) queues and tasks
## Overview ## Overview
Asynqmon is a web UI tool for monitoring & administrating [Asynq](https://github.com/hibiken/asynq) queues and tasks. Asynqmon is a web UI tool for monitoring and administering [Asynq](https://github.com/hibiken/asynq) queues and tasks.
It optionally integrates with Prometheus to display time-series data. It supports integration with [Prometheus](https://prometheus.io) to display time-series data.
Asynqmon is both a library that you can include in your web application, as well as a binary that you can simply install and run. Asynqmon is both a library that you can include in your web application, as well as a binary that you can simply install and run.
## Version Compatibility ## Version Compatibility
Please make sure the version compatibility with the Asynq package you are using.
| Asynq version | WebUI (asynqmon) version | | Asynq version | WebUI (asynqmon) version |
| -------------- | ------------------------ | | -------------- | ------------------------ |
| 0.20.x | 0.5.x |
| 0.19.x | 0.4.x | | 0.19.x | 0.4.x |
| 0.18.x | 0.2.x, 0.3.x | | 0.18.x | 0.2.x, 0.3.x |
| 0.16.x, 0.17.x | 0.1.x | | 0.16.x, 0.17.x | 0.1.x |
## Install the binary ## Install the binary
There're a few options to install the binary:
- [Download a release binary](#release-binaries)
- [Download a docker image](#docker-image)
- [Build a binary from source](building-from-source)
- [Build a docker image from source](#building-docker-image-locally)
### Release binaries ### Release binaries
You can download the release binary for your system from the [releases page](https://github.com/hibiken/asynqmon/releases). You can download the release binary for your system from the [releases page](https://github.com/hibiken/asynqmon/releases).
@ -60,10 +70,10 @@ make docker
To use the defaults, simply run and open http://localhost:8080. To use the defaults, simply run and open http://localhost:8080.
```bash ```bash
# with a local binary # with a binary
./asynqmon ./asynqmon
# with docker # with a docker image
docker run --rm \ docker run --rm \
--name asynqmon \ --name asynqmon \
-p 8080:8080 \ -p 8080:8080 \
@ -75,10 +85,10 @@ By default, Asynqmon web server listens on port `8080` and connects to a Redis s
To see all available flags, run: To see all available flags, run:
```bash ```bash
# with a local binary # with a binary
./asynqmon --help ./asynqmon --help
# with Docker # with a docker image
docker run hibiken/asynqmon --help docker run hibiken/asynqmon --help
``` ```
@ -104,7 +114,7 @@ _Note_: Use `--redis-url` to specify address, db-number, and password with one f
The binary supports two flags to enable integration with [Prometheus](https://prometheus.io/). The binary supports two flags to enable integration with [Prometheus](https://prometheus.io/).
First, enable metrics exporter to expose queue metrics to Prometheus server by passing `--enable-metrics-exporter` flag. First, enable metrics exporter to expose queue metrics to Prometheus server by passing `--enable-metrics-exporter` flag.
The metrics data is now available under `/metrics` for Prometheus to scape. The metrics data is now available under `/metrics` for Prometheus server to scrape.
Once the metrics data is collected by a Prometheus server, you can pass the address of the Prometheus server to asynqmon to query the time-series data. Once the metrics data is collected by a Prometheus server, you can pass the address of the Prometheus server to asynqmon to query the time-series data.
The address can be specified via `--prometheus-addr`. This enables the metrics view on the Web UI. The address can be specified via `--prometheus-addr`. This enables the metrics view on the Web UI.