모니터링 권장사항

Private Cloud용 Edge v. 4.16.05

알림 모니터링

Apigee Edge를 사용하면 오류 또는 실패가 발생한 경우를 의미합니다. 이러한 알림은 시스템 수준 또는 애플리케이션 수준의 경보/이벤트입니다. 애플리케이션 수준 알림은 주로 애플리케이션 수준에서 생성할 수 있습니다. 일반적으로 네트워크 관리자는 조건일 수 있습니다 알림에 대한 자세한 내용은 Apigee 지원팀에 문의하세요.

알림 기준 설정

알림을 생성해야 하는 기준을 설정합니다. 설정하는 내용은 어떻게 해야 할까요? 기준치는 용량을 기준으로 설정해야 합니다. 예를 들어 Apigee는 용량이 6GB밖에 없는 경우 Edge가 너무 낮을 수 있습니다. 같음 (=)으로 임곗값을 할당할 수 있습니다. 이상(>) 기준을 적용합니다. 연속하는 두 개의 텍스트 사이의 시간 간격을 지정할 수도 있습니다. 알림을 생성합니다. 시간/분/초 옵션을 사용할 수 있습니다.

시스템 수준 경고 설정 기준

다음 표에서는 기준을 설명합니다.

알림

추천 기준

설명

메모리 부족

500MB

메모리가 너무 부족하여 구성요소를 시작할 수 없습니다.

디스크 공간 부족 (/var/log)

8GB

디스크 공간이 너무 부족합니다.

높은 부하

3회 이상

실행 대기 중인 프로세스가 예기치 않게 증가했습니다.

프로세스 중지됨

해당 사항 없음, 부울 값 true 또는 false

시스템의 Apigee Java 프로세스가 중지되었습니다.

Apigee 전용 및 서드 파티 확인 포트

다음 포트를 모니터링하여 활성 상태인지 확인하세요.

  • 관리 서버, 라우터, 메시지 프로세서의 포트 4526, 4527, 4528
  • 관리 서버, 라우터, 메시지 프로세서의 포트 1099, 1100, 1101
  • 라우터의 포트 8081
  • 메시지 프로세서의 포트 8082 및 8998
  • 관리 서버의 포트 8080

다음 타사 포트가 활성화되어 있는지 확인하세요.

  • Qpid 포트 5672
  • Postgres 포트 5432
  • Cassandra 포트 7000, 7199, 9042, 9160
  • 주키퍼 포트 2181
  • OpenLDAP 포트 10389

각 Apigee 구성요소가 API 호출을 리슨하는 포트를 파악하려면 다음을 실행합니다. (일반적으로 포트 8080에 있는) Management Server에 대한 다음 API 호출입니다.

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

이러한 명령어의 출력에는 아래와 유사한 섹션이 포함됩니다. 이 &quot;http.management.port&quot; 섹션 는 지정된 구성요소의 포트 번호를 제공합니다.

{
  "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"
}

로그 보기

로그 파일은 시스템의 이벤트/운영과 관련된 메시지를 추적합니다. 메시지가 표시됨 또는 오류 조건이 발생할 때 로그에 기록됩니다. 로그 보기 파일이 있으면 CPU, 메모리, 디스크, 로드, CPU 및 저장과 같은 시스템 구성 요소에 대한 정보를 얻을 수 있습니다. 장애 상태에 도달하기 전후에 추적됩니다. 또한 이 도구를 사용하면 현재 시스템 문제의 원인을 진단하거나 잠재적인 시스템 예측 지원 문제를 해결하는 데 도움이 됩니다

예를 들어 구성요소의 일반적인 시스템 로그에는 아래와 같은 항목이 포함됩니다.

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 ;

/<inst_root>/apigee/conf/logback.xml 파일을 편집하여 로깅을 제어할 수 있습니다. 재부팅할 필요가 없습니다 logback.xml 파일에는 다음이 포함되어 있습니다. 이 속성은 로깅 메커니즘이 logback.xml 파일을 검사하는 빈도를 설정하는 속성입니다. 구성 변경사항:

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

기본적으로 로깅 메커니즘은 변경사항을 1분마다 확인합니다. 시간 단위를 생략하는 경우 scanPeriod 속성에 기본값은 밀리초입니다.

다음 표에서는 Apigee Edge 프라이빗 클라우드 구성요소의 로그 파일 위치를 보여줍니다.

구성요소

위치

관리 서버

&lt;inst_root&gt;/apigee/var/log/edge-management-server

라우터

&lt;inst_root&gt;/apigee/var/log/edge-router

메시지 프로세서

&lt;inst_root&gt;/apigee/var/log/edge-message-processor

Qpid 서버

&lt;inst_root&gt;/apigee/var/log/edge-qpid-server

Apigee Postgres 서버

&lt;inst_root&gt;/apigee/var/log/edge-postgres-server

Edge UI

&lt;inst_root&gt;/apigee/var/log/edge-ui

ZooKeeper

&lt;inst_root&gt;/apigee/var/log/apigee-zookeeper

OpenLDAP

&lt;inst_root&gt;/apigee/var/log/apigee-openldap

Cassandra

&lt;inst_root&gt;/apigee/var/log/apigee-cassandra

퀴피드

&lt;inst_root&gt;/apigee/var/log/apigee-qpidd

PostgreSQL 데이터베이스

&lt;inst_root&gt;/apigee/var/log/apigee-postgresql

메시지의 디버그 로그 사용 설정 프로세서 및 Edge UI

메시지 프로세서의 디버그 로그를 사용 설정하려면 다음 단계를 따르세요.

  1. 메시지 프로세서 노드에서 /&lt;install_dir&gt;/apigee/customer/application/messsage-processor.properties를 수정합니다. 해당 파일이 없으면 새로 만듭니다.
  2. 다음 속성을 파일에 추가합니다.
    conf_system_log.level=DEBUG
  3. 메시지 프로세서를 다시 시작합니다.
    &gt; /<install_dir>/apigee/apigee-service/bin/apigee-service Edge-message-processor 다시 시작

Edge UI의 디버그 로그를 사용 설정하려면 다음 안내를 따르세요.

  1. Edge UI 노드에서 /&lt;install_dir&gt;/apigee/customer/application/ui.properties를 수정합니다. 해당 파일이 없으면 새로 만듭니다.
  2. 다음 속성을 파일에 추가합니다.
    conf_application_logger.application=DEBUG
  3. Edge UI를 다시 시작합니다.
    &gt; /<install_dir>/apigee/apigee-service/bin/apigee-service Edge-ui 재시작

모니터링 도구

Nagios, Collectd, Graphite, Splunk, Sumologic, Monit을 사용하면 전체 엔터프라이즈 환경과 비즈니스 프로세스를 모니터링할 수 있습니다.

구성요소

Nagios

수집됨

Splunk

시스템 수준 검사

CPU 사용률

?

?

사용 가능/사용된 메모리

?

?

디스크 공간 사용량

?

?

네트워크 통계

?

?

프로세스

?

API 검사

?

JMX

?

자바

?

로그 파일

?

중요한 이벤트

비율 제한에 도달함

?

백엔드 서버 (Hybris 또는 SharePoint)에 연결할 수 없음

?

FaaS (STS)에 연결할 수 없음

?

경고 이벤트

SMTP 서버에 연결할 수 없습니다.

?

SLA 위반

?