Skip to main content

rq-dashboard-fast is a FastAPI-based dashboard to monitor your Redis-Queue (RQ) Jobs, Queues, and Workers

Project description

RQ Dashboard FastAPI 🛠

Redis FastAPI Python

RQ Dashboard FastAPI is a general purpose, lightweight FastAPI-based web frontend to monitor your RQ queues, jobs, and workers in real-time. Goal of this package is to ease integration into FastAPI-Applications and provide a Docker Image for convenience.

Screenshot 2024-02-09 at 18 14 13

Featured in Related Projects Redis Queue Docs

Example Usage

from fastapi import FastAPI
from rq_dashboard_fast import RedisQueueDashboard
import uvicorn

app = FastAPI()
dashboard = RedisQueueDashboard("redis://redis:6379/", "/rq")

app.mount("/rq", dashboard)

if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)

Access the Dashboard at

http://127.0.0.1:8000/rq

Installing from PyPi

PyPi: rq-dashboard-fast

$ pip install rq-dashboard-fast

Running Standalone

After installing, you can run the dashboard directly from the terminal:

$ rq-dashboard-fast

This starts the dashboard at http://localhost:8000/rq using Redis at redis://localhost:6379.

Available options:

$ rq-dashboard-fast --help
$ rq-dashboard-fast --redis-url redis://my-redis:6379 --port 9000
$ rq-dashboard-fast --host 127.0.0.1 --prefix /dashboard
Flag Default Environment Variable
--redis-url redis://localhost:6379 REDIS_URL
--host 0.0.0.0 FASTAPI_HOST
--port 8000 FASTAPI_PORT
--prefix /rq

Running in Docker

  1. You can run the RQ Dashboard FastAPI as a Docker container with custom Redis URL:
docker run -e REDIS_URL=<your_redis_url> hannes221/rq-dashboard-fast

Access the Dashboard at

http://127.0.0.1:8000/rq

To change change the port, you can specify the following flag:

docker run -e REDIS_URL=<your_redis_url>  -e FASTAPI_PORT=<your_fastapi_port> hannes221/rq-dashboard-fast

Replace <your_fastapi_port> with your desired FastAPI and host port.

  1. You can use Docker Compose by creating a docker-compose.yml file:
services:
  dashboard:
    image: hannes221/rq-dashboard-fast
    ports:
      - '8000:8000'
    environment:
      - REDIS_URL=<your_redis_url>

Then run:

docker compose up

Access the Dashboard at

http://127.0.0.1:8000/rq

To change the part update the compose file:

services:
  dashboard:
    image: hannes221/rq-dashboard-fast
    ports:
      - '<your_fastapi_port>:<your_fastapi_port>'
    environment:
      - REDIS_URL=<your_redis_url>
      - FASTAPI_PORT=<your_fastapi_port>

Replace <your_fastapi_port> with your desired FastAPI and host port.

Docker Hub: hannes221/rq-dashboard-fast

Github Repository

Github: rq-dashboard-fast

$ pip install rq-dashboard-fast

Planned Features

  • Data from rq-scheduler
  • More data about workers
  • Docker Image
  • Add pagination to jobs page
  • Data Export
  • Statistics Tab
  • Run Standalone (Terminal)

Contributing

If you want to contribute, reach out or create a PR directly.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rq_dashboard_fast-0.6.1.tar.gz (16.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rq_dashboard_fast-0.6.1-py3-none-any.whl (22.7 kB view details)

Uploaded Python 3

File details

Details for the file rq_dashboard_fast-0.6.1.tar.gz.

File metadata

  • Download URL: rq_dashboard_fast-0.6.1.tar.gz
  • Upload date:
  • Size: 16.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for rq_dashboard_fast-0.6.1.tar.gz
Algorithm Hash digest
SHA256 6efde874e88519b237b7c63e5b0cee679ee6883f3b09c4919fb8fc2419f2f781
MD5 b359f2f7af392568534b0a7be8d0ac74
BLAKE2b-256 d67dbba3f2fa91f597885961067eb92e06be19d6dee4616c96a6026d532c2107

See more details on using hashes here.

Provenance

The following attestation bundles were made for rq_dashboard_fast-0.6.1.tar.gz:

Publisher: docker-pypi-publish.yml on Hannes221/rq-dashboard-fast

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rq_dashboard_fast-0.6.1-py3-none-any.whl.

File metadata

File hashes

Hashes for rq_dashboard_fast-0.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 83ad82e8a3299c2e0a9e8d23a475a69bcd82c02c5bdc8904cc96f4c007c69b21
MD5 a387017b453314469cb1437442fe13b3
BLAKE2b-256 7e71d64f21ecca1b6ab064695b1141c6b774092235052c3db664a81cacab4a07

See more details on using hashes here.

Provenance

The following attestation bundles were made for rq_dashboard_fast-0.6.1-py3-none-any.whl:

Publisher: docker-pypi-publish.yml on Hannes221/rq-dashboard-fast

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page