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

Edge for Private Cloud v4.18.01

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

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

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

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

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

  • Двухъядерный процессор.
  • 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:

Ресурс

Описание

INFLUXDB_URL

Укажите URL узла apigee-influxdb, включая порт 8086. Пример:

http://192.168.0.1:8086

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

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

Ресурс

Описание

INFLUXDB_HOST

Укажите IP-адрес или имя DNS узла InfluxDB. Например:

192.168.0.1

INFLUXDB_PORT

Порт InfluxDB API, используемый источником данных Grafana. Укажите 8086.

GRAFANA_USERNAME

Имя пользователя Grafana для входа в интерфейс панели управления.

GRAFANA_PASSWORD

Пароль Grafana для входа в интерфейс панели управления.

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

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

  • 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. Повторите эти действия на всех узлах Edge.

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

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

  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. В поле Query (Запрос) введите "show servers". Убедитесь, что в списке есть узлы apigee-influxdb.
  3. Проверьте источники данных для сводки:
    1. В главном меню выберите Источники данных. Вы увидите значки трех источников данных.
    2. Выберите значок для каждого источника данных.
    3. На странице сведений об источнике данных нажмите кнопку Сохранить и протестировать.
    4. Если источник данных настроен правильно, вы увидите сообщение:
      Успешно
      Источник данных работает

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

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

  • Для версий 4.16.09 и 4.17.0x используется одна и та же процедура
  • В версии 4.16.05 вам нужно удалить apigee-collectd в рамках обновления.

Обновление с версии 4.16.09 или 4.17.0x

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

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

  1. Обновите Edge до версии 4.18.01, как описано в статьях Update Apigee Edge 4.17.01/4.17.05 to 4.17.09 (Как обновить Apigee Edge 4.17.01/4.17.05 до версии 4.17.09), Update Apigee Edge 4.16.09 to 4.17.09 (Как обновить Apigee Edge 4.16.09 до версии 4.17.09) и Update Apigee Edge 4.16.01/4.16.05 to 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.18.01 вы удаляете apigee-collectd и устанавливаете apigee-telegraf.

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

  1. Обновите Edge до версии 4.18.01, как описано в статьях Как обновить Apigee Edge 4.16.01/4.16.05 до версии 4.17.01 и Как обновить Apigee Edge 4.16.09 до версии 4.17.01.
  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 для каждого узла.