本文件說明內部部署系統支援的元件監控技術 Apigee Edge 的私有雲部署作業
總覽
Edge 支援多種取得服務詳細資料及檢查服務 狀態。下表列出每個符合資格的檢查項目類型 服務:
管理 API | |||||||
元件 | 記憶體用量 [JMX*] | 服務檢查 | 使用者/機構/ 部署作業狀態 | axstatus | 資料庫檢查 | apigee-service 狀態 |
apigee-monit ** |
管理伺服器 | |||||||
訊息處理器 | |||||||
路由器 | |||||||
Qpid | |||||||
Postgres | |||||||
更多資訊 | 更多資訊 | 更多資訊 | 更多資訊 | 更多資訊 | 更多資訊 | 更多資訊 | |
* 您必須先啟用 JMX , 詳細說明請參閱啟用 JMX。 ** |
監控通訊埠和設定檔
每個元件都支援 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
- 將下列檔案從 $JAVA_HOME 目錄中複製到
- 重新啟動適當的 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 |
|
用量 |
|
設定檔參考資料
以下各節說明您可能需要對 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 |
傳回服務的相關資訊,包括:
這個 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:passwordcurl 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 服務,請參閱以下資訊:
- http://www.postgresql.org/docs/9.0/static/monitoring.html
- http://www.postgresql.org/docs/9.0/static/diskusage.html
- http://bucardo.org/check_postgres/check_postgres.pl.html
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
檔案:- 將下列檔案從
$JAVA_HOME
目錄複製到/opt/apigee/customer/application/apigee-cassandra/
:cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/customer/application/apigee-cassandra/jmxremote.password
- 編輯
jmxremote.password
檔案,並新增 JMX 使用者名稱和密碼 使用下列語法:JMX_USERNAME JMX_PASSWORD
其中 JMX_USERNAME 和 JMX_PASSWORD 是 JMX 使用者名稱和 密碼。
- 請確定檔案的擁有者為「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
檔案:- 編輯
/opt/apigee/customer/application/cassandra.properties
檔案。如果 檔案不存在,請建立該檔案。 - 請將以下內容新增到該檔案:
conf_cassandra_env_com.sun.management.jmxremote.encrypted.authenticate=true
- 儲存 cassandra.properties 檔案。
- 將檔案擁有者變更為 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 連線。
確認上述規定後:
- 將 KeyStore 檔案放入
/opt/apigee/customer/application/apigee-cassandra/
中。 - 藉由輸入
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
- 輸入以停止 Cassandra 節點
- 設定
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 引數)
設定下列環境變數:
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 環境,詳情請參閱 設定選項如下:
選項與 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
開始 - 如果已設定環境變數
CASS_JMX_SSL
,請移除該變數。unset CASS_JMX_SSL
- 檢查
apigee-service
的指令,例如ring
、stop
、backup
等都在運作中。 - 停止搭配使用
--ssl
切換器和 nodetool
apigee-service apigee-cassandra start
停用 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"
啟用透過 SSL 進行 Qpid 監控的功能
如要提高監控與管理的安全性,請在 Qpid 的管理入口網站和 Qpid 的 Management API 上啟用 SSL。請按照以下指南提供金鑰和憑證。
Qpid 提供適用於 Apigee 的 File KeyStore 選項。這個類型接受 Java 和 Java 工具 (例如 keytool) 瞭解的標準 JKS KeyStore 格式。
KeyStore 準備
除了使用 keytool 以外,您還需要直接提供憑證檔案以供 Qpidd 用戶端使用。
如要產生 KeyStore,請參閱 Java Keytool 說明文件。
確認需求條件後
- 將 KeyStore 和憑證檔案放入
/opt/apigee/customer/application/apigee-qpidd
中。 - 確保只有 Apigee 使用者能夠讀取 KeyStore 檔案:
chown apigee:apigee /opt/apigee/customer/application/apigee-qpidd/qpidd.keystore chmod 400 /opt/apigee/customer/application/apigee-qpidd/qpidd.keystore chown apigee:apigee /opt/apigee/customer/application/apigee-qpidd/qpidd-cert.pem chmod 400 /opt/apigee/customer/application/apigee-qpidd/qpidd-cert.pem
在 Qpid 中啟用 SSL
請一次對一個 Qpid 節點執行以下步驟:
開啟 /opt/apigee/customer/application/qpidd.properties
檔案,並新增下列幾行內容:
conf_qpidd_qpid_management.https.enabled=true conf_qpidd_qpid.keystore.storeUrl=/opt/apigee/customer/application/apigee-qpidd/qpidd.keystore conf_qpidd_qpid.keystore.password=keystore-password conf_qpidd_qpid.keystore.certificateAlias=certificate-alias conf_qpidd_qpid.keystore.certificate=/opt/apigee/customer/application/apigee-qpidd/qpidd-cert.pem
- 將檔案擁有者變更為 apigee:apigee:
chown apigee:apigee /opt/apigee/customer/application/qpidd.properties
- 設定 Qpidd:
apigee-service apigee-qpidd configure
- 重新啟動 Qpidd:
apigee-service apigee-qpidd restart
- 使用 wait_for_ready 查看狀態:
apigee-service apigee-qpidd wait_for_ready
還原 SSL 設定
移除 /opt/apigee/customer/application/qpidd.properties
檔案中的屬性或將其註解排除:
conf_qpidd_qpid_management.https.enabled=true conf_qpidd_qpid.keystore.storeUrl=/opt/apigee/customer/application/apigee-qpidd/keystore
- 設定 Qpidd:
apigee-service apigee-qpidd configure
- 重新啟動 Qpidd:
apigee-service apigee-qpidd restart
- 使用 wait_for_ready 查看狀態:
apigee-service apigee-qpidd wait_for_ready
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
) 來取得快取相關資訊。