Pure Storage FlashArray ダッシュボード - 概要 (上)
Pure Storage FlashArray ダッシュボード - 概要 (中)
Pure Storage FlashArray ダッシュボード - 概要 (下)
概要
このチェックでは、Datadog Agent と Pure Storage OpenMetrics エクスポーターを通して Pure Storage FlashArray を監視します。
このインテグレーションにより、アレイ、ホスト、ボリューム、ポッドレベルのパフォーマンスデータ、および容量と構成の概要情報を提供することができます。
複数の FlashArray を監視し、それらを 1 つのダッシュボードに集計したり、顧客定義環境ごとにまとめたりすることが可能です。
このインテグレーションには以下が必要です。
- Agent v7.26.x+、OpenMetricsBaseCheckV2 を利用するため
- Python 3
- Pure Storage OpenMetrics エクスポーターは、コンテナ環境でインストールされ、実行されます。インストール方法は、GitHub リポジトリを参照してください。
セットアップ
ホストで実行されている Agent 用にこのチェックをインストールおよび構成する場合は、以下の手順に従ってください。コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照してこの手順を行ってください。
インストール
- Datadog Agent をダウンロードして起動します。
- Pure FlashArray インテグレーションを手動でインストールします。環境に応じた詳細は、コミュニティインテグレーションを利用するを参照してください。
ホスト
ホスト上で動作している Agent に対してこのチェックを構成するには、sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==<INTEGRATION_VERSION> を実行します。
注: <INTEGRATION_VERSION> は、Datadog Integration Extras の CHANGELOG.md 内に記載されています。
- 例:
sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==1.2.0
構成
- FlashArray に Read-Only ロールのローカルユーザーを作成し、このユーザー用の API トークンを生成します。
- PureFA のパフォーマンスデータの収集を開始するには、Agent のコンフィギュレーションディレクトリのルートにある
conf.d/ フォルダーの purefa.d/conf.yaml ファイルに以下の構成ブロックを追加します。使用可能なすべてのコンフィギュレーションオプションについては、サンプル purefa.d/conf.yaml を参照してください。
注: コンフィギュレーションファイルを作成する際には、最低限 /array エンドポイントが必要です。
init_config:
timeout: 60
instances:
- openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/array?endpoint=<array_ip_or_fqdn>
tags:
- env:<env>
- fa_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/volumes?endpoint=<array_ip_or_fqdn>
tags:
- env:<env>
- fa_array_name:<full_fqdn>
headers:
Authorization: Bearer <api_token>
min_collection_interval: 120
- openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/hosts?endpoint=<array_ip_or_fqdn>
tags:
- env:<env>
- fa_array_name:<full_fqdn>
headers:
Authorization: Bearer <api_token>
min_collection_interval: 120
- openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/pods?endpoint=<array_ip_or_fqdn>
tags:
- env:<env>
- fa_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/directories?endpoint=<array_ip_or_fqdn>
tags:
- env:<env>
- fa_array_name:<full_fqdn>
- host:<full_fqdn>
headers:
Authorization: Bearer <api_token>
min_collection_interval: 120
- Agent を再起動します。
検証
Agent の status サブコマンドを実行し、Checks セクションの purefa を探します。
本インテグレーションの新しいバージョンへのアップグレード
PureFA Agent Check 1.0.x から 1.1.x へ
1.1.x では、Pure Storage OpenMetrics エクスポーターと非推奨の Pure Storage Prometheus エクスポーターの両方がサポートされています。
非推奨の Pure Storage Prometheus エクスポーターのダッシュボードは、Pure FlashArray - Overview (Legacy Exporter) に名称が変更されました。
各エクスポーターで共有されるメトリクスと固有のメトリクスの一覧は、metrics.py に記載されています。Pure Storage Prometheus エクスポーター]10から Pure Storage OpenMetrics エクスポーターに移行する場合、新しいメトリクス名に合わせてダッシュボードやアラートを更新する必要がある場合があります。ご不明な点がございましたら、 Support タブの情報をもとに Pure Storage にお問い合わせください。
Pure Storage Prometheus エクスポーターから Pure Storage OpenMetrics エクスポーターに移行する際、エンドポイント URI に /flasharray が含まれないようになりました。
PureFA Agent Check の将来のバージョンでは、Pure Storage Prometheus エクスポーターからのメトリクス名は削除されます。
トラブルシューティング
ダッシュボードにアレイが表示されない
このインテグレーションに含まれるダッシュボードでは、env と fa_array_name というタグが使用されます。これらはインスタンスごとに設定されていることを確認してください。また、purefa.d/conf.yaml で /array と /pods のエンドポイントに host を設定する必要があります。
- tags:
- env:<env>
- fa_array_name:<full_fqdn>
- host:<full_fqdn>
収集間隔を長くする
Pure Storage FlashArray のチェックでは、デフォルトで min_collection_interval が 120 に設定されており、推奨される最小値は 20 です。必要に応じて purefa.d/conf.yaml ファイルで min_collection_interval を増やしたり減らしたりすることができます。
min_collection_interval: 120
収集データ
メトリクス
イベント
PureFA インテグレーションには、イベントは含まれません。
サービスチェック
このインテグレーションによって提供されるサービスチェックのリストについては、service_checks.json を参照してください。
Agent
サポートまたは機能リクエストをご希望の場合は、以下の方法で Pure Storage にお問い合わせください。
