現在、Apigee と Apigee ハイブリッドのドキュメントを表示しています。
Apigee Edge のドキュメントはこちらをご覧ください。
トラブルシューティングという行為は、アートでありサイエンスでもあります。Apigee のテクニカル サポートチームは、絶え間ない努力により、このアートを解き明かし、問題の特定と解決の背後にあるサイエンスを明らかにしました。
ハンドブックの概要
Apigee テクニカル サポートチームと共同で開発した Apigee のトラブルシューティング ハンドブックは、Apigee プロダクトを使用する際に発生する可能性のあるエラーやその他の問題に対して、迅速かつ効果的なソリューションを提供します。
対象
トラブルシューティング ハンドブックは、Apigee とそのアーキテクチャに対する高い理解と、ポリシーや分析などの基本的なコンセプトに関する一定の理解を持つ読者を対象にしています。
Apigee ハイブリッド ユーザーのみが診断して解決できる問題もあり、これには Cassandra データストアや Postgres データストア、Message Processor、Router などの内部コンポーネントに関する知識が必要な場合もあります。
Apigee を使用している場合は、示されたトラブルシューティングを実施できるタイミングと、Google Cloud カスタマーケアにサポートに問い合わせる必要があるタイミングが明確に示されます。
ハンドブック
このセクションでは、現在のハンドブックについて説明します。
このテーブルをフィルタリングするには、カテゴリの選択、プロダクトの選択、検索キーワードの入力、列の見出しのクリックを行います。
| カテゴリ | ハンドブック / 問題の説明 | エラー メッセージ | 該当するハンドブック |
|---|---|---|---|
| Cassandra | Cassandra 復元のトラブルシューティング | Apigee ハイブリッドでの Cassandra の復元時に、復元ログでエラーが見つかることがあります。 | Apigee ハイブリッドのみ |
| 問題の特定の自動化 | ランタイム プレーンとコントロール プレーンがネットワーク接続されていない | Apigee API 管理リクエストが失敗します。
|
Apigee ハイブリッドのみ |
| 問題の特定の自動化 | 仮想ホストに環境グループが存在しない | kubectl -n apigee get apigeeissues を実行すると、AIS_VIRTUALHOST_MISSING_ENVGROUP エラーが表示されます。 |
Apigee ハイブリッドのみ |
| 問題の特定の自動化 | 仮想ホストにセレクタがない | kubectl -n apigee get apigeeissues を実行すると、AIS_VIRTUALHOST_MISSING_SELECTOR エラーが表示されます。 |
Apigee ハイブリッドのみ |
| 問題の特定の自動化 | Ingress 証明書の不一致 | kubectl -n apigee get apigeeissues を実行すると、AIS_INGRESS_CERT_MISMATCH エラーが表示されます。
|
Apigee ハイブリッドのみ |
| 問題の特定の自動化 | Ingress 証明書の期限切れ | kubectl -n apigee get apigeeissues を実行すると、AIS_INGRESS_CERT_EXPIREY エラーが表示されます。 |
Apigee ハイブリッドのみ |
| 問題の特定の自動化 | Ingress mTLS CA 証明書の有効期限切れ | kubectl -n apigee get apigeeissues を実行すると、AIS_INGRESS_MTLS_CA_CERT_EXPIREY エラーが表示されます。 |
Apigee ハイブリッドのみ |
| 問題の特定の自動化 | Ingress mTLS CA 証明書が無効 | kubectl -n apigee get apigeeissues を実行すると、AIS_INGRESS_MTLS_CA_CERT_INVALID エラーが表示されます。 |
Apigee ハイブリッドのみ |
| Cassandra | Cassandra のデータ レプリケーション エラー |
マルチリージョン展開中にデータを複製すると、CassandraDataReplication ステータスにエラー状態が表示され、データ レプリケーションが失敗する可能性があります。 |
Apigee ハイブリッドのみ |
| Cassandra | Cassandra Java ヒープスペースの問題 |
Cassandra ヒープの問題により、Apigee ハイブリッド プロキシの実行速度が低下することや、Datastore エラーが発生することがあります。場合によっては、症状が発生する前であっても、ログで早期に問題を確認できることがあります。 |
Apigee ハイブリッドのみ |
| Cassandra | Cassandra Pod がセカンダリ リージョンで起動しない |
マルチリージョンのハイブリッド セットアップのいずれかで、Cassandra Pod の起動に失敗します。Cassandra Pod のログに node already exists エラー メッセージが表示されたり、Cassandra Pod のステータスに FailedPreStopHook 警告が表示されたりする場合があります。 |
Apigee ハイブリッドのみ |
| Cassandra | Cassandra のトラブルシューティング ガイド |
kubectl を使用して Pod の状態を表示すると、1 つ以上の Cassandra Pod が停止していることがわかります。このガイドでは、Cassandra データストアの問題の診断と解決について説明します。
|
Apigee ハイブリッドのみ |
| デプロイ | API プロキシのデプロイに失敗し、アクティブなランタイム Pod がないという警告が表示される | API プロキシのページで、「ENVIRONMENT のデプロイに関する問題: REVISION_NUMBER」というエラー メッセージの [詳細] ダイアログに「アクティブなランタイム Pod がない」という警告が表示されます。 | Apigee ハイブリッドのみ |
| Ingressgateway | タイムアウト エラーで API 呼び出しが失敗する |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Apigee ハイブリッドのみ |
| Ingressgateway | TLS エラーで API 呼び出しが失敗する |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Apigee ハイブリッドのみ |
| ロギング | Cloud Logging から消失した Apigee ログのトラブルシューティング | このシナリオでは、エラー メッセージは表示されません。 | Apigee と Apigee ハイブリッド |
| 管理 UI | ハイブリッド UI または管理 API でモニタリングされたエンティティのデータがない、もしくは整合性がない | このシナリオでは、エラー メッセージは表示されません。 | Apigee ハイブリッドのみ |
| ネットワークの構成 | Apigee でのアクセス ルーティングの問題 |
外部クライアントが適切な方法で Apigee にアクセスできない、または Apigee に接続できません。これには、ネットワーク接続の失敗（TLS handshake の失敗）または Apigee からの 4xx/5xx レスポンスが含まれます。 |
Apigee と Apigee ハイブリッド |
| ネットワークの構成 | Apigee とサウスバウンド PSC ターゲットの接続に関する問題 |
Apigee とターゲット サービスの間のネットワーク接続に関する問題や TCP タイムアウトは、503 エラー レスポンスとして表示されます。デバッグ セッションを作成すると、次のようなエラーが表示されます。{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}} |
Apigee と Apigee ハイブリッド |
| その他 | ノードのドレイン時の Istio プロパティ レプリカ数の拡張 | Istio Pod をドレインするときに 3 以上のレプリカが必要ですが、一部のノードのレプリカ数が 1 になっているため、そのノードをドレインできないことがあります。これを回避するには、各プロパティの最小レプリカ数を 3 以上に設定する必要があります。 | Apigee ハイブリッドのみ |
| その他 | Message Processor のトラブルシューティング ガイド |
1 つ以上の apigee-runtime Pod が Ready 状態ではありません。kubectl を使用して、失敗した apigee-runtime Pod に説明を取得すると、次のようなエラーが表示されます。Readiness probe failed: HTTP probe failed with statuscode: 500 |
Apigee ハイブリッドのみ |
| その他 | ビルド情報を出力する |
buildinfo API は、ランタイム コンポーネントの現在のビルドに関する情報を返します。この情報は、サポートに問い合わせる場合に役立ちます。 |
Apigee ハイブリッドのみ |
| その他 | StreamingPull エラー 100% |
指標ダッシュボードに google.pubsub.vl.Subscriber.StreamingPull メソッドが 100% エラーで失敗していることが表示されている場合、この問題は無視してかまいません。これは想定された挙動です。 |
Apigee ハイブリッドのみ |
| デプロイ | インスタンスが環境グループのステータスを報告していない | Apigee ハイブリッド UI で API プロキシのデプロイが失敗し、「インスタンス INSTANCE_NAME が環境グループ ENV_GROUP_NAME のステータスを報告していません」エラーが返される。 | Apigee ハイブリッドのみ |
| デプロイ | apigee-serving-cert が見つからないか期限切れになっているため、API プロキシのデプロイに失敗する |
API プロキシのデプロイに失敗し、apigee-watcher ログにエラー メッセージが表示される。 |
Apigee ハイブリッドのみ |
| Ingressgateway | Istio プロパティのレプリカ数を拡張して Istio ノードのドレイン時の問題を回避する |
Istio Pod をドレインするときに 3 以上のレプリカが必要ですが、一部のノードのレプリカ数が 1 になっているため、そのノードをドレインできないことがあります。これを回避するには、各プロパティの最小レプリカ数を 3 以上に設定する必要があります。 |
Apigee ハイブリッドのみ |
| ネットワークの構成 | IP アドレス空間が不足する場合のトラブルシューティング | Apigee のプロビジョニング中に、十分な空きのないネットワーク CIDR 範囲を選択すると、エラー メッセージが表示されることがあります。 | Apigee と Apigee ハイブリッド |
| ネットワークの構成 | VPC ピアリングの使用時に TARGET_CONNECT_TIMEOUT により「503 Service Unavailable（サービス利用不可）」エラーが発生する | このドキュメントでは、VPC ピアリングの使用時に TARGET_CONNECT_TIMEOUT により「503 Service Unavailable（サービス利用不可）」エラーが発生する問題を診断して修正する方法について説明します。 | Apigee |
| ネットワークの構成 | 504 ゲートウェイ タイムアウト - ターゲット読み取りタイムアウト | このドキュメントでは、TARGET_READ_TIMEOUT の理由により「504 Gateway Timeout（ゲートウェイ タイムアウト）」エラーが発生する問題を診断して修正する方法について説明します。 | Apigee と Apigee ハイブリッド |
| その他 | Apigee ハイブリッドが作成状態またはリリース状態から先に進まない場合のトラブルシューティング |
このドキュメントでは、Apigee ハイブリッド コンポーネントが creating や releasing 状態から動かない場合に、そのコンポーネントをリセットする方法について説明します。 |
Apigee ハイブリッドのみ |