報表逾時

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

問題

使用 apigee-provision 指令碼建立新機構時，指令碼有時會結束並顯示錯誤訊息。發生這個錯誤後，如果您嘗試查看 Edge UI 資訊主頁或任何 Analytics 資訊主頁，系統會針對新建立的機構顯示「報表已逾時」錯誤訊息。

錯誤訊息

執行 apigee-provision 指令碼建立新機構時，可能會看到下列錯誤訊息：

!!!! Error !!!! 
HTTP STATUS CODE: 400 
{ 
"code" : "dataapi.service.PGFoundInMultipleGroups", 
"message" : "dataapi.service.PGFoundInMultipleGroups", 
"contexts" : [ ] 
}

即使收到這則錯誤訊息，您仍可在佈建指令碼結束後，對新建立的機構執行作業。不過，當您嘗試查看 Edge UI 資訊主頁時，會看到新建立的機構顯示下列錯誤訊息：

The report timed out
Try again with a smaller date range or a larger aggregation interval.

以下是顯示錯誤的螢幕截圖：

可能原因

原因 說明 適用於以下裝置的疑難排解說明
設定多個 AX 群組 已使用同一組 Postgres 伺服器建立多個 Analytics 群組。 Edge Private Cloud 使用者

原因：設定多個 AX 群組

診斷

  1. 執行下列 Analytics Groups Management API，判斷輸出內容是否顯示多個已定義的 Analytics 群組。例如：

    curl -u adminEmail:adminPwd http://<ms_ip>:8080/v1/analytics/groups/ax

    輸出內容範例，顯示兩個 Analytics 群組

    {  
 "name":"axgroup-001",
 "properties":{  
 },
 "scopes":[  
 ],
 "uuids":{  
    "qpid-server":[  
       "5c1e9690-7b58-499a-a4bb-d54454474b8f",
       "7794c428-e553-4ed2-843d-69f93bbec8a3"
    ],
    "postgres-server":[  
       "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e"
    ]
 },
 "consumer-groups":[  
    {  
       "name":"consumer-group-001",
       "consumers":[  
          "5c1e9690-7b58-499a-a4bb-d54454474b8f",
          "7794c428-e553-4ed2-843d-69f93bbec8a3"
       ],
       "datastores":[  
          "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e"
       ],
       "properties":{
       }
    }
 ],
 "data-processors":{  
 }
},
{  
 "name":"axgroup001",
 "properties":{  
    "consumer-type":"ax"
 },
 "scopes":[  
    "017pdspoint~dev",
    "010test~dev",
    "019charmo~dev",
    "009gcisearch1~dev",
    "000fj~trial-fjwan",
    "009dekura~dev",
    "008pisa~dev",
    "004fjadrms~dev",
    "018k5billing~dev",
    "004study14~dev",
    "001teama~dev",
    "005specdb~dev",
    "test~dev",
    "000fj~prod-fjwan",
    "012pjweb~dev",
    "020workflow~dev",
    "007ikou~prod-fjwan",
    "003asano~dev",
    "013mims~dev",
    "006studyhas~dev",
    "006efocus~dev",
    "002wfproto~dev",
    "008murahata~dev",
    "016mediaapi~dev",
    "015skillnet~dev",
    "014aclmanager~dev",
    "010fjppei~dev",
    "000fj~trial",
    "003esupport~dev",
    "000fj~prod",
    "005ooi~dev",
    "test~elb1",
    "007fjauth~dev",
    "011osp~dev",
    "002study~dev",
    "999test~dev"
 ],
 "uuids":{  
    "qpid-server":[  
       "5c1e9690-7b58-499a-a4bb-d54454474b8f",
       "7794c428-e553-4ed2-843d-69f93bbec8a3"
    ],
    "aries-datastore":[  
    ],
    "postgres-server":[  
       "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e"
    ],
    "dw-server":[  
    ]
 },
 "consumer-groups":[  
    {  
       "name":"consumer-group-001",
       "consumers":[  
          "5c1e9690-7b58-499a-a4bb-d54454474b8f",
          "7794c428-e553-4ed2-843d-69f93bbec8a3"
       ],
       "datastores":[  
          "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e"
       ],
       "properties":{  
       }
    }
 ],
 "data-processors":{  
 }
}

    這項輸出內容顯示有兩個 Analytics 群組：axgroup-001 和 axgroup001。

  2. 請檢查是否已為所有 Analytics 群組定義範圍。

    在上方的範例分析群組輸出內容中，分析群組 axgroup-001 未定義任何範圍，但仍將 Postgres 伺服器定義為資料存放區。

  3. 在 Qpid 伺服器上執行下列 Qpid 佇列統計資料指令，並驗證步驟 2 中識別的特定 Analytics 群組是否沒有任何訊息。

    qpid-stat -q

    Qpid 佇列統計資料範例

    下列 Qpid 佇列統計資料指出，上述範例 (axgroup-001) 中特定 Analytics 群組佇列沒有任何訊息：

    queue dur autoDel excl msg msgIn msgOut 位元組 bytesIn bytesOut 缺點 繫結
    140995fe-71a7-4000-a1f4-71b7a951da7f:0.0 Y Y 0 0 0 0 0 0 1 2
    ax-q-axgroup-001-consumer-group-001 Y 0 0 0 0 0 0 12 2
    ax-q-axgroup-001-consumer-group-001-dl Y 0 0 0 0 0 0 0 2
    ax-q-axgroup001-consumer-group-001 Y 0 241K 241K 0 21.7g 21.7g 12 2
    ax-q-axgroup001-consumer-group-001-dl Y 323 323 0 52.4m 52.4m 0 0 2

    由於特定 Analytics 群組 axgroup-001 沒有任何訊息/流量，因此您會在 Edge UI 資訊主頁或 Analytics 資訊主頁中看到「報表已逾時」錯誤。

解析度

如要解決這個問題，請刪除沒有任何範圍且沒有任何流量的 axgroup。

請按照下列程序刪除 axgroup：

步驟 1：刪除特定 axgroup 的消費者。

  1. 使用下列管理 API 從 axgroup 中移除每個消費者：

    curl -v -u admin@email.com:password -X DELETE -H 'Accept:application/json' -H 'Content-Type:application/json' 'http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}/consumer-groups/{consumer-group-name}/consumers/{uuid-of the consumer}'

  2. 如有其他消費者，請重複上述 API 呼叫，並在個別 API 呼叫中提及每位消費者的 UUID。

    以上述範例來說，下列 API 會移除 UUID 為 5c1e9690-7b58-499a-a4bb-d54454474b8f: 的消費者

    curl -v -X DELETE -H 'Accept:application/json' -H 'Content-Type:application/json' 'http://localhost:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/5c1e9690-7b58-499a-a4bb-d54454474b8f'

{
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ ],
  "uuids" : {
    "qpid-server" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ],
    "postgres-server" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "7794c428-e553-4ed2-843d-69f93bbec8a3" ],
    "datastores" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ],
    "properties" : {
    }
  } ],
  "data-processors" : {
  }
* Connection #0 to host localhost left intact
* Closing connection #0
}

  3. 重新執行相同的 API，刪除本例中 UUID 為 7794c428-e553-4ed2-843d-69f93bbec8a3 的其他消費者。

步驟 2：移除用戶群組

  1. 使用下列管理 API，從特定 axgroup 移除消費者群組：

    curl -v -u admin@email.com:password -X DELETE 'http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}/consumer-groups/{consumer-group-name}'

    範例：

    下列 API 會刪除用戶群組名稱 consumer-group-001:

    curl -v -X DELETE 'http://localhost:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001'
{
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ ],
  "uuids" : {
    "qpid-server" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ],
    "postgres-server" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ ],
    "datastores" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ],
    "properties" : {
    }
  } ],
  "data-processors" : {
  }
* Connection #0 to host localhost left intact
* Closing connection #0
}

步驟 3：從 axgroup 刪除 qpid 伺服器

  1. 使用下列管理 API，從特定 axgroup 刪除 qpid-servers。

    curl -X DELETE -u admin@email.com "http://localhost:8080/v1/analytics/groups/ax/{axgroup-name}/servers?uuid={qpid-server-uuid}type=qpid-server" -H "Content-type: application/json"

  2. 如有數個 Qpid 伺服器，請重新執行相同的 API 呼叫。

    範例：

    在本範例中，使用下列 API 刪除 UUID 為 7794c428-e553-4ed2-843d-69f93bbec8a3 的 Qpid 伺服器：

    curl -X DELETE "http://localhost:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=7794c428-e553-4ed2-843d-69f93bbec8a3&type=qpid-server" -H "Content-type: application/json"

{
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ ],
  "uuids" : {
    "qpid-server" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f" ],
    "postgres-server" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ ],
    "datastores" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ],
    "properties" : {
    }
  } ],
  "data-processors" : {
  }
}

步驟 4：從 axgroup 刪除 postgres 伺服器

  1. 如果只有一個 Postgres 伺服器，請使用下列管理 API 刪除該伺服器：

    curl -v -X DELETE -H 'Accept:application/json'  "http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}/servers?uuid={postgres-server-uuid}&type=postgres-server&force=true"

  2. 如果您已設定主伺服器和 Postgres 從屬伺服器，請使用下列管理 API 刪除 Postgres 伺服器

    curl -v -X DELETE -H 'Accept:application/json'  "http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}/servers?uuid={postgres-master-uuid,postgres-slave-uuid}&type=postgres-server&force=true"

    範例：

    如上例所示，有主要和從屬 Postgres 伺服器，因此您可以使用下列 API 刪除 Postgres 伺服器：

    curl -v -X DELETE -H 'Accept:application/json'  "http://localhost:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=3b28b790-ec4e-45c5-a8d0-6d6f2088da65,750cd8ba-1799-4dfb-8c74-548010e95e5e&type=postgres-server&force=true"

{
"name" : "axgroup-001",
"properties" : {
},
"scopes" : [ ],
"uuids" : {
"qpid-server" : [ ],
"postgres-server" : [ ]
},
"consumer-groups" : [ ],
"data-processors" : {
}
* Connection #0 to host localhost left intact
* Closing connection #0
}

步驟 5：移除 Analytics 群組

  1. 使用下列管理 API 移除 Analytics 群組：

    curl -v -X DELETE "http://{mgmt-server-host}:8080/v1/analytics/groups/ax/{axgroup-name}"

    範例：

    curl -v -X DELETE "http://localhost:8080/v1/analytics/groups/ax/axgroup-001"
{
  "properties" : {
  },
  "scopes" : [ ],
  "uuids" : {
  },
  "consumer-groups" : [ ],
  "data-processors" : {
  }
* Connection #0 to host localhost left intact
* Closing connection #0
}

步驟 6：確認群組是否已完全移除

  1. 使用下列管理 API，檢查特定 Analytics 群組是否已完全移除：

    curl -v -u admin@email.com -X GET "http://{mgmt-server-host}:8080/v1/analytics/groups/ax

    範例：

    curl localhost:8080/v1/analytics/groups/ax
[ {
  "name" : "axgroup001",
  "properties" : {
    "consumer-type" : "ax"
  },
  "scopes" : [ "017pdspoint~dev", "010test~dev", "019charmo~dev", "009gcisearch1~dev", "000fj~trial-fjwan", "009dekura~dev", "008pisa~dev", "004fjadrms~dev", "018k5billing~dev", "004study14~dev", "001teama~dev", "005specdb~dev", "test~dev", "000fj~prod-fjwan", "012pjweb~dev", "020workflow~dev", "007ikou~prod-fjwan", "003asano~dev", "013mims~dev", "006studyhas~dev", "006efocus~dev", "002wfproto~dev", "016mediaapi~dev", "015skillnet~dev", "014aclmanager~dev", "010fjppei~dev", "000fj~trial", "003esupport~dev", "000fj~prod", "005ooi~dev", "test~elb1", "007fjauth~dev", "011osp~dev", "002study~dev" ],
  "uuids" : {
    "qpid-server" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ],
    "aries-datastore" : [ ],
    "postgres-server" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ],
    "dw-server" : [ ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "5c1e9690-7b58-499a-a4bb-d54454474b8f", "7794c428-e553-4ed2-843d-69f93bbec8a3" ],
    "datastores" : [ "3b28b790-ec4e-45c5-a8d0-6d6f2088da65:750cd8ba-1799-4dfb-8c74-548010e95e5e" ],
    "properties" : {
    }
  } ],
  "data-processors" : {
  }
} ]

    請注意，上述輸出內容中沒有與特定 Analytics 群組 axgroup-001 相關的資訊。這表示 axgroup-001 已完全移除。

步驟 7：重新啟動程序

Qpid 和 Postgres 電腦上的下列程序：

  1. 重新啟動 apigee-qpidd。
  2. 重新啟動 edge-qpid-server。
  3. 重新啟動 edge-postgres-server。
  4. 重新啟動 apigee-postgresql。

步驟 8：驗證

確認資料是否顯示在分析資訊主頁中。

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

必須收集診斷資訊

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

  1. 私有雲安裝架構設定 (設定的主機數量、各元件的數量)。

  2. 下列指令的輸出內容：

    1. Analytics Group

      curl -u sysadminEmail:sysadminPwd   http://{mgmt-server-host}:8080/v1/analytics/groups/ax

    2. 每部 Qpid 電腦上的 Qpid 佇列統計資料

      qpid-stat -q

    3. Analytics 狀態

      curl -u sysadminEmail:sysadminPwd http://{mgmt-server-host}:8080/v1/organizations/{org-name}/environments/{environment-name}/provisioning/axstatus