이 페이지는 Cloud Translation API를 통해 번역되었습니다.

모니터링 방법

Private Cloud용 Edge v. 4.17.01

이 문서에서는 Apigee Edge의 온프레미스 배포에서 지원되는 구성요소의 모니터링 기법을 설명합니다.

JMX 사용 설정

JMX는 Cassandra에 기본적으로 사용 설정되고 다른 모든 Edge 구성요소에 대해서는 기본적으로 사용 중지됩니다. 따라서 각 구성요소에 대해 개별적으로 JMX를 사용 설정해야 합니다.

각 구성요소는 서로 다른 포트에서 JMX를 지원합니다. 다음 표에는 JMX 포트와 이 포트에서 JMX를 사용 설정하기 위해 수정하는 파일이 나와 있습니다.

구성요소	JMX 포트	파일
관리 서버	1099	/opt/apigee/edge-management-server/bin/start
메시지 프로세서	1101	/opt/apigee/edge-mesage-processor/bin/start
QPID	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	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 인증을 사용 설정하기 위해 각 구성요소에는 인증을 사용 설정/사용 중지하고 JMX 사용자 인증 정보를 설정하는 데 사용하는 change_jmx_auth 작업이 있습니다.

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=y/n
- JMX_PASSWORD=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 통계를 사용하여 그래픽 인터페이스에 표시할 수 있습니다. JConsole 사용에 관한 자세한 내용은 http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html을 참조하세요.

JConsole 및 다음 서비스 URL을 사용하여 JMX를 통해 제공되는 JMX 속성(MBeans)을 모니터링합니다.

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

여기서 <ip address>는 관리 서버 (또는 각 서버)의 IP 주소입니다. 관리 서버의 포트는 기본적으로 1099입니다.

다음 표는 일반적인 JMX 통계를 보여줍니다.

JMX MBeans	JMX 속성
메모리	HeapMemoryUsage
	NonHeapMemoryUsage
	사용
참고: 속성 값은 커밋, init, 최대, 사용됨이라는 네 가지 값으로 표시됩니다.

Edge Application API 검사 사용

다음 CURL 명령어를 호출하여 관리 서버 (또는 모든 서버)에서 API 검사를 수행할 수 있습니다.

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

여기서 <host>는 관리 서버의 IP 주소입니다.

이 호출은 'true'와 'false'를 반환합니다. true이면 노드가 작동 중이고 자바 서비스가 실행 중인 것입니다.

HTTP 200 (OK) 응답을 받지 못하면 Edge가 포트 8080 요청에 응답할 수 없습니다.

문제 해결

서버에 로그인하고 다음 명령어를 실행합니다.
/opt/apigee/apigee-service/bin/apigee-service Edge-management-server status
서비스가 실행 중이 아닌 경우 서비스를 시작합니다.
/opt/apigee/apigee-service/bin/apigee-service Edge-management-server start

에지 애플리케이션 사용 – 사용자, 조직, 배포 확인

관리 서버는 각 온프레미스 설치 시 다른 모든 파일들을 함께 보관하는 데 중요한 역할을 합니다. 다음 명령어를 실행하여 관리 서버에서 사용자, 조직, 배포 상태를 확인할 수 있습니다.

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 restart

라우터

다음 CURL 명령어를 호출하여 라우터 (또는 서버)에서 API 검사를 수행할 수 있습니다.

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

여기서 호스트는 라우터의 IP 주소입니다.

이 호출은 'true'와 'false'를 반환합니다. true이면 노드가 작동 중이고 라우터 서비스가 실행 중임을 의미합니다.

HTTP 200 (OK) 응답을 받지 못하면 Edge가 포트 8081 요청에 응답할 수 없습니다.