모니터링 권장사항

Private Cloud용 Edge v. 4.16.09

알림 모니터링

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

알림 기준 설정

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

시스템 수준 경고 설정 기준

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

알림

추천 기준

설명

메모리 부족

500MB

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

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

8GB

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

높은 부하

3회 이상

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

프로세스 중지됨

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

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

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

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

  • 관리 서버, 라우터, 메시지 프로세서의 포트 4526, 4527, 4528
  • 관리 서버, 라우터, 메시지 프로세서의 포트 1099, 1100, 1101
  • 라우터의 포트 8081 및 15999
  • 메시지 프로세서의 포트 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 위반

?