Связаться с намиПодключиться

Запись метрик через Remote API

Статья создана
Улучшена
Обновлена 7 марта 2025 г.

Чтобы настроить запись метрик через Remote API, используя Prometheus в качестве агента для сбора метрик:

  1. В консоли управления перейдите в каталог, в котором хотите хранить данные.
  2. Создайте сервисный аккаунт с ролью monitoring.editor на выбранный каталог.
  3. Создайте API-ключ для сервисного аккаунта.
  4. В конфигурацию Prometheus, в секцию remote_write, добавьте эндпоинт (url): 
    ...
remote_write:
  ...
  - url: 'https://monitoring.api.cloud.yandex.net/prometheus/workspaces/<Идентификатор_воркспейса>/api/v1/write'
    bearer_token_file: '<имя_файла_с_API-ключом>'
    # Или сам ключ (не рекомендуется):
    # bearer_token: '<API-ключ>'
    queue_config:
        max_samples_per_send: 2000 # 10000 в случае использования vmagent
        min_backoff: 100ms
        max_backoff: 15s
        # для Prometheus 2.26 и новее
        # retry_on_http_429: true
    metadata_config:
        send: false
  5. Перезапустите Prometheus или перезагрузите конфигурацию.
  6. Проверьте, что в логах Prometheus нет ошибок, которые связаны с заданным эндпоинтом.

Примеры ошибок

Код ошибки Описание Пример лога
404 Эндпоинт не найден. Убедитесь, что в конфигурации указан правильный url. ts=2024-04-04T09:59:15.973Z caller=dedupe.go:112 component=remote level=error remote_name=366d8d
url=https://monitoring.api.cloud.yandex.net/prometheus/workspaces/monb1piptmdo********/api/v1/write
msg="non-recoverable error" count=105 exemplarCount=0 err="server returned HTTP status 404 Not Found:
{\"status\":\"error\",\"errorType\":\"not_found\",\"error\":\"workspace not found: monb1piptmdo********\"}
401 Сервисный аккаунт не найден. Убедитесь, что в конфигурации указан правильный API-ключ. ts=2024-04-12T12:55:10.124Z caller=dedupe.go:112 component=remote level=error remote_name=6b764c
url=https://monitoring.api.cloud.yandex.net/prometheus/workspaces/monb1piptmdo********/api/v1/write
msg="non-recoverable error" count=1 exemplarCount=0 err="server returned HTTP status 401 Unauthorized:
{\"error\":\"cannot authenticate by either token or api-key, cause: UNAUTHENTICATED: The token is invalid\",\"errorType\":\"\",\"status\":\"error\"}"
403 Отсутствуют права на запись. Убедитесь, что сервисный аккаунт имеет роль monitoring.editor на выбранный каталог. ts=2024-04-05T17:10:47.706Z caller=dedupe.go:112 component=remote level=error remote_name=a9c26f
url=https://monitoring.api.cloud.yandex.net/prometheus/workspaces/monb1piptmdo********/api/v1/write
msg="non-recoverable error" count=205 exemplarCount=0 err="server returned HTTP status 403 Forbidden:
{\"error\":\"PERMISSION_DENIED: Permission denied\",\"errorType\":\"\",\"status\":\"error\"}"
413 Превышена квота Количество уникальных метрик. ts=2024-04-05T16:48:16.002Z caller=dedupe.go:112 component=remote level=error remote_name=37b6df
url=https://monitoring.api.cloud.yandex.net/prometheus/workspaces/monb1piptmdo********/api/v1/write
msg="non-recoverable error" count=205 exemplarCount=0 err="server returned HTTP status 413 Request Entity Too Large:
{\"status\":\"error\",\"errorType\":\"execution\",\"error\":\"more than 1000000 metrics in shard\"}
413 Превышена квота Количество метрик в одном запросе на запись. ts=2024-04-05T17:39:29.102Z caller=dedupe.go:112 component=remote level=error remote_name=37b6df
url=https://monitoring.api.cloud.yandex.net/prometheus/workspaces/monb1piptmdo********/api/v1/write
msg="non-recoverable error" count=10001 exemplarCount=0 err="server returned HTTP status 413 Request Entity Too Large:
{\"status\":\"error\",\"errorType\":\"execution\",\"error\":\"more than 10000 metrics from one URL\"}
429 Превышена квота Максимальная скорость записи в формате Remote Write. Если включена опция retry_on_http_429, повторная отправка данных произойдет автоматически, а нагрузка распределится по времени. Если ошибка наблюдается продолжительное время, обратитесь в техническую поддержку. ts=2024-04-06T14:31:01.113Z caller=dedupe.go:112 component=remote level=error remote_name=37b6df
url=https://monitoring.api.cloud.yandex.net/prometheus/workspaces/monb1piptmdo********/api/v1/write
msg="Failed to send batch, retrying" count=205 exemplarCount=0 err="server returned HTTP status 429 Too Many Requests:
{\"status\":\"error\",\"errorType\":\"execution\",\"error\":\"too many requests (bytes/sec)\"}
400 Невалидный формат данных Remote Write. ts=2024-04-07T13:42:10.543Z caller=dedupe.go:112 component=remote level=error remote_name=37b6df
url=https://monitoring.api.cloud.yandex.net/prometheus/workspaces/monb1piptmdo********/api/v1/write
msg="non-recoverable error" count=499 exemplarCount=0 err="server returned HTTP status 400 Bad Request:
{\"status\":\"error\",\"errorType\":\"bad_data\",\"error\":\"unrecognized remote write format (some headers are missing?): monb1piptmdo********\"}

Метрики Prometheus

Имя метрики Единицы измерения Пояснения
prometheus_remote_storage_sent_batch_duration_seconds Секунды Гистограмма времени выполнения запроса на запись.
prometheus_remote_storage_highest_timestamp_in_seconds Секунды Последняя временная метка, записанная в WAL.
prometheus_remote_storage_queue_highest_sent_timestamp_seconds Секунды Последняя временная метка, успешно отправленная в удаленное хранилище.
prometheus_remote_storage_bytes_total Байты Общее количество байтов данных (не метаданных), отправленных в удаленное хранилище после сжатия.
prometheus_remote_storage_enqueue_retries_total Штуки Общее количество неудачных попыток добавления точки в очередь отправки.
prometheus_remote_storage_max_samples_per_send Штуки Максимальное количество точек, отправленных в одном запросе на запись.
prometheus_remote_storage_samples_dropped_total Штуки Общее количество точек, прочитанных из WAL, но не отправленных в удаленное хранилище.
prometheus_remote_storage_samples_failed_total Штуки Общее количество точек, которые не удалось отправить в удаленное хранилище, неустранимые ошибки.
prometheus_remote_storage_samples_pending Штуки Количество точек, ожидающих отправки в удаленное хранилище.
prometheus_remote_storage_samples_retried_total Штуки Общее количество точек, которые не удалось отправить в удаленное хранилище, но для которых была предпринята повторная попытка, поскольку ошибка отправки является устранимой.
prometheus_remote_storage_samples_total Штуки Общее количество точек, отправленных в удаленное хранилище.
prometheus_remote_storage_shards Штуки Общее количество шардов, задействованных для отправки точек в удаленное хранилище.
prometheus_remote_storage_shards_min Штуки Минимальное доступное количество шардов.
prometheus_remote_storage_shards_max Штуки Максимальное доступное количество шардов.
prometheus_remote_storage_shards_desired Штуки Результат вычисления количества шардов, оптимального для того, чтобы обработать объем приходящих точек.
prometheus_wal_watcher_current_segment Число Текущий сегмент WAL, из которого производится чтение.
prometheus_tsdb_wal_segment_current Число Текущий сегмент WAL, в который записываются новые точки.

© 2025 Linux Foundation. Все права защищены. Linux Foundation зарегистрировала товарные знаки и использует товарные знаки. Список товарных знаков Linux Foundation см. на странице Trademark Usage.

Предыдущая
Агент сбора метрик
Следующая
Диагностика и устранение проблем