Surveillance des métriques de requêtes Athena à l’aide de CloudWatch - Amazon Athena

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

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

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 dans la console CloudWatch :

  • 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 métriques et dimensions CloudWatch pour 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 dans la console CloudWatch sous l'espace de noms AmazonAthenaForApacheSpark :

  • 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 métriques et dimensions CloudWatch pour 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 Athena à l’aide de CloudWatch.

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

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

  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.

    Choisissez le menu d'expansion.

  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 récupérée à partir de CloudWatch en fonction de l'intervalle que vous spécifiez à l'étape suivante.

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

    Spécification de l'intervalle de récupération des métriques pour un groupe de travail dans la console Athena.

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

    Choisissez l'icône d'actualisation.

  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.

    Choix d'un intervalle de rafraîchissement pour l'affichage des métriques du groupe de travail dans la console Athena.
Affichage des métriques à l'aide de la console Amazon CloudWatch

  1. Ouvrez la console CloudWatch à 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 à l’aide de l’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"

Si vous avez activé les métriques CloudWatch dans Athena, les métriques suivantes sont envoyées à CloudWatch pour 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 qu'étant donné que le moteur de requêtes effectue la planification des requêtes, le temps de planification de ces dernières 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 comprend 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.