TiDB ダッシュボードに関するよくある質問

このドキュメントには、TiDB ダッシュボードに関するよくある質問 (FAQ) とその回答がまとめられています。指示どおりに実行しても問題が見つからない場合、または問題が解決しない場合は、支持を得ます PingCAP またはコミュニティから連絡を受けます。

ファイアウォールまたはリバースプロキシが構成されている場合、TiDB ダッシュボード以外の内部アドレスにリダイレクトされます

複数の配置Driver(PD) インスタンスがクラスターにデプロイされている場合、PD インスタンスのうちの 1 つだけが実際に TiDB ダッシュボードサービスを実行します。このインスタンスではなく他の PD インスタンスにアクセスすると、ブラウザは別のアドレスにリダイレクトします。 TiDB ダッシュボードにアクセスするためにファイアウォールまたはリバースプロキシが適切に構成されていない場合、ダッシュボードにアクセスすると、ファイアウォールまたはリバースプロキシによって保護されている内部アドレスにリダイレクトされる可能性があります。

複数の PD インスタンスを使用した TiDB ダッシュボードの動作原理については、 TiDB ダッシュボードのマルチ PD インスタンスの展開を参照してください。
リバースプロキシを正しく構成する方法については、リバースプロキシ経由で TiDB ダッシュボードを使用するを参照してください。
ファイアウォールを正しく構成する方法についてはセキュリティTiDB ダッシュボードを参照してください。

TiDB ダッシュボードがデュアルネットワークインターフェイスカード (NIC) で展開されている場合、別の NIC を使用して TiDB ダッシュボードにアクセスすることはできません

セキュリティ上の理由から、PD 上の TiDB ダッシュボードは、展開中に指定された IP アドレスのみを監視します (つまり、 0.0.0.0つの NIC でのみリッスンします)。したがって、ホストに複数の NIC がインストールされている場合、別の NIC を使用して TiDB ダッシュボードにアクセスすることはできません。

tiup clusterまたはtiup playgroundコマンドを使用して TiDB をデプロイした場合、現時点ではこの問題は解決できません。 TiDB ダッシュボードを別の NIC に安全に公開するには、リバースプロキシを使用することをお勧めします。詳細はリバースプロキシの背後で TiDB ダッシュボードを使用するを参照してください。

`prometheus_not_found`エラーが、概要ページのQPSセクションとレイテンシセクションに表示される

「概要」ページの「QPS」および「レイテンシー」セクションでは、Prometheus がデプロイされたクラスターが必要です。それ以外の場合は、エラーが表示されます。この問題は、クラスターに Prometheus インスタンスをデプロイすることで解決できます。

Prometheus インスタンスがデプロイされているときに引き続きこの問題が発生する場合は、デプロイメントツール (TiUPまたはTiDB Operator) が古く、ツールがメトリクスアドレスを自動的にレポートしないため、TiDB ダッシュボードがクエリを実行できなくなっていることが考えられます。メトリクス。導入ツールを最新バージョンにアップグレードして、再試行できます。

デプロイメントツールがTiUPの場合は、次の手順を実行してこの問題を解決してください。他の展開ツールについては、それらのツールの対応するドキュメントを参照してください。

TiUPおよびTiUPクラスタをアップグレードします。
```
tiup update --self
tiup update cluster --force
```
アップグレード後、Prometheus インスタンスを使用して新しいクラスターがデプロイされると、メトリックが通常どおり表示されます。
アップグレード後、既存のクラスターの場合、このクラスターを再起動してメトリックアドレスをレポートできます。 CLUSTER_NAME実際のクラスター名に置き換えます。
```
tiup cluster start CLUSTER_NAME
```
クラスタが起動している場合でも、このコマンドを実行してください。このコマンドはクラスター内の通常のアプリケーションには影響しませんが、監視メトリックを TiDB ダッシュボードに通常どおり表示できるように、メトリックアドレスを更新してレポートします。

「遅いクエリ」ページに`invalid connection`エラーが表示される

考えられる理由は、TiDB のプリペアドプランキャッシュ機能を有効にしていることです。実験的機能として、有効にすると、プリペアドプランキャッシュが特定の TiDB バージョンで正しく機能しない可能性があり、TiDB ダッシュボード (および他のアプリケーション) でこの問題が発生する可能性があります。システム変数tidb_enable_prepared_plan_cache = OFFを設定すると、プリペアドプランキャッシュを無効にできます。

`required component NgMonitoring is not started`エラーが表示される

NgMonitoring は、継続的プロファイリングやTop SQLなどの TiDB ダッシュボード機能をサポートするために、v5.4.0 以降のバージョンの TiDB クラスターに組み込まれた高度な監視コンポーネントです。新しいバージョンのTiUPを使用してクラスターをデプロイまたはアップグレードすると、NgMonitoring が自動的にデプロイされます。 TiDB Operatorを使用してデプロイされたクラスターの場合は、継続的プロファイリングを有効にするを参照して NgMonitoring を手動でデプロイできます。

Web ページにrequired component NgMonitoring is not started表示されている場合は、次のように展開の問題をトラブルシューティングできます。

TiUPを使用してデプロイされたクラスター

ステップ 1. バージョンを確認する

TiUPクラスターのバージョンを確認します。 NgMonitoring は、 TiUP がv1.9.0 以降の場合にのみデプロイされます。
```
tiup cluster --version
```
コマンド出力には、 TiUP のバージョンが表示されます。例えば：
```
tiup version 1.9.0 tiup
Go Version: go1.17.2
Git Ref: v1.9.0
```
TiUPクラスターのバージョンが v1.9.0 より前の場合は、 TiUPとTiUPクラスターを最新バージョンにアップグレードします。
```
tiup update --all
```

ステップ 2. TiUPを使用して、制御マシンに ng_port 構成項目を追加します。次に、Prometheus をリロードします。

クラスター構成ファイルを編集モードで開きます。
```
tiup cluster edit-config ${cluster-name}
```
monitoring_serversの下にng_port:12020パラメータを追加します。
```
monitoring_servers:
- host: 172.16.6.6
  ng_port: 12020
```

プロメテウスをリロードします:

tiup cluster reload ${cluster-name} --role prometheus

上記の手順を実行した後もエラーメッセージが表示される場合は、PingCAP またはコミュニティから支持を得ます。

TiDB Operatorを使用してデプロイされたクラスター

TiDB Operatorドキュメントの継続的プロファイリングを有効にするセクションの手順に従って、NgMonitoringコンポーネントをデプロイ。

TiUP Playground を使用して開始されたクラスター

クラスターを起動すると、 TiUP Playground (>= v1.8.0) は自動的に NgMonitoringコンポーネントを起動します。 TiUP Playground を最新バージョンに更新するには、次のコマンドを実行します。

tiup update --self
tiup update playground

「遅いクエリ」ページに`unknown field`エラーが表示される

クラスターのアップグレード後に[スロークエリ]ページにunknown fieldエラーが表示される場合、そのエラーは、TiDB ダッシュボードサーバーフィールド (更新される可能性があります) とユーザー設定フィールド (ブラウザーキャッシュ内にある) の間の違いによって引き起こされる互換性の問題に関連しています。。この問題は修正されました。クラスターが v5.0.3 または v4.0.14 より前の場合は、次の手順を実行してブラウザーのキャッシュをクリアします。

TiDB ダッシュボードページを開きます。
開発者ツールを開きます。ブラウザーが異なれば、開発者ツールを開く方法も異なります。メニューバーをクリックした後:
- Firefox: [メニュー] > [Web 開発者] > [ツールの切り替え] 、または[ツール] > [Web 開発者] > [ツールの切り替え] 。
- Chrome:その他のツール>開発者ツール。
- Safari: [開発] > [Web インスペクターを表示] 。 [開発]メニューが表示されない場合は、 [Safari] > [環境設定] > [詳細設定]に移動し、[メニューバーに開発メニューを表示する] チェックボックスをオンにします。
次の例では Chrome が使用されています。
「アプリケーション」パネルを選択し、 「ローカルストレージ」メニューを展開して、 「TiDB ダッシュボード」ページのドメインを選択します。 「すべてクリア」ボタンをクリックします。

TiDB ダッシュボードに関するよくある質問

アクセスに関するFAQ

ファイアウォールまたはリバース プロキシが構成されている場合、TiDB ダッシュボード以外の内部アドレスにリダイレクトされます

TiDB ダッシュボードがデュアル ネットワーク インターフェイス カード (NIC) で展開されている場合、別の NIC を使用して TiDB ダッシュボードにアクセスすることはできません

UI関連のFAQ

prometheus_not_foundエラーが、概要ページのQPSセクションとレイテンシセクションに表示される

「遅いクエリ」ページにinvalid connectionエラーが表示される

required component NgMonitoring is not startedエラーが表示される