Ceph Manager モジュールの使用

オンライン編集

ceph mgr module ls コマンドを使用して、使用可能なモジュールと、現在使用可能になっているモジュールを確認します。

モジュールを使用可能または使用不可にするには、それぞれ ceph mgr module enable MODULE コマンドまたは ceph mgr module disable MODULE コマンドを使用します。

モジュールが使用可能になっている場合は、アクティブな ceph-mgr デーモンがそのモジュールをロードして実行します。 HTTP サーバなどのサービスを提供するモジュールの場合、モジュールがロードされた際にそのアドレスが公開される場合があります。 このようなモジュールのアドレスを表示するには、 ceph mgr services コマンドを実行します。

一部のモジュールは、アクティブ・デーモンだけでなく、スタンバイ ceph-mgr デーモンでも実行される特殊なスタンバイ・モードを実装する場合もあります。 これにより、クライアントがスタンバイに接続しようとした場合に、サービスを提供するモジュールがクライアントをアクティブ・デーモンにリダイレクトできるようになります。

以下に、ダッシュボード・モジュールを有効にする例を示します。

[ceph: root@host01 /]# ceph mgr module enable dashboard

[ceph: root@host01 /]# ceph mgr module ls
    
        MODULE                              
        balancer              on (always on)
        crash                 on (always on)
        devicehealth          on (always on)
        orchestrator          on (always on)
        pg_autoscaler         on (always on)
        progress              on (always on)
        rbd_support           on (always on)
        status                on (always on)
        telemetry             on (always on)
        volumes               on (always on)
        cephadm               on            
        dashboard             on            
        iostat                on            
        nfs                   on            
        prometheus            on            
        restful               on            
        alerts                -             
        diskprediction_local  -             
        influx                -             
        insights              -             
        k8sevents             -             
        localpool             -             
        mds_autoscaler        -             
        mirroring             -             
        osd_perf_query        -             
        osd_support           -             
        rgw                   -             
        rook                  -             
        selftest              -             
        snap_schedule         -             
        stats                 -             
        telegraf              -             
        test_orchestrator     -             
        zabbix                -   

[ceph: root@host01 /]# ceph mgr services
{
        "dashboard": "http://myserver.com:7789/",
        "restful": "https://myserver.com:8789/"
}

クラスターは、初めて始動するときに、 mgr_initial_modules 設定を使用して、有効にするモジュールをオーバーライドします。 ただし、この設定はクラスターの残りの存続期間中は無視され、ブートストラッピングにのみ使用されます。 例えば、初めてモニター・デーモンを開始する前に、次のようなセクションを ceph.conf ファイルに追加することができます。

[mon]
    mgr initial modules = dashboard balancer

モジュールがコメント行フックを実装する場合、コマンドは通常の Ceph コマンドとしてアクセス可能であり、Ceph は自動的にモジュール・コマンドを標準 CLI インターフェースに取り込み、それらをモジュールに適切に経路指定します。

[ceph: root@host01 /]# ceph <command | help>

上記のコマンドでは、以下の構成パラメーターを使用できます。

表 1. 設定パラメータ

構成

説明

タイプ

デフォルト

mgr module path

ロード・モジュールのパス。

ストリング

"<library dir>/mgr"

mgr data

デーモン・データ (鍵リングなど) をロードするためのパス

ストリング

"/var/lib/ceph/mgr/$cluster-$id"

mgr tick period

モニター対象のマネージャー・ビーコンと、その他の定期的なチェックとの間の秒数。

整数

5

mon mgr beacon grace

マネージャーが失敗したと見なされる最後のビーコンの後の時間。

整数

30