Рекомендации по мониторингу

Edge for Private Cloud v4.18.05

Оповещения о мониторинге

Apigee Edge позволяет пересылать оповещения в системные журналы или внешние системы/инструменты мониторинга, когда возникает ошибка или сбой из-за сбоя события. Оповещения могут быть на уровне системы или приложения. Оповещения на уровне приложения – это в основном специальные оповещения, которые создаются на основе сгенерированных событий. Обычно специальные условия настраивает администратор сети. Чтобы получить дополнительную информацию об оповещениях, обратитесь в службу поддержки Apigee.

настройку пороговых значений для оповещений;

Укажите пороговое значение, при достижении которого должно создаваться оповещение. Выбор зависит от конфигурации оборудования. Пороговое значение должно быть установлено в соответствии с вашими возможностями. Например, если у вас всего 6 ГБ, то Apigee Edge может быть слишком низким. Вы можете задать пороговое значение с помощью критерия "равно" (=) или "больше" (>). Вы также можете указать интервал времени между двумя последовательными оповещениями. Вы можете использовать вариант с часами, минутами и секундами.

Критерии для настройки оповещений на уровне системы

В таблице ниже описаны критерии.

Предупреждение об ошибке Рекомендуемое пороговое значение Описание

Недостаточно памяти

500 МБ

Недостаточно памяти для запуска компонента.

Недостаточно места на диске (/var/log)

8 ГБ

На диске слишком мало места.

Высокая нагрузка

3+

Неожиданно увеличилось количество процессов, ожидающих запуска

Процесс остановлен

Недоступно, логическое значение true или false

Процесс Apigee Java в системе остановлен.

Проверка портов, относящихся к Apigee и сторонним сервисам

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

  • Порты 4526, 4527 и 4528 на Management Server, Router и Message Processor.
  • Порты 1099, 1100 и 1101 на сервере управления, маршрутизаторе и процессоре сообщений.
  • Порты 8081 и 15999 на маршрутизаторах
  • Порты 8082 и 8998 на Message Processor.
  • Порт 8080 на сервере управления

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

  • Порт Qpid 5672
  • Postgres, порт 5432;
  • Порты Cassandra 7000, 7199, 9042, 9160
  • Порт ZooKeeper 2181
  • Порт OpenLDAP 10389

Чтобы определить, какой порт каждый компонент Apigee прослушивает для вызовов API, выполните следующие вызовы API к серверу управления (обычно это порт 8080):

curl -v -u username:password http://host:port/v1/servers?pod=gateway&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=central&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=analytics&region=dc-1

Выходные данные этих команд будут содержать разделы, подобные показанным ниже. В разделе http.management.port указан номер порта для заданного компонента.

{
  "externalHostName" : "localhost",
  "externalIP" : "111.222.333.444",
  "internalHostName" : "localhost",
  "internalIP" : "111.222.333.444",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "default",
  "tags" : {
    "property" : [ {
      "name" : "Profile",
      "value" : "Router"
    }, {
      "name" : "rpc.port",
      "value" : "4527"
    }, {
      "name" : "http.management.port",
      "value" : "8081"
    }, {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    } ]
  },
  "type" : [ "router" ],
  "uUID" : "2d4ec885-e20a-4173-ae87-10be38b35750"
}

Просмотр журналов

Файлы журналов отслеживают сообщения о событиях и операциях в системе. Сообщения появляются в журнале, когда процессы начинаются и завершаются или когда возникает ошибка. В файлах журналов можно найти информацию о компонентах системы, например о ЦП, памяти, диске, нагрузке, процессах и т. д., до и после сбоя. Это также позволяет выявлять и диагностировать источники текущих проблем с системой или прогнозировать потенциальные проблемы.

Например, типичный системный журнал компонента содержит следующие записи:

TimeStamp = 25/01/13 19:25 ; NextDelay = 30
Memory
HeapMemoryUsage = {used = 29086176}{max = 64880640} ;
NonHeapMemoryUsage = {init = 24313856}{committed = 57278464} ;
Threading
PeakThreadCount = 53 ; ThreadCount = 53 ;
OperatingSystem
SystemLoadAverage = 0.25 ;

Вы можете изменить файл /opt/apigee/conf/logback.xml, чтобы управлять механизмом ведения журнала без перезапуска сервера. Файл logback.xml содержит следующее свойство, которое задает частоту, с которой механизм ведения журнала проверяет файл logback.xml на наличие изменений конфигурации:

<configuration scan="true" scanPeriod="30 seconds" >

По умолчанию механизм ведения журнала проверяет наличие изменений каждую минуту. Если вы не укажете единицы измерения в атрибуте scanPeriod, по умолчанию будут использоваться миллисекунды.

В таблице ниже указано расположение файлов журналов для компонентов Apigee Edge Private Cloud.

Компоненты Местоположение

Сервер управления

opt/apigee/var/log/edge-management-server

Маршрутизатор

opt/apigee/var/log/edge-router

Message Processor

opt/apigee/var/log/edge-message-processor

Сервер Qpid

opt/apigee/var/log/edge-qpid-server

Сервер Apigee Postgres

opt/apigee/var/log/edge-postgres-server

Интерфейс Edge

opt/apigee/var/log/edge-ui

ZooKeeper

opt/apigee/var/log/apigee-zookeeper

OpenLDAP

opt/apigee/var/log/apigee-openldap

Cassandra

opt/apigee/var/log/apigee-cassandra

Qpidd

opt/apigee/var/log/apigee-qpidd

База данных PostgreSQL

opt/apigee/var/log/apigee-postgresql

Включение журналов отладки для Message Processor и Edge UI

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

  1. На узле Message Processor отредактируйте файл /opt/apigee/customer/application/messsage-processor.properties. Если такого файла нет, создайте его.
  2. Добавьте в файл следующее свойство:
    conf_system_log.level=DEBUG
  3. Перезапустите Message Processor:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Чтобы включить журналы отладки для Edge UI:

  1. На узле Edge UI отредактируйте файл /opt/apigee/customer/application/ui.properties. Если такого файла нет, создайте его.
  2. Добавьте в файл следующее свойство:
    conf_application_logger.application=DEBUG
  3. Перезапустите Edge UI:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Инструменты мониторинга

Инструменты мониторинга, такие как Nagios, Collectd, Graphite, Splunk, Sumologic и Monit, помогут вам отслеживать всю корпоративную среду и бизнес-процессы.

Компонент Nagios Collectd Splunk

Проверки на уровне системы

Загрузка ЦП

Свободная/используемая память

Использование места на диске

Статистика сети

Процессы

Проверки API

JMX

Java

Файлы журналов

Критические события

Достигнуто ограничение частоты запросов

Не удается подключиться к бэкенд-серверу (Hybris или SharePoint).

FaaS (STS) недоступен

Предупреждения

SMTP-сервер недоступен

Нарушенные соглашения об уровне обслуживания