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

Edge для частного облака v. 4.17.05

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

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

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

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

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

  • 2-ядерный процессор
  • 4 ГБ ОЗУ
  • 250 ГБ дискового пространства (данные мониторинга удаляются через 1 месяц)
  • 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 . Например, установите их в текстовый файл с именем sa_telegraf.txt :

Свойство

Описание

INFLUXDB_URL

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

Например:

http://192.168.0.1:8086

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

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

Свойство

Описание

INFLUXDB_HOST

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

Например:

192.168.0.1

INFLUXDB_PORT

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

ГРАФАНА_ИМЯ ПОЛЬЗОВАТЕЛЯ

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

ГРАФАНА_ПАРОЛЬ

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

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

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

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

Установите apigee-influxdb на один пограничный или автономный узел.

На автономном узле или пограничном узле, на котором работает сервер управления или пограничный пользовательский интерфейс:

  1. Установите apigee-influxdb :
    > /opt/apigee/apigee-service/bin/apigee-service установка apigee-influxdb
  2. Настройте базу данных apigee-influxdb :
    > /opt/apigee/apigee-service/bin/apigee-service настройка apigee-influxdb
  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
  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 -f /opt/apigee/customer/application/sa_telegraf.txt
  5. Перезапустите apigee-telegraf :
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-telegraf
  6. Повторите этот процесс на всех узлах Edge.

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

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

  1. На первом Edge-узле установите apigee-grafana :
    > /opt/apigee/apigee-service/bin/apigee-service установка apigee-grafana
  2. Создайте файл конфигурации для apigee-grafana с именем sa_grafana.txt . Обычно вы сохраняете этот файл в каталоге, доступном пользователю apigee, например /opt/apigee/customer/application , и делаете его владельцем пользователя apigee.

    Установите следующие свойства в файле. Эти свойства описаны выше:
    INFLUXDB_HOST=192.168.56.101
    INFLUXDB_PORT=8086
    GRAFANA_USERNAME=админ
    GRAFANA_PASSWORD=админ
  3. Измените владельца на «apigee»:
    > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
  4. Настройте apigee-grafana, используя файл конфигурации:
    > /opt/apigee/apigee-service/bin/apigee-service настройка apigee-grafana -f /opt/apigee/customer/application/sa_grafana.txt
  5. Перезапустите apigee-grafana :
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-grafana

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

http://grafana_IP_or_DNS:3000

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

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

Если вы не видите данные на панели мониторинга, используйте следующую процедуру для устранения неполадок при установке:

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

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

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

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

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

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

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

  1. Обновите Edge до версии 4.17.05, как описано в разделах «Обновление Apigee Edge с 4.17.01 до 4.17.05» , «Обновление Apigee Edge с 4.16.09 до 4.17.05 » и «Обновление Apigee Edge с 4.16.01/4.16.05 до 4.17.05» .
  2. Обновите apigee-influxdb на узле Management Server:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f файл конфигурации

    где configFile — файл конфигурации, который вы использовали для установки apigee-influx .

    Если вы также установили apigee-grafana на узле Management Server, то на этом этапе также обновляется apigee-grafana . В противном случае обновите apigee-granfana, как показано на следующем шаге.
  3. Если вы не установили apigee-grafana на узле Management Server , обновите apigee-grafana на узле, где вы его установили:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f файл конфигурации
  4. Обновите apigee-telegraf на узле 1:
    > /opt/apigee/apigee-service/bin/apigee-service обновление apigee-telegraf
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-telegraf
  5. Повторите шаг 4 для каждого узла.

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

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

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

  1. Обновите Edge до версии 4.17.05, как описано в разделах «Обновление Apigee Edge с 4.17.01 до 4.17.05» , «Обновление Apigee Edge с 4.16.09 до 4.17.05 » и «Обновление Apigee Edge с 4.16.01/4.16.05 до 4.17.05» .
  2. Обновите apigee-influxdb на узле Management Server:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f файл конфигурации

    где configFile — файл конфигурации, который вы использовали для установки apigee-influx .

    Если вы также установили apigee-grafana на узле Management Server, то на этом этапе также обновляется apigee-grafana . В противном случае обновите apigee-granfana, как показано на следующем шаге.
  3. Если вы не установили apigee-grafana на узле Management Server , обновите apigee-grafana на узле, где вы его установили:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f файл конфигурации
  4. Установите apigee-telegraf на узел 1:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
    > /opt/apigee/apigee-service/bin/apigee-service установка apigee-telegraf
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
    > /opt/apigee/apigee-service/bin/apigee-service перезапуск apigee-telegraf
    > /opt/apigee/apigee-service/bin/apigee-service удаление apigee-collectd
  5. Повторите шаг 4 для каждого узла.