Pure Storage FlashArray

Supported OS Linux Mac OS Windows

Intégration1.0.1

Présentation

Ce check surveille le service Pure Storage FlashArray via l’Agent Datadog et l’exportateur Prometheus Pure Storage.

Cette intégration vous permet d’obtenir des données sur les performances des baies, hosts, volumes et pods, ainsi que des informations générales sur la configuration et la capacité.

Vous pouvez surveiller plusieurs baies FlashArray et les agréger au sein d’un unique dashboard, ou encore les regrouper en fonction de l’environnement de votre choix.

Cette intégration nécessite les éléments suivants :

  • La version 7.26.x+ de l’Agent, afin d’exploiter OpenMetricsBaseCheckV2
  • Python 3
  • L’exportateur Prometheus Pure Storage, installé et exécuté dans un environnement conteneurisé (voir le référentiel GitHub pour obtenir des instructions d’installation)

Configuration

Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer ces instructions à des environnements conteneurisés.

Installation

  1. Téléchargez et lancez l’Agent Datadog.
  2. Installez manuellement l’intégration Pure Storage FlashArray. Consultez la section Utiliser les intégrations de la communauté pour découvrir plus de détails en fonction de votre environnement.

Host

Pour configurer ce check pour un Agent en cours d’exécution sur un host, exécutez la commande datadog-agent integration install -t datadog-purefa==<VERSION_INTÉGRATION>.

Remarque : la version de l’intégration est indiquée dans le CHANGELOG.md du référentiel Integration Extras Datadog.

  • Exemple : datadog-agent integration install -t datadog-purefa==1.0.1

Configuration

  1. Créez un utilisateur local sur votre baie FlashArray avec un rôle en lecture seule, puis générez un token d’API pour cet utilisateur. Générer une clé d’API
  2. Ajoutez le bloc de configuration suivant au fichier purefa.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance PureFA. Consultez le fichier d’exemple purefa.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

Remarque : lors de la création de votre fichier de configuration, vous devez impérativement utiliser l’endpoint /array.

init_config:
   timeout: 60

instances:

  - openmetrics_endpoint: http://<ip_ou_fqdn_exportateur>:<port>/metrics/flasharray/array?endpoint=<ip_ou_fqdn_baie>
    tags:
       - env:<environnement>
       - fa_array_name:<fqdn_complet>
       - host:<fqdn_complet>
    headers:
       Authorization: Bearer <token_api>
    min_collection_interval: 120

  - openmetrics_endpoint: http://<ip_ou_fqdn_exportateur>:<port>/metrics/flasharray/volumes?endpoint=<ip_ou_fqdn_baie>
    tags:
       - env:<environnement>
       - fa_array_name:<fqdn_complet>
    headers:
       Authorization: Bearer <token_api>
    min_collection_interval: 120

  - openmetrics_endpoint: http://<ip_ou_fqdn_exportateur>:<port>/metrics/flasharray/hosts?endpoint=<ip_ou_fqdn_baie>
    tags:
       - env:<environnement>
       - fa_array_name:<fqdn_complet>
    headers:
       Authorization: Bearer <token_api>
    min_collection_interval: 120

  - openmetrics_endpoint: http://<ip_ou_fqdn_exportateur>:<port>/metrics/flasharray/pods?endpoint=<ip_ou_fqdn_baie>
    tags:
       - env:<environnement>
       - fa_array_name:<fqdn_complet>
       - host:<fqdn_complet>
    headers:
       Authorization: Bearer <token_api>
    min_collection_interval: 120
  1. Redémarrez l’Agent.

Validation

Lancez la sous-commande status de l’Agent et cherchez purefa dans la section Checks.

Dépannage

Aucune baie dans les dashboards

Les dashboards fournis par cette intégration reposent sur les tags env et fa_array_name. Vérifiez que vous les avez définis au niveau des instances. Vous devez également définir host pour les endpoints /array et /pods dans purefa.d/conf.yaml.

- tags:
   - env:<environnement>
   - fa_array_name:<fqdn_complet>
   - host:<fqdn_complet>

Augmenter l’intervalle de collecte

Le check Pure Storage FlashArray définit par défaut min_collection_interval sur 120. La valeur minimale recommandée est 20. Vous pouvez augmenter ou diminuer min_collection_interval dans le fichier purefa.d/conf.yaml en fonction de vos besoins :

min_collection_interval: 120

Données collectées

Métriques

purefa.alerts.open
(gauge)
FlashArray open alert events.
purefa.alerts.total
(gauge)
(Legacy) Number of alert events.
purefa.array.performance_average_bytes
(gauge)
FlashArray array average operations size in bytes.
Shown as byte
purefa.array.performance_avg_block_bytes
(gauge)
(Legacy) FlashArray avg block size.
Shown as byte
purefa.array.performance_bandwidth_bytes
(gauge)
FlashArray array throughput in bytes per second.
Shown as byte
purefa.array.performance_iops
(gauge)
(Legacy) FlashArray IOPS.
Shown as operation
purefa.array.performance_latency_usec
(gauge)
FlashArray array latency in microseconds.
Shown as microsecond
purefa.array.performance_qdepth
(gauge)
(Legacy) FlashArray queue depth.
purefa.array.performance_queue_depth_ops
(gauge)
FlashArray array queue depth size.
Shown as operation
purefa.array.performance_throughput_iops
(gauge)
FlashArray array throughput in iops.
Shown as operation
purefa.array.space_bytes
(gauge)
FlashArray array space in bytes.
Shown as byte
purefa.array.space_capacity_bytes
(gauge)
(Legacy) FlashArray overall space capacity.
Shown as byte
purefa.array.space_data_reduction_ratio
(gauge)
FlashArray array space data reduction.
purefa.array.space_datareduction_ratio
(gauge)
(Legacy) FlashArray overall data reduction.
purefa.array.space_provisioned_bytes
(gauge)
(Legacy) FlashArray overall provisioned space.
Shown as byte
purefa.array.space_used_bytes
(gauge)
(Legacy) FlashArray overall used space.
Shown as byte
purefa.array.space_utilization
(gauge)
FlashArray array space utilization in percent.
Shown as percent
purefa.directory.performance_average_bytes
(gauge)
FlashArray directory average operations size in bytes.
Shown as byte
purefa.directory.performance_bandwidth_bytes
(gauge)
FlashArray directory throughput in bytes per second.
Shown as byte
purefa.directory.performance_latency_usec
(gauge)
FlashArray directory latency in microseconds.
Shown as microsecond
purefa.directory.performance_throughput_iops
(gauge)
FlashArray directory throughput in iops.
Shown as operation
purefa.directory.space_bytes
(gauge)
FlashArray directory space in bytes.
Shown as byte
purefa.directory.space_data_reduction_ratio
(gauge)
FlashArray directory space data reduction.
purefa.drive.capacity_bytes
(gauge)
FlashArray drive capacity in bytes.
Shown as byte
purefa.hardware.chassis_health
(gauge)
(Legacy) FlashArray hardware chassis health status.
purefa.hardware.component_health
(gauge)
(Legacy) FlashArray hardware component health status.
purefa.hardware.controller_health
(gauge)
(Legacy) FlashArray hardware controller health status.
purefa.hardware.power_volts
(gauge)
(Legacy) FlashArray hardware power supply voltage.
Shown as volt
purefa.hardware.temperature_celsius
(gauge)
(Legacy) FlashArray hardware temperature sensors.
Shown as degree celsius
purefa.host.connections_info
(gauge)
FlashArray host volumes connections.
purefa.host.connectivity_info
(gauge)
FlashArray host connectivity info.
purefa.host.performance_average_bytes
(gauge)
FlashArray host average operations size in bytes.
Shown as byte
purefa.host.performance_bandwidth_bytes
(gauge)
FlashArray host bandwidth in bytes per second.
Shown as byte
purefa.host.performance_iops
(gauge)
(Legacy) FlashArray host IOPS.
Shown as operation
purefa.host.performance_latency_usec
(gauge)
FlashArray host latency in microseconds.
Shown as microsecond
purefa.host.performance_throughput_iops
(gauge)
FlashArray host throughput in iops.
Shown as operation
purefa.host.space_bytes
(gauge)
FlashArray host space in bytes.
Shown as byte
purefa.host.space_data_reduction_ratio
(gauge)
FlashArray host space data reduction.
purefa.host.space_datareduction_ratio
(gauge)
(Legacy) FlashArray host volumes data reduction ratio.
purefa.host.space_size_bytes
(gauge)
FlashArray host volumes size.
Shown as byte
purefa.hw.component_status
(gauge)
FlashArray hardware component status.
purefa.hw.component_temperature_celsius
(gauge)
FlashArray hardware component temperature in C.
Shown as degree celsius
purefa.hw.component_voltage_volt
(gauge)
FlashArray hardware component voltage.
Shown as volt
purefa.info
(gauge)
FlashArray system information.
purefa.network.interface_performance_bandwidth_bytes
(gauge)
FlashArray network interface bandwidth in bytes per second
Shown as byte
purefa.network.interface_performance_errors
(gauge)
FlashArray network interface errors in errors per second
Shown as error
purefa.network.interface_performance_throughput_pkts
(gauge)
FlashArray network interface throughput in packets per second.
Shown as packet
purefa.pod.mediator_status
(gauge)
(Legacy) FlashArray pod mediatorstatus.
purefa.pod.performance_average_bytes
(gauge)
FlashArray pod average operations size.
Shown as byte
purefa.pod.performance_bandwidth_bytes
(gauge)
FlashArray pod throughput in bytes per second.
Shown as byte
purefa.pod.performance_iops
(gauge)
(Legacy) FlashArray pod IOPS.
Shown as operation
purefa.pod.performance_latency_usec
(gauge)
FlashArray pod latency in microseconds.
Shown as microsecond
purefa.pod.performance_replication_bandwidth_bytes
(gauge)
FlashArray pod replication bandwidth.
Shown as byte
purefa.pod.performance_throughput_iops
(gauge)
FlashArray pod throughput in iops.
Shown as operation
purefa.pod.replica_links_lag_average_sec
(gauge)
FlashArray pod links average lag in seconds.
Shown as second
purefa.pod.replica_links_lag_max_sec
(gauge)
FlashArray pod links max lag in seconds.
Shown as second
purefa.pod.replica_links_performance_bandwidth_bytes
(gauge)
FlashArray pod links bandwidth.
Shown as byte
purefa.pod.space_bytes
(gauge)
FlashArray pod space in bytes.
Shown as byte
purefa.pod.space_data_reduction_ratio
(gauge)
FlashArray pod space data reduction.
purefa.pod.space_datareduction_ratio
(gauge)
(Legacy) FlashArray pod data reduction ratio.
purefa.pod.space_size_bytes
(gauge)
(Legacy) FlashArray pod size.
Shown as byte
purefa.pod.status
(gauge)
(Legacy) FlashArray pod status.
purefa.volume.performance_average_bytes
(gauge)
FlashArray volume average operations size in bytes.
Shown as byte
purefa.volume.performance_bandwidth_bytes
(gauge)
FlashArray volume throughput in bytes per second.
Shown as byte
purefa.volume.performance_iops
(gauge)
(Legacy) FlashArray volume IOPS.
Shown as operation
purefa.volume.performance_latency_usec
(gauge)
FlashArray volume latency in microseconds.
Shown as microsecond
purefa.volume.performance_throughput_bytes
(gauge)
(Legacy) FlashArray volume throughput.
Shown as byte
purefa.volume.performance_throughput_iops
(gauge)
FlashArray volume throughput in iops.
Shown as operation
purefa.volume.space_bytes
(gauge)
FlashArray volume space in bytes.
Shown as byte
purefa.volume.space_data_reduction_ratio
(gauge)
FlashArray volume space data reduction.
purefa.volume.space_datareduction_ratio
(gauge)
(Legacy) FlashArray volumes data reduction ratio.
purefa.volume.space_size_bytes
(gauge)
(Legacy) FlashArray volumes size.
Shown as byte

Événements

L’intégration PureFA n’inclut aucun événement.

Checks de service

Consultez le fichier service_checks.json pour parcourir la liste des checks de service fournis par cette intégration.

Assistance

Pour obtenir de l’aide ou demander l’ajout d’une fonctionnalité, contactez Pure Storage à l’aide des informations suivantes :