Previous

Next

Dashboard Pure Storage FlashArray - Vue d'ensemble (haut)

Dashboard Pure Storage FlashArray - Vue d'ensemble (milieu)

Dashboard Pure Storage FlashArray - Vue d'ensemble (bas)

Section Overview

Ce contrôle surveille le Pure Storage FlashArray par l’intermédiaire de Datadog Agent et de Pure Storage OpenMetrics exporter.

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 Pure Storage OpenMetrics est installé et fonctionne dans un environnement conteneurisé. Reportez-vous au [GitHub repo] (https://github.com/PureStorage-OpenConnect/pure-fa-openmetrics-exporter) pour les instructions d’installation.
  • Sur les FlashArrays utilisant Purity//FA version 6.7.0 et supérieure, l’exportateur OpenMetrics fonctionne nativement sur la matrice, voir Configuration pour plus de détails.

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 le site Datadog Agent .
2. Installez manuellement l’intégration Pure FlashArray. Voir [Use Community Integrations] (https://docs.datadoghq.com/agent/guide/community-integrations-installation-with-docker-agent) pour 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 sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==<INTEGRATION_VERSION>.

Note : <INTEGRATION_VERSION> peut être trouvé dans le CHANGELOG.md pour Datadog Integration Extras.

• par exemple sudo -u dd-agent -- datadog-agent integration install -t datadog-purefa==1.3.0

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.
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 à collecter les données de performance de PureFA. Voir l’exemple purefa.d/conf.yaml pour toutes les options de configuration disponibles.

Note : Le point de terminaison /array est requis au minimum lors de la création de votre fichier de configuration.

(Préféré) Pour utilisation avec le Pure Storage OpenMetrics Exporter natif (Purity//FA 6.7.0+)

init_config :
   timeout : 60

instances :

  - openmetrics_endpoint : https://<array_ip_or_fqdn>/metrics/array?namespace=purefa
    tags :
       - env :<env>
       - fa_array_name :<full_fqdn>
       - host :<full_fqdn>
    headers :
       Authorization : Bearer <api_token>
    min_collection_interval : 120
    # Si vous n'avez pas configuré votre certificat TLS de gestion de la pureté, vous pouvez sauter la vérification TLS. Pour les autres options TLS, veuillez consulter conf.yaml.exemple.
    # tls_verify : false
    # tls_ignore_warning : true

  - openmetrics_endpoint : https://<array_ip_or_fqdn>/metrics/volumes?namespace=purefa
    tags :
       - env :<env>
       - fa_array_name :<full_fqdn>
    headers :
       Authorization : Bearer <api_token>
    min_collection_interval : 120
    # Si vous n'avez pas configuré votre certificat TLS de gestion de la pureté, vous pouvez sauter la vérification TLS. Pour les autres options TLS, veuillez consulter conf.yaml.exemple.
    # tls_verify : false
    # tls_ignore_warning : true

  - openmetrics_endpoint : https://<array_ip_or_fqdn>/metrics/hosts?namespace=purefa
    tags :
       - env :<env>
       - fa_array_name :<full_fqdn>
    headers :
       Authorization : Bearer <api_token>
    min_collection_interval : 120
    # Si vous n'avez pas configuré votre certificat TLS de gestion de la pureté, vous pouvez sauter la vérification TLS. Pour les autres options TLS, veuillez consulter conf.yaml.exemple.
    # tls_verify : false
    # tls_ignore_warning : true

  - openmetrics_endpoint : https://<array_ip_or_fqdn>/metrics/pods?namespace=purefa
    tags :
       - env :<env>
       - fa_array_name :<full_fqdn>
       - host :<full_fqdn>
    headers :
       Authorization : Bearer <api_token>
    min_collection_interval : 120
    # Si vous n'avez pas configuré votre certificat TLS de gestion de la pureté, vous pouvez sauter la vérification TLS. Pour les autres options TLS, veuillez consulter conf.yaml.exemple.
    # tls_verify : false
    # tls_ignore_warning : true

  - openmetrics_endpoint : https://<array_ip_or_fqdn>/metrics/directories?namespace=purefa
    tags :
       - env :<env>
       - fa_array_name :<full_fqdn>
       - host :<full_fqdn>
    headers :
       Authorization : Bearer <api_token>
    min_collection_interval : 120
    # Si vous n'avez pas configuré votre certificat TLS de gestion de la pureté, vous pouvez sauter la vérification TLS. Pour les autres options TLS, veuillez consulter conf.yaml.exemple.
    # tls_verify : false
    # tls_ignore_warning : true

À utiliser avec l’exportateur externe [Pure Storage OpenMetrics exporter] (https://github.com/PureStorage-OpenConnect/pure-fa-openmetrics-exporter) (Purity //FA <6.7.0)

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

2. [Redémarrer le Agent] (https://docs.datadoghq.com/agent/guide/agent-commands/#start-stop-and-restart-the-agent).

Validation

Exécutez la sous-commande Agent’s status et recherchez purefa dans la section Checks.

Mise à niveau vers de nouvelles versions de cette intégration

De PureFA Agent Check 1.0.x à 1.1.x

La version 1.1.x prend en charge à la fois l’exportateur [Pure Storage OpenMetrics] (https://github.com/PureStorage-OpenConnect/pure-fa-openmetrics-exporter) et l’exportateur [Pure Storage Prometheus] (https://github.com/PureStorage-OpenConnect/pure-exporter), qui n’est plus d’actualité.

Le tableau de bord de l’exportateur [Pure Storage Prometheus] (https://github.com/PureStorage-OpenConnect/pure-exporter) a été renommé Pure FlashArray - Overview (Legacy Exporter).

Une liste des métriques qui sont à la fois partagées et uniques aux différents exportateurs est listée dans [metrics.py] (https://github.com/datadog/integrations-extras/blob/master/purefa/datadog_checks/purefa/metrics.py). Il se peut que vous deviez mettre à jour vos tableaux de bord et/ou vos alertes pour qu’ils correspondent aux nouveaux noms des mesures lors de la migration de Pure Storage Prometheus exporter vers Pure Storage OpenMetrics exporter. Si vous avez des questions, veuillez contacter Pure Storage à l’aide des informations figurant dans l’onglet Support.

Lors de la migration de Pure Storage Prometheus exporter vers Pure Storage OpenMetrics exporter, les points d’extrémité n’ont plus /flasharray dans l’URI du point d’extrémité.

Dans les futures versions du PureFA Agent Check, les noms de métriques issus de l’exportateur Prometheus de Pure Storage seront supprimés.

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

Événements

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

Checks de service

purefa.openmetrics.health

Renvoie CRITICAL si Agent n’est pas en mesure de se connecter au point de terminaison OpenMetrics, sinon renvoie OK.

Etat : ok, critique

Assistance

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

• E-mail : pure-observability@purestorage.com
• Slack : [Pure Storage Code// Observability Channel] (https://code-purestorage.slack.com/messages/C0357KLR1EU).