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