概要

このチェックは、Datadog Agent を介して RedHat Gluster Storage クラスターの状態、ボリューム、ブリックステータスを監視します。 この GlusterFS インテグレーションは、RedHat ベンダーバージョンとオープンソースバージョンの GlusterFS の両方と互換性があります。

セットアップ

ホストで実行されている Agent 用にこのチェックをインストールおよび構成する場合は、以下の手順に従ってください。コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照してこの手順を行ってください。

インストール

GlusterFS チェックは Datadog Agent パッケージに含まれています。 サーバーに追加でインストールする必要はありません。

構成

1. GlusterFS のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの glusterfs.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル glusterfs.d/conf.yaml を参照してください。

   init_config:
   
    ## @param gstatus_path - string - optional - default: /opt/datadog-agent/embedded/sbin/gstatus
    ## Path to the gstatus command.
    ##
    ## A version of the gstatus is shipped with the Agent binary.
    ## If you are using a source install, specify the location of gstatus.
    #
    # gstatus_path: /opt/datadog-agent/embedded/sbin/gstatus
   
    instances:
      -
        ## @param min_collection_interval - number - optional - default: 60
        ## The GlusterFS integration collects cluster-wide metrics which can put additional workload on the server.
        ## Increase the collection interval to reduce the frequency.
        ##
        ## This changes the collection interval of the check. For more information, see:
        ## https://docs.datadoghq.com/developers/write_agent_check/#collection-interval
        #
        min_collection_interval: 60
   

   注: デフォルトでは、gstatus はスーパーユーザーとして実行する必要がある gluster コマンドを内部的に呼び出します。次のような行を sudoers ファイルに追加します。

    dd-agent ALL=(ALL) NOPASSWD:/path/to/your/gstatus
   

   GlusterFS 環境が root を必要としない場合は、use_sudo コンフィギュレーションオプションを false に設定します。

2. Agent を再起動します。

ログ収集

1. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。

   logs_enabled: true
   

2. GlusterFS のログの収集を開始するには、glusterfs.d/conf.yaml ファイルでこのコンフィギュレーションブロックを編集します。

   logs:
     - type: file
       path: /var/log/glusterfs/glusterd.log
       source: glusterfs
     - type: file
       path: /var/log/glusterfs/cli.log
       source: glusterfs
   

path パラメーターの値を環境に合わせて変更します。使用可能なすべてのコンフィギュレーションオプションについては、conf.yaml のサンプルを参照してください。

3. Agent を再起動します。

Kubernetes 環境でのログ収集のための Agent の構成については、Kubernetes ログの収集を参照してください。

検証

Agent の status サブコマンドを実行し、Checks セクションで glusterfs を探します。

収集データ

メトリクス

イベント

GlusterFS には、イベントは含まれません。

サービスチェック

glusterfs.brick.health
Returns CRITICAL if the sub volume is ‘degraded’. Returns OK if ‘up’.
Statuses: ok, critical, warning

glusterfs.volume.health
Returns CRITICAL if the volume is ‘degraded’. Returns OK if ‘up’.
Statuses: ok, critical, warning

glusterfs.cluster.health
Returns CRITICAL if the volume is ‘degraded’. Returns OK otherwise.
Statuses: ok, critical, warning

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。