5cd001daee
A URL can contain all of the information in the individual flags as a single string rather than as separate pieces. I've mostly run into URLs pointing to Redis and this make those existing URLs easier to work with. This also introduces the -redis-insecure-tls flag which turns off TLS certificate hostname verification. We've chosen Heroku Redis for a recent project which requires TLS but, for reasons I don't know, they don't provide a certificate that is valid for the hostname. I also wasn't able to get the existing -redis-tls flag to work. |
||
---|---|---|
.github | ||
ui | ||
.dockerignore | ||
.gitignore | ||
CHANGELOG.md | ||
conversion_helpers.go | ||
Dockerfile | ||
go.mod | ||
go.sum | ||
LICENSE | ||
main.go | ||
Makefile | ||
middlewares.go | ||
queue_handlers.go | ||
README.md | ||
redis_info_handlers.go | ||
scheduler_entry_handlers.go | ||
server_handlers.go | ||
task_handlers.go |
A modern web based tool for monitoring & administrating Asynq queues, tasks and message broker
☝️ Important Note: Current version of Asynqmon is compatible with Asynq
v0.15.x
or above.
Install
Release binaries
You can download the release binary for your system from the releases page.
Docker image
To pull the Docker image:
# Pull the latest image
docker pull hibiken/asynqmon
# Or specify the image by tag
docker pull hibiken/asynqmon[:tag]
Building from source
To build Asynqmon from source code, make sure you have Go installed (download). Version 1.16
or higher is required. You also need Node.js and Yarn installed in order to build the frontend assets.
Download the source code of this repository and then run:
make build
The asynqmon
binary should be created in the current directory.
Building Docker image locally
To build Docker image locally, run:
make docker
Run
To use the defaults, simply run and open http://localhost:8080.
# with a local binary
./asynqmon
# with docker
docker run --rm \
--name asynqmon \
-p 8080:8080 \
hibiken/asynqmon
By default, Asynqmon web server listens on port 8080
and connects to a Redis server listening on 127.0.0.1:6379
.
Pass flags to specify port, redis server address, etc.
# with a local binary
./asynqmon --port=3000 --redis_addr=localhost:6380
# with Docker (connect to a Redis server running on the host machine)
docker run --rm \
--name asynqmon \
-p 3000:3000 \
hibiken/asynqmon --port=3000 --redis_addr=host.docker.internal:6380
# with Docker (connect to a Redis server running in the Docker container)
docker run --rm \
--name asynqmon \
--network dev-network \
-p 8080:8080 \
hibiken/asynqmon --redis_addr=dev-redis:6379
To see all available flags, run:
# with a local binary
./asynqmon --help
# with Docker
docker run hibiken/asynqmon --help
Next, go to localhost:8080 and see Asynqmon dashboard:
Tasks view
Settings and adaptive dark mode
License
Copyright (c) 2019-present Ken Hibino and Contributors. Asynqmon
is free and open-source software licensed under the MIT License. Official logo was created by Vic Shóstak and distributed under Creative Commons license (CC0 1.0 Universal).