Pure Storage FlashBlade

Supported OS Linux Mac OS Windows

Intégrationv1.0.1

Présentation

Ce check surveille le service Pure Storage FlashBlade via l’Agent Datadog et l’exportateur Pure Storage FlashBlade OpenMetrics.

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

Vous pouvez surveiller plusieurs stockages FlashBlade 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 :

  • FlashBlade Purity 3.2.x+
  • La version 7.26.x+ de l’Agent Datadog, afin d’exploiter OpenMetricsBaseCheckV2
  • Python 3
  • L’exportateur Pure Storage FlashBlade OpenMetrics, installé et exécuté dans un environnement conteneurisé (voir le référentiel Pure Storage 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 à un environnement conteneurisé.

Installation

  1. Téléchargez et lancez l’Agent Datadog.
  2. Installez manuellement l’intégration Pure Storage FlashBlade. 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-purefb==1.0.0.

Configuration

  1. Créez un utilisateur sur votre stockage FlashBlade avec un rôle en lecture seule, puis générez un token d’API pour cet utilisateur.

  2. Ajoutez le bloc de configuration suivant au fichier purefb.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 PureFB. Consultez le fichier d’exemple purefb.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: 120

instances:

  - openmetrics_endpoint: http://<exporter_ip_or_fqdn>:<port>/metrics/array?endpoint=<array_ip_or_fqdn>
    tags:
       - env:<environnement>
       - fb_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/clients?endpoint=<ip_ou_fqdn_baie>
    tags:
       - env:<environnement>
       - fb_array_name:<fqdn_complet>
       - host:<fqdn_complet>
    headers:
       Authorization: Bearer <token_api>
    min_collection_interval: 600

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

Validation

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

Dépannage

Aucune baie dans les dashboards

Les dashboards fournis par cette intégration reposent sur les tags env, host et fb_array_name. Vérifiez que vous les avez définis au niveau des instances.

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

Augmenter l’intervalle de collecte

Pour l’endpoint /array, le check Pure Storage FlashBlade définit par défaut min_collection_interval sur 120. La valeur minimale recommandée est 15. Vous pouvez augmenter ou diminuer min_collection_interval dans le fichier purefb.d/conf.yaml en fonction de vos besoins :

min_collection_interval: 120

Pour les endpoints /clients et /usage, le check Pure Storage FlashBlade définit par défaut min_collection_interval sur 600. La valeur minimale recommandée est 120. Vous pouvez augmenter ou diminuer min_collection_interval dans le fichier purefb.d/conf.yaml en fonction de vos besoins :

min_collection_interval: 600

Données collectées

Métriques

purefb.info
(gauge)
FlashBlade system information
purefb.hardware.health
(gauge)
FlashBlade hardware component health status
purefb.alerts.open
(gauge)
Open alert events
purefb.array.performance_latency_usec
(gauge)
FlashBlade array latency
Shown as microsecond
purefb.array.performance_throughput_iops
(gauge)
FlashBlade array throughput
Shown as operation
purefb.array.performance_bandwidth_bytes
(gauge)
FlashBlade array bandwidth
Shown as byte
purefb.array.performance_average_bytes
(gauge)
FlashBlade array average operations size
Shown as byte
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_latency_usec
(gauge)
FlashBlade array NFS latency
Shown as microsecond
purefb.array.nfs_throughput_iops
(gauge)
FlashBlade array NFS 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_data_reduction_ratio
(gauge)
FlashBlade space data reduction
purefb.array.space_bytes
(gauge)
FlashBlade space in bytes
Shown as byte
purefb.array.space_parity
(gauge)
FlashBlade space parity
purefb.array.space_utilization
(gauge)
FlashBlade array space utilization in percent
Shown as percent
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.performance_bandwidth_bytes
(gauge)
FlashBlade buckets bandwidth
Shown as byte
purefb.buckets.performance_average_bytes
(gauge)
FlashBlade buckets average operations size
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_data_reduction_ratio
(gauge)
FlashBlade buckets space data reduction
purefb.buckets.space_bytes
(gauge)
FlashBlade buckets space in bytes
Shown as byte
purefb.buckets.space_objects
(gauge)
FlashBlade buckets objects count
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_performance_bandwidth_bytes
(gauge)
FlashBlade filesystems bandwidth
Shown as byte
purefb.file.systems_performance_average_bytes
(gauge)
FlashBlade filesystems average operations size
Shown as byte
purefb.file.systems_space_data_reduction_ratio
(gauge)
FlashBlade file systems space data reduction
purefb.file.systems_space_bytes
(gauge)
FlashBlade file systems space in bytes
Shown as byte
purefb.bucket.replica_links_lag_msec
(gauge)
FlashBlade bucket replica links lag
Shown as millisecond
purefb.file.system_links_lag_msec
(gauge)
FlashBlade filesystem links lag
Shown as millisecond
purefb.hardware.connectors_performance_bandwidth_bytes
(gauge)
FlashBlade hardware connectors performance bandwidth
Shown as byte
purefb.hardware.connectors_performance_throughput_pkts
(gauge)
FlashBlade hardware connectors performance throughputh
purefb.hardware.connectors_performance_errors
(gauge)
FlashBlade hardware connectors performance errors per sec
purefb.file.system_usage_users_bytes
(gauge)
FlashBlade file system users usage
Shown as byte
purefb.file.system_usage_groups_bytes
(gauge)
FlashBlade file system groups usage
Shown as byte
purefb.array.clients_performance_latency_usec
(gauge)
FlashBlade array clients latency
Shown as microsecond
purefb.array.clients_performance_throughput_iops
(gauge)
FlashBlade array clients throughput
Shown as operation
purefb.array.clients_performance_bandwidth_bytes
(gauge)
FlashBlade array clients bandwidth
Shown as byte
purefb.array.clients_performance_avg_size_bytes
(gauge)
FlashBlade array clients average operations size
Shown as byte

Événements

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

Checks de service

Consultez le fichier service_checks.json pour afficher 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 :