VMAgent

VMAgent — агент, который позволяет настроить процесс сбора и обработки метрик.

Перед началом работы настройте VMAgent.

Настроить VMAgent

Вы можете настроить агент для получения метрик в свою инфраструктуру.

Добавьте сервисного пользователя.
Настройте агент для получения метрик.

1. Добавить сервисного пользователя

Добавьте сервисного пользователя с разрешением в области доступа Проекты и ролью:

Добавлять пользователей может Владелец аккаунта или пользователи с ролью iam.admin.

2. Настроить агент для получения метрик

Откройте CLI.
Создайте файл конфигурации vmagent.yaml:
```
nano /etc/vmagent/vmagent.yaml
```
В файле конфигурации vmagent.yaml заполните блок scrape_configs:
```
scrape_configs:
  - job_name: test_scrape
    scrape_interval: 1m
    metrics_path: /projects/<project_id>/namespaces/<namespace>/prometheus/metrics
    static_configs:
      - targets:
          - <base_url>
    basic_auth:
      username: <user_id>
      password: <password>
```
Укажите:
- <project_id> — ID проекта. Можно скопировать в панели управления: в верхнем меню нажмите Продукты и выберите любой продукт → откройте меню проектов → в строке нужного проекта нажмите ;
- <namespace> — имя выбранного пространства имен, например compute;
- <base_url> — URL для обращения к API сервиса Метрики. Список URL можно посмотреть в инструкции Список URL;
- <user_id> — ID пользователя, которого вы добавили на этапе 1;
- <password> — пароль пользователя, которого вы добавили на этапе 1.
Опционально: вы можете настроить сбор метрик из нескольких пулов или проектов. Чтобы добавить новый пул или проект, повторите шаг 3.
Опционально: добавьте отправку метрик во внешние системы хранения или обработки, например в VictoriaMetrics. Для этого добавьте и заполните раздел remote_write в файл конфигурации vmagent.yaml.
Выйдите из текстового редактора nano с сохранением изменений: нажмите Ctrl+Х, а затем Y+Enter.

Запустите VMAgent:

docker run \
  --name vmagent \
  --rm \
  -v ${PWD}/vmagent.yaml:/etc/vmagent/vmagent.yaml:ro  \
  -p 8429:8429 \
  victoriametrics/vmagent:latest \
  --promscrape.config=/etc/vmagent/vmagent.yaml \
  --remoteWrite.url=http:/<storage_path>/api/v1/write

Укажите <storage_path> — адрес вашего пользовательского хранилища метрик.

Опционально: убедитесь, что метрики собираются. Для этого проверьте подключение агента к сервису Метрики:
```
curl localhost:8429/targets
```
В выводе команды должен отобразиться статус up. Пример вывода:
```
job=test_scrape (1/1 up)
```