Глава 5. Установка и минимальная настройка
Пред.	Наверх	Документация pgpro-otel-collector	Начало	След.

Глава 5. Установка и минимальная настройка

Установить pgpro-otel-collector можно из репозитория программного обеспечения Postgres Pro. Для минимальной настройки выполните шаги ниже.

Подключите репозиторий и установите пакет
Подключите репозиторий Postgres Pro скриптом pgpro-repo-add.sh, обновите метаданные пакетного менеджера и установите пакет pgpro-otel-collector.
Для дистрибутивов Debian/Ubuntu:
```
# wget https://repo.postgrespro.ru/otelcol/otelcol/keys/pgpro-repo-add.sh
# sh ./pgpro-repo-add.sh
# apt update
# apt install pgpro-otel-collector
```
Настройте коллектор
Основной файл конфигурации — /etc/pgpro-otel-collector/basic.yml. Настройте его под ваше окружение.
1. Задайте параметры подключения к базе данных
  Найдите раздел receivers:postgrespro и убедитесь, что параметры подключения указаны верно. Пароль может быть задан через переменную окружения.
```
receivers:
    postgrespro:
         # Адрес сервера Postgres Pro
        endpoint: &endpoint localhost:5432
        # Имя базы данных для подключения
        database: postgres
        # Пользователь для подключения
        username: postgres
        # Пароль подключения
        password: ${env:POSTGRESQL_PASSWORD}
```
2. (Необязательно) Отрегулируйте параметры производительности
  Интервал сбора и способ пакетной отправки метрик можно изменять. Например:
```
receivers:
    postgrespro:
        # Интервал сбора метрик
        collection_interval: 60s
processors:
  batch/metrics:
    # Пороговый размер пакета для отправки
    send_batch_size: 8192
    # Тайм-аут для отправки пакетов
    timeout: 10s
```
3. Включите и настройте плагины
  Определите, какие плагины будут активны. collection_interval также можно переопределить для каждого конкретного плагина.
```
receivers:
    postgrespro:
        plugins:
            activity:
                enabled: true
                # collection_interval: 60s
            bgwriter:
                enabled: true
            locks:
                enabled: true
            version:
                enabled: true
            wal:
                enabled: true
            cache:
                enabled: true
```
  За подробной информацией о плагинах обратитесь к Главе 7.
Запустите pgpro-otel-collector
Выполните следующую команду для запуска pgpro-otel-collector:
```
# systemctl start pgpro-otel-collector
```
pgpro-otel-collector автоматически перейдёт в режим сбора и передачи данных в соответствии с параметрами в файле конфигурации.

По умолчанию собранные метрики доступны в формате Prometheus по адресу localhost:8889/metrics.

Для просмотра журналов коллектора используйте следующую команду:

# sudo journalctl -u pgpro-otel-collector