

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Surveillance des systèmes FSx de fichiers ONTAP à l'aide de Harvest et Grafana
<a name="monitoring-harvest-grafana"></a>

NetApp Harvest est un outil open source permettant de recueillir des mesures de performance et de capacité à partir des systèmes ONTAP. Il est compatible avec FSx ONTAP. Vous pouvez utiliser Harvest avec Grafana pour une solution de surveillance open source.

## Commencer à utiliser Harvest et Grafana
<a name="harvest-grafana"></a>

La section suivante explique comment configurer Harvest et Grafana FSx pour mesurer les performances de votre système de fichiers ONTAP et l'utilisation de la capacité de stockage. 

Vous pouvez surveiller votre système de fichiers Amazon FSx for NetApp ONTAP en utilisant Harvest etGrafana. NetApp Harvestsurveille les centres de ONTAP données en collectant des indicateurs de performance, de capacité et de matériel à partir FSx des systèmes de fichiers ONTAP. Grafanafournit un tableau de bord où les Harvest métriques collectées peuvent être affichées.

## Tableaux de bord Harvest pris en charge
<a name="supported-harvest-dashboards"></a>

Amazon FSx for NetApp ONTAP présente un ensemble de mesures différent de celui affiché sur site. NetApp ONTAP Par conséquent, seuls les out-of-the-box Harvest tableaux de bord suivants marqués avec le tag `fsx` sont actuellement pris en charge pour une utilisation avec FSx ONTAP. Certains panneaux de ces tableaux de bord peuvent ne pas contenir des informations qui ne sont pas prises en charge.
+ Récolte : métadonnées
+ ONTAP : Agrégat
+ ONTAP : CDot
+ ONTAP : Cluster
+ ONTAP : Conformité
+ ONTAP : Datacenter
+ ONTAP : Protection des données
+ CONTAP : LUNE
+ ONTAP : Réseau
+ ONTAP : Nœud
+ ONTAP : Arree
+ ONTAP : Sécurité
+ ONTAP : SnapMirror
+ ONTAP : Destinations SnapMirror 
+ ONTAP : Sources SnapMirror 
+ POINT DE CONTACT : SVM
+ ONTAP : Volume
+ ONTAP : Volume par SVM
+ ONTAP : Volume Deep Dive

Les Harvest tableaux de bord suivants sont pris en charge par FSx ONTAP, mais ne sont pas activés par défaut dans. Harvest
+ ONTAP : FlexCache
+ ONTAP : FlexGroup
+ ONTAP : Clients NFS
+ ONTAP : Moniteurs NFSv4 Storepool
+ ONTAP : Résolution des problèmes liés au NFS
+ ONTAP : NVMe Espaces de noms
+ POINT DE CONTACT : SMB
+ ONTAP : Charge de travail

## Tableaux de bord non pris en charge Harvest
<a name="unsupported-dashboards"></a>

Les Harvest tableaux de bord suivants *ne sont pas* pris en charge par FSx for ONTAP.
+ ONTAP : Disque
+ ONTAP : Fonctionnement du service externe
+ ONTAP : Analyse des systèmes de fichiers (FSA)
+ ONTAP : Headroom
+ ONTAP : Health
+ ONTAP : Demande MAV
+ ONTAP : MetroCluster
+ ONTAP : Alimentation
+ ONTAP : Étagère
+ ONTAP : magasins d'objets S3

## CloudFormation modèle
<a name="harvest-grafana-template"></a>

Pour commencer, vous pouvez déployer un CloudFormation modèle qui lance automatiquement une EC2 instance Amazon exécutant Harvest et Grafana. En entrée dans le CloudFormation modèle, vous spécifiez l'`fsxadmin`utilisateur et le point de terminaison de FSx gestion Amazon pour le système de fichiers qui sera ajouté dans le cadre de ce déploiement. Une fois le déploiement terminé, vous pouvez vous connecter au tableau de bord Grafana pour surveiller votre système de fichiers.

Cette solution permet CloudFormation d'automatiser le déploiement de la solution Harvest et Grafana. Le modèle crée une instance Amazon EC2 Linux et installe les logiciels Harvest et Grafana. Pour utiliser cette solution, téléchargez le [fsx-ontap-harvest-grafanamodèle CloudFormation .template.](https://solution-references.s3.amazonaws.com/fsx/harvest-grafana/harvest-grafana.yaml)

**Note**  
La mise en œuvre de cette solution entraîne la facturation des AWS services associés. Pour plus d'informations, consultez les pages de détail des tarifs de ces services.

## Types d' EC2 instances Amazon
<a name="ec2-instance-types"></a>

Lors de la configuration du modèle, vous indiquez le type d' EC2 instance Amazon. NetAppLa recommandation concernant la taille de l'instance dépend du nombre de systèmes de fichiers que vous surveillez et du nombre de métriques que vous choisissez de collecter. Avec la configuration par défaut, pour chaque 10 systèmes de fichiers que vous surveillez, NetApp recommande :
+ Processeur : 2 cœurs
+ Mémoire : 1 Go
+ Disque : 500 Mo (principalement utilisé par les fichiers journaux)

Voici quelques exemples de configurations et le type d'`t3`instance que vous pouvez choisir.


****  

| Systèmes de fichiers | CPU | Disk | Type d’instance | 
| --- | --- | --- | --- | 
|  Moins de 10 ans  |  2 noyaux  |  500 Mo  |  `t3.micro`  | 
|  10 à 40  |  4 cœurs  |  1000 MO  |  `t3.xlarge`  | 
|  40 ans et plus  |  8 noyaux  |  2000 MO  |  `t3.2xlarge`  | 

Pour plus d'informations sur les types d' EC2 [instances Amazon, consultez la section Instances à usage général](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/general-purpose-instances.html) dans le *guide de EC2 l'utilisateur Amazon*.

### Règles relatives aux ports d'instance
<a name="instance-port-rules"></a>

Lorsque vous configurez votre EC2 instance Amazon, assurez-vous que les ports 3000 et 9090 sont ouverts au trafic entrant pour le groupe de sécurité dans lequel se trouve l'instance Amazon EC2 Harvest et Grafana. Étant donné que l'instance lancée se connecte à un point de terminaison via HTTPS, elle doit résoudre le point de terminaison, qui a besoin du port 53 TCP/UDP pour le DNS. De plus, pour atteindre le point de terminaison, il a besoin du port 443 TCP pour HTTPS et Internet Access.

## Procédure de déploiement
<a name="harvest-grafana-deployment"></a>

La procédure suivante permet de configurer et de déployer la Harvest/Grafana solution. Le déploiement prend environ cinq minutes. Avant de commencer, vous devez disposer d'un système de fichiers FSx for ONTAP exécuté dans un Amazon Virtual Private Cloud (Amazon VPC) sur AWS votre compte, ainsi que des informations sur les paramètres du modèle répertorié ci-dessous. Pour plus d'informations sur la création d'un système de fichiers, consultez[Création de systèmes de fichiers](creating-file-systems.md).

**Pour lancer la pile de Harvest/Grafana solutions**

1. Téléchargez le [fsx-ontap-harvest-grafanamodèle CloudFormation .template.](https://solution-references.s3.amazonaws.com/fsx/harvest-grafana/harvest-grafana.yaml) Pour plus d'informations sur la création d'une CloudFormation pile, consultez la section [Création d'une pile sur la AWS CloudFormation console](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) dans le *Guide de AWS CloudFormation l'utilisateur*.
**Note**  
Par défaut, ce modèle est lancé dans la AWS région USA Est (Virginie du Nord). Vous devez lancer cette solution Région AWS là où Amazon FSx est disponible. *Pour plus d'informations, consultez la section [ FSx Points de terminaison et quotas Amazon](https://docs.aws.amazon.com/general/latest/gr/fsxn.html) dans le Références générales AWS.*

1. Pour **les paramètres**, passez en revue les paramètres du modèle et modifiez-les en fonction des besoins de votre système de fichiers. Cette solution utilise les valeurs par défaut suivantes.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/fsx/latest/ONTAPGuide/monitoring-harvest-grafana.html)

1. Choisissez **Suivant**.

1. Pour **Options**, choisissez **Next**.

1. Pour la **révision**, vérifiez et confirmez les paramètres. Vous devez cocher la case reconnaissant que le modèle crée des ressources IAM.

1. Choisissez **Créer** pour déployer la pile.

Vous pouvez consulter l'état de la pile dans la CloudFormation console dans la colonne **État**. Vous devriez voir le statut **CREATE\$1COMPLETE** dans environ cinq minutes.

## Connexion à Grafana
<a name="harvest-grafana-login"></a>

Une fois le déploiement terminé, utilisez votre navigateur pour vous connecter au tableau de bord Grafana à l'adresse IP et au port 3000 de l'instance Amazon EC2  :

```
http://EC2_instance_IP:3000
```

Lorsque vous y êtes invité, utilisez le nom d'utilisateur par défaut (`admin`) et le mot de passe (`pass`) de Grafana. Nous vous recommandons de modifier votre mot de passe dès que vous vous connectez.

Pour plus d'informations, consultez la page [ NetApp Récolte](https://github.com/NetApp/harvest) sur GitHub.

## Résolution des problèmes liés à Harvest et Grafana
<a name="troubleshooting-harvest-grafana"></a>

Si vous rencontrez des données manquantes mentionnées dans les tableaux de bord Harvest et Grafana ou si vous rencontrez des difficultés pour configurer Harvest et Grafana avec FSx pour ONTAP, consultez les rubriques suivantes pour trouver une solution potentielle.

**Topics**
+ [Les tableaux de bord des SVM et des volumes sont vides](#svm-volume-blank-dashboards)
+ [CloudFormation pile annulée après expiration du délai](#cfn-stack-rolled-back)

### Les tableaux de bord des SVM et des volumes sont vides
<a name="svm-volume-blank-dashboards"></a>

Si la CloudFormation pile a été déployée avec succès et peut contacter Grafana mais que les tableaux de bord de la SVM et des volumes sont vides, suivez la procédure ci-dessous pour dépanner votre environnement. Vous aurez besoin d'un accès SSH à l' EC2 instance Amazon sur laquelle Harvest et Grafana sont déployés.

1. Connectez-vous par SSH à l' EC2 instance Amazon sur laquelle vos clients Harvest et Grafana s'exécutent.

   ```
   [~]$ ssh ec2-user@ec2_ip_address
   ```

1. Utilisez la commande suivante pour ouvrir le `harvest.yml` fichier et :
   + Vérifiez qu'une entrée a été créée pour votre instance FSx for ONTAP en tant que`Cluster-2`.
   + Vérifiez que les entrées du nom d'utilisateur et du mot de passe correspondent à vos `fsxadmin` informations d'identification.

   ```
   [ec2-user@ip-ec2_ip_address ~]$ sudo cat /home/ec2-user/harvest_install/harvest/harvest.yml
   ```

1. Si le champ du mot de passe est vide, ouvrez le fichier dans un éditeur et mettez-le à jour avec le `fsxadmin` mot de passe, comme suit :

   ```
   [ec2-user@ip-ec2_ip_address ~]$ sudo vi /home/ec2-user/harvest_install/harvest/harvest.yml
   ```

1. Assurez-vous que les informations `fsxadmin` d'identification de l'utilisateur sont stockées dans Secrets Manager au format suivant pour tout futur déploiement, en les `fsxadmin_password` remplaçant par votre mot de passe.

   ```
   {"username" : "fsxadmin", "password" : "fsxadmin_password"}
   ```

### CloudFormation pile annulée après expiration du délai
<a name="cfn-stack-rolled-back"></a>

Si vous ne parvenez pas à déployer la CloudFormation pile avec succès et qu'elle est annulée avec des erreurs, suivez la procédure ci-dessous pour résoudre le problème. Vous aurez besoin d'un accès SSH à l' EC2 instance déployée par la CloudFormation pile.

1. Redéployez la CloudFormation pile en vous assurant que la restauration automatique est désactivée.

1. Connectez-vous par SSH à l' EC2 instance Amazon sur laquelle vos clients Harvest et Grafana s'exécutent.

   ```
   [~]$ ssh ec2-user@ec2_ip_address
   ```

1. Vérifiez que les conteneurs docker ont bien été démarrés à l'aide de la commande suivante.

   ```
   [ec2-user@ip-ec2_ip_address ~]$ sudo docker ps
   ```

   Dans la réponse, vous devriez voir cinq conteneurs comme suit :

   ```
   CONTAINER ID   IMAGE                   COMMAND                  CREATED         STATUS                          PORTS                    NAMES
   6b9b3f2085ef   rahulguptajss/harvest   "bin/poller --config…"   8 minutes ago   Restarting (1) 20 seconds ago                            harvest_cluster-2
   3cf3e3623fde   rahulguptajss/harvest   "bin/poller --config…"   8 minutes ago   Up About a minute                                        harvest_cluster-1
   708f3b7ef6f8   grafana/grafana         "/run.sh"                8 minutes ago   Up 8 minutes                    0.0.0.0:3000->3000/tcp   harvest_grafana
   0febee61cab7   prom/alertmanager       "/bin/alertmanager -…"   8 minutes ago   Up 8 minutes                    0.0.0.0:9093->9093/tcp   harvest_prometheus_alertmanager
   1706d8cd5a0c   prom/prometheus         "/bin/prometheus --c…"   8 minutes ago   Up 8 minutes                    0.0.0.0:9090->9090/tcp   harvest_prometheus
   ```

1. Si les conteneurs docker ne sont pas en cours d'exécution, vérifiez les défaillances dans le `/var/log/cloud-init-output.log` fichier comme suit.

   ```
   [ec2-user@ip-ec2_ip_address ~]$ sudo cat /var/log/cloud-init-output.log
        PLAY [Manage Harvest] **********************************************************
    
   TASK [Gathering Facts] *********************************************************
   ok: [localhost]
    
   TASK [Verify images] ***********************************************************
   failed: [localhost] (item=prom/prometheus) => {"ansible_loop_var": "item", "changed": false, "item": "prom/prometheus",
   "msg": "Error connecting: Error while fetching server API version: ('Connection aborted.', ConnectionResetError(104, 'Co
   nnection reset by peer'))"}
   failed: [localhost] (item=prom/alertmanager) => {"ansible_loop_var": "item", "changed": false, "item": "prom/alertmanage
   r", "msg": "Error connecting: Error while fetching server API version: ('Connection aborted.', ConnectionResetError(104,
   'Connection reset by peer'))"}
   failed: [localhost] (item=rahulguptajss/harvest) => {"ansible_loop_var": "item", "changed": false, "item": "rahulguptajs
   s/harvest", "msg": "Error connecting: Error while fetching server API version: ('Connection aborted.', ConnectionResetEr
   ror(104, 'Connection reset by peer'))"}
   failed: [localhost] (item=grafana/grafana) => {"ansible_loop_var": "item", "changed": false, "item": "grafana/grafana",
   "msg": "Error connecting: Error while fetching server API version: ('Connection aborted.', ConnectionResetError(104, 'Co
   nnection reset by peer'))"}
    
   PLAY RECAP *********************************************************************
   localhost                  : ok=1    changed=0    unreachable=0    failed=1    skipped=0    rescued=0    ignored=0
   ```

1. En cas d'échec, exécutez les commandes suivantes pour déployer les conteneurs Harvest et Grafana.

   ```
   [ec2-user@ip-ec2_ip_address ~]$ sudo su
        [ec2-user@ip-ec2_ip_address ~]$ cd /home/ec2-user/harvest_install
        [ec2-user@ip-ec2_ip_address ~]$ /usr/local/bin/ansible-playbook manage_harvest.yml
        [ec2-user@ip-ec2_ip_address ~]$ /usr/local/bin/ansible-playbook manage_harvest.yml --tags api
   ```

1. Validez les conteneurs démarrés avec succès en exécutant **sudo docker ps** et en vous connectant à votre URL Harvest et Grafana.