本頁面由 Cloud Translation API 翻譯而成。

如何監控

本文件說明內部部署系統支援的元件監控技術 Apigee Edge 的私有雲部署作業

總覽

Edge 支援多種取得服務詳細資料及檢查服務狀態。下表列出每個符合資格的檢查項目類型服務：

		管理 API
元件	記憶體用量 [JMX^*]	服務檢查	使用者/機構/ 部署作業狀態	axstatus	資料庫檢查	`apigee-service` 狀態	`apigee-monit`**
管理伺服器
訊息處理器
路由器
Qpid
Postgres
	更多資訊	更多資訊	更多資訊	更多資訊	更多資訊	更多資訊	更多資訊
^{* 您必須先啟用 JMX ，詳細說明請參閱啟用 JMX。} ^{** apigee-monit 服務會檢查元件是否更新，並會嘗試如果不是，請重新啟動。如需詳細資訊，請參閱使用自我修復 apigee-monit。}

監控通訊埠和設定檔

每個元件都支援 Java Management Extensions (JMX) 和 Management API 監控呼叫不同的通訊埠下表列出每種伺服器類型的 JMX and Management API 通訊埠設定檔位置：

元件	JMX 通訊埠	Management API 通訊埠	設定檔位置
管理伺服器	1099	8080	`$APIGEE_ROOT/customer/application/management-server.properties`
訊息處理器	1101	8082	`$APIGEE_ROOT/customer/application/message-processor.properties`
路由器	1100	8081	`$APIGEE_ROOT/customer/application/router.properties`
Qpid	1102	8083	`$APIGEE_ROOT/customer/application/qpid-server.properties`
Postgres	1103	8084	`$APIGEE_ROOT/customer/application/postgres-server.properties`

使用 JMX 監控元件

以下各節說明如何使用 JMX 監控 Edge 元件。

啟用 JMX

如要在不啟用驗證或 SSL 式通訊的情況下啟用 JMX，請執行下列步驟。 注意：在實際運作系統中，您應該為安全性。

編輯適當的設定檔 (請參閱設定檔參考資料)。如果設定檔不存在，請建立設定檔。
```
conf_system_jmxremote_enable=true
```
儲存設定檔，並確認該檔案的擁有者為 apigee:apigee。

重新啟動適當的 Edge 元件

apigee-service edge-management-server restart

如要停用 JMX，請移除 conf_system_jmxremote_enable 屬性或變更將其值設為 false。然後重新啟動適當的 Edge 元件。

JMX 驗證

Edge for Private Cloud 支援使用儲存在檔案中的詳細資料以密碼進行驗證。您可以將密碼儲存為雜湊，進一步提升安全性。

如要在 Edge-* 元件中啟用 JMX 驗證，請編輯適當的設定檔 (請參閱設定檔參考資料)。如果設定檔不存在，請建立設定檔：

conf_system_jmxremote_enable=true
conf_system_jmxremote_authenticate=true
conf_system_jmxremote_encrypted_auth=true
conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access
conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password

敬上儲存設定檔，並確認該檔案的擁有者為 apigee:apigee。

為密碼建立 SHA256 雜湊：
```
echo -n '' | openssl dgst -sha256
```

使用 JMX 使用者憑證建立 jmxremote.password 檔案：

將下列檔案從 $JAVA_HOME 目錄複製到 /opt/apigee/customer/application/<component>/ 目錄：

cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/management-server/jmxremote.password

編輯檔案，並使用以下語法新增 JMX 使用者名稱和密碼：
```
USERNAME <HASH-PASSWORD>
```

確認檔案的擁有者為 apigee，且檔案模式為 400：

chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password
chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.password

建立具有 JMX 使用者權限的 jmxremote.access 檔案：

將下列檔案從 $JAVA_HOME 目錄中複製到 /opt/apigee/customer/application/<component>/ 目錄


cp ${JAVA_HOME}/lib/management/jmxremote.access$APIGEE_ROOT/customer/application/management-server/jmxremote.password/jmxremote.access

編輯檔案，然後新增 JMX 使用者名稱並在後方加上權限 (READONLY/READWRITE)
```
USERNAME READONLY
```

確認檔案的擁有者為 apigee，且檔案模式為 400：

chown apigee:apigee $APIGEE_ROOT/customer/application/management-server/jmxremote.password

chmod 400 $APIGEE_ROOT/customer/application/management-server/jmxremote.access

重新啟動適當的 Edge 元件：

apigee-service edge-management-server restart

如要停用 JMX 驗證，請移除屬性請conf_system_jmxremote_authenticate，或將值改為 false，重新啟動適當的 Edge 元件。

JMX 中的 SSL

如何在 Edge-* 元件中啟用 SSL 型 JMX：

編輯適當的設定檔 (請參閱設定檔參考資料)。如果設定檔不存在，請建立設定檔：

conf_system_jmxremote_enable=true
conf_system_jmxremote_ssl=true
conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore
conf_system_javax_net_ssl_keystorepassword=<keystore-password>

敬上儲存設定檔，並確認該檔案的擁有者為 apigee:apigee。

準備含有伺服器金鑰的 KeyStore，然後將其放在設定 conf_system_javax_net_ssl_keystore。確認 KeyStore 檔案可由 apigee:apigee 讀取。

重新啟動適當的 Edge 元件：

apigee-service edge-management-server restart

如要停用 SSL 型 JMX，請移除屬性 conf_system_jmxremote_ssl 或將值改為 false。重新啟動適當的 Edge 元件。

透過 Jconsole 監控

透過 Jconsole 監控操作說明的方式與 https://docs.apigee.com/private-cloud/v4.52.01/how-monitor#jconsole.

可加入一行文字：「如果 JMX 啟用 SSL，則必須啟動 Truststore 和 Truststore 密碼。」參考資料：https://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html

使用 JConsole 監控

使用 JConsole (與 JMX 相容的工具) 管理及監控健康狀態檢查和程序統計資料。透過 JConsole，您可以使用伺服器揭露的 JMX 統計資料，並將這些統計資料顯示在圖形介面。若需更多資訊，請參閲使用 JConsole。

如果 JMX 已啟用 SSL，您需要使用信任儲存庫和信任儲存庫密碼啟動 JConsole。詳情請參閱使用 JConsole。

JConsole 會使用下列服務網址來監控透過 JMX：

service:jmx:rmi:///jndi/rmi://IP_address:port_number/jmxrmi

在此情況下：

IP_address 是您要監控的伺服器 IP 位址。
port_number 是您要授予的伺服器 JMX 通訊埠編號監控功能

舉例來說，若要監控管理伺服器，發出類似如下的指令 (假設伺服器的 IP 位址為 216.3.128.12)：

service:jmx:rmi:///jndi/rmi://216.3.128.12:1099/jmxrmi

請注意，這個範例指定了通訊埠 1099，也就是管理伺服器 JMX 通訊埠。如果您不是通訊埠，請參閱 JMX and Management API 監控通訊埠。

下表列出一般 JMX 統計資料：

JMX MBeans	JMX 屬性
記憶體	HeapMemoryUsage
	NonHeapMemoryUsage
	用量
附註屬性值會以四形式顯示值：Commit、init、max 和 used。

設定檔參考資料

以下各節說明您可能需要對 Edge 元件設定進行的變更檔案。詳情請見監控通訊埠和設定檔瞭解詳情可能不準確或不適當

將 JMX 設定新增至適當元件的設定檔

在邊緣元件上啟用 JMX 代理程式。預設為 False。
```
conf_system_jmxremote_enable=true
```

密碼式驗證設定

啟用密碼式驗證。預設為 False。
```
conf_system_jmxremote_authenticate=true
```

檔案存取路徑。僅限 Apigee 使用者擁有及讀取。

conf_system_jmxremote_access_file=/opt/apigee/customer/application/management-server/jmxremote.access

密碼檔案的路徑。僅限 Apigee 使用者擁有及讀取。

conf_system_jmxremote_password_file=/opt/apigee/customer/application/management-server/jmxremote.password

允許以加密格式儲存密碼。預設為 False。
```
conf_system_jmxremote_encrypted_auth=true
```

基於 SSL 的 JMX 設定

啟用 JMX 通訊的 SSL。預設為 False。
```
conf_system_jmxremote_ssl=true
```

KeyStore 路徑。僅限 Apigee 使用者擁有及讀取。

conf_system_javax_net_ssl_keystore=/opt/apigee/customer/application/management-server/jmxremote.keystore

KeyStore 密碼：

conf_system_javax_net_ssl_keystorepassword=changeme

選用的 JMX 設定

列出的值為預設值，可以變更。

JMX 通訊埠。預設值如下表所示。
```
conf_system_jmxremote_port=
```
JMX RMI 通訊埠。根據預設，Java 程序會挑選隨機通訊埠。
```
conf_system_jmxremote_rmi_port=
```
遠端虛設常式的主機名稱。localhost 的預設 IP 位址。
```
conf_system_java_rmi_server_hostname=
```
使用 SSL 保護 JMX 登錄檔。預設值為 false。只有在啟用 SSL 時才適用。
```
conf_system_jmxremote_registry_ssl=false
```

使用 Management API 監控

Edge 提供多個 API，可讓您用於在伺服器上執行服務檢查，以及檢查使用者、機構和部署作業本節將說明這些 API。

執行服務檢查

Management API 提供多個端點，用以監控和診斷免費 Google Cloud 服務這些端點包括：

端點說明

端點	說明
`/servers/self/up`	檢查服務是否正在執行。您不必執行這項 API 呼叫，並進行驗證。如果服務正在執行，此端點會傳回下列回應： <ServerField> <Up>true</Up> </ServerField> 如果服務並未執行，您會收到類似以下的回應 (視服務類型和檢查方式而定)： curl: Failed connect to localhost:`port_number`; Connection refused
`/servers/self`	傳回服務的相關資訊，包括：設定屬性開始時間和開始時間建構、RPM 和 UUID 資訊內部和外部主機名稱和 IP 位址區域和 Pod `<isUp>` 屬性，表示服務是否正在執行這個 API 呼叫需要用 Apigee 管理員憑證進行驗證。

/servers/self/up

檢查服務是否正在執行。您不必執行這項 API 呼叫，並進行驗證。

如果服務正在執行，此端點會傳回下列回應：

<ServerField>
  <Up>true</Up>
</ServerField>

如果服務並未執行，您會收到類似以下的回應 (視服務類型和檢查方式而定)：

curl: Failed connect to localhost:port_number; Connection refused

/servers/self

傳回服務的相關資訊，包括：

設定屬性
開始時間和開始時間
建構、RPM 和 UUID 資訊
內部和外部主機名稱和 IP 位址
區域和 Pod
<isUp> 屬性，表示服務是否正在執行

這個 API 呼叫需要用 Apigee 管理員憑證進行驗證。

如要使用這些端點，請透過使用curl 語法如下：

curl http://host:port_number/v1/servers/self/up -H "Accept: [application/json|application/xml]"
curl http://host:port_number/v1/servers/self -u username:password -H "Accept: [application/json|application/xml]"

在此情況下：

host 是您要檢查的伺服器 IP 位址。如果您已經登入伺服器可以使用「localhost」否則，請一併指定伺服器的 IP 位址做為使用者名稱和密碼
port_number 是您要檢查伺服器的 Management API 通訊埠。這是為每個元件類型使用不同的通訊埠舉例來說，管理伺服器的 Management API 通訊埠為 8080。如需要使用的 Management API 通訊埠編號清單，請參閱 JMX and Management API 監控通訊埠

如要變更回應格式，您可以將 Accept 標頭指定為 "application/json"或「application/xml」

以下範例會取得 localhost (通訊埠 8081) 上的路由器狀態：

curl http://localhost:8081/v1/servers/self/up -H "Accept: application/xml"

下列範例會取得 216.3.128.12 (通訊埠) 的訊息處理者資訊 8082)：

curl http://216.3.128.12:8082/v1/servers/self -u sysAdminEmail:password
  -H "Accept: application/xml"

監控使用者、機構及部署狀態

您可以使用 Management API 監控使用者、機構及部署狀態執行下列指令，管理管理伺服器和訊息處理器上的 Proxy：

curl http://host:port_number/v1/users -u sysAdminEmail:password
curl http://host:port_number/v1/organizations -u sysAdminEmail:password
curl http://host:port_number/v1/organizations/orgname/deployments -u sysAdminEmail:password

其中 port_number 為管理伺服器 (管理伺服器) 8080 或 8082 (訊息) 處理器。

這個呼叫需要您透過系統管理使用者名稱進行驗證密碼。

伺服器應會傳回「已部署」的。如果上述方法失敗，請執行以下操作：

查看伺服器記錄，瞭解是否有任何錯誤。記錄位於：
- 管理伺服器：opt/apigee/var/log/edge-management-server
- 訊息處理器：opt/apigee/var/log/edge-message-processor
對伺服器發出呼叫，檢查該伺服器是否正常運作。
將伺服器從 ELB 中移除，然後重新啟動：
```
/opt/apigee/apigee-service/bin/apigee-service service_name restart
```
其中 service_name 為：
- edge-management-server
- edge-message-processor

使用 `apigee-service` 指令檢查狀態

您可以在以下情況下使用 apigee-service 指令排解 Edge 服務問題：使用者登入執行服務的伺服器。

如要使用 apigee-service 查看服務狀態，請按照下列步驟操作：

登入伺服器並執行下列指令：
```
/opt/apigee/apigee-service/bin/apigee-service service_name status
```
其中 service_name 為下列其中一項：
- 管理伺服器：edge-management-server
- 訊息處理器：edge-message-processor
- Postgres：edge-postgres-server
- Qpid：edge-qpid-server
- 路由器：edge-router
例如：
```
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor status
```

如果服務未執行，請啟動服務：

/opt/apigee/apigee-service/bin/apigee-service service_name start

重新啟動服務後，使用先前使用的 apigee-service status 指令，或透過 Management API 執行相關說明請參閱「使用 Management API 監控」一文。
例如：
```
curl -v http://localhost:port_number/v1/servers/self/up
```
其中 port_number 是服務的 Management API 通訊埠。

這個範例假設您已登入伺服器，且可以使用「localhost」作為主機名稱。如要使用 Management API 遠端檢查狀態，您必須指定 IP 位址位址，並在 API 中納入系統管理員的使用者名稱和密碼呼叫。

Postgres 監控

Postgres 支援多種公用程式，可用來查看其狀態。這些公用程式都會在後續章節中說明。

查看 Postgres 上的機構和環境

您可以查看已加入 Postgres 伺服器的機構和環境名稱執行下列 curl 指令：

curl -v http://postgres_IP:8084/v1/servers/self/organizations

系統應會顯示機構和環境名稱。

驗證數據分析狀態

您可以發出以下項目，驗證 Postgres 和 Qpid 分析伺服器的狀態 curl 指令：

curl -u userEmail:password http://host:port_number/v1/organizations/orgname/environments/envname/provisioning/axstatus

系統應會顯示所有分析伺服器的成功狀態，如以下範例所示顯示：

{
  "environments" : [ {
    "components" : [ {
      "message" : "success at Thu Feb 28 10:27:38 CET 2013",
      "name" : "pg",
      "status" : "SUCCESS",
      "uuid" : "[c678d16c-7990-4a5a-ae19-a99f925fcb93]"
     }, {
      "message" : "success at Thu Feb 28 10:29:03 CET 2013",
      "name" : "qs",
      "status" : "SUCCESS",
      "uuid" : "[ee9f0db7-a9d3-4d21-96c5-1a15b0bf0adf]"
     } ],
    "message" : "",
    "name" : "prod"
   } ],
  "organization" : "acme",
  "status" : "SUCCESS"
}

PostgreSQL 資料庫

本節說明您可以專門用於監控 Postgres 的技術資料庫

使用 `check_postgres.pl` 指令碼

如要監控 PostgreSQL 資料庫，可以使用標準監控指令碼 check_postgres.pl。若需更多資訊，請參閲 http://bucardo.org/wiki/Check_postgres.

執行指令碼之前：

您必須在每個 Postgres 節點上安裝 check_postgres.pl 指令碼。
確認您已安裝 perl-Time-HiRes.x86_64。執行高解析度鬧鐘、睡眠、取得時間和間歇計時器。舉例來說，可以使用以下指令進行安裝：
```
yum install perl-Time-HiRes.x86_64
```
CentOS 7：在 CentOS v7 上使用 check_postgres.pl 前，請先安裝每分鐘 perl-Data-Dumper.x86_64 轉。

check_postgres.pl 輸出

使用 check_postgres.pl 的 API 呼叫預設輸出內容為 Nagios 相容。安裝指令碼後，請進行以下檢查：

檢查資料庫大小：

check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -include=apigee -action database_size --warning='800 GB' --critical='900 GB'

檢查資料庫連入連線數量，並與允許的數量上限進行比較連線：
```
check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action backends
```

檢查資料庫是否正在執行並且可供使用：

check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action connection

檢查磁碟空間：

check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action disk_space --warning='80%' --critical='90%'

檢查在 Postgres 節點中登入的機構和環境數量：

check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action=custom_query --query="select count(*) as result from pg_tables where schemaname='analytics' and tablename like '%fact'" --warning='80' --critical='90' --valtype=integer

執行資料庫檢查

您可以驗證是否已在 PostgreSQL 資料庫中建立適當的資料表。登入 PostgreSQL 建立資料庫

psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee

接著執行：

\d analytics."org.env.fact"

查看 postgres 程序的健康狀態

您可以叫用下列 curl，在 Postgres 機器上執行 API 檢查指令：

curl -v http://postgres_IP:8084/v1/servers/self/health

這個指令會在 postgres 程序執行時傳回 ACTIVE 狀態。如果 Postgres 程序未執行，會傳回 INACTIVE 狀態。

Postgres 資源

如要進一步瞭解如何監控 Postgres 服務，請參閱以下資訊：

Apache Cassandra

Cassandra 預設會啟用 JMX，遠端 JMX 存取 Cassandra 不需要密碼。

為 Cassandra 啟用 JMX 驗證

您可以為 Cassandra 啟用 JMX 驗證。執行完成後，系統會要求您將使用者名稱和密碼向所有對 nodetool 公用程式的呼叫傳遞。

如何為 Cassandra 啟用 JMX 驗證：

建立及編輯 cassandra.properties 檔案：

編輯 /opt/apigee/customer/application/cassandra.properties 檔案。如果檔案不存在，請建立該檔案。

請將以下內容新增到該檔案：

conf_cassandra_env_com.sun.management.jmxremote.authenticate=true
conf_cassandra_env_com.sun.management.jmxremote.password.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.password
conf_cassandra_env_com.sun.management.jmxremote.access.file=${APIGEE_ROOT}/customer/application/apigee-cassandra/jmxremote.access

儲存 cassandra.properties 檔案。

將檔案擁有者變更為 apigee:apigee，如以下範例所示：

chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

如要進一步瞭解如何使用屬性檔案設定符記，請參閱如何設定 Edge。

建立及編輯 jmx_auth.sh：

如果檔案不存在，請於以下位置建立檔案：
```
/opt/apigee/customer/application/jmx_auth.sh
```

在檔案中新增下列屬性：

export CASS_JMX_USERNAME=JMX_USERNAME
export CASS_JMX_PASSWORD=JMX_PASSWORD

儲存 jmx_auth.sh 檔案。

檔案來源：

source /opt/apigee/customer/application/jmx_auth.sh

複製並編輯 jmxremote.password 檔案：
1. 將下列檔案從 $JAVA_HOME 目錄複製到 /opt/apigee/customer/application/apigee-cassandra/:
```
cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password
```
2. 編輯 jmxremote.password 檔案，並新增 JMX 使用者名稱和密碼使用下列語法：
```
JMX_USERNAME JMX_PASSWORD
```
  其中 JMX_USERNAME 和 JMX_PASSWORD 是 JMX 使用者名稱和密碼。
3. 請確定檔案的擁有者為「apigee」並且檔案模式為 400：
```
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.password
```

複製並編輯 jmxremote.access 檔案：

將下列檔案從 $JAVA_HOME 目錄複製到 /opt/apigee/customer/application/apigee-cassandra/:

cp ${JAVA_HOME}/lib/management/jmxremote.access
$APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.access

編輯 jmxremote.access 檔案並新增下列角色：
```
JMX_USERNAME readwrite
```

請確定檔案的擁有者為「apigee」並且檔案模式為 400：

chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/jmxremote.access
chmod 400 /opt/apigee/customer/application/apigee-cassandra/jmxremote.access

在 Cassandra 上執行 configure：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

重新啟動 Cassandra：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

對所有其他 Cassandra 節點重複這項程序。

啟用 JMX 密碼加密

如要啟用 JMX 密碼加密，請按照下列步驟操作：

開啟 source/conf/casssandra-env.sh 檔案。
建立及編輯 cassandra.properties 檔案：
1. 編輯 /opt/apigee/customer/application/cassandra.properties 檔案。如果檔案不存在，請建立該檔案。
2. 請將以下內容新增到該檔案：
```
conf_cassandra_env_com.sun.management.jmxremote.encrypted.authenticate=true
```
3. 儲存 cassandra.properties 檔案。
4. 將檔案擁有者變更為 apigee:apigee，如以下範例所示：
```
chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
```
在指令列中輸入文字，產生所需密碼的 SHA1 雜湊 echo -n 'Secret' | openssl dgst -sha1
根據使用者名稱設定密碼： $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password (建立於前一節所述)。

在 Cassandra 上執行設定：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

重新啟動 Cassandra：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

對所有其他 Cassandra 節點重複這項程序。

為 Cassandra 啟用具備 SSL 的 JMX

啟用 JMX 搭配 SSL 可為與 Cassandra如要透過 SSL 啟用 JMX，您必須向 Cassandra 提供金鑰和憑證，以便接受 SSL 型 JMX 連線。另外，您也需要設定 nodetool (以及以便與 SSL 通訊。

啟用 SSL 的 JMX 支援明文和加密的 JMX 密碼。

如要為 Cassandra 啟用具備 SSL 的 JMX，請按照下列步驟操作：

啟用 JMX。必要時啟用密碼加密。
為 Cassandra 啟用 JMX 驗證。。確保 nodetool 正常運作使用者名稱和密碼
```
/opt/apigee/apigee-cassandra/bin/nodetool -u <JMX_USER> -pw <JMX_PASS> ring
```
準備 KeyStore 和信任儲存庫。
- KeyStore 應包含金鑰和憑證。並用於設定 Cassandra 伺服器如果是 KeyStore 包含多個金鑰組，Cassandra 會使用第一個金鑰組即可啟用 SSL 功能。
  
  請注意，KeyStore 的密碼和金鑰應相同 (使用 keytool 產生金鑰時的預設值)。
- Truststore 只能包含憑證，並由用戶端使用 (以 Apigee 服務為基礎) 指令或 nodetool) 來透過 JMX 連線。
確認上述規定後：
1. 將 KeyStore 檔案放入 /opt/apigee/customer/application/apigee-cassandra/ 中。
2. 藉由輸入
```
chown apigee:apigee /opt/apigee/customer/application/apigee-cassandra/keystore.node1
chmod 400 /opt/apigee/customer/application/apigee-cassandra/keystore.node1
```

請按照下列步驟為具有 SSL 的 JMX 設定 Cassandra：

輸入以停止 Cassandra 節點
```
apigee-service apigee-cassandra stop
```

透過以下方式在 Cassandra 中啟用安全資料傳輸層 (SSL) 開啟檔案「/opt/apigee/customer/application/cassandra.properties」然後加入下列程式碼：

conf_cassandra_env_com.sun.management.jmxremote.ssl=true
conf_cassandra_env_javax.net.ssl.keyStore=/opt/apigee/customer/application/apigee-cassandra/keystore.node1
conf_cassandra_env_javax.net.ssl.keyStorePassword=keystore-password

將檔案擁有者變更為 apigee:apigee，如以下範例所示：

chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

在 Cassandra 上執行設定：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

重新啟動 Cassandra：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

對所有其他 Cassandra 節點重複這項程序。
輸入
```
apigee-service apigee-cassandra start
```

設定 apigee-service Cassandra 指令。您需要在執行期間設定特定環境變數 apigee-service 指令，包括下列指令：

apigee-service apigee-cassandra stop
apigee-service apigee-cassandra wait_for_ready
apigee-service apigee-cassandra ring
apigee-service apigee-cassandra backup

為 JMX 驗證設定 apigee-service 的方法有很多種以及 SSL請依據可用性和安全性做法選擇所需選項。

選項 1 (儲存在檔案中的 SSL 引數)
選項 2 (儲存在環境變數中的 SSL 引數)
選項 3 (直接傳遞至 apigee-service 的 SSL 引數)

選項 1 (儲存在檔案中的 SSL 引數)

設定下列環境變數：

export CASS_JMX_USERNAME=ADMIN
# Provide encrypted password here if you have setup JMX password encryption
export CASS_JMX_PASSWORD=PASSWORD
export CASS_JMX_SSL=Y

在 Apigee 使用者的主目錄 (/opt/apigee) 中建立檔案。

$HOME/.cassandra/nodetool-ssl.properties

編輯該檔案，並新增下列程式碼：

-Djavax.net.ssl.trustStore=<path-to-truststore.node1>
-Djavax.net.ssl.trustStorePassword=<truststore-password>
-Dcom.sun.management.jmxremote.registry.ssl=true

確保 Apigee 使用者能夠讀取信任檔案。

執行下列 apigee-service 指令。如果執行時沒有發生錯誤，就表示您的設定正確無誤。

apigee-service apigee-cassandra ring

選項 2 (儲存在環境變數中的 SSL 引數)

設定下列環境變數：

export CASS_JMX_USERNAME=ADMIN
# Provide encrypted password here if you have setup JMX password encryption
export CASS_JMX_PASSWORD=PASSWORD
export CASS_JMX_SSL=Y
# Ensure the truststore file is accessible by Apigee user.
export CASS_JMX_TRUSTSTORE=<path-to-trustore.node1>
export CASS_JMX_TRUSTSTORE_PASSWORD=<truststore-password>

執行下列 apigee-service 指令。如果執行時沒有發生錯誤，就表示您的設定正確無誤。

apigee-service apigee-cassandra ring

選項 3 (直接傳遞至 `apigee-service` 的 SSL 引數)

執行任何 apigee-service 指令，如下所示。您不需要設定任何環境變數。

CASS_JMX_USERNAME=ADMIN CASS_JMX_PASSWORD=PASSWORD CASS_JMX_SSL=Y CASS_JMX_TRUSTSTORE=<path-to-trustore.node1> CASS_JMX_TRUSTSTORE_PASSWORD=<trustore-password> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra ring

設定 nodetool。必須將 JMX 參數傳遞至 Nodetool。與 GCP 互動的方式您可以將 nodetool 設為在執行時使用已啟用 SSL 的 JMX 環境，詳情請參閱設定選項如下：
- 設定選項 1
- 設定選項 2
選項與 SSL 相關設定傳送至 nodetool 的方式不同。無論是哪種情況執行 nodetool 的使用者應擁有信任儲存庫檔案的 READ 權限。請依據可用性和安全性做法選取適當選項。

如要進一步瞭解 nodetool 參數，請參閱 DataStax 說明文件。

設定選項 1

在執行 nodetool 的使用者主目錄中建立檔案。
```
$HOME/.cassandra/nodetool-ssl.properties
```
在檔案中新增下列幾行內容：
```
-Djavax.net.ssl.trustStore=<path-to-truststore.node1>
-Djavax.net.ssl.trustStorePassword=<truststore-password>
-Dcom.sun.management.jmxremote.registry.ssl=true
```
凡是執行上述作業的使用者，都能存取上方指定的信任存放區路徑 nodetool.

使用 --ssl 選項執行 nodetool。
```
/opt/apigee/apigee-cassandra/bin/nodetool --ssl -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring
```
設定選項 2

使用包含下列額外參數的單一指令執行 nodetool。
```
/opt/apigee/apigee-cassandra/bin/nodetool -Djavax.net.ssl.trustStore=<path-to-truststore.node1> -Djavax.net.ssl.trustStorePassword=<truststore-password> -Dcom.sun.management.jmxremote.registry.ssl=true -Dssl.enable=true -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring
```

還原 SSL 設定

如果您需要還原程序中所述的 SSL 設定，請按照下列步驟操作：

加入即可apigee-cassandra停止
```
apigee-service apigee-cassandra stop
```
移除下列位置的 conf_cassandra-env_com.sun.management.jmxremote.ssl=true 行： /opt/apigee/customer/application/cassandra.properties 檔案。

將 /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh 中的下列幾行註解排除

# JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStore=/opt/apigee/data/apigee-cassandra/keystore.node0"
# JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStorePassword=keypass"
# JVM_OPTS="$JVM_OPTS -Dcom.sun.management.jmxremote.registry.ssl=true”

從入場apigee-cassandra開始

apigee-service apigee-cassandra start

如果已設定環境變數 CASS_JMX_SSL，請移除該變數。
```
unset CASS_JMX_SSL
```
檢查 apigee-service 的指令，例如 ring、 stop、backup 等都在運作中。
停止搭配使用 --ssl 切換器和 nodetool

停用 Cassandra 的 JMX 驗證

如何為 Cassandra 停用 JMX 驗證：

編輯 /opt/apigee/customer/application/cassandra.properties。

請在檔案中移除下列這一行：

conf_cassandra-env_com.sun.management.jmxremote.authenticate=true

在 Cassandra 上執行設定：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure

重新啟動 Cassandra：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

對所有其他 Cassandra 節點重複這項程序。

使用 JConsole：監控工作統計資料

使用 JConsole 和下列服務網址，監控透過 JMX：

service:jmx:rmi:///jndi/rmi://IP_address:7199/jmxrmi

其中 IP_address 是 Cassandra 伺服器的 IP。

Cassandra JMX 統計資料

JMX MBeans	JMX 屬性
ColumnFamilies/apprepo/environments ColumnFamilies/apprepo/organizations ColumnFamilies/apprepo/apiproxy_revisions ColumnFamilies/apprepo/apiproxies ColumnFamilies/audit/audits ColumnFamilies/audit/audits_ref	PendingTasks
	MemtableColumnsCount
	MemtableDataSize
	ReadCount
	RecentReadLatencyMicros
	TotalReadLatencyMicros
	WriteCount
	RecentWriteLatencyMicros
	TotalWriteLatencyMicros
	TotalDiskSpaceUsed
	LiveDiskSpaceUsed
	LiveSSTableCount
	BloomFilterFalsePositives
	RecentBloomFilterFalseRatio
	BloomFilterFalseRatio

使用 nodetool 管理叢集節點

nodetool 公用程式是 Cassandra 的指令列介面，叢集節點您可以在 /opt/apigee/apigee-cassandra/bin 找到這個公用程式。

可以對所有 Cassandra 叢集節點進行下列呼叫：

一般環狀資訊 (適用於單一 Cassandra 節點)：請找出「向上」和「Normal」適用於所有節點

nodetool [-u username -pw password] -h localhost ring

只有在下列情況下，您才需要傳送使用者名稱和密碼為 Cassandra 啟用 JMX 驗證。

上述指令的輸出內容如下所示：

Datacenter: dc-1
==========
Address            Rack     Status State   Load    Owns    Token
192.168.124.201    ra1      Up     Normal  1.67 MB 33,33%  0
192.168.124.202    ra1      Up     Normal  1.68 MB 33,33%  5671...5242
192.168.124.203    ra1      Up     Normal  1.67 MB 33,33%  1134...0484

節點的一般資訊 (每個節點的呼叫)

nodetool [-u username -pw password]  -h localhost info

上述指令的輸出內容如下所示：

ID                     : e2e42793-4242-4e82-bcf0-oicu812
Gossip active          : true
Thrift active          : true
Native Transport active: true
Load                   : 273.71 KB
Generation No          : 1234567890
Uptime (seconds)       : 687194
Heap Memory (MB)       : 314.62 / 3680.00
Off Heap Memory (MB)   : 0.14
Data Center            : dc-1
Rack                   : ra-1
Exceptions             : 0
Key Cache              : entries 150, size 13.52 KB, capacity 100 MB, 1520781 hits, 1520923 requests, 1.000 recent hit rate, 14400 save period in seconds
Row Cache              : entries 0, size 0 bytes, capacity 0 bytes, 0 hits, 0 requests, NaN recent hit rate, 0 save period in seconds
Counter Cache          : entries 0, size 0 bytes, capacity 50 MB, 0 hits, 0 requests, NaN recent hit rate, 7200 save period in seconds
Token                  : 0

等待伺服器的狀態 (提供用戶端 API)
```
nodetool [-u username -pw password] -h localhost statusthrift
```
上述指令的輸出內容如下所示：
```
running
```

資料串流作業狀態：觀察 Cassandra 節點的流量：

nodetool [-u username -pw password] -h localhost netstats

上述指令的輸出內容如下所示：

Mode: NORMAL
Not sending any streams.
Read Repair Statistics:
Attempted: 151612
Mismatch (Blocking): 0
Mismatch (Background): 0
Pool Name                    Active   Pending      Completed   Dropped
Commands                        n/a         0              0         0
Responses                       n/a         0              0       n/a

如要進一步瞭解 nodetool，請參閱關於 nodetool 公用程式。

Cassandra 資源

請參閱以下網址：http://www.datastax.com/docs/1.0/operations/monitoring。

監控 Apache Qpid Broker-J

您可以透過 Qpid 管理控制台監控 Qpid Broker-J。本節說明以及如何存取控制台來執行基本監控功能。如要進一步瞭解有關使用管理主控台的資訊，請參閱網路管理控制台，參閱 Apache Qpid 說明文件。

存取管理控制台

預設的管理主控台通訊埠為 8090。如何存取這個預設通訊埠的控制台：網路瀏覽器指向：

http://QPID_NODE_IP:8090

敬上

如要登入控制台，請使用 Apigee 或邊緣設定檔。詳情請參閱邊緣設定檔參考資料。

監控佇列和訊息

在左側導覽面板中，瀏覽至「Java-Broker」>虛擬主機 >佇列。選取佇列，在 UI 的主要部分查看其詳細資料。在詳細資料檢視畫面中「佇列屬性」和「統計資料」，包括已傳送訊息、已排入佇列、訊息率等資訊。

查看及下載記錄檔

在左側導覽面板中，瀏覽至「Java-Broker」代理人 >logfile，在主要使用者介面詳細資料檢視畫面，您可以查看記錄檔詳細資料及下載記錄檔。

使用 Qpid Management API

您可以使用 Apache Qpid Broker-J REST API 自動管理工作及監控代理程式。如需詳細資訊，請參閱 Apache Qpid 代理程式 REST API 說明文件。

您也可以使用指令列工具來監控代理程式。例如：

curl "QPID_NODE_IP":"8090"/api/latest/broker -u "USERNAME":"PASSWORD"

Apache ZooKeeper

查看 ZooKeeper 狀態

確認 ZooKeeper 程序正在執行。ZooKeeper 會將 PID 檔案寫入 opt/apigee/var/run/apigee-zookeeper/apigee-zookeeper.pid。
測試 ZooKeeper 通訊埠，以確保您可以建立與通訊埠 2181 及 3888 美元。
確認您可以從 ZooKeeper 資料庫讀取值。使用 ZooKeeper 連線用戶端程式庫 (或 /opt/apigee/apigee-zookeeper/bin/zkCli.sh)，並讀取

檢查狀態：

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper status

使用 ZooKeeper 字母字詞

透過傳送一組命令 (四個字母的單字) 即可監控 ZooKeeper，而指令會傳送至通訊埠 2181 使用 netcat (nc) 或 telnet

如要進一步瞭解 ZooKeeper 指令，請參閱 Apache ZooKeeper 指令參考資料。

例如：

srvr：列出伺服器的完整詳細資料。
stat：列出伺服器和已連線用戶端的簡要詳細資料。

您可以對 ZooKeeper 連接埠發出以下指令：

只要執行四個字母的指令 ruok，即可測試伺服器是否在非錯誤狀態下執行。A 罩杯成功的回應會傳回「imok」
```
echo ruok | nc host 2181
```
傳回：
```
imok
```

執行四字母指令 stat，即可列出伺服器效能並保持連線客戶統計資料：

echo stat | nc host 2181

傳回：

Zookeeper version: 3.4.5-1392090, built on 09/30/2012 17:52 GMT
Clients:
/0:0:0:0:0:0:0:1:33467[0](queued=0,recved=1,sent=0)
/192.168.124.201:42388[1](queued=0,recved=8433,sent=8433)
/192.168.124.202:42185[1](queued=0,recved=1339,sent=1347)
/192.168.124.204:39296[1](queued=0,recved=7688,sent=7692)
Latency min/avg/max: 0/0/128
Received: 26144
Sent: 26160
Connections: 4
Outstanding: 0
Zxid: 0x2000002c2
Mode: follower
Node count: 283

敬上

如果無法使用 netcat (nc)，您可以使用 Python 做為替代方案。建立檔案名為 zookeeper.py，包含下列內容：

import time, socket,
sys c = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
c.connect((sys.argv[1], 2181))
c.send(sys.argv[2])
time.sleep(0.1)
print c.recv(512)

現在執行下列 Python 程式碼：

python zookeeper.py 192.168.124.201 ruok
python zookeeper.py 192.168.124.201 stat

LDAP 層級測試

您可以監控 OpenLDAP，確認特定要求是否已正確提供。於意即尋找傳回正確結果的特定搜尋。

使用 ldapsearch (yum install openldap-clients) 查詢項目系統管理員的角色此項目可用來驗證所有 API 呼叫。

ldapsearch -b "uid=admin,ou=users,ou=global,dc=apigee,dc=com" -x -W -D "cn=manager,dc=apigee,dc=com" -H ldap://localhost:10389 -LLL

系統隨即會提示您輸入 LDAP 管理員密碼：

Enter LDAP Password:

輸入密碼後，您會在表單中看到回應：

dn:
uid=admin,ou=users,ou=global,dc=apigee,dc=com
objectClass: organizationalPerson
objectClass: person
objectClass: inetOrgPerson
objectClass: top
uid: admin
cn: admin
sn: admin
userPassword:: e1NTSEF9bS9xbS9RbVNXSFFtUWVsU1F0c3BGL3BQMkhObFp2eDFKUytmZVE9PQ=
 =
mail: opdk@google.com

請使用以下指令檢查 Management Server 是否仍與 LDAP 連線：

curl -u userEMail:password http://localhost:8080/v1/users/ADMIN

傳回：

{
  "emailId" : ADMIN,
  "firstName" : "admin",
  "lastName" : "admin"
}

您也可以監控 OpenLDAP 快取，進而減少存取磁碟的次數進而改善系統效能然後調整 Cloud Storage 中的 OpenLDAP 伺服器可能會嚴重影響目錄伺服器的效能。您可以查看記錄檔檔案 (opt/apigee/var/log) 來取得快取相關資訊。

如何監控

總覽

監控通訊埠和設定檔

使用 JMX 監控元件

啟用 JMX

JMX 驗證

JMX 中的 SSL

透過 Jconsole 監控

使用 JConsole 監控

設定檔參考資料

將 JMX 設定新增至適當元件的設定檔

密碼式驗證設定

基於 SSL 的 JMX 設定

選用的 JMX 設定

使用 Management API 監控

執行服務檢查

監控使用者、機構及部署狀態

使用 apigee-service 指令檢查狀態

Postgres 監控

查看 Postgres 上的機構和環境

驗證數據分析狀態

PostgreSQL 資料庫

使用 check_postgres.pl 指令碼

執行資料庫檢查

查看 postgres 程序的健康狀態

Postgres 資源

Apache Cassandra

為 Cassandra 啟用 JMX 驗證

啟用 JMX 密碼加密

為 Cassandra 啟用具備 SSL 的 JMX

選項 1 (儲存在檔案中的 SSL 引數)

選項 2 (儲存在環境變數中的 SSL 引數)

選項 3 (直接傳遞至 apigee-service 的 SSL 引數)

設定選項 1

設定選項 2

還原 SSL 設定

停用 Cassandra 的 JMX 驗證

使用 JConsole：監控工作統計資料

Cassandra JMX 統計資料

使用 nodetool 管理叢集節點

Cassandra 資源

監控 Apache Qpid Broker-J

存取管理控制台

監控佇列和訊息

查看及下載記錄檔

使用 Qpid Management API

Apache ZooKeeper

查看 ZooKeeper 狀態

使用 ZooKeeper 字母字詞

LDAP 層級測試

使用 `apigee-service` 指令檢查狀態

使用 `check_postgres.pl` 指令碼

選項 3 (直接傳遞至 `apigee-service` 的 SSL 引數)