[Документация Yandex Cloud](../../../../index.md) > [Monium](../../../index.md) > [Yandex Managed Service for Prometheus®](../index.md) > [Чтение метрик](index.md) > Grafana

# Чтение и визуализация метрик при помощи Grafana

Yandex Managed Service for Prometheus® поддерживает [Prometheus data source](https://grafana.com/docs/grafana/latest/datasources/prometheus/) и позволяет работать с дашбордами, которые созданы вами или сообществом, в Grafana.

Рекомендуемый способ визуализации — графики и дашборды в [Monium Metrics](monitoring.md).

Чтобы перенести дашборды из существующих инсталляций Grafana, воспользуйтесь [скриптом импорта](https://github.com/yandex-cloud-examples/yc-monitoring-dashboard-importer). Он автоматизирует процесс и позволяет избежать ошибок при ручном переносе конфигураций.

## Подключить data source {#data-source}

1. В [консоли управления](https://kz.console.yandex.cloud) перейдите в каталог, в котором хранятся данные.
1. [Создайте сервисный аккаунт](../../../../iam/operations/sa/create.md) с ролью `monitoring.viewer` на выбранный каталог.
1. [Создайте API-ключ](../../../../iam/operations/authentication/manage-api-keys.md#create-api-key) для сервисного аккаунта.
1. Откройте главную страницу вашей инсталляции Grafana.
1. В главном меню выберите **Configuration → Data Sources**.
1. Нажмите кнопку **Add data source**.
1. В разделе **Time series databases** выберите **Prometheus**.
1. В поле **Name** введите имя источника данных. 
1. В поле **URL**, в разделе **HTTP**, введите [эндпоинт, который получили ранее](../index.md#access).
1. В разделе **Custom HTTP headers** нажмите кнопку **Add Header** и добавьте заголовок для авторизации. В поле **Header** введите `Authorization`, в поле **Value** — `Bearer <API-ключ>`.
1. Нажмите кнопку **Save & test**. На экране должно появиться сообщение `The data source is working`.

## Примеры ошибок {#errors}

| Код ошибки | Описание | Текст ошибки |
|----|----|----|
| `404` | Эндпоинт не найден. Убедитесь, что в конфигурации указан правильный `url`. | ```not_found: workspace not found: monb1piptmdo********``` |
| `401` | Сервисный аккаунт не найден. Убедитесь, что в конфигурации указан правильный [API-ключ](../../../../iam/concepts/authorization/api-key.md). | ```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](../index.md#limits). | ```execution: too many requests: monb1piptmdo********``` |
| `400` | Запрос вернул слишком много линий. Попробуйте уточнить запрос. | ```bad_data: Too many metrics are loaded by selectors {job=='grafana'}, expected not more than: 20000``` |

## Текущие ограничения {#restrictions}

Yandex Managed Service for Prometheus® работает на порту TCP 443. Его публичный IP-адрес — 158.160.59.216. Со временем адрес может измениться. Чтобы не потерять доступ к сервису, рекомендуем использовать дополнительные адреса [из списка доступных](../../../../overview/concepts/public-ips.md).

В реализации Prometheus [HTTP API](https://prometheus.io/docs/prometheus/latest/querying/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`.

_© 2025 Linux Foundation. Все права защищены. Linux Foundation зарегистрировала товарные знаки и использует товарные знаки. Список товарных знаков Linux Foundation приведен на странице [Trademark Usage](https://www.linuxfoundation.org/legal/trademark-usage)._