monitoring-flower

# Flower Monitoring Skill

This skill provides comprehensive templates and configurations for setting up Flower, the real-time monitoring tool for Celery. Includes authentication, custom dashboards, Prometheus metrics integration, and production deployment patterns.

## Overview

Flower is a web-based monitoring and administration tool for Celery that provides:

1. **Real-time Monitoring** - Worker status, task progress, event tracking
2. **Task Management** - View, revoke, and retry tasks
3. **Authentication** - Basic auth, OAuth, and custom authentication
4. **Metrics Export** - Prometheus integration for external monitoring
5. **Custom Dashboards** - Tailored views for specific workflows

This skill covers production-ready Flower deployments with security and scalability.

## Available Scripts

### 1. Start Flower Server

**Script**: `scripts/start-flower.sh <broker-url> <port>`

**Purpose**: Starts Flower monitoring server with proper configuration

**Parameters**:
- `broker-url` - Redis/RabbitMQ broker URL (default: redis://localhost:6379/0)
- `port` - Port to run Flower on (default: 5555)

**Usage**:
```bash
# Start with default settings
./scripts/start-flower.sh

# Start with custom Redis broker
./scripts/start-flower.sh redis://redis:6379/0 5555

# Start with RabbitMQ
./scripts/start-flower.sh amqp://guest:guest@localhost:5672// 5555

# Start with authentication
FLOWER_BASIC_AUTH="user:password" ./scripts/start-flower.sh
```

**Environment Variables**:
- `FLOWER_BASIC_AUTH` - Basic auth credentials (user:password)
- `FLOWER_OAUTH2_REDIRECT_URI` - OAuth2 redirect URI
- `FLOWER_MAX_TASKS` - Maximum tasks to keep in memory (default: 10000)

**Output**: Flower web UI available at http://localhost:5555

### 2. Install Flower as Systemd Service

**Script**: `scripts/flower-systemd.service`

**Purpose**: Systemd service file for production Flower deployment

**Usage**:
```bash
# Copy service file
sudo cp scripts/flower-systemd.service /etc/systemd/system/flower.ser