uptime-kuma

uptime-kuma

Автор: msarheed · Категория: System & DevOps

Инструмент для взаимодействия с сервером мониторинга Uptime Kuma. Используется для проверки статуса мониторов, добавления и удаления проверок, управления их состоянием (пауза/возобновление), а также просмотра истории heartbeat. :

О проекте uptime-kuma

Данный навык предоставляет удобный интерфейс для работы с системой мониторинга Uptime Kuma через CLI. Он позволяет автоматизировать управление мониторингом сервисов и инфраструктуры, сокращая необходимость ручной работы через веб-интерфейс. :

Установка

openclaw skills install uptime-kuma

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

# После установки используйте команду
openclaw uptime-kuma --help

Основные возможности

• Простая установка и настройка
• Бесшовная интеграция с OpenClaw
• Открытый исходный код и поддержка сообщества
• Интеграция с другими навыками экосистемы

Ключевые функции

• Проверка общего статуса мониторинга
• Просмотр списка всех мониторов
• Получение подробной информации о конкретном мониторинге
• Добавление новых мониторов (HTTP, ping, порт и др.)
• Удаление мониторов
• Пауза и возобновление проверок
• Просмотр истории heartbeat
• Работа с каналами уведомлений

Примеры команд

# Общий статус
python scripts/kuma.py status

# Список мониторов
python scripts/kuma.py list
python scripts/kuma.py list --json

# Детали монитора
python scripts/kuma.py get 

# Добавление мониторов
python scripts/kuma.py add --name "My Site" --type http --url https://example.com
python scripts/kuma.py add --name "Server Ping" --type ping --hostname 192.168.1.1
python scripts/kuma.py add --name "SSH Port" --type port --hostname server.local --port 22

# Пауза и возобновление
python scripts/kuma.py pause 
python scripts/kuma.py resume 

# Удаление
python scripts/kuma.py delete 

# История heartbeat
python scripts/kuma.py heartbeats  --hours 24

# Уведомления
python scripts/kuma.py notifications

Типы мониторинга

• http — проверка HTTP/HTTPS
• ping — ICMP-пинг
• port — проверка TCP-порта
• keyword — поиск ключевого слова
• dns — проверка DNS
• docker — контейнеры Docker
• push — пассивный мониторинг
• mysql / postgres / mongodb / redis — базы данных
• mqtt — брокер MQTT
• group — группы мониторов

Типовые сценарии использования

Проверка состояния сервисов:

python scripts/kuma.py status
python scripts/kuma.py list

Добавление HTTP-монитора:

python scripts/kuma.py add --name "API Health" --type http --url https://api.example.com/health --interval 30

Режим обслуживания (пауза всех проверок):

for id in $(python scripts/kuma.py list --json | jq -r '.[].id'); do
 python scripts/kuma.py pause $id
done

Настройка

Для работы требуется Python-пакет uptime-kuma-api:

pip install uptime-kuma-api

Также необходимо задать переменные окружения:

• UPTIME_KUMA_URL — URL сервера
• UPTIME_KUMA_USERNAME — имя пользователя
• UPTIME_KUMA_PASSWORD — пароль

Скрипты находятся в директории scripts/kuma.py и обеспечивают полный контроль над системой мониторинга. :