4.19.06 Edge for Private Cloud 版本資訊

一開始未評分交易

首次為機構啟用營利功能時，Private Cloud 邊緣不會針對交易評分。這適用於新機構和現有機構。

營利啟用 API 使用工作 ID 回應，完成時，工作狀態會指出工作成功。不過，一開始所有的營利 API 呼叫都不會由營利處理，也不會評分。這類交易只會顯示在一般數據分析中。

解決方法：

apigee-service edge-message-processor restart

啟用營利功能後，重新啟動 MP 會導致 Edge 在啟動時從 ZooKeeper 載入設定。每次重新啟動都會發生這個情形，這表示問題一開始只會發生。

次要評分伺服器記憶體流失

在 MX 群組中註冊新的 Qpid 執行個體後，佇列會在沒有取用端的情況下建構，導致佇列深度增加，直到使用所有可用資源為止。

解決方法：

apigee-sso 安裝的中繼資料檔案格式

安裝 apigee-sso 並使用 metadata.xml 檔案 (而非網址) 時，如果 metadata.xml 檔案結尾不含新的一行 (CRLF)，則 metadata.xml 檔案並不會完全讀取。

解決方法：

如要解決這個問題，您可以採取下列其中一種做法：

• 在 metadata.xml 檔案結尾加上 CRLF

  或

• 使用以網址為基礎的中繼資料位置

Amazon Linux 1 不支援 apigee-monit

解決方法：

訊息處理器備份未備份正確的檔案組合

解決方法：

第二次執行備份作業，應會備份正確的檔案組合。

多個資料中心設定中的 DataAccessException

在多個資料中心設定中，如果有一個資料儲存庫無法使用，您可能會看到以下錯誤：

DataAccessException: Error while accessing datastore;
Please retry later

結果是，管理伺服器可能無法啟動，因為其嘗試同時連線至 dc-1 和 dc-2 中的 Cassandra 節點。如果 Cassandra 節點停止運作，就會發生 DataAccessExceptions。這也可能會造成 API 流量中斷，因為訊息處理器在嘗試擷取 KVM 時會回報 DataAccessExceptions。

請注意，預期狀態是管理伺服器不會跨區域連線至資料儲存庫元件。

解決方法

解決方法是在無法使用的資料中心內取消註冊下列 Cassandra 節點類型，然後在 Cassandra 節點再次提供時重新註冊這些類型：

• kms-datastore
• dc-datastore
• keyvaluemap-datastore

如何取消註冊及重新註冊這些 Cassandra 節點類型：

1. 使用下列 curl 指令取得 Cassandra 節點的 UUID：

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   地點：

   • ADMIN_EMAIL 和 ADMIN_PW 是 Apigee 帳戶的憑證。
   • MS_IP 和 MS_PORT 是管理伺服器的 IP 位址和通訊埠編號。
   • REGION 是管理伺服器所在的資料中心名稱。
   • GATEWAY_POD 是 Pod 名稱，預設為「閘道」。但您可能已經將其重新命名為其他名稱，因此請檢查實作方式。
   • CASSANDRA_NODE_TYPE 是 kms-datastore、dc-datastore 和 keyvaluemap-datastore 其中之一。

   例如：

   curl -u nickdanger@google.com:myP@$$w0rD
     "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

   回應會使用以下格式：

   {
     "internalIP" : "POD_IP_ADDRESS",
     "isUp" : [true|false],
     "pod" : "GATEWAY_POD",
     "reachable" : [true|false],
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
       "uUID" : "POD_UUID"
   }

   例如：

   {
     "internalIP" : "192.168.1.11",
     "isUp" : false,
     "pod" : "gateway",
     "reachable" : false,
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : "dc-datastore",
     "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
   }

   請記下回應中 uUID 欄位的值。您將使用這些項目取消註冊節點。

2. 針對各種 Cassandra 節點類型，重複執行步驟 1：kms-datastore、dc-datastore 和 keyvaluemap-datastore。請務必記下傳回的 UUID。
3. 使用下列指令取消註冊節點：

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   其中 UUID 是前一個指令回應中傳回的 UUID。

4. 為您在步驟 1 和 2 中收集到的每個 UUID 重複步驟 3。
5. 使用下列指令重新註冊節點：

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
     "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
     Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
     region=REGION&pod=GATEWAY_POD" -H \
     'content-type: application/x-www-form-urlencoded' -X POST

請注意，這些作業會從 Zookeeper 註冊及取消註冊節點，不會對 Cassandra 叢集造成任何影響。如要進一步瞭解這些指令，請參閱更新資料儲存庫註冊。

MessageLogging 政策，在記錄訊息中加入額外資訊

MessageLogging 政策的 FormatMessage 元素可控管記錄訊息的格式。若為 FormatMessage=false，記錄的訊息不應包含任何 Apigee 產生的資訊。不過，即使您設定 FormatMessage=false，記錄訊息仍會包含以下資訊：

• 優先順序分數
• 時間戳記

解決方法：