3.6. PG コマンドラインリファレンス
ceph
CLI では、プールの配置グループ数の設定および取得、PG マップの表示、PG の統計の取得を行うことができます。
3.6.1. PG の数の設定
プール内の配置グループの数を設定するには、プールの作成時に配置グループの数を指定する必要があります。詳細は、プールの作成 を参照してください。プールの配置グループを設定したら、配置グループの数を増減できます。配置グループの数を変更するには、以下のコマンドを使用します。
構文
ceph osd pool set POOL_NAME pg_num PG_NUMBER
例
[ceph: root@host01 /]# ceph osd pool set pool1 pg_num 60 set pool 2 pg_num to 60
配置グループの数を増減したら、クラスターがリバランスする前に、配置 (pgp_num
) の配置グループの数も調整する必要があります。pgp_num
は pg_num
と同じである必要があります。
構文
ceph osd pool set POOL_NAME pgp_num PGP_NUMBER
例
[ceph: root@host01 /]# ceph osd pool set pool1 pgp_num 60 set pool 2 pgp_num to 60
3.6.2. PG の数の取得
プール内の配置グループの数を取得します。
構文
ceph osd pool get POOL_NAME pg_num
例
[ceph: root@host01 /]# ceph osd pool get pool1 pg_num pg_num: 60
3.6.3. クラスター PG の統計の取得
配置グループの統計情報を取得します。
構文
ceph pg dump [--format FORMAT]
有効な形式は plain
(デフォルト) および json
です。
3.6.4. 詰まった PG の統計を取得
指定された状態でスタックしたすべての配置グループの統計情報を取得します。
構文
ceph pg dump_stuck {inactive|unclean|stale|undersized|degraded [inactive|unclean|stale|undersized|degraded...]} INTEGER
Inactive 配置グループは、最新のデータを持つ OSD が up で in になることを待っているため、読み取りや書き込みを処理できません。
Unclean 配置グループには、希望する回数を複製しないオブジェクトが含まれます。これらは回復中である必要があります。
Stale 配置グループは不明な状態にあります それをホストする OSD は、しばらくモニタークラスターに対して報告されていない OSD です (mon_osd_report_timeout
で設定されます)。
有効な形式は plain
(デフォルト) および json
です。このしきい値は、返される統計に含める前に、配置グループがス詰まった最小秒数を定義します (デフォルトは 300 秒)。
3.6.5. PG マップの取得
特定の配置グループの配置グループマップを取得します。
構文
ceph pg map PG_ID
例
[ceph: root@host01 /]# ceph pg map 1.6c osdmap e13 pg 1.6c (1.6c) -> up [1,0] acting [1,0]
Ceph は配置グループマップ、配置グループ、および OSD ステータスを返します。
3.6.6. PG の統計の取得
特定の配置グループの統計情報を取得します。
構文
ceph pg PG_ID query
3.6.7. 配置グループへのスクラブ
配置グループへのスクラブ
構文
ceph pg scrub PG_ID
Ceph はプライマリーノードとレプリカノードを確認し、配置グループ内の全オブジェクトのカタログを生成し、オブジェクトが見つからないか、一致しないか、その内容の一貫性を保つようにします。レプリカがすべて一致したことを想定すると、最終的なセマンティックスイープにより、すべてのスナップショット関連のオブジェクトメタデータの一貫性が確保されます。エラーはログにより報告されます。
3.6.8. 失われたオブジェクトの回復
クラスターが 1 つ以上のオブジェクトが失われ、失われたデータの検索を破棄した場合、失われたオブジェクトを lost
とマークする必要があります。
可能なロケーションがすべてクエリーされ、オブジェクトが依然として失われている場合は、失われたオブジェクトは諦めるしかありません。この障害には、書き込み自体が復旧する前に実行された書き込みについて、クラスターが認識できるようにする、障害上の組み合わせが発生したことが考えられます。
Ceph は revert オプションのみをサポートします。オブジェクトの以前のバージョンにロールバックするか、新規オブジェクトの場合はこれを忘れないでください。unfound オブジェクトを lost とマークするには、以下のコマンドを使用します。
構文
ceph pg PG_ID mark_unfound_lost revert|delete
オブジェクトが存在すると想定されるアプリケーションが同じ場合があるため、この機能は注意して使用してください。