Установка бета-версии панели мониторинга

Edge для частного облака версии 4.17.09

Системные требования

Чтобы собирать данные для панели управления, необходимо установить apigee-telegraf на всех узлах Edge. Поэтому системные требования для apigee-telegraf такие же, как и для узла Edge, на который вы его устанавливаете.

Вы можете установить apigee-grafana на отдельном узле или повторно использовать один из существующих узлов Edge, например узел сервера управления или интерфейса Edge.

apigee-influxdb можно установить на существующий узел Edge, например на узел сервера управления или узел интерфейса Edge, без изменения системных требований.

Если вы решите установить apigee-influxdb на отдельном узле для повышения производительности, то узел должен соответствовать следующим требованиям:

• 2-ядерный процессор
• 4 ГБ ОЗУ
• 250 ГБ места на диске (данные мониторинга удаляются через месяц).
• 1000 или более операций ввода-вывода в секунду

Дополнительную информацию можно найти в документации InfluxData.

Требования к портам для apigee-influxdb

Порты 8086 и 8183 должны быть открыты на узлах данных apigee-influxdb для доступа узла, на котором выполняются apigee-grafana и apigee-telegraf.

Файлы конфигурации для установки компонентов панели управления

Чтобы установить компоненты apigee-telegraf и apigee-grafana, передайте файл конфигурации утилите apigee-service. Сохраните эти файлы в каталоге, доступном пользователю apigee, например /opt/apigee/customer/application, и сделайте их принадлежащими пользователю apigee.

Параметры конфигурации для apigee-telegraf

Эти свойства задаются в текстовом файле, который передается команде apigee-telegraf setup. Например, их можно указать в текстовом файле sa_telegraf.txt:

http://192.168.0.1:8086

Параметры конфигурации для apigee-grafana

Задайте эти свойства в текстовом файле, который вы передадите команде apigee-grafana setup. Например, их можно указать в текстовом файле sa_grafana.txt:

192.168.0.1

Инструкции по установке

Чтобы установить компоненты панели управления, следуйте инструкциям ниже в указанном порядке:

• apigee-influxdb (на центральном узле)
• apigee-telegraf (на каждом узле)
• apigee-grafana (на центральном сервере)

Установите apigee-influxdb на одном узле Edge или отдельном узле.

На отдельном узле или узле Edge, на котором запущен сервер управления или интерфейс Edge:

1. Установите apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
2. Настройте базу данных apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
3. Запустите apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Установите apigee-telegraf на каждом узле Edge.

На каждом узле установки Edge:

1. На первом узле Edge установите apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. Создайте файл конфигурации для apigee-telegraf с именем sa_telegraf.txt. Как правило, этот файл хранится в каталоге, доступном пользователю apigee, например /opt/apigee/customer/application, и принадлежит пользователю apigee.
   
   Укажите в файле следующий параметр, чтобы задать URL узла apigee-influxdb, включая порт 8086:
   INFLUXDB_URL=http://influx_IP:8086
3. Измените владельца на apigee:
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. Настройте apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
5. Перезапустите apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
6. Повторите этот процесс на всех пограничных узлах.

Как установить apigee-grafana на одном узле Edge

На одном узле установки Edge, например на узле интерфейса Edge:

1. На первом узле Edge установите apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. Создайте файл конфигурации для apigee-grafana с именем sa_grafana.txt. Обычно этот файл хранится в каталоге, доступном пользователю apigee, например /opt/apigee/customer/application, и принадлежит пользователю apigee.
   
   Задайте в файле следующие свойства: Эти свойства описаны выше:
   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin
3. Измените владельца на apigee:
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. Настройте apigee-grafana с помощью файла конфигурации:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
5. Перезапустите apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

Чтобы открыть панель управления, введите в браузере следующий URL:

http://grafana_IP_or_DNS:3000

Войдите в систему, используя учетные данные, указанные в файле конфигурации для apigee-grafana. В примере выше имя пользователя и пароль – admin/admin.

Устранение неполадок при установке

Если на панели управления нет данных, выполните следующие действия, чтобы устранить неполадки с установкой:

1. Чтобы убедиться, что apigee-telegraf собирает данные:
   1. Выполните команду apigee-service apigee-telegraf setup. Она идемпотентна. Проверьте наличие ошибок и недостающих зависимостей и устраните их.
   2. Перезапустите apigee-telegraf и проверьте, нет ли ошибок в файле /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log.
2. Чтобы убедиться, что apigee-influxdb получает данные:
   1. Убедитесь, что на узлах данных apigee-influxdb открыты следующие порты TCP: 8086 и 8183.
   2. Чтобы открыть интерфейс influxdb в браузере, используйте следующий URL:
      http://influxdb_IP_or_DNS:8183
      1. В поле Query (Запрос) введите show databases.
         Убедитесь, что созданы следующие базы данных: system, application, events, _internal.
      2. В поле запроса введите "show servers".
         Убедитесь, что в списке есть узлы apigee-influxdb.
3. Проверьте источники данных на панели управления:
   1. В главном меню выберите Источники данных. Вы увидите значки трех источников данных.
   2. Нажмите на значок рядом с каждым источником данных.
   3. На странице сведений об источнике данных нажмите кнопку Сохранить и проверить.
   4. Если источник данных настроен правильно, вы увидите сообщение следующего вида:
      Успешно
      Источник данных работает

Обновление панели мониторинга бета-версии

Используйте одну из двух процедур ниже в зависимости от версии Edge, с которой вы выполняете обновление:

• 4.16.09, 4.17.01 и 4.17.05.
• В версии 4.16.05 необходимо удалить apigee-collectd в рамках обновления.

Обновление с версии 4.16.09, 4.17.01 или 4.17.05

Если вы установили бета-версию панели мониторинга Apigee в версии 4.16.09, 4.17.01 или 4.17.05, вы можете обновить ее до бета-версии для 4.17.09.

Чтобы обновить панель мониторинга бета-версии:

1. Обновите Edge до версии 4.17.09, следуя инструкциям в статьях Обновление Apigee Edge 4.17.01/4.17.05 до версии 4.17.09, Обновление Apigee Edge 4.16.09 до версии 4.17.09 и Обновление Apigee Edge 4.16.01/4.16.05 до версии 4.17.09.
2. Обновите apigee-influxdb на узле сервера управления:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   где configFile – это файл конфигурации, который вы использовали для установки apigee-influx.
   
   Если вы также установили apigee-grafana на узле сервера управления, этот шаг также обновит apigee-grafana. В противном случае обновите apigee-granfana, как показано на следующем шаге.
3. Если вы не установили apigee-grafana на узле сервера управления, обновите apigee-grafana на узле, на котором вы его установили:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Обновите apigee-telegraf на узле 1:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
5. Повторите шаг 4 для каждого узла.

Обновление с версии 4.16.05

В версии 4.16.05 панели управления использовался apigee-collectd вместо apigee-telegraf. При обновлении до версии 4.17.09 вы удаляете apigee-collectd и устанавливаете apigee-telegraf.

Чтобы обновить панель мониторинга бета-версии:

1. Обновите Edge до версии 4.17.09, следуя инструкциям в статьях Обновление Apigee Edge 4.17.01/4.17.05 до версии 4.17.09, Обновление Apigee Edge 4.16.09 до версии 4.17.09 и Обновление Apigee Edge 4.16.01/4.16.05 до версии 4.17.09.
2. Обновите apigee-influxdb на узле сервера управления:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   где configFile – это файл конфигурации, который вы использовали для установки apigee-influx.
   
   Если вы также установили apigee-grafana на узле сервера управления, этот шаг также обновит apigee-grafana. В противном случае обновите apigee-granfana, как показано на следующем шаге.
3. Если вы не установили apigee-grafana на узле сервера управления, обновите apigee-grafana на узле, на котором вы его установили:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Установите apigee-telegraf на узле 1:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall
5. Повторите шаг 4 для каждого узла.