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