Supported OS Linux Windows Mac OS

インテグレーションバージョン2.0.0

概要

このチェックでは、Datadog AgentPure Storage FlashBlade OpenMetrics エクスポーターを通して Pure Storage FlashBlade を監視します。

このインテグレーションにより、アレイ、クライアント、シェア、バケットレベルのパフォーマンスデータ、および容量と構成の概要情報を提供することができます。

複数の FlashBlade を監視し、それらを 1 つのダッシュボードに集計したり、顧客定義環境ごとにまとめたりすることが可能です。

このインテグレーションには以下が必要です

  • FlashBlade Purity 4.1.x 以降
  • Datadog Agent v7.26.x+、OpenMetricsBaseCheckV2 を利用するため
  • Python 3
  • Pure Storage FlashBlade OpenMetrics エクスポーター v1.0.11 以降は、コンテナ環境でインストールされ、実行されます。インストール方法は、Pure Storage GitHub リポジトリを参照してください。

セットアップ

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

インストール

  1. Datadog Agent をダウンロードして起動します。
  2. Pure FlashBlade インテグレーションを手動でインストールします。環境に応じた詳細は、コミュニティインテグレーションを利用するを参照してください。

ホスト

ホスト上で動作している Agent に対してこのチェックを構成するには、datadog-agent integration install -t datadog-purefb==2.0.0 を実行します。

構成

  1. FlashBlade に Read-Only ロールのユーザーを作成し、このユーザー用の API トークンを生成します。

  2. PureFB のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの purefb.d/conf.yaml ファイルに以下の構成ブロックを追加します。使用可能なすべてのコンフィギュレーションオプションについては、サンプル purefb.d/conf.yaml を参照してください。

: コンフィギュレーションファイルを作成する際には、最低限 /array エンドポイントが必要です。

init_config:
   timeout: 120

instances:

  - openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/array?endpoint=<array_ip_or_fqdn>
    tags:
       - env:<env>
       - fb_array_name:<full_fqdn>
       - host:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 120

  - openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/clients?endpoint=<array_ip_or_fqdn>
    tags:
       - env:<env>
       - fb_array_name:<full_fqdn>
       - host:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 600

  - openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/usage?endpoint=<array_ip_or_fqdn>
    tags:
       - env:<env>
       - fb_array_name:<full_fqdn>
       - host:<full_fqdn>
    headers:
       Authorization: Bearer <api_token>
    min_collection_interval: 600
  1. Agent を再起動します

検証

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

トラブルシューティング

ダッシュボードにアレイが表示されない

このインテグレーションに含まれるダッシュボードでは、envhostfb_array_name というタグが使用されます。これらはインスタンスごとに設定されていることを確認してください。

 tags:
    - env:<env>
    - fb_array_name:<full_fqdn>
    - host:<full_fqdn>

収集間隔を長くする

/array エンドポイントの場合、Pure Storage FlashBlade のチェックでは、デフォルトで min_collection_interval120 に設定されており、推奨される最小値は 15 です。必要に応じて purefb.d/conf.yaml ファイルで min_collection_interval を増やしたり減らしたりすることができます。

min_collection_interval: 120

/clients、および /usage エンドポイントの場合、Pure Storage FlashBlade のチェックでは、デフォルトで min_collection_interval600 に設定されており、推奨される最小値は 120 です。必要に応じて purefb.d/conf.yaml ファイルで min_collection_interval を増やしたり減らしたりすることができます。

min_collection_interval: 600

収集データ

メトリクス

purefb.alerts.open
(gauge)
Open alert events
purefb.array.http_specific_performance_latency_usec
(gauge)
FlashBlade array HTTP specific latency
Shown as microsecond
purefb.array.http_specific_performance_throughput_iops
(gauge)
FlashBlade array HTTP specific throughput
Shown as operation
purefb.array.nfs_specific_performance_latency_usec
(gauge)
FlashBlade array NFS latency
Shown as microsecond
purefb.array.nfs_specific_performance_throughput_iops
(gauge)
FlashBlade array NFS throughput
Shown as operation
purefb.array.performance_average_bytes
(gauge)
FlashBlade array average operations size
Shown as byte
purefb.array.performance_bandwidth_bytes
(gauge)
FlashBlade array bandwidth
Shown as byte
purefb.array.performance_latency_usec
(gauge)
FlashBlade array latency
Shown as microsecond
purefb.array.performance_replication
(gauge)
FlashBlade array replication throughput in bytes per second
Shown as byte
purefb.array.performance_throughput_iops
(gauge)
FlashBlade array throughput
Shown as operation
purefb.array.s3_specific_performance_latency_usec
(gauge)
FlashBlade array S3 specific latency
Shown as microsecond
purefb.array.s3_specific_performance_throughput_iops
(gauge)
FlashBlade array S3 specific throughput
Shown as operation
purefb.array.space_bytes
(gauge)
FlashBlade space in bytes
Shown as byte
purefb.array.space_data_reduction_ratio
(gauge)
FlashBlade space data reduction
purefb.array.space_parity
(gauge)
FlashBlade space parity
purefb.array.space_utilization
(gauge)
FlashBlade array space utilization in percent
Shown as percent
purefb.buckets.object_count
(gauge)
FlashBlade buckets object count
purefb.buckets.performance_average_bytes
(gauge)
FlashBlade buckets average operations size
Shown as byte
purefb.buckets.performance_bandwidth_bytes
(gauge)
FlashBlade buckets bandwidth
Shown as byte
purefb.buckets.performance_latency_usec
(gauge)
FlashBlade buckets latency
Shown as microsecond
purefb.buckets.performance_throughput_iops
(gauge)
FlashBlade buckets throughput
Shown as operation
purefb.buckets.quota_space_bytes
(gauge)
FlashBlade buckets quota space in bytes
Shown as byte
purefb.buckets.s3_specific_performance_latency_usec
(gauge)
FlashBlade buckets S3 specific latency
Shown as microsecond
purefb.buckets.s3_specific_performance_throughput_iops
(gauge)
FlashBlade buckets S3 specific throughput
Shown as operation
purefb.buckets.space_bytes
(gauge)
FlashBlade buckets space in bytes
Shown as byte
purefb.buckets.space_data_reduction_ratio
(gauge)
FlashBlade buckets space data reduction
purefb.clients.performance_average_bytes
(gauge)
FlashBlade array clients average operations size
Shown as byte
purefb.clients.performance_bandwidth_bytes
(gauge)
FlashBlade array clients bandwidth
Shown as byte
purefb.clients.performance_latency_usec
(gauge)
FlashBlade array clients latency
Shown as microsecond
purefb.clients.performance_throughput_iops
(gauge)
FlashBlade array clients throughput
Shown as operation
purefb.file.system_usage_groups_bytes
(gauge)
FlashBlade file system groups usage
Shown as byte
purefb.file.system_usage_users_bytes
(gauge)
FlashBlade file system users usage
Shown as byte
purefb.file.systems_performance_average_bytes
(gauge)
FlashBlade filesystems average operations size
Shown as byte
purefb.file.systems_performance_bandwidth_bytes
(gauge)
FlashBlade filesystems bandwidth
Shown as byte
purefb.file.systems_performance_latency_usec
(gauge)
FlashBlade filesystems latency
Shown as microsecond
purefb.file.systems_performance_throughput_iops
(gauge)
FlashBlade filesystems throughput
Shown as operation
purefb.file.systems_space_bytes
(gauge)
FlashBlade file systems space in bytes
Shown as byte
purefb.file.systems_space_data_reduction_ratio
(gauge)
FlashBlade file systems space data reduction
purefb.hardware.connectors_performance_bandwidth_bytes
(gauge)
FlashBlade hardware connectors performance bandwidth
Shown as byte
purefb.hardware.connectors_performance_errors
(gauge)
FlashBlade hardware connectors performance errors per sec
purefb.hardware.connectors_performance_throughput_pkts
(gauge)
FlashBlade hardware connectors performance throughputh
purefb.hardware.health
(gauge)
FlashBlade hardware component health status
purefb.info
(gauge)
FlashBlade system information
purefb.nfs.export_rule
(gauge)
FlashBlade NFS export rules

イベント

PureFB インテグレーションには、イベントは含まれません。

サービスチェック

このインテグレーションによって提供されるサービスチェックのリストについては、service_checks.json を参照してください。

Agent

サポートまたは機能リクエストをご希望の場合は、以下の方法で Pure Storage にお問い合わせください。