Эта страница переведена с помощью Cloud Translation API.

Как контролировать

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

В этом документе описаны методы мониторинга компонентов, поддерживаемых локальным развертыванием Apigee Edge.

Включение JMX

JMX включен по умолчанию для Cassandra и отключен по умолчанию для всех остальных компонентов Edge. Поэтому вам необходимо включить JMX индивидуально для каждого компонента.

Каждый компонент поддерживает JMX на своем порту. В следующей таблице перечислены порт JMX и файл, который вы изменяете, чтобы включить JMX на этом порту:

Компонент	JMX-порт	Файл
Сервер управления	1099	/opt/apigee/edge-management-server/bin/start
Маршрутизатор	1100	/opt/apigee/edge-router/bin/start
Процессор сообщений	1101	/opt/apigee/edge-message-processor/bin/start
Qpid	1102	/opt/apigee/edge-qpid-server/bin/start
Постгрес	1103	/opt/apigee/edge-postgres-server/bin/start

Например, чтобы включить JMX на сервере управления, откройте /opt/apigee/edge-management-server/bin/start в редакторе. Вы должны увидеть следующую строку, используемую для запуска сервера управления:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts -Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path 
-Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

Отредактируйте эту строку, добавив следующее:

-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

Обратите внимание, что в этой строке указан номер порта JMX 1099 для сервера управления. Установите номер порта для каждого компонента, как указано в таблице выше. Например:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts 
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false 
-Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path -Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

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

> /opt/apigee/apigee-service/bin/ apigee-service edge-management-server restart

Включение аутентификации JMX и установка пароля JMX

Процесс мониторинга для сервера управления, процессора сообщений, Qpid и Postgres использует JMX. JMX включен по умолчанию, и для удаленного доступа к JMX не требуется пароль.

Чтобы включить аутентификацию JMX, каждый компонент имеет действиеchange_jmx_auth , которое вы используете для включения/отключения аутентификации и установки учетных данных JMX.

Чтобы включить аутентификацию JMX, используйте следующую команду:

>  /opt/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

где:

comp — это Edge-Management-Server, Edge-Message-Processor, Edge-Qpid-Server или Edge-Postgres-Server .
Варианты:
- -u : имя пользователя
- -p : пароль
- -e : y (включить) или n (возможно)
Конфигурационный файл включает в себя:
- JMX_USERNAME= имя пользователя
- JMX_ENABLED=да/нет
- JMX_PASSWORD= пароль (если он не установлен или не передан с помощью -p , вам будет предложено)

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

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -u foo -p bar -e y

Если у вас есть файл конфигурации:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -f configFile

Если вы используете Edge на нескольких узлах, запустите эту команду на всех узлах, указав одно и то же имя пользователя и пароль.

Чтобы позже отключить аутентификацию JMX, используйте команду:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -e n

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

Использование JConsole для мониторинга работоспособности системы и обработки информации.

Используйте JConsole (JMX-совместимый инструмент) для управления и мониторинга проверки работоспособности и обработки статистики. Используя JConsole, вы можете использовать статистику JMX, предоставляемую Management Server (или любым сервером), и отображать ее в графическом интерфейсе. Для получения дополнительной информации об использовании JConsole см. http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html .

Используйте JConsole и следующий URL-адрес службы для мониторинга атрибутов JMX (MBeans), предлагаемых через JMX.

service:jmx:rmi:///jndi/rmi://<ip address>:<port>/jmxrmi

где <ip-адрес> — IP-адрес Сервера управления (или соответствующего сервера). По умолчанию для сервера управления используется порт 1099.

В следующей таблице показана общая статистика JMX:

JMX-MBean-компоненты	Атрибуты JMX
Память	КучаПамятьИспользование
	NonHeapMemoryUsage
	Применение
Примечание. Значения атрибутов будут отображаться в четырех значениях: зафиксировано, инициализировано, максимально и использовано.

Использование проверок API Edge Application

Вы можете выполнить проверку API на сервере управления (или любом другом сервере), вызвав следующую команду CURL:

curl http://<host>:8080/v1/servers/self/up -H "Accept: application/json"

Где <хост> — это IP-адрес сервера управления. Вы можете указать тип Accept как application/json или application/xml .

Этот вызов возвращает «истину» и «ложь». Если это правда, это означает, что узел работает и служба Java работает.

Если вы не получили ответ HTTP 200 (ОК), Edge не сможет ответить на запросы порта 8080.

Поиск неисправностей

Войдите на сервер и выполните следующую команду:
/opt/apigee/apigee-service/bin/apigee-service состояние сервера Edge-Management-Server
Если служба не запущена, запустите ее:
/opt/apigee/apigee-service/bin/apigee-service запуск сервера Edge-Management-Server

Использование Edge Application — проверки пользователей, организации и развертывания

Сервер управления играет жизненно важную роль в объединении всех остальных пакетов в каждой локальной установке. Вы можете проверить статус пользователя, организации и развертывания на сервере управления, выполнив следующие команды:

curl -u userEmail:password http://localhost:8080/v1/users
curl -u userEmail:password http://localhost:8080/v1/organizations
curl -u userEmail:password http://localhost:8080/v1/organizations/orgname/deployments

Система должна отображать статус «развернуто» для всех вызовов. Если это не помогло, сделайте следующее:

Проверьте журналы сервера управления ( opt/apigee/var/log/edge-management-server ) на наличие ошибок.
Вызовите сервер управления, чтобы проверить, правильно ли он работает.
Удалите сервер из ELB, а затем перезапустите сервер управления.
/opt/apigee/apigee-service/bin/apigee-service перезапуск сервера Edge-Management-Server

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

Вы можете выполнить проверку API на маршрутизаторе (или любом сервере), вызвав следующую команду CURL:

curl http://<host>:8081/v1/servers/self/up

Где хост — это IP-адрес маршрутизатора.

Этот вызов возвращает «истину» и «ложь». Если это правда, это означает, что узел работает и служба маршрутизатора работает.

Если вы не получили ответ HTTP 200 (ОК), Edge не сможет ответить на запросы порта 8081.