Чтение и визуализация метрик при помощи Grafana
Статья создана
Обновлена 19 ноября 2024 г.
Yandex Managed Service for Prometheus® поддерживает Prometheus data source и позволяет работать с дашбордами, которые созданы вами или сообществом, в Grafana.
Подключить data source
- В консоли управления перейдите в каталог, в котором хранятся данные.
- Создайте сервисный аккаунт с ролью
monitoring.viewerна выбранный каталог. - Создайте API-ключ для сервисного аккаунта.
- Откройте главную страницу вашей инсталляции Grafana.
- В главном меню выберите Configuration → Data Sources.
- Нажмите кнопку Add data source.
- В разделе Time series databases выберите Prometheus.
- В поле Name введите имя источника данных.
- В поле URL, в разделе HTTP, введите эндпоинт, который получили ранее.
- В разделе Custom HTTP headers нажмите кнопку Add Header и добавьте заголовок для авторизации. В поле Header введите
Authorization, в поле Value —Bearer <API-ключ>. - Нажмите кнопку Save & test. На экране должно появиться сообщение
The data source is working.
Примеры ошибок
| Код ошибки | Описание | Текст ошибки |
|---|---|---|
404 |
Эндпоинт не найден. Убедитесь, что в конфигурации указан правильный url. |
not_found: workspace not found: monb1piptmdo******** |
401 |
Сервисный аккаунт не найден. Убедитесь, что в конфигурации указан правильный API-ключ. | auth: cannot authenticate by either token or api-key, cause: UNAUTHENTICATED: The token is invalid |
403 |
Отсутствуют права на чтение. Убедитесь, что сервисный аккаунт имеет роль monitoring.viewer на выбранный каталог. |
auth: PERMISSION_DENIED: Permission denied |
429 |
Превышена квота Количество запросов в секунду на чтение через HTTP API. | execution: too many requests: monb1piptmdo******** |
400 |
Запрос вернул слишком много линий. Попробуйте уточнить запрос. | bad_data: Too many metrics are loaded by selectors {job=='grafana'}, expected not more than: 10000 |
Текущие ограничения
В реализации Prometheus HTTP API поддерживаются только следующие эндпоинты:
/api/v1/query/api/v1/query_range/api/v1/labels/api/v1/<label_name>/values/api/v1/series
При этом действуют следующие ограничения:
- Параметр
timeoutне поддерживается и игнорируется. - Параметры
startиendне поддерживаются и игнорируются для запросов/api/v1/labels,/api/v1/<label_name>/valuesи/api/v1/series. - Максимальное число селекторов, которые можно передать в качестве параметра
match[], — 8.
- Максимальное количество временных рядов, по которым можно получить метаданные при помощи запроса
/api/v1/series, — 10 000. - Максимально количество временных рядов, которые можно прочитать в рамках одного запроса
/api/v1/queryили/api/v1/query_range, — 10 000.
- Параметр
--query.lookback-deltaравен5m.
© 2024 Linux Foundation. Все права защищены. Linux Foundation зарегистрировала товарные знаки и использует товарные знаки. Список товарных знаков Linux Foundation см. на странице Trademark Usage.