5.7. Telemetry モジュール

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

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

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

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

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

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

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

  ceph telemetry on

  Copy to Clipboard Toggle word wrap

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

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

  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

  Copy to Clipboard Toggle word wrap

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

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

  Copy to Clipboard Toggle word wrap

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

  ceph telemetry enable channel all
  ceph telemetry disable channel all

  Copy to Clipboard Toggle word wrap

サンプルレポート

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

  ceph telemetry show

  Copy to Clipboard Toggle word wrap

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

  ceph telemetry preview

  Copy to Clipboard Toggle word wrap

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

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

  ceph telemetry show-device

  Copy to Clipboard Toggle word wrap

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

  ceph telemetry preview-device

  Copy to Clipboard Toggle word wrap

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

  ceph telemetry show-all

  Copy to Clipboard Toggle word wrap

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

  ceph telemetry preview-all

  Copy to Clipboard Toggle word wrap

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

  構文

  ceph telemetry show CHANNEL_NAME

  Copy to Clipboard Toggle word wrap

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

  構文

  ceph telemetry preview CHANNEL_NAME

  Copy to Clipboard Toggle word wrap

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

  ceph telemetry collection ls

  Copy to Clipboard Toggle word wrap

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

  ceph telemetry diff

  Copy to Clipboard Toggle word wrap

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

  構文

  ceph telemetry on
  ceph telemetry enable channel CHANNEL_NAME

  Copy to Clipboard Toggle word wrap

• 間隔を調整します。

  構文

  ceph config set mgr mgr/telemetry/interval INTERVAL

  Copy to Clipboard Toggle word wrap

  例

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

  Copy to Clipboard Toggle word wrap

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

ステータス

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

  ceph telemetry status

  Copy to Clipboard Toggle word wrap

Telemetry を手動で送信する

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

  ceph telemetry send

  Copy to Clipboard Toggle word wrap

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

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

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

  構文

  ceph config set mgr mgr/telemetry/proxy PROXY_URL

  Copy to Clipboard Toggle word wrap

  例

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

  Copy to Clipboard Toggle word wrap

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

  例

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

  Copy to Clipboard Toggle word wrap

連絡先と説明

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

  構文

  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

  Copy to Clipboard Toggle word wrap

  例

  [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

  Copy to Clipboard Toggle word wrap

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

リーダーボード

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

  例

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

  Copy to Clipboard Toggle word wrap

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

Telemetry を無効にする

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

  例

  ceph telemetry off

  Copy to Clipboard Toggle word wrap