Диагностика работы дашбордов

Владелец или администратор организации может запросить сводное состояние дашбордов через GET /api/v1/organizations/:orgId/dashboard-ops. Ответ помогает отличить медленные запросы, ошибки источников, проблемы кэша, частые отказы в доступе и отказы в доступе.

API возвращает только агрегаты выбранной организации. В нём нет результатов блоков, фильтров, адресов, токенов, учётных данных, email или идентификаторов отдельных дашбордов и пользователей.

Для запроса нужен вход и права владельца или администратора этой организации. Доступность инструкции не даёт доступа к данным других организаций.

1. Используйте учётную запись владельца или администратора нужной организации.
2. Выполните запрос к операторскому API. Параметр windowMinutes задаёт окно от 1

минуты до 7 дней; без параметра используется последний час.

1. Проверьте количество запросов, долю ошибок, среднюю и p95-задержку.
2. Сравните попадания и промахи кэша, ошибки и тайм-ауты источников.
3. Проверьте, часто ли запросы отклоняются из-за недостаточных прав.
4. Просмотрите состояния сигналов с фиксированными порогами: ok, firing или

insufficient_data.

Состояния вычисляются во время каждого запроса. firing означает, что агрегат достиг заданного порога; insufficient_data — что в окне пока недостаточно событий для оценки. API можно опрашивать внешним операторским инструментом, но сам Agnostic пока не запускает проверку по расписанию и не отправляет активные уведомления. Подключение такого мониторинга запланировано отдельным этапом.

Если растут задержки или ошибки источников, проверьте доступность подключённых источников и повторите запрос позже. При обращении в поддержку передайте период, видимый симптом и агрегированные показатели; приватные данные и токены не нужны.

Если видите 403, проверьте роль в организации. При 404 проверьте выбранную организацию: ответ не раскрывает сведения о чужих организациях.