Zabbix
Шаблон Zabbix для Hubris — баланс, расход, доля ошибок и лимиты ключей через HTTP-агента. Готовый файл импортируется одним действием.
Zabbix читает метрики Hubris HTTP-агентом: узел сети раз в минуту забирает один ответ, а элементы данных достают из него нужные значения. Всё это уже собрано в шаблоне — импортируйте и привяжите к узлу.
Что в шаблоне
| Элемент данных | Что показывает |
|---|---|
| Баланс | Остаток в рублях |
| Расход всего | Списано за всё время; скорость Zabbix считает сам |
| Запросов всего / с ошибкой | Счётчики запросов по исходу |
| Доля ошибок | Процент неуспешных запросов с прошлой проверки |
| Время ответа, 95-й перцентиль | Секунды |
| Ключи с лимитом | Обнаруживаются автоматически: на каждый ключ лимит и истраченное |
Триггеры: баланс ниже порога, метрики не приходят пять минут, доля ошибок выше порога за 15 минут, медленные ответы, а на каждый ключ — «израсходовано больше 90% лимита».
Установка
1. Ключ для мониторинга
На странице Ключи создайте ключ и включите режим только чтение — он видит статистику, но не может потратить баланс. Если Zabbix стоит на вашем сервере, там же привяжите ключ к его адресу.
2. Импорт шаблона
Data collection → Templates → Import, загрузите файл, подтвердите создание элементов и триггеров.
Семь элементов данных, автоматическое обнаружение ключей с лимитом и пять триггеров. Опрос раз в минуту одним запросом.
3. Привязка к узлу и макросы
Привяжите шаблон Hubris by HTTP к любому узлу сети (подойдёт и сам сервер Zabbix) и задайте макросы:
| Макрос | По умолчанию | Зачем |
|---|---|---|
{$HUBRIS.TOKEN} | — | Ключ Hubris. Тип «секретный текст», в интерфейсе не показывается |
{$HUBRIS.URL} | https://api.hubris.pw | Адрес API |
{$HUBRIS.BALANCE.MIN} | 500 | Порог оповещения о балансе, рубли |
{$HUBRIS.ERRORS.MAX} | 5 | Допустимая доля ошибок, проценты |
{$HUBRIS.LATENCY.MAX} | 30 | Порог 95-го перцентиля, секунды |
Проверить, что всё встало: Monitoring → Latest data по узлу — у элемента «Hubris: баланс» должно появиться значение в течение минуты.
Шаблон рассчитан на Zabbix 6.0 и новее: он опирается на предобработку Prometheus pattern и Prometheus to JSON, которые появились в шестой версии.
Если данных нет
- Элемент «получить метрики» с ошибкой. Откройте его в Latest data и посмотрите текст:
401— неверный ключ,403— ключ привязан к другим адресам,429— опрос чаще 30 раз в минуту. - Значения не разбираются. Проверьте, что мастер-элемент возвращает текст, начинающийся с
# HELP hubris_balance_kopecks. Если вместо этого пришёл JSON с ошибкой — дело в ключе. - Ключи не обнаружились. Автоматическое обнаружение берёт только ключи с заданным лимитом расхода; без лимита обнаруживать нечего.
Обновлено: