Surveillez les métriques des requêtes Athena avec 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 DPUs (d'unités de traitement des données) prévues dans une réservation de capacité pour exécuter des requêtes.

• DPUConsumed— Le nombre de requêtes DPUs activement consommées par un RUNNING État à un moment donné dans une réservation. 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 données DPUs 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 scannés par Athena 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 à Athéna pour exécuter une requête or. DDL 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 personnes DPUs consommées pendant 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 Surveillez les statistiques d'utilisation d'Athena avec CloudWatch.

Vous pouvez consulter les métriques des requêtes dans la console Athena ou dans la CloudWatch console.

Afficher les métriques des requêtes dans la console Athena

Pour afficher les métriques des requêtes d'un groupe de travail dans la console Athena

1. Ouvrez la console à 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.

   

Afficher les métriques des requêtes dans la CloudWatch console

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 le AWS Espace de noms /Athena.

Affichez les métriques des requêtes à l'aide du AWS CLI

Pour consulter les statistiques à l'aide du AWS 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	Nombre total DPUs (d'unités de traitement des données) allouées dans une réservation de capacité pour exécuter des requêtes.
DPUConsumed	Le nombre de requêtes DPUs activement consommées par un RUNNING État à un moment donné dans une réservation. 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 Gérer la capacité de traitement des requêtes.
DPUCount	Le nombre maximum de données DPUs 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 analysés par Athena 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 DDL requêtes.
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 à Athéna pour exécuter une requête or. DDL 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 : SUCCEEDEDFAILED, ouCANCELED.
QueryType	Le type de requête. Statistiques valides : DDL, DML ou UTILITY. Type d'instruction de requête exécutée. DDLindique les instructions de requête DDL (langage de définition des données). DMLindique des instructions de requête DML (langage de manipulation des données), telles queCREATE TABLE AS SELECT. UTILITYindique des instructions de requête autres que DDL etDML, telles queSHOW CREATE TABLE, ouDESCRIBE TABLE.
WorkGroup	Le nom du groupe de travail.