5.7. Telemetry モジュール

• basic - デフォルトは on です。このチャネルは、次の情報を含む、クラスターに関する基本情報を提供します。

  • クラスターの容量。
  • モニター、マネージャー、OSD、MDS、オブジェクトゲートウェイ、またはその他のデーモンの数。
  • 現在使用されているソフトウェアのバージョン。
  • RADOS プールと Ceph ファイルシステムの数とタイプ。
  • デフォルトから変更した設定オプションの名前 (値は変更されません)。

• crash - デフォルトは on です。このチャネルは、デーモンのクラッシュに関する情報を提供します。これには次の情報が含まれます。

  • デーモンの種類。
  • デーモンのバージョン。
  • オペレーティングシステム、OS ディストリビューション、およびカーネルのバージョン。
  • Ceph コード内のクラッシュが発生した場所を特定するスタックトレース。
• device - デフォルトは on です。このチャネルは、匿名化された SMART メトリックを含むデバイスメトリクスに関する情報を提供します。
• ident - デフォルトは off です。このチャネルは、クラスターの説明や連絡先電子メールアドレスなど、ユーザーが提供したクラスターに関する識別情報を提供します。

• perf - デフォルトは off です。このチャネルは、クラスターのさまざまなパフォーマンスメトリクスを提供し、次の目的で使用できます。

  • クラスター全体の健全性を明らかにします。
  • ワークロードのパターンを特定します。
  • レイテンシー、スロットル、メモリー管理、その他の同様の問題に関するトラブルシューティングを行います。
  • デーモンごとにクラスターのパフォーマンスを監視します。

• テレメトリーを有効にします。

  ceph telemetry on

チャネルの有効化と無効化

• 個々のチャネルを有効または無効にします。

  ceph telemetry enable channel basic
  ceph telemetry enable channel crash
  ceph telemetry enable channel device
  ceph telemetry enable channel ident
  ceph telemetry enable channel perf
  
  ceph telemetry disable channel basic
  ceph telemetry disable channel crash
  ceph telemetry disable channel device
  ceph telemetry disable channel ident
  ceph telemetry disable channel perf

• 複数のチャネルを有効または無効にします。

  ceph telemetry enable channel basic crash device ident perf
  ceph telemetry disable channel basic crash device ident perf

• すべてのチャネルをまとめて有効または無効にします。

  ceph telemetry enable channel all
  ceph telemetry disable channel all

サンプルレポート

• レポートされたデータをいつでも確認するには、サンプルレポートを生成します。

  ceph telemetry show

• Telemetry が off の場合は、サンプルレポートをプレビューします。

  ceph telemetry preview

  数百以上の OSD を持つストレージクラスターのサンプルレポートを生成するには、より長い時間がかかります。

• プライバシーを保護するために、デバイスレポートは個別に生成され、ホスト名やデバイスのシリアル番号などのデータは匿名化されます。デバイスの Telemetry は別のエンドポイントに送信され、デバイスデータを特定のクラスターに関連付けません。デバイスレポートを表示するには、次のコマンドを実行します。

  ceph telemetry show-device

• Telemetry が off の場合は、サンプルデバイスレポートをプレビューします。

  ceph telemetry preview-device

• Telemetry を on にして、両方のレポートについて 1 つの出力を取得します。

  ceph telemetry show-all

• Telemetry を off にして、両方のレポートについて 1 つの出力を取得します。

  ceph telemetry preview-all

• チャネルごとにサンプルレポートを生成します。

  構文

  ceph telemetry show CHANNEL_NAME

• チャネルごとにサンプルレポートのプレビューを生成します。

  構文

  ceph telemetry preview CHANNEL_NAME

• コレクションをリストします。

  ceph telemetry collection ls

• 登録しているコレクションと、新しく利用可能なコレクションの違いを確認してください。

  ceph telemetry diff

• 最新のコレクションに登録します。

  構文

  ceph telemetry on
  ceph telemetry enable channel CHANNEL_NAME

• 間隔を調整します。

  構文

  ceph config set mgr mgr/telemetry/interval INTERVAL

  例

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/interval 72

  この例では、レポートは 3 日 (72 時間) ごとに生成されます。

ステータス

• 現在の設定を表示します。

  ceph telemetry status

Telemetry を手動で送信する

• Telemetry データをアドホックベースで送信します。

  ceph telemetry send

  Telemetry が無効になっている場合は、--license sharing-1-0 を ceph telemetry send コマンドに追加します。

プロキシー経由で Telemetry を送信する

• クラスターが設定済みの Telemetry エンドポイントに直接接続できない場合は、HTTP/HTTPS プロキシーサーバーを設定できます。

  構文

  ceph config set mgr mgr/telemetry/proxy PROXY_URL

  例

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/proxy https://10.0.0.1:8080

  コマンドにユーザーパスを含めることができます。

  例

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/proxy https://10.0.0.1:8080

連絡先と説明

• オプション: 連絡先と説明をレポートに追加します。

  構文

  ceph config set mgr mgr/telemetry/contact '_CONTACT_NAME_'
  ceph config set mgr mgr/telemetry/description '_DESCRIPTION_'
  ceph config set mgr mgr/telemetry/channel_ident true

  例

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/contact 'John Doe <john.doe@example.com>'
  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/description 'My first Ceph cluster'
  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/channel_ident true

  ident フラグが有効になっている場合、その詳細はリーダーボードに表示されません。

リーダーボード

• 公開ダッシュボードのリーダーボードに参加します。

  例

  [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/leaderboard true

  リーダーボードには、ストレージクラスターに関する基本情報が表示されます。このボードには、総ストレージ容量と OSD の数が含まれます。

Telemetry を無効にする

• Telemetry はいつでも無効にできます。

  例

  ceph telemetry off