如果已設定多個軸群組,則不會顯示自訂維度

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

問題

使用統計資料收集器政策建立的自訂變數,不會顯示在 Edge UI 的 Analytics 自訂報表中的「自訂維度」下方。

錯誤訊息

重新啟動後,edge-postgres-server 系統記錄會針對每個缺少路徑的機構/環境組合,顯示下列錯誤:

KeeperErrorCode = NoNode for
/organizations/<ORG>/environments/<ENV>/properties
2018-03-29 16:14:48,980 pool-10-thread-2 ERROR ZOOKEEPER -
ZooKeeperServiceImpl.getData() : Could not get data for path:
/organizations//environments//properties, reason:
KeeperErrorCode = NoNode for
/organizations//environments//properties

可能原因

原因 說明 適用於下列裝置的疑難排解說明
機構和環境組合缺少 Zookeeper 屬性路徑。 如果缺少 ZooKeeper 路徑 /organizations//environments//properties,就無法建立自訂維度。 Edge Private Cloud 使用者

原因:機構和環境組合缺少 ZooKeeper 屬性路徑

診斷

透過 啟用 Analytics API,即可為機構/環境組合啟用 Analytics,這會在 ZooKeeper 樹狀結構中填入 /organizations//environments//properties。如果這個 API 失敗,edge-postgres-server 元件就無法建立自訂維度,且系統的 system.log 中會顯示下列錯誤:

KeeperErrorCode = NoNode for
/organizations/example/environments/prod/properties
2018-03-29 16:14:48,980 pool-10-thread-2 ERROR ZOOKEEPER -
ZooKeeperServiceImpl.getData() : Could not get data for path:
/organizations/example/environments/prod/properties, reason:
KeeperErrorCode = NoNode for
/organizations/digi/environments/sandbox/properties

通常發生這種情況,是因為機構在加入時,存在多個使用相同 postgres 伺服器 UUID 的 Analytics 群組。如要查看現有的 Analytics 群組數量,請執行下列 API 呼叫:

curl -u username:password "http://management-server-host:8080/v1/analytics/groups/ax"

如果這個 API 傳回多個群組,很可能就是問題所在。 在下列範例中,請注意有兩個群組,兩者只差一個連字號:axgroup-001axgroup001

[ {
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test" ],
  "uuids" : {
    "qpid-server" : [ "94c96375-1ca7-412d-9eee-80fda94f6e07" ],
    "postgres-server" : [ "8ee86b70-5b33-44b6-b2f8-1b0ec0ec8d77" ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "94c96375-1ca7-412d-9eee-80fda94f6e07" ],
    "datastores" : [ "8ee86b70-5b33-44b6-b2f8-1b0ec0ec8d77" ],
    "properties" : {
    }
  } ],
  "data-processors" : {
  }
}, {
  "name" : "axgroup001",
  "properties" : {
  },
  "scopes" : [ "example~prod" ],
  "uuids" : {
    "qpid-server" : [ "94c96375-1ca7-412d-9eee-80fda94f6e07" ],
    "postgres-server" : [ "8ee86b70-5b33-44b6-b2f8-1b0ec0ec8d77" ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "94c96375-1ca7-412d-9eee-80fda94f6e07" ],
    "datastores" : [ "8ee86b70-5b33-44b6-b2f8-1b0ec0ec8d77" ],
    "properties" : {
    }
  } ],
  "data-processors" : {
  }

具體來說,如果為每個 axgroup 設定的 postgres-server UUID 相同,就會導致這個問題。如要快速判斷,請執行下列指令:

curl -u username:password "http://management-server-host:8080/v1/analytics/groups/ax"|grep -B7 "postgres-server"

下列範例輸出內容會快速比較 postgres-server UUID,判斷兩者是否相同:

{  "name" : "axgroup-001",  "properties" : {  },  "scopes" : [ "VALIDATE~test" ],
"uuids" : {    "qpid-server" : [ "94c96375-1ca7-412d-9eee-80fda94f6e07" ],
"postgres-server" : [ "8ee86b70-5b33-44b6-b2f8-1b0ec0ec8d77" ]--
"name" : "axgroup001",  "properties" : {  },  "scopes" : [ "myorg~prod" ],
"uuids" : {    "qpid-server" : [ "94c96375-1ca7-412d-9eee-80fda94f6e07" ],
"aries-datastore" : [ ],    "postgres-server" : [ "8ee86b70-5b33-44b6-b2f8-1b0ec0ec8d77" ],

解析度

同一組 PostgreSQL 伺服器無法指派給兩個 axgroup。 最快速的解決方法是從一個 axgroup 刪除 postgres 伺服器資訊,並將所有範圍 (機構、環境組合) 指派給另一個群組。如要這麼做,請按照下列步驟操作:

  1. 按照「 在 Analytics 群組中新增及刪除 Analytics 元件」一文中的指示,從其中一個 axgroup 移除 postgres 伺服器元件。如果只有非正式環境範圍發生問題,請選擇「axgroup」,這個練習的「axgroup」不應有任何正式環境範圍。否則,請選擇範圍數量最少的 axgroup。
  2. 從不再有任何 postgres 伺服器的 axgroup 中移除所有範圍,並從 axgroup 中移除您看到自訂維度問題的範圍。假設上述範例中的 axgroup-001 是您要使用的群組,您必須使用下列指令,移除 myorg 機構和 prod 環境的範圍:
    curl -u username:password -X DELETE 'http://management-server-host:8080/v1/analytics/groups/ax/axgroup001/scopes?org=myorg&env=prod'
    
  3. 使用「啟用 Analytics API」啟用 Analytics。
  4. 在 postgres 主節點上重新啟動 edge-postgres-server 元件,並使用下列指令重新啟動您可能安裝的所有 edge-qpid-server 元件:
     /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
    
     /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    
  5. 確認 Postgres 伺服器的記錄檔 /opt/apigee/var/log/edge-postgres-server/logs/system.log 中,不再出現上述「錯誤訊息」一節提供的錯誤。
  6. 確認自訂維度是否顯示在 Edge UI 中。

如果問題仍未解決,請參閱「必須收集的診斷資訊」。

必須收集診斷資訊

如果按照上述指示操作後問題仍未解決,請收集下列診斷資訊。請聯絡 Apigee Edge 支援團隊並提供下列資訊:

  1. edge-postgres-server /opt/apigee/var/log/edge-postgres-server/logs/system.log 自上次重新啟動以來的時間。
  2. 下列 Management API 呼叫的輸出內容:
    curl -u username:password "http://management-server-host:8080/v1/analytics/groups/ax"
    
  3. 使用下列指令取得的 ZooKeeper 樹狀結構輸出內容:
    /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh > zktree-output.txt