このページには、Apigee Edge で発生する可能性があるエラーやその他の問題の、トラブルシューティング ハンドブックへのリンクが記載されています。各トラブルシューティング ハンドブックでは、各種問題の診断と解決方法について説明します。
アナリティクスの問題
このトピックでは、アナリティクス データがアナリティクスのダッシュボードやカスタム レポートに表示されない場合のトラブルシューティング方法について説明します。
| エラー メッセージまたは説明 | ハンドブック |
|---|---|
The report timed out: Try again with a smaller
date range or a larger aggregation interval. |
アナリティクスでタイムアウトがレポートされる |
| Postgres サーバーの空き容量が完全になくならない限り、エラー メッセージは表示されません。 | Postgres サーバーのディスク容量が不足している |
| エラー メッセージは表示されません。 | アナリティクス カスタム レポートにカスタム変数が表示されない |
No traffic in the selected date range |
アナリティクス ダッシュボードにデータが表示されない |
| このトピックでは、一般的にリクエストされるタスクを実行する方法について説明します。 | アナリティクス グループ内のアナリティクス コンポーネントの追加と削除 |
Could not get data for path |
複数の axgroup が構成されているとカスタム ディメンションが表示されない |
デプロイエラー
Edge サーバー間のネットワーク接続の問題、Cassandra データストアの問題、ZooKeeper の例外、API プロキシ バンドルのエラーなど、さまざまな理由で API プロキシのデプロイが失敗する可能性があります。このセクションでは、デプロイエラーのトラブルシューティングの際に実施する特定の手順に関する情報とガイダンスを示します。
| エラー メッセージまたは説明 | ハンドブック |
|---|---|
Error: Call timed out; either server is down or
server is not reachable |
タイムアウト エラー |
Unexpected error Error while fetching children for path |
子を取得する際のパスのエラー |
Error while accessing datastore;Please retry later |
データストアへのアクセスエラー |
Configuration failed, associated contexts = [] |
構成の失敗 |
Unexpected error occurred while processing the updates,
associated contexts = [] |
更新処理のエラー |
デベロッパー ポータルのエラー
これらのトピックは、デベロッパー ポータルを使用する際に発生する可能性のある問題を解決するのに役立ちます。デベロッパー ポータルの問題解決を試みる前に、デベロッパー ポータルのトラブルシューティングの概要で説明されている、デベロッパー ポータルの動作の基本を理解しておいてください。
| エラー メッセージまたは説明 | ハンドブック |
|---|---|
An internal error has occurred. Please retry your request. |
デベロッパー ポータルの内部エラー |
The website encountered an unexpected error.
Please try again later. または There was an error trying to create the App.
Please try again later.
|
デベロッパー ポータルの通信に関する問題 |
Monetization の問題
以下のトピックは、一般的な Monetization の問題のトラブルシューティングと修正に役立ちます。
| エラー メッセージまたは説明 | ハンドブック |
|---|---|
<error>
<messages>
<message>Exceeded developer limit configuration -</message>
<message>Is Developer Suspended - true</message>
</messages>
</error>
|
デベロッパーの停止 |
| エラー メッセージは表示されないこともありますが、Monetization のセットアップでの問題の症状セクションで説明している問題が現れます。 | Monetization のセットアップでの問題 |
Edge Router の問題
Edge Router は Nginx を使用して実装されています。Edge のアップグレード プロセス中または Edge Router の構成の変更中に、Nginx の構成エラーが表示されることがあります。次のトピックは、このような問題に対処するのに役立ちます。
| エラー メッセージまたは説明 | ハンドブック |
|---|---|
| エラー メッセージは表示されません。ただし、不正な構成ファイルが原因で、API プロキシを実行できないことがあります。 | 不正な構成ファイル |
OpenLDAP の問題
以下のトピックは、一般的な OpenLDAP の問題のトラブルシューティングと修正に役立ちます。
| エラー メッセージまたは説明 | ハンドブック |
|---|---|
Unknown username and password combination. |
SMTP が無効になり、ユーザーがパスワードをリセットする必要がある |
| エラーは表示されません。Edge UI に、すべての OpenLDAP サーバーにわたって複製される必要があるユーザーのリストが表示されません。 | LDAP が複製されない |
SLAPD Dead But Pid File Exists |
OpenLDAP を起動できない |
Unknown username and password combination. |
OpenLDAP データの破損 |
ランタイム エラー
以下のトピックは、一般的なランタイムの問題のトラブルシューティングと修正に役立ちます。
| エラー メッセージまたは説明 | ハンドブック |
|---|---|
HTTP/1.1 500 Internal Server Error
または
{
"fault":{
"detail":{
"errorcode":"steps.servicecallout.ExecutionFailed"
},
"faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
Reason: ResponseCode 400 is treated as error"
}
}
|
500 内部サーバーエラー |
HTTP/1.1 502 Bad Gateway
または
{
"fault": {
"faultstring": "Unexpected EOF at target",
"detail": {
"errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
}
}
}
|
502 不正なゲートウェイ |
HTTP/1.1 503 Service Unavailable
または
HTTP/1.1 503 Service Unavailable: Back-end server is at capacity
または
{
"fault": {
"faultstring": "The Service is temporarily unavailable",
"detail": {
"errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
}
}
}
|
503 サービス利用不可 |
HTTP/1.1 503 Service Unavailable
または
Received fatal alert: handshake_failure
|
SSL handshake の失敗 |
HTTP/1.1 503 Service Unavailable
または
{
"fault": {
"faultstring":"The Service is temporarily unavailable",
"detail":{
"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
}
}
}
|
SSL handshake エラー - 不正なクライアント証明書 |
HTTP/1.1 504 Gateway Timeout
または
{
"fault": {
"faultstring": "Gateway Timeout",
"detail": {
"errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
}
}
}
|
504 ゲートウェイ タイムアウト |
ZooKeeper の問題
以下のトピックは、一般的な ZooKeeper の問題のトラブルシューティングと修正に役立ちます。
| エラー メッセージまたは説明 | ハンドブック |
|---|---|
org: env: main ERROR ZOOKEEPER - ZooKeeperServiceImpl.exists() :
Could not detect existence of path:
/regions/dc-1/pods/analytics/servers/abc123/reachable ,
reason: KeeperErrorCode = ConnectionLoss
または
org.apache.zookeeper.KeeperException$ConnectionLossException:
KeeperErrorCode = ConnectionLoss
または Edge UI に次のエラーが表示されることがあります。
Error Fetching Deployments
Error while checking path existence for path: path
|
ZooKeeper 接続切断エラー |
| 一般に接続問題と呼ばれるデータ関連の問題は、複数の問題の内の 1 つとして現れます。詳細については、ZooKeeper データの問題をご覧ください。 | ZooKeeper データの問題 |
+ apigee-service apigee-zookeeper status
apigee-service: apigee-zookeeper: Not running (DEAD)
apigee-all: Error: status failed on [apigee-zookeeper]
|
ZooKeeper を起動できない |
診断ツールとログ
これらのトピックでは、Apigee Edge で発生する可能性がある特定の種類の問題の診断に役立つツールとログについて説明します。
- TCP/IP パケット スニファ（tcpdump）ユーティリティ
tcpdump ツールは、ネットワーク経由で送受信される TCP/IP パケットをキャプチャまたはフィルタリングできるコマンドライン パケット スニファツールです。 - ヒープダンプ
ヒープダンプは、Java プロセスのメモリのスナップショットです。ヒープダンプが収集された時点のヒープ内の Java オブジェクトやクラスに関する情報が含まれています。 - スレッドダンプ
スレッドダンプは、実行中の Java プロセスのすべてのスレッドの状態のスナップショットです。各スレッドの状態には、スタック トレースと呼ばれるスタックの内容が表示されます。