Surveillance de la passerelle de fichiers

Vous pouvez surveiller votre passerelle de fichiers et les ressources associées dansAWS Storage Gatewayen utilisant les mesures Amazon CloudWatch et les journaux d'audit des partages de fichiers. Vous pouvez également utiliser CloudWatch Events pour recevoir une notification lorsque vos opérations sur les fichiers sont terminées. Pour plus d'informations sur les métriques de type passerelle de fichiers, consultez Surveillance de la passerelle de fichiers.

Obtention des journaux d'intégrité de la passerelle de fichiers avec les groupes de journaux CloudWatch

Vous pouvez utiliser Amazon CloudWatch Logs pour obtenir des informations sur l'état de votre passerelle de fichiers et des ressources connexes. Vous pouvez utiliser les journaux pour surveiller votre passerelle afin de détecter les erreurs qu'elle rencontre. En outre, vous pouvez utiliser les filtres d'abonnement Amazon CloudWatch pour automatiser le traitement des informations des journaux en temps réel. Pour de plus amples informations, veuillez consulterTraitement en temps réel des données de journaux avec les abonnementsdans leGuide de l'utilisateur Amazon CloudWatch.

Par exemple, vous pouvez configurer un groupe de journaux CloudWatch pour surveiller votre passerelle et recevoir une notification lorsque votre passerelle de fichiers ne parvient pas à charger des fichiers sur un système de fichiers Amazon FSx. Vous pouvez configurer le groupe lorsque vous activez la passerelle ou une fois que la passerelle est activée et opérationnelle. Pour plus d'informations sur la façon de configurer un groupe de journaux CloudWatch lors de l'activation d'une passerelle, consultezConfigurer votre passerelle de fichiers Amazon FSx. Pour obtenir des informations générales sur les groupes de journaux CloudWatch, consultez.Gestion des groupes de journaux et des flux de journauxdans leGuide de l'utilisateur Amazon CloudWatch.

Voici un exemple d'erreur signalée par une passerelle de fichiers.

Dans le journal de l'état de la passerelle précédent, ces éléments spécifient les informations données :

• source: share-E1A2B34C indique le partage de fichiers qui a rencontré cette erreur.

• "type": "InaccessibleStorageClass" indique le type d'erreur qui s'est produite. Dans ce cas, cette erreur s'est produite lorsque la passerelle a tenté de charger l'objet spécifié dans Amazon S3 ou de lire à partir d'Amazon S3. Toutefois, dans ce cas, l'objet a été transféré vers Amazon S3 Glacier. La valeur de "type" peut être n'importe quelle erreur rencontrée par la passerelle de fichiers. Pour obtenir la liste des erreurs possibles, consultez Dépannage des problèmes de passerelle de fichiers

• "operation": "S3Upload"indique que cette erreur s'est produite lorsque la passerelle a tenté de charger cet objet dans S3.

• "key": "myFolder/myFile.text" indique l'objet à l'origine de l'échec.

• gateway": "sgw-B1D123D4 indique la passerelle de fichiers qui a rencontré cette erreur.

• "timestamp": "1565740862516"indique l'heure à laquelle l'erreur s'est produite.

Pour de plus amples informations sur la façon de résoudre et corriger ces types d’erreurs, veuillez consulter Dépannage des problèmes de passerelle de fichiers.

Configuration d'un groupe de journaux CloudWatch après l'activation de votre passerelle

La procédure suivante vous montre comment configurer un groupe de journaux CloudWatch après l'activation de votre passerelle.

Pour configurer un groupe de journaux CloudWatch afin qu'il fonctionne avec votre passerelle de fichiers

1. Connectez-vous à la consoleAWS Management Consoleet ouvrez la console Storage Gateway surhttps://console.aws.amazon.com/storagegateway/home.

2. Dans le volet de navigation, choisissez.Passerelles, puis choisissez la passerelle pour laquelle vous souhaitez configurer le groupe de journaux CloudWatch.

3. PourActions, choisissezModification de vos informations de. Ou, sur leDétailsonglet, sousJournaux de HealthetNon activé, choisissezConfigurer un groupe de journauxpour ouvrirModifierNom de la passerelle clientboîte de dialogue.

4. PourGroupe de journaux d'intégrité de passerelle, choisissez l'une des options suivantes :

   • Disable logging (Désactivation de la journalisation).si vous ne souhaitez pas surveiller votre passerelle à l'aide de groupes de journaux CloudWatch.

   • Création d'un nouveau groupe de journauxPour créer un nouveau groupe de journaux CloudWatch.

   • Utiliser un groupe de journaux existantpour utiliser un groupe de journaux CloudWatch existant déjà.

     Choisissez un groupe de journaux dansListe des groupes de journaux existants.

5. Choisissez Save changes (Enregistrer les modifications).

6. Pour afficher les journaux d'intégrité de votre passerelle, procédez comme suit :

   1. Dans le volet de navigation, choisissez.Passerelles, puis choisissez la passerelle pour laquelle vous avez configuré le groupe de journaux CloudWatch.

   2. Cliquez sur l'ongletDétailset sousJournaux de Health, choisissezCloudWatch Logs. LeDétails du groupe de journauxs'ouvre dans la console CloudWatch.

Pour configurer un groupe de journaux CloudWatch afin qu'il fonctionne avec votre passerelle de fichiers

1. Connectez-vous à la consoleAWS Management Consoleet ouvrez la console Storage Gateway surhttps://console.aws.amazon.com/storagegateway/home.

2. ChoisissezPasserelles, puis choisissez la passerelle pour laquelle vous souhaitez configurer le groupe de journaux CloudWatch.

3. PourActions, choisissezModification de vos informations de. Ou, dans leDétails, à côté deJournalisation, sousNon activé, choisissezConfigurer un groupe de journauxpour ouvrirModification de vos informations deboîte de dialogue.

4. PourGroupe de journaux de passerelle, choisissezUtiliser un groupe de journaux existant, puis choisissez le groupe de journaux que vous souhaitez utiliser.

   Si vous n'avez pas de groupe de journaux, choisissez Create a new log group (Créer un nouveau groupe de journaux) pour en créer un. Vous êtes dirigé vers la console CloudWatch Logs où vous pouvez créer le groupe de journaux. Si vous créez un nouveau groupe de journaux, cliquez sur le bouton d'actualisation pour afficher le nouveau groupe de journaux dans la liste déroulante.

5. Lorsque vous avez terminé, choisissez Save.

6. Pour afficher les journaux de votre passerelle, choisissez la passerelle, puis choisissez l'Détailsonglet.

Pour plus d'informations sur la résolution des erreurs, consultez Dépannage des problèmes de passerelle de fichiers.

Utilisation des métriques Amazon CloudWatch

Vous pouvez obtenir des données de surveillance relatives à la passerelle en utilisant l'AWS Management Consoleou l'API CloudWatch. La console affiche un ensemble de graphiques basés sur les données brutes obtenues avec l'API CloudWatch. L'API CloudWatch peut également être utilisée via l'un desAWSKits SDKouAPI Amazon CloudWatchoutils. En fonction de vos besoins, vous pouvez utiliser les graphiques affichés dans la console ou extraits de l'API.

Quelle que soit la méthode que vous utilisez pour travailler avec les métriques, vous devez spécifier les informations suivantes :

• La dimension de métrique à utiliser. Une dimension est une paire nom-valeur qui vous aide à identifier une métrique de façon unique. Les dimensions de Storage Gateway sontGatewayIdetGatewayName. Dans la console CloudWatch, vous pouvez utiliser leGateway Metricspour sélectionner des dimensions spécifiques à la passerelle. Pour obtenir de plus amples informations sur les dimensions, consultez.Dimensionsdans leGuide de l'utilisateur Amazon CloudWatch..

• Le nom de la métrique, par exemple ReadBytes.

Le tableau suivant résume les types de données de métriques de Storage Gateway disponibles pour vous.

Namespace de noms Amazon CloudWatch	Dimension	Description
AWS/StorageGateway	GatewayId, GatewayName	Ces dimensions filtrent les données des métriques qui décrivent des aspects de la passerelle. Vous pouvez identifier une passerelle de fichiers à utiliser en spécifiant les dimensions GatewayId et GatewayName. Les données de débit et de latence d'une passerelle reposent sur tous les partages de fichiers de la passerelle. Les données sont disponibles automatiquement toutes les 5 minutes sans coût aucun.

L'utilisation des métriques de passerelle et de fichier est similaire à l'utilisation des autres métriques de service. Vous trouverez des informations sur certaines des tâches de métriques les plus courantes dans la documentation CloudWatch indiquée ci-après :

• Affichage des métriques disponibles

• Obtention des statistiques d'une métrique

• Création d'alarmes CloudWatch

Présentation des métriques de la passerelle

Le tableau suivant décrit les métriques couvrant les passerelles de fichiers FSx. Chaque passerelle est associée à un ensemble de métriques. Certaines métriques propres à la passerelle portent le même nom que certaines métriques propres au système de fichiers. Ces métriques représentent les mêmes types de mesures, mais s'appliquent à la passerelle plutôt qu'au système de fichiers.

Précisez toujours si vous souhaitez utiliser une passerelle ou un système de fichiers lorsque vous utilisez une métrique particulière. Plus précisément, lorsque vous utilisez les métriques de passerelle, vous devez spécifier laGateway Namepour la passerelle dont vous souhaitez afficher les données de métrique. Pour plus d'informations, consultez Utilisation des métriques Amazon CloudWatch.

Le tableau suivant décrit les métriques d'que vous pouvez utiliser pour obtenir des informations sur votrePasserelle de fichiers FSxLes

Métrique	Description
AvailabilityNotifications	Cette métrique indique le nombre de notifications d'intégrité liées à la disponibilité et générées par la passerelle au cours de la période de génération de rapport. Unités: Nombre
CacheDirectorySize	Cette métrique effectue le suivi de la taille des dossiers contenus dans le cache de la passerelle. La taille du dossier est déterminée par le nombre de fichiers et de sous-dossiers de son premier niveau, qui ne compte pas de manière récursive dans les sous-dossiers. Utilisez cette mesure avec leAveragestatistique pour mesurer la taille moyenne d'un dossier dans le cache de passerelle. Utilisez cette mesure avec leMaxstatistique pour mesurer la taille maximale d'un dossier dans le cache de passerelle. Unités: Nombre
CacheFileSize	Cette métrique analyse la taille des fichiers dans le cache de la passerelle. Utilisez cette mesure avec leAveragestatistique pour mesurer la taille moyenne d'un fichier dans le cache de passerelle. Utilisez cette mesure avec leMaxstatistique pour mesurer la taille maximale d'un fichier dans le cache de passerelle. Unités: Octets
CacheFree	Cette métrique indique le nombre d'octets disponibles dans le cache de la passerelle. Unités: Octets
CacheHitPercent	Pourcentage des opérations de lecture d'application à partir de la passerelle qui sont fournies par le cache. L'exemple est pris à la fin de la période de génération de rapport. Lorsqu'il n'y a aucune demande d'opération de lecture à partir de la passerelle, cette métrique indique 100 %. Unités: Pourcentage
CachePercentDirty	Le pourcentage global de cache de passerelle n'est pas permanent dansAWS. L'exemple est pris à la fin de la période de génération de rapport. Unités: Pourcentage
CachePercentUsed	Pourcentage global du stockage de cache de passerelle utilisé. L'exemple est pris à la fin de la période de génération de rapport. Unités: Pourcentage
CacheUsed	Cette métrique indique le nombre d'octets utilisés dans le cache de la passerelle. Unités: Octets
CloudBytesDownloaded	Nombre total d'octets que la passerelle a téléchargés versAWSpendant la période visée par le rapport. Utilisez cette métrique avec la statistique Sum pour mesurer le débit et avec la statistique Samples pour mesurer les opérations d'entrée/de sortie par seconde (E/S par seconde). Unités: Octets
CloudBytesUploaded	Nombre total d'octets que la passerelle a téléchargés depuisAWSpendant la période visée par le rapport. Utilisez cette métrique avec la statistique Sum pour mesurer le débit et avec la statistique Samples pour mesurer les E/S par seconde. Unités: Octets
FilesFailingUpload	Cette métrique effectue le suivi du nombre de fichiers qui ne sont pas en cours de chargement dansAWS. Ces fichiers généreront des notifications de santé contenant plus d'informations sur le problème. Utilisez cette mesure avec leSumstatistique pour indiquer le nombre de fichiers qui ne parviennent pas actuellement à être téléchargés dansAWS. Unités: Nombre
FileShares	Cette métrique indique le nombre de partages de fichiers sur la passerelle. Unités: Nombre
FileSystem-ERROR	Cette mesure indique le nombre d'associations de systèmes de fichiers sur ces passerelles qui sont dans l'état ERROR. Si cette mesure indique que des associations de systèmes de fichiers sont dans l'état ERROR, il est probable qu'il y ait un problème avec la passerelle, ce qui peut perturber votre flux de travail. Il est recommandé de créer une alarme lorsque cette métrique indique une valeur différente de zéro. Unités: Nombre
HealthNotifications	Cette mesure indique le nombre de notifications d'intégrité générées par cette passerelle au cours de la période de reporting. Unités: Nombre
IoWaitPercent	Cette métrique indique le pourcentage de temps pendant lequel l'UC est en attente d'une réponse du disque local. Unités: Pourcentage
MemTotalBytes	Cette mesure indique la quantité totale de mémoire sur la passerelle. Unités: Octets
MemUsedBytes	Cette mesure indique la quantité de mémoire utilisée sur la passerelle. Unités: Octets
RootDiskFreeBytes	Cette métrique indique le nombre d'octets disponibles sur le disque racine de la passerelle. Si cette mesure indique que moins de 20 Go sont libres, vous devez augmenter la taille du disque racine. Unités: Octets
SmbV2Sessions	Cette métrique indique le nombre de sessions SMBv2 qui sont actives sur la passerelle. Unités: Nombre
SmbV3Sessions	Cette métrique indique le nombre de sessions SMBv3 qui sont actives sur la passerelle. Unités: Nombre
TotalCacheSize	Cette métrique indique la taille totale du cache. Unités: Octets
UserCpuPercent	Cette mesure indique le pourcentage de temps consacré au traitement de la passerelle. Unités: Pourcentage

Comprendre les métriques du système de fichiers

Vous trouverez, ci-après, des informations sur les métriques de Storage Gateway qui couvrent les partages de fichiers. Chaque partage de fichiers est associé à un ensemble de métriques. Certaines métriques propres au partage de fichiers ont le même nom que certaines métriques propres à la passerelle. Ces métriques représentent les mêmes types de mesures, mais s'appliquent au partage de fichiers.

Précisez toujours si vous souhaitez travailler avec une métrique de passerelle ou de partage de fichiers avant d'utiliser une métrique. Plus précisément, lorsque vous travaillez avec des métriques de partage de fichiers, vous devez spécifier l'File share ID qui identifie le partage de fichiers pour lequel vous souhaitez afficher des métriques. Pour plus d'informations, consultez Utilisation des métriques Amazon CloudWatch.

Le tableau suivant décrit les métriques de Storage Gateway que vous pouvez utiliser pour obtenir des informations sur vos partages de fichiers.

Métrique	Description
CacheHitPercent	Pourcentage des opérations de lecture d'application à partir des partages de fichiers qui sont servis à partir du cache. L'exemple est pris à la fin de la période de génération de rapport. Lorsqu'il n'y a aucune demande d'opération de lecture à partir du partage de fichiers, cette métrique indique 100 %. Unités: Pourcentage
CachePercentDirty	Contribution du partage de fichiers pour le pourcentage global de cache de la passerelle qui n'est pas conservé dansAWS. L'exemple est pris à la fin de la période de génération de rapport. Utilisation de l'CachePercentDirtymétrique de la passerelle pour afficher le pourcentage global de cache de la passerelle qui n'est pas conservé dans.AWS. Unités: Pourcentage
CachePercentUsed	Contribution du partage de fichiers à l'utilisation en pourcentage global du stockage de cache de la passerelle. L'exemple est pris à la fin de la période de génération de rapport. Utilisez la métrique CachePercentUsed de la passerelle pour afficher l'utilisation en pourcentage global du stockage de cache de la passerelle. Unités: Pourcentage
CloudBytesUploaded	Nombre total d'octets que la passerelle a téléchargés versAWSpendant la période visée par le rapport. Utilisez cette métrique avec la statistique Sum pour mesurer le débit et avec la statistique Samples pour mesurer les E/S par seconde. Unités: Octets
CloudBytesDownloaded	Nombre total d'octets que la passerelle a téléchargés depuisAWSpendant la période visée par le rapport. Utilisez cette métrique avec la statistique Sum pour mesurer le débit et avec la statistique Samples pour mesurer les opérations d'entrée/de sortie par seconde (E/S par seconde). Unités: Octets
ReadBytes	Nombre total d'octets lus depuis vos applications sur site au cours de la période de génération de rapport pour un partage de fichiers. Utilisez cette métrique avec la statistique Sum pour mesurer le débit et avec la statistique Samples pour mesurer les E/S par seconde. Unités: Octets
WriteBytes	Nombre total d'octets écrits dans vos applications sur site au cours de la période de génération de rapport. Utilisez cette métrique avec la statistique Sum pour mesurer le débit et avec la statistique Samples pour mesurer les E/S par seconde. Unités: Octets

Comprendre les journaux d'audit de passerelle de fichiers

Les journaux d'audit Amazon FSx File Gateway (FSx File Gateway) fournissent des détails sur l'accès des utilisateurs aux fichiers et dossiers dans une association de système de fichiers. Vous pouvez utiliser les journaux d'audit pour surveiller les activités des utilisateurs et prendre des mesures si des modèles d'activité inappropriés sont identifiés. Les journaux sont formatés de la même manière que les événements du journal de sécurité Windows Server, afin de prendre en charge la compatibilité avec les outils de traitement des journaux existants pour les événements de sécurité Windows.

Opérations

Le tableau suivant décrit les opérations d'accès aux fichiers journaux d'audit de la passerelle de fichiers.

Nom de l'opération	Définition
Lire des données	Lire le contenu d'un fichier.
Écrire des données	Modifier le contenu d'un fichier.
Création	Créer un nouveau fichier ou dossier.
Rename	Renommer un fichier ou un dossier existant.
Delete	Supprimer un fichier ou un dossier.
Écrire des attributs	Mettre à jour les métadonnées de fichiers ou de dossiers (ACL, propriétaire, groupe, autorisations).

Attributs

Le tableau suivant décrit les attributs d'accès aux fichiers journaux d'audit FSx File Gateway.

Attribut	Définition
securityDescriptor	Affiche la liste ACL discrétionnaire (DACL) définie sur un objet, au format SDDL.
sourceAddress	Adresse IP de la machine cliente de partage de fichiers.
SubjectDomainName	Domaine Active Directory (AD) auquel appartient le compte du client.
SubjectUserName	Le nom d'utilisateur Active Directory du client.
source	ID de la Storage GatewayFileSystemAssociationqui est en cours d'audit.
mtime	Moment où le contenu de l'objet a été modifié, défini par le client.
version	Version du format du journal d'audit.
ObjectType	Définit si l'objet est un fichier ou un dossier.
locationDnsName	Nom DNS du système FSx File Gateway.
objectName	Chemin d'accès complet à l'objet.
ctime	Moment où le contenu ou les métadonnées de l'objet a été modifié, défini par le client.
shareName	Nom du partage auquel vous accédez.
operation	Nom de l'opération d'accès à l'objet.
newObjectName	Chemin d'accès complet au nouvel objet après qu'il a été renommé.
gateway	ID de la passerelle de stockage.
status	L'état de l'opération. Seules les réussites sont enregistrées (les échecs sont consignés à l'exception des échecs résultant des autorisations refusées).
fileSizeInBytes	Taille du fichier en octets, définie par le client au moment de la création du fichier.

Attributs enregistrés par opération

Le tableau suivant décrit les attributs du journal d'audit de la passerelle de fichiers FSx enregistrés dans chaque opération d'accès aux fichiers.

	Lire des données	Écrire des données	Créer un dossier	Créer un fichier	Renommer le fichier/dossier	Supprimer un fichier/dossier	Attributs d'écriture (modifier l'ACL)	Attributs d'écriture (chown)	Attributs d'écriture (chmod)	Attributs d'écriture (chgrp)
securityDescriptor							X
sourceAddress	X	X	X	X	X	X	X	X	X	X
SubjectDomainName	X	X	X	X	X	X	X	X	X	X
SubjectUserName	X	X	X	X	X	X	X	X	X	X
source	X	X	X	X	X	X	X	X	X	X
mtime			X	X
version	X	X	X	X	X	X	X	X	X	X
objectType	X	X	X	X	X	X	X	X	X	X
locationDnsName	X	X	X	X	X	X	X	X	X	X
objectName	X	X	X	X	X	X	X	X	X	X
ctime			X	X
shareName	X	X	X	X	X	X	X	X	X	X
operation	X	X	X	X	X	X	X	X	X	X
newObjectName					X
gateway	X	X	X	X	X	X	X	X	X	X
status	X	X	X	X	X	X	X	X	X	X
fileSizeInBytes				X