Pure Storage FlashArray

Supported OS Linux Mac OS Windows

Intégrationv1.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&rsquo;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.total
(gauge)
Number of alert events
purefa.array.performance_avg_block_bytes
(gauge)
FlashArray avg block size
Shown as byte
purefa.array.performance_bandwidth_bytes
(gauge)
FlashArray bandwidth
Shown as byte
purefa.array.performance_iops
(gauge)
FlashArray IOPS
Shown as operation
purefa.array.performance_latency_usec
(gauge)
FlashArray latency
Shown as microsecond
purefa.array.performance_qdepth
(gauge)
FlashArray queue depth
purefa.array.space_capacity_bytes
(gauge)
FlashArray overall space capacity
Shown as byte
purefa.array.space_datareduction_ratio
(gauge)
FlashArray overall data reduction
purefa.array.space_provisioned_bytes
(gauge)
FlashArray overall provisioned space
Shown as byte
purefa.array.space_used_bytes
(gauge)
FlashArray overall used space
Shown as byte
purefa.hardware.chassis_health
(gauge)
FlashArray hardware chassis health status
purefa.hardware.component_health
(gauge)
FlashArray hardware component health status
purefa.hardware.controller_health
(gauge)
FlashArray hardware controller health status
purefa.hardware.power_volts
(gauge)
FlashArray hardware power supply voltage
Shown as volt
purefa.hardware.temperature_celsius
(gauge)
FlashArray hardware temperature sensors
Shown as degree celsius
purefa.host.performance_bandwidth_bytes
(gauge)
FlashArray host bandwidth
Shown as byte
purefa.host.performance_iops
(gauge)
FlashArray host IOPS
Shown as operation
purefa.host.performance_latency_usec
(gauge)
FlashArray host IO latency
Shown as microsecond
purefa.host.space_bytes
(gauge)
FlashArray host volumes allocated space
Shown as byte
purefa.host.space_datareduction_ratio
(gauge)
FlashArray host volumes data reduction ratio
purefa.host.space_size_bytes
(gauge)
FlashArray host volumes size
Shown as byte
purefa.info
(gauge)
FlashArray host volumes connections
purefa.pod.mediator_status
(gauge)
FlashArray pod mediatorstatus
purefa.pod.performance_bandwidth_bytes
(gauge)
FlashArray pod bandwidth
Shown as byte
purefa.pod.performance_iops
(gauge)
FlashArray pod IOPS
Shown as operation
purefa.pod.performance_latency_usec
(gauge)
FlashArray pod IO latency
Shown as microsecond
purefa.pod.space_bytes
(gauge)
FlashArray pod size
Shown as byte
purefa.pod.space_datareduction_ratio
(gauge)
FlashArray pod data reduction ratio
purefa.pod.space_size_bytes
(gauge)
FlashArray pod size
Shown as byte
purefa.pod.status
(gauge)
FlashArray pod status
purefa.volume.performance_iops
(gauge)
FlashArray volume IOPS
Shown as operation
purefa.volume.performance_latency_usec
(gauge)
FlashArray volume IO latency
Shown as microsecond
purefa.volume.performance_throughput_bytes
(gauge)
FlashArray volume throughput
Shown as byte
purefa.volume.space_bytes
(gauge)
FlashArray allocated space
Shown as byte
purefa.volume.space_datareduction_ratio
(gauge)
FlashArray volumes data reduction ratio
purefa.volume.space_size_bytes
(gauge)
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 :