tiup cluster display
クラスタ内の各コンポーネントの動作状況を確認したい場合、各マシンに1台ずつログインするのは明らかに非効率的です。そこで、 tiup-clusterは、この作業を効率的に実行するためのtiup cluster displayコマンドを提供します。
構文
tiup cluster display <cluster-name> [flags]
<cluster-name> : 操作対象のクラスターの名前。クラスター名を忘れた場合は、 クラスターリストコマンドで確認できます。
オプション
--dashboard
- デフォルトでは、クラスター全体のすべてのノード情報が表示されます。1オプションを指定すると、
--dashboardボード情報のみが表示されます。 - データ型:
BOOLEAN - このオプションはデフォルトで無効になっており、デフォルト値は
falseです。このオプションを有効にするには、コマンドにこのオプションを追加し、値trueを渡すか、値を渡さないかのいずれかを選択します。
-N, --node
- 表示するノードを指定します。このオプションを指定しない場合は、すべてのノードが表示されます。このオプションの値は、ノードIDのカンマ区切りのリストです。ノードのIDが不明な場合は、コマンドでこのオプションを省略して、すべてのノードのIDとステータスを出力に表示できます。
- データ型:
STRINGS - コマンドでこのオプションを指定しない場合は、デフォルトですべてのノードがチェックされます。
注記：
-R, --roleオプションを同時に指定した場合は、-N, --nodeと-R, --role両方の指定に一致するサービス ノードのみがチェックされます。
-R, --role
- 表示するロールを指定します。指定しない場合は、すべてのロールが表示されます。このオプションの値は、ノードロールのカンマ区切りのリストです。ノードにデプロイされているロールが不明な場合は、コマンドでこのオプションを省略して、すべてのノードのロールとステータスを出力に表示できます。
- データ型:
STRINGS - コマンドでこのオプションを指定しない場合は、デフォルトですべてのロールが表示されます。
注記：
-N, --nodeオプションを同時に指定した場合は、-N, --nodeと-R, --role両方の指定に一致するサービス ノードのみが表示されます。
- プロセス
- このオプションを有効にすると、ノードのCPUとメモリの使用状況が表示されます。このオプションはデフォルトでは無効になっています。
- データ型:
BOOLEAN - デフォルト値:
false - このオプションを有効にするには、このオプションをコマンドに追加し、値
trueを渡すか、値を渡さないようにします。
--稼働時間
- このオプションを有効にすると、ノードの
uptime情報が表示されます。このオプションはデフォルトでは無効です。 - データ型:
BOOLEAN - デフォルト値:
false - このオプションを有効にするには、このオプションをコマンドに追加し、値
trueを渡すか、値を渡さないようにします。
--ステータスタイムアウト
- ノードステータス情報を取得するためのタイムアウト期間を指定します。
- データ型:
INT - デフォルト値:
10、単位は秒。
-h, --help
- ヘルプ情報を出力します。
- データ型:
BOOLEAN - このオプションはデフォルトで無効になっており、デフォルト値は
falseです。このオプションを有効にするには、コマンドにこのオプションを追加し、値trueを渡すか、値を渡さないかのいずれかを選択します。
出力
- クラスター名
- クラスターバージョン
- SSHクライアントタイプ
- ダッシュボードアドレス
- 次のフィールドを持つテーブル:
- ID:
IP:PORTの - ロール: このノードにデプロイされたサービス ロール (TiDB、TiKV など)
- ホスト: ノードに対応するマシンのIP
- ポート: サービスが占有するポート番号
- OS/アーキテクチャ: このノードのオペレーティングシステムとマシンアーキテクチャ
- ステータス: ノードサービスの現在のステータス
- データ ディレクトリ: サービスのデータ ディレクトリ。1
-データ ディレクトリがないことを意味します。 - デプロイディレクトリ: サービスのデプロイディレクトリ
- ID:
ノードサービスステータス
ノード サービスは次のいずれかのステータスで実行できます。
- 稼働中: ノード サービスは正常に実行されています。
- ダウンまたは到達不能: ノード サービスが実行されていないか、対応するホストにネットワークの問題が発生しています。
- トゥームストーン: ノードサービス上のデータが完全に移行され、スケールインが完了しました。このステータスは TiKV またはTiFlashでのみ存在します。
- オフライン保留中: ノードサービス上のデータが移行中で、スケールインが進行中です。このステータスは TiKV またはTiFlashでのみ表示されます。
- 不明: ノード サービスの実行ステータスは不明です。
注記：
TiUPの
Pending Offline、PD API によって返されるOffline、および TiDB ダッシュボードのLeaving同じステータスを示します。
ノードのサービスステータスはPDのスケジューリング情報から取得されます。詳細については情報収集参照してください。