Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

모니터링 방법

프라이빗 클라우드용 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

예를 들어 Management Server에서 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=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을 사용하면 Management Server (또는 모든 서버)에서 노출하는 JMX 통계를 사용하고 그래픽 인터페이스에 표시할 수 있습니다. JConsole 사용에 대한 자세한 내용은 http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html을 참조하세요.

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

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

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

다음 표에는 일반 JMX 통계가 나와 있습니다.

JMX MBean	JMX 속성
메모리	HeapMemoryUsage
	NonHeapMemoryUsage
	사용
참고: 속성 값은 커밋됨, 초기화, 최댓값, 사용됨의 네 가지 값으로 표시됩니다.

Edge Application API 검사 사용

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

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

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

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

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

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

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

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에서 서버를 삭제한 후 Management Server를 다시 시작합니다.
/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 요청에 응답할 수 없습니다.