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.

Utiliser l'interface de requête Amazon CloudWatch Internet Monitor

Pour mieux comprendre le trafic Internet de votre AWS application, vous pouvez utiliser l'interface de requête Amazon CloudWatch Internet Monitor. Pour utiliser l'interface de requête, vous créez une requête avec les filtres de données de votre choix, puis vous exécutez la requête pour renvoyer un sous-ensemble de vos données du Moniteur Internet. L'exploration des données renvoyées par la requête peut vous donner un aperçu des performances de votre application sur Internet.

Vous pouvez interroger et explorer toutes les mesures capturées par Internet Monitor avec votre moniteur, notamment les scores de disponibilité et de performance, les octets transférés, les temps d'aller-retour et le délai jusqu'au premier octet ()TTFB.

Le Moniteur Internet utilise l'interface de requête pour fournir les données que vous pouvez explorer dans le tableau de bord de la console du Moniteur Internet. En utilisant les options de recherche du tableau de bord (sur la page Analyser ou Optimiser), vous pouvez interroger et filtrer les données Internet pour votre application.

Si vous souhaitez explorer et filtrer vos données avec plus de flexibilité que celle fournie par le tableau de bord, vous pouvez utiliser vous-même l'interface de requête, en utilisant les API opérations d'Internet Monitor avec AWS Command Line Interface ou avec un AWS SDK. Cette section présente les types de requêtes que vous pouvez utiliser avec l'interface de requête, ainsi que les filtres que vous pouvez spécifier pour créer un sous-ensemble de données, afin d'obtenir des informations sur le trafic Internet de votre application.

Comment utiliser l'interface de requête

Vous créez une requête à l'aide de l'interface de requête en choisissant un type de requête, puis en spécifiant des valeurs de filtre, pour renvoyer un sous-ensemble spécifique souhaité des données de votre fichier journal. Vous pouvez ensuite utiliser le sous-ensemble de données pour filtrer et trier davantage, créer des rapports, etc.

Le processus de requête fonctionne de la manière suivante :

L'interface de requête fournit les types de requêtes suivants. Chaque type de requête renvoie un ensemble d'informations différent à propos de votre trafic à partir des fichiers journaux, comme indiqué.

Vous pouvez filtrer davantage les données en utilisant des critères spécifiques. Pour la plupart des types de requêtes, à l'exception des suggestions de routage, vous pouvez filtrer en spécifiant un ou plusieurs des critères suivants :

Pour le type de requête de suggestions de routage, vous pouvez filtrer davantage les données en spécifiant un ou plusieurs des critères suivants :

Les opérateurs que vous pouvez utiliser pour filtrer vos données sont EQUALS et NOT_EQUALS. Pour plus de détails sur les paramètres de filtrage, consultez l'FilterParameterAPIopération.

Pour en savoir plus sur les opérations de l'interface de requête, consultez les API opérations suivantes dans le guide de API référence Amazon CloudWatch Internet Monitor :

Exemples de requêtes

Pour créer une requête que vous pouvez utiliser pour récupérer un ensemble de données filtré à partir du fichier journal de votre moniteur, vous utilisez l'StartQueryAPIopération. Vous spécifiez un type de requête et des paramètres de filtre pour la requête. Ensuite, lorsque vous utilisez l'interface de requête d'Internet API Monitor pour obtenir les résultats de la requête à l'aide de la requête, le sous-ensemble de données que vous souhaitez utiliser est récupéré.

Pour illustrer le fonctionnement des types de requêtes et des paramètres de filtre, examinons quelques exemples.

Exemple 1

Supposons que vous souhaitiez récupérer toutes les données du fichier journal de votre moniteur pour un pays spécifique, à l'exception d'une ville. L'exemple suivant montre les paramètres de filtre pour une requête que vous pourriez créer avec l'opération StartQuery correspondant à ce scénario.

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "MEASUREMENTS"
   FilterParameters: [
      {
       Field: "country",
       Operator: "EQUALS",
       Values: ["Germany"]
      },
      {
       Field: "city",
       Operator: "NOT_EQUALS",
       Values: ["Berlin"]
      },
    ]
}

Exemple 2

Autre exemple, supposons que vous souhaitiez afficher les emplacements les plus importants par zone métropolitaine. Vous pouvez utiliser l'exemple de requête suivant pour ce scénario.

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "TOP_LOCATIONS"
   FilterParameters: [
      {
       Field: "geo",
       Operator: "EQUALS",
       Values: ["metro"]
      },
    ]
}

Exemple 3

Supposons maintenant que vous souhaitiez connaître les meilleures combinaisons de réseaux urbains de la région métropolitaine de Los Angeles. Pour ce faire, spécifiez geo=city, puis définissez metro à Los Angeles. Désormais, la requête renvoie les principaux réseaux urbains de la région métropolitaine de Los Angeles au lieu des principaux réseaux métropolitains leur ensemble.

Voici l'exemple de requête que vous pourriez utiliser :

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "TOP_LOCATIONS"
   FilterParameters: [
      {
       Field: "geo",
       Operator: "EQUALS",
       Values: ["city"]
      },
      {
       Field: "metro",
       Operator: "EQUALS",
       Values: ["Los Angeles"]
      }
    ]
}

Exemple 4

Supposons ensuite que vous souhaitiez récupérer TTFB des données pour une subdivision spécifique (par exemple, un État américain).

Voici un exemple de requête pour ce scénario :

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "TOP_LOCATION_DETAILS"
   FilterParameters: [
      {
       Field: "subdivision",
       Operator: "EQUALS",
       Values: ["California"]
      },
    ]
}

Exemple 5

Supposons maintenant que vous souhaitiez récupérer TTFB des données pour chaque emplacement où votre application reçoit du trafic client.

Voici un exemple de requête pour ce scénario :

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "OVERALL_TRAFFIC_SUGGESTIONS"
   FilterParameters: []
}

Results:
[us-east-1, 40, us-west-2, 30],
[us-east-1, 40, us-west-1, 35],
[us-east-1, 40, us-east-1, 44],
[us-east-1, 40, CloudFront, 22],
...
[us-east-2, 44, us-west-2, 30],
[us-east-2, 44, us-west-1, 35],
...

Exemple 6

Supposons que vous souhaitiez récupérer TTFB des données pour un nouveau produit spécifique Région AWS.

Voici un exemple de requête pour ce scénario :

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "OVERALL_TRAFFIC_SUGGESTIONS_DETAILS"
   FilterParameters: [
      {
       Field: "proposed_aws_location",
       Operator: "EQUALS",
       Values: ["us-west-2"]
      },
   ]
}

Results:
[San Jose, San Jose-Santa Clara, California, United States, 7922, us-east-1, 40, 350, 350, us-west-2, 45]
[San Jose, San Jose-Santa Clara, California, United States, 7922, us-west-1, 35, 450, 450, us-west-2, 45]

Exemple 7

Un dernier exemple consiste à récupérer des données pour des DNS résolveurs spécifiques.

Voici un exemple de requête pour ce scénario :

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "ROUTING_SUGGESTIONS"
   FilterParameters: [
      {
       Field: "proposed_aws_location",
       Operator: "EQUALS",
       Values: ["us-east-1"]
      },
   ]
}

Results:
[162.158.180.245, 13335, Cloudflare, [5.4.0.0/14], us-east-2, 200.0, us-east-1, 160.0]
[162.158.180.243, 13313, Cloudflare, [5.4.0.0/10], us-east-2, 150.0, us-east-1, 125.0]

Obtention des résultats de requêtes

Après avoir défini une requête, vous pouvez renvoyer un ensemble de résultats avec la requête en exécutant une autre API opération Internet Monitor, GetQueryResults. Lorsque vous exécutez GetQueryResults, vous spécifiez l'ID de requête pour la requête que vous avez définie, ainsi que le nom de votre moniteur. GetQueryResults extrait les données de la requête spécifiée dans un jeu de résultats.

Lorsque vous exécutez une requête, assurez-vous que l'exécution de la requête est terminée avant d'utiliser GetQueryResults pour consulter les résultats. Vous pouvez déterminer si la requête est terminée en utilisant l'GetQueryStatusAPIopération. Lorsque le Status de la requête est SUCCEEDED, vous pouvez procéder à la consultation des résultats.

Lorsque votre requête est terminée, vous pouvez suivre ces conseils pour consulter les résultats. Chaque type de requête que vous utilisez pour créer une requête inclut un ensemble unique de champs de données provenant des fichiers journaux, comme décrit dans la liste suivante :

Lorsque vous exécutez l'GetQueryResultsAPIopération, Internet Monitor renvoie ce qui suit dans la réponse :

Résolution des problèmes

Si des erreurs sont renvoyées lorsque vous utilisez les API opérations de l'interface de requête, vérifiez que vous disposez des autorisations requises pour utiliser Amazon CloudWatch Internet Monitor. Plus précisément, assurez-vous que vous disposez des autorisations suivantes :

internetmonitor:StartQuery
internetmonitor:GetQueryStatus
internetmonitor:GetQueryResults
internetmonitor:StopQuery

Ces autorisations sont incluses dans la AWS Identity and Access Management politique recommandée pour utiliser le tableau de bord Internet Monitor dans la console. Pour de plus amples informations, veuillez consulter AWS politiques gérées pour Amazon CloudWatch Internet Monitor.