Мониторинг и отчёты

Проверить глубину очереди

Читает RabbitMQ Management API и сравнивает число сообщений и потребителей с порогами.

Shell Linux macOS Продвинутый
Скачать queue_depth.sh
Описание

Что делает скрипт

Скрипт запрашивает сведения о конкретной очереди, извлекает messages, ready, unacknowledged и consumers через jq. Пароль берется из RABBIT_PASSWORD или запрашивается интерактивно. Превышение порога сообщений или отсутствие потребителей дает ошибку.

Перед запуском
  • Пароль RabbitMQ не хранится в скрипте: задайте RABBIT_PASSWORD или введите его при запуске.
Запуск

Быстрый старт

bash queue_depth.sh --url http://127.0.0.1:15672/api/queues/%2F/app

Скачайте файл, откройте терминал в папке со скриптом и выполните команду.

Примеры

Другие варианты

  • bash queue_depth.sh --url http://127.0.0.1:15672/api/queues/%2F/app --warn 100 --crit 500
  • RABBIT_USER=monitor bash queue_depth.sh --url http://127.0.0.1:15672/api/queues/%2F/app --min-consumers 2
Зависимости

Что понадобится

Bash 4+ Стандартные утилиты: awk, grep, sed, find, coreutils
Linux sudo apt install bash
macOS brew install bash
curl
Linux sudo apt install curl
macOS brew install curl
jq
Linux sudo apt install jq
macOS brew install jq
Исходник

queue_depth.sh

#!/usr/bin/env bash
set -euo pipefail

usage() {
    echo "Использование: $0 --url <API очереди> [--user monitor] [--warn 100] [--crit 500] [--min-consumers 1]"
}

url="http://127.0.0.1:15672/api/queues/%2F/app"
user="${RABBIT_USER:-monitor}"
warn="100"
crit="500"
min_consumers="1"

while [[ $# -gt 0 ]]; do
    case "$1" in
        --url) url="${2:-}"; shift 2 ;;
        --user) user="${2:-}"; shift 2 ;;
        --warn) warn="${2:-}"; shift 2 ;;
        --crit) crit="${2:-}"; shift 2 ;;
        --min-consumers) min_consumers="${2:-}"; shift 2 ;;
        -h|--help) usage; exit 0 ;;
        *) echo "Неизвестный аргумент: $1" >&2; usage >&2; exit 2 ;;
    esac
done

if ! command -v jq >/dev/null 2>&1; then
    echo "Не найден jq" >&2
    exit 3
fi
if ! command -v curl >/dev/null 2>&1; then
    echo "Не найден curl" >&2
    exit 3
fi

password="${RABBIT_PASSWORD:-}"
if [[ -z "$password" ]]; then
    if [[ -t 0 ]]; then
        read -r -s -p "Пароль RabbitMQ для $user: " password
        echo
    else
        echo "Задайте RABBIT_PASSWORD" >&2
        exit 3
    fi
fi

tmp="$(mktemp)"
trap 'rm -f "$tmp"' EXIT

if ! curl -fsS --max-time 10 -u "$user:$password" "$url" >"$tmp" 2>&1; then
    echo "CRITICAL: не удалось прочитать очередь" >&2
    cat "$tmp" >&2
    exit 2
fi

messages="$(jq -r '.messages // 0' "$tmp")"
ready="$(jq -r '.messages_ready // 0' "$tmp")"
unacked="$(jq -r '.messages_unacknowledged // 0' "$tmp")"
consumers="$(jq -r '.consumers // 0' "$tmp")"

printf 'Очередь: %s\nСообщений: %s (ready %s, unacked %s)\nПотребителей: %s\n' \
    "$url" "$messages" "$ready" "$unacked" "$consumers"

status=0
if (( messages >= crit )); then
    status=2
elif (( messages >= warn )); then
    status=1
fi
if (( consumers < min_consumers )); then
    status=2
fi

case "$status" in
    0) echo "OK" ;;
    1) echo "WARNING: очередь растет" ;;
    *) echo "CRITICAL: очередь переполнена или нет потребителей" ;;
esac
exit "$status"

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get monitoring-queue-depth
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Мониторинг и отчёты

Сбор метрик, проверка доступности, отчёты и уведомления.