

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 de fichiers FSx pour 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 for 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 pour mesurer les performances et l'utilisation de la capacité de stockage de votre système de fichiers FSx for ONTAP. 

Vous pouvez surveiller votre système de fichiers Amazon FSx for NetApp ONTAP en utilisant et. Harvest Grafana NetApp Harvestsurveille les centres de ONTAP données en collectant des indicateurs de performance, de capacité et de matériel à partir de FSx pour les systèmes de fichiers ONTAP. Grafanafournit un tableau de bord dans lequel les Harvest mesures 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 Harvest tableaux de bord prêts à l'emploi suivants étiquetés avec `fsx` sont actuellement pris en charge pour une utilisation avec FSx for 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 for 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 : espaces de noms NVMe
+ POINT DE CONTACT : SMB
+ ONTAP : Charge de travail

## Non pris en charge Récolte tableaux de bord
<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 instance Amazon EC2 exécutant Harvest et Grafana. En entrée du CloudFormation modèle, vous spécifiez l'`fsxadmin`utilisateur et le point de terminaison de gestion Amazon FSx 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 Linux Amazon EC2 et installe les logiciels Harvest et Grafana. Pour utiliser cette solution, téléchargez le modèle [CloudFormation fsx-ontap-harvest-grafana.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’instances Amazon EC
<a name="ec2-instance-types"></a>

Lors de la configuration du modèle, vous indiquez le type d'instance Amazon EC2. 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 noyaux | 1000 MO | `t3.xlarge` | 
| 40 ans et plus | 8 noyaux | 2000 MO | `t3.2xlarge` | 

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

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

Lorsque vous configurez votre instance Amazon EC2, assurez-vous que les ports 3000 et 9090 sont ouverts au trafic entrant pour le groupe de sécurité auquel appartient 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 votre AWS compte, ainsi que des informations sur les paramètres du modèle répertoriées 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 modèle [CloudFormation fsx-ontap-harvest-grafana.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 [Points de terminaison et quotas Amazon FSx](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\_COMPLETE** 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'instance Amazon EC2 sur laquelle Harvest and Grafana est déployé.

1. Connectez-vous par SSH à l'instance Amazon EC2 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 correctement et qu'elle est en train de revenir en arrière avec des erreurs, suivez la procédure ci-dessous pour résoudre le problème. Vous aurez besoin d'un accès SSH à l'instance EC2 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'instance Amazon EC2 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.