Surveillance des requêtes Athena à l'aide de métriques CloudWatch

Athena publie les métriques relatives aux requêtes sur Amazon CloudWatch, lorsque l'option Publier les métriques de requête sur est sélectionnée. CloudWatch Vous pouvez créer des tableaux de bord personnalisés, définir des alarmes et des déclencheurs sur les métriques ou utiliser des tableaux de bord préremplis directement depuis la console Athena. CloudWatch

Lorsque vous activez des métriques de requête pour des requêtes dans les groupes de travail, les métriques sont affichées dans l'onglet Metrics (Métriques) du panneau Workgroups (Groupes de travail) pour chaque groupe de travail de la console Athena.

Athena publie les métriques suivantes sur la CloudWatch console :

• DPUAllocated : le nombre total de DPU (unités de traitement des données) allouées à une réserve de capacité pour exécuter des requêtes.

• DPUConsumed : le nombre de DPU activement consommées par les requêtes étant dans l'état RUNNING à un moment donné dans une réserve. Métrique émise uniquement lorsque le groupe de travail est associé à une réserve de capacité et inclut tous les groupes de travail associés à une réserve.

• DPUCount : le nombre maximum de DPU consommées par votre requête, publié une seule fois à la fin de la requête.

• EngineExecutionTime : le nombre de millisecondes nécessaires à l'exécution de la requête.

• ProcessedBytes : le nombre d'octets qu'Athena a analysé par requête DML.

• QueryPlanningTime : le nombre de millisecondes nécessaires à Athena pour planifier le flux de traitement des requêtes.

• QueryQueueTime : le nombre de millisecondes pendant lesquelles la requête est restée dans la file d'attente des ressources.

• ServicePreProcessingTime : le nombre de millisecondes nécessaires à Athena pour prétraiter la requête avant de la soumettre au moteur de requête.

• ServiceProcessingTime : le nombre de millisecondes nécessaires à Athena pour traiter les résultats de la requête après que le moteur de requête ait fini d'exécuter la requête.

• TotalExecutionTime : le nombre de millisecondes nécessaires à Athena pour exécuter une requête DDL ou DML.

Pour des descriptions plus complètes, veuillez consulter les rubriques Liste des CloudWatch métriques et des dimensions d'Athena plus avant dans le présent document.

Ces métriques ont les dimensions suivantes :

• CapacityReservation : le nom de la réserve de capacité utilisée pour exécuter la requête, le cas échéant.

• QueryState – SUCCEEDED, FAILED, ou CANCELED

• QueryType – DML, DDL, ou UTILITY

• WorkGroup – nom du groupe de travail

Athena publie la métrique suivante sur la CloudWatch console sous l'espace de AmazonAthenaForApacheSpark noms :

• DPUCount – nombre de DPU consommés au cours de la session pour exécuter les calculs.

Cette métrique a les dimensions suivantes :

• SessionId – L'ID de la session dans laquelle les calculs sont soumis.

• WorkGroup – nom du groupe de travail.

Pour de plus amples informations, veuillez consulter Liste des CloudWatch métriques et des dimensions d'Athena plus loin dans cette rubrique. Pour plus d'informations sur les métriques d'utilisation d'Athena, veuillez consulter Surveillance des métriques d'utilisation d'Athena.

Pour afficher les métriques de requête d'un groupe de travail dans la console.

1. Ouvrez la console Athena à l’adresse https://console.aws.amazon.com/athena/.

2. Si le panneau de navigation de la console n'est pas visible, choisissez le menu d'extension sur la gauche.

   

3. Dans le panneau de navigation, choisissez Workgroups (Groupes de travail).

4. Choisissez le groupe de travail souhaité dans la liste, puis choisissez l'onglet Metrics (Métriques).

   Le tableau de bord des métriques s'affiche.

   Note

   Si vous venez d'activer les métriques pour le groupe de travail et/ou s'il n'y a pas eu d'activité de requête récente, les graphiques du tableau de bord peuvent être vides. L'activité de requête est extraite CloudWatch en fonction de l'intervalle que vous spécifiez à l'étape suivante.

5. Dans la section Metrics, choisissez l'intervalle de métriques qu'Athena doit utiliser pour récupérer les métriques de requête CloudWatch, ou spécifiez un intervalle personnalisé.

   

6. Pour actualiser les métriques affichées, choisissez l'icône Actualiser.

   

7. Cliquez sur la flèche à côté de l'icône d'actualisation pour choisir la fréquence à laquelle vous souhaitez que l'affichage des métriques soit mis à jour.

   

Pour consulter les statistiques dans la CloudWatch console Amazon

1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Dans le panneau de navigation, sélectionnez Métriques, Toutes les métriques.

3. Sélectionnez l'espace de nom AWS/Athena.

Pour afficher les métriques grâce à la CLI

• Effectuez l’une des actions suivantes :

  • Pour répertorier les métriques d'Athena, ouvrez une invite de commandes et utilisez la commande suivante :

    aws cloudwatch list-metrics --namespace "AWS/Athena"

  • Pour répertorier toutes les métriques disponibles, utilisez la commande suivante :

    aws cloudwatch list-metrics"

Liste des CloudWatch métriques et des dimensions d'Athena

Si vous avez activé CloudWatch les métriques dans Athena, celle-ci envoie les métriques suivantes à CloudWatch chaque groupe de travail. Les métriques suivantes utilisent l'espace de noms AWS/Athena.

Nom des métriques	Description
DPUAllocated	Le nombre total de DPU (unités de traitement des données) allouées à une réserve de capacité pour exécuter des requêtes.
DPUConsumed	Le nombre de DPU activement consommées par les requêtes étant dans l'état RUNNING à un moment donné dans une réserve. Cette métrique n'est émise que lorsque le groupe de travail est associé à une réserve de capacité et inclut tous les groupes de travail associés à une réserve. Par conséquent, si vous déplacez un groupe de travail d'une réserve à une autre, la métrique inclut les données de la période pendant laquelle le groupe de travail appartenait à la première réserve. Pour plus d'informations sur les réserves de capacité, veuillez consulter Gestion de la capacité de traitement des requêtes.
DPUCount	Le nombre maximal de DPU consommées par votre requête, publié une seule fois à la fin de la requête. Cette métrique n'est émise que pour les groupes de travail associés à une réserve de capacité.
EngineExecutionTime	Le nombre de millisecondes nécessaires à l'exécution de la requête.
ProcessedBytes	Le nombre d'octets qu'Athena a analysé par requête DML. Pour les requêtes qui ont été annulées (soit par les utilisateurs, soit automatiquement, si la limite a été atteinte), cela inclut la quantité de données analysées avant l'heure de l'annulation. Cette métrique n'est pas signalée pour les requêtes DDL.
QueryPlanningTime	Le nombre de millisecondes nécessaires à Athena pour planifier le flux de traitement des requêtes. Cela inclut le temps passé à récupérer les partitions de la table à partir de la source de données, Notez que, dans la mesure où le moteur de requêtes effectue la planification des requêtes, le temps de planification des requêtes est un sous-ensemble de EngineExecutionTime.
QueryQueueTime	Le nombre de millisecondes pendant lesquelles la requête est restée dans la file d'attente des ressources. Notez que si des erreurs transitoires se produisent, la requête peut être automatiquement replacée dans la file d'attente.
ServicePreProcessingTime	Le nombre de millisecondes nécessaires à Athena pour prétraiter la requête avant de la soumettre au moteur de requête.
ServiceProcessingTime	Le nombre de millisecondes nécessaires à Athena pour traiter les résultats de la requête après que le moteur de requête ait fini d'exécuter la requête.
TotalExecutionTime	Le nombre de millisecondes nécessaires pour qu'Athena exécute une requête DDL ou DML. TotalExecutionTime inclut QueryQueueTime QueryPlanningTime, EngineExecutionTime, et ServiceProcessingTime.

Ces métriques pour Athena ont les dimensions suivantes.

Dimension	Description
CapacityReservation	Le nom de la réserve de capacité qui a été utilisée pour exécuter la requête, le cas échéant. Lorsqu'aucune réserve de capacité n'est utilisée, cette dimension ne renvoie aucune donnée.
QueryState	L'état de la requête. Statistiques valides : SUCCEEDED (réussite), FAILED (échec) ou CANCELED (annulé).
QueryType	Le type de requête. Statistiques valides : DDL, DML ou UTILITY. Type d'instruction de requête exécutée. DDL indique les instructions de requête DDL (Data Definition Language). DML indique les instructions de requête DML (Data Manipulation Language), telles que CREATE TABLE AS SELECT. UTILITY indique des instructions de requête autres que DDL et DML, telles que SHOW CREATE TABLE ou DESCRIBE TABLE.
WorkGroup	Le nom du groupe de travail.