TiProxy のトラブルシューティング

このドキュメントでは、TiProxy の一般的な問題、原因、および解決策について説明します。

TiProxyに接続できません

次の手順に従って、問題をトラブルシューティングできます。

1. コネクタバージョンサポートされているかどうかを確認します。コネクタがリストにない場合は、コネクタが認証プラグインをサポートしているかどうかを確認します。
2. クライアントがNo available TiDB instances, please make sure TiDB is availableを報告する場合は、TiDBサーバーが存在するかどうか、および TiDBサーバーの SQL ポートと HTTP ステータス ポートに正常に接続できるかどうかを確認します。
3. クライアントがRequire TLS enabled on TiProxy when require-backend-tls=trueを報告する場合は、TiProxy が TLS 証明書で正しく構成されているかどうかを確認します。
4. クライアントがVerify TiDB capability failed, please upgrade TiDBを報告する場合は、TiDBサーバーのバージョンが v6.5.0 以降であるかどうかを確認します。
5. クライアントがTiProxy fails to connect to TiDB, please make sure TiDB is availableを報告した場合は、 TiProxy ノードが TiDBサーバーに接続できるかどうかを確認します。
6. クライアントがRequire TLS enabled on TiDB when require-backend-tls=trueを報告する場合は、TiDB が TLS 証明書で正しく構成されているかどうかを確認します。
7. クライアントがTiProxy fails to connect to TiDB, please make sure TiDB proxy-protocol is set correctlyを報告した場合は、 TiProxy でproxy.proxy-protocolが有効になっているかどうか、 TiDBサーバーでproxy-protocolが有効になっていないかどうかを確認します。
8. TiProxy がmax-connectionsに設定され、TiProxy 上の接続数が最大接続制限を超えているかどうかを確認します。
9. TiProxy ログでエラー メッセージを確認してください。

TiProxyは接続を移行しません

次の手順に従って、問題をトラブルシューティングできます。

1. TiProxy の制限満たされていないかどうか。TiProxy ログを確認することでこれをさらに確認できます。
2. security.session-token-signing-cert security.session-token-signing-key graceful-wait-before-shutdownで正しく構成されているかどうか。

TiDBサーバーの CPU 使用率が不均衡

TiDBサーバーの接続数が均等であるかどうかを確認します。均等でない場合は、セクションTiProxyは接続を移行しませんに従ってトラブルシューティングを行います。

接続数がバランスされている場合、一部の接続は CPU 使用率が高く、他の接続は比較的アイドル状態である可能性があります。TiProxy は、実際の負荷ではなく、TiDBサーバー上の接続数に基づいて接続のバランスをとります。

レイテンシーが大幅に増加

次の手順に従って、問題をトラブルシューティングできます。

1. Grafana を通じて TiProxy のレイテンシーを確認します。TiProxy のレイテンシーが高くない場合は、クライアントの負荷が高いか、クライアントと TiProxy 間のネットワークレイテンシーが高いことを意味します。
2. Grafana を使用して TiDBサーバーのレイテンシーを確認します。TiDBサーバーのレイテンシーが高い場合は、 遅延が大幅に増加する手順に従ってトラブルシューティングを行います。
3. Grafana でTiProxyとTiDBサーバー間のネットワーク継続時間確認します。
4. TiProxy の CPU 使用率を確認します。CPU 使用率が 90% を超える場合は、TiProxy をスケールアウトする必要があります。