監控最佳做法

Private Cloud v4.19.01 版

監控快訊

Apigee Edge 可讓您在何時將快訊轉送至系統記錄或外部監控系統/工具 因事件失敗而發生錯誤或失敗。這些警示可以是系統層級或 應用程式層級快訊/事件應用程式層級快訊主要是自訂快訊 根據產生的事件建立而成網路管理員通常會將 條件。如要進一步瞭解快訊,請與 Apigee 支援團隊聯絡。

設定快訊門檻

設定門檻後必須產生快訊。設定方式取決於您的 硬體設定門檻應以容量為準。例如 Apigee 如果容量只有 6 GB,邊緣可能過低。您可以指派等於 (=) 的門檻 或大於 (>) 標準。也可以指定兩個連續之間的時間間隔 生成快訊但可以使用小時/分鐘/秒的選項。

設定系統層級快訊的條件

下表說明這些條件:

快訊 建議的門檻 說明

記憶體不足

500MB

記憶體不足,無法啟動元件

磁碟空間不足 (/var/log)

8 GB

磁碟空間不足。

高負載

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
  • ZooKeeper 連接埠 2181
  • OpenLDAP 通訊埠 10389

如要判斷每個 Apigee 元件要在哪個通訊埠監聽 API 呼叫,請發出 下列對 Management Server 的 API 呼叫 (通常是透過通訊埠 8080):

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

這些指令的輸出內容會包含與下方相似的區段。 http.management.port 區段提供指定元件的通訊埠號碼。

{
  "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、記憶體、磁碟、負載 因此在取得失敗狀態前後這也能讓您 診斷目前系統問題的來源,或預測潛在系統 如要解決關聯問題,可用 Apriori 這類關聯規則學習技術和演算法

例如,元件的一般系統記錄會包含下列項目:

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 ;

您可以編輯 /opt/apigee/conf/logback.xml 檔案來控制記錄機制,但沒有 而不必重新啟動伺服器logback.xml 檔案包含以下屬性: 記錄機制檢查 logback.xml 檔案是否有設定變更的頻率:

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

根據預設,記錄機制每分鐘會檢查變更。如果省略時間單位 設為 scanPeriod 屬性,則預設為毫秒。

下表提供 Apigee Edge 私有雲元件的記錄檔位置。

元件 位置

管理伺服器

opt/apigee/var/log/edge-management-server

路由器

opt/apigee/var/log/edge-router

訊息處理器

opt/apigee/var/log/edge-message-processor

Qpid 伺服器

opt/apigee/var/log/edge-qpid-server

Apigee Postgres 伺服器

opt/apigee/var/log/edge-postgres-server

Edge UI

opt/apigee/var/log/edge-ui

ZooKeeper

opt/apigee/var/log/apigee-zookeeper

OpenLDAP

opt/apigee/var/log/apigee-openldap

Cassandra

opt/apigee/var/log/apigee-cassandra

Qpidd

opt/apigee/var/log/apigee-qpidd

PostgreSQL 資料庫

opt/apigee/var/log/apigee-postgresql

啟用訊息的偵錯記錄 處理器和邊緣 UI

如何啟用訊息處理器的偵錯記錄:

  1. 在「訊息處理器」節點上編輯 /opt/apigee/customer/application/messsage-processor.properties。如果這個檔案 不存在,請先建立。
  2. 在檔案中新增以下屬性:
    conf_system_log.level=DEBUG
  3. 重新啟動訊息處理器:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

如何啟用 Edge UI 的偵錯記錄:

  1. 在 Edge UI 節點上編輯 /opt/apigee/customer/application/ui.properties。 如果該檔案不存在,請建立該檔案。
  2. 在檔案中新增以下屬性:
    conf_application_logger.application=DEBUG
  3. 重新啟動 Edge UI:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Apigee-monit 最佳做法

使用 apigee-monit 時,Apigee 建議您:

  • 在執行任何前先停止監控元件 啟動或停止作業的作業,例如備份或升級。
  • 使用 cron 等工具監控 apigee-monit。如要 相關資訊,請參閱監控 apigee-monit

監控工具

Nagios、Collectd、Graphite、Splunk、Sumologic 和 Monit 等監控工具可協助您 監控整個企業環境與業務流程

元件 Nagios 收集 Splunk

系統層級檢查

CPU 使用率

可用記憶體/可用記憶體

磁碟空間用量

網路統計資料

程序

API 檢查

JMX

Java

記錄檔

重大事件

達到頻率限制

無法連線至後端伺服器 (Hybris 或 SharePoint)

無法連線至 FaaS (STS)

警告事件

無法連上 SMTP 伺服器

違反的服務水準協議