Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Erkunden Sie Ihre Daten mit CloudWatch Tools und der Internet Monitor-Abfrageschnittstelle Neben der Visualisierung der Leistung und Verfügbarkeit Ihrer Anwendung mit dem Dashboard von Internet Monitor gibt es mehrere Methoden, mit denen Sie tiefer in die Daten eintauchen können, die Internet Monitor für Sie generiert. Zu diesen Methoden gehören die Verwendung von CloudWatch Tools mit Internet Monitor-Daten, die in CloudWatch Protokolldateien gespeichert sind, und die Internet Monitor-Abfrageschnittstelle. Zu den Tools, die Sie verwenden können, gehören CloudWatch Logs Insights, CloudWatch Metrics, CloudWatch Contributor Insights und Amazon Athena. Je nach Bedarf können Sie einige oder alle dieser Tools sowie das Dashboard verwenden, um Internet-Monitor-Daten zu untersuchen. Internet Monitor aggregiert CloudWatch Metriken über den Datenverkehr zu Ihrer Anwendung und zu den einzelnen AWS-Region Anwendungen und umfasst Daten wie die Gesamtbelastung des Datenverkehrs, die Verfügbarkeit und die Round-Trip-Zeit. Diese Daten werden in CloudWatch Logs veröffentlicht und können auch mit der Internet Monitor-Abfrageschnittstelle verwendet werden. Die Einzelheiten zur Geogranularität und zu anderen Aspekten der Informationen, die für einzelne Bereiche zur Verfügung stehen, sind unterschiedlich. Internet Monitor veröffentlicht Daten für Ihren Monitor in Intervallen von 5 Minuten und stellt die Daten dann auf verschiedene Weise zur Verfügung. In der folgenden Tabelle werden Szenarien für den Zugriff auf Internet-Monitor-Daten aufgeführt und die Merkmale der Daten beschrieben, die für die einzelnen Szenarien gesammelt werden. **** | Feature | CloudWatch Protokolle | Exportieren in S3 | Abfrageschnittstelle | CloudWatch Armaturenbrett | | --- | --- | --- | --- | --- | | Standardmäßig aktiviert. | Ja | Nein | Ja | Ja | | Anzahl der Stadtnetze, für die Daten gesammelt werden | Top 500 (siehe Hinweis unten) | Alle | Alle | Alle | | Datenaufbewahrung | Benutzergesteuert | Benutzergesteuert | 30 Tage | 30 Tage | | Geogranularitäten, für die Daten gesammelt werden | Alle (Stadtnetz, Metro\$1Netzwerk, Unterteilung\$1Netzwerk, Land\$1Netzwerk) | Stadtnetz | Alle (Stadtnetz, Metro\$1Netzwerk, Unterteilung\$1Netzwerk, Land\$1Netzwerk) | Alle (Stadtnetz, Metro\$1Netzwerk, Unterteilung\$1Netzwerk, Land\$1Netzwerk) | | So können Daten abgefragt und gefiltert werden | [Verwenden Sie CloudWatch Logs Insights, um die Messungen von Internet Monitor zu untersuchen](CloudWatch-IM-view-cw-tools-logs-insights.md) | [Verwenden von Amazon Athena, um Internetmessungen in Amazon-S3-Protokolldateien abzufragen](CloudWatch-IM-view-cw-tools.S3_athena.md) | [Verwenden der Internet-Monitor-Abfrageschnittstelle](CloudWatch-IM-view-cw-tools-cwim-query.md) | [Überwachen und optimieren mit dem Internet-Monitor-Dashboard](CloudWatch-IM-monitor-and-optimize.md) | Anmerkung: Die Top-500-Messungen werden für Stadtnetze erfasst; die Top-250 für Metro\$1Netzwerke, die Top-100 für Unterteilung\$1Netzwerke, die Top-50 für Land\$1Netzwerke. In diesem Kapitel wird beschrieben, wie Sie Ihre Daten mithilfe von CloudWatch Tools oder der Internet Monitor-Abfrageschnittstelle abfragen und untersuchen können, sowie Beispiele für jede Methode. **Topics** + [CloudWatch Logs & Einblicke](CloudWatch-IM-view-cw-tools-logs-insights.md) + [CloudWatch Contributor Insights](CloudWatch-IM-view-cw-tools-contributor-insights.md) + [CloudWatch Metriken](CloudWatch-IM-view-cw-tools-metrics-dashboard.md) + [Athena mit S3-Protokollen](CloudWatch-IM-view-cw-tools.S3_athena.md) + [Internet-Monitor-Abfrageschnittstelle](CloudWatch-IM-view-cw-tools-cwim-query.md) # Verwenden Sie CloudWatch Logs Insights, um die Messungen von Internet Monitor zu untersuchen Sie können CloudWatch Logs Insights-Abfragen verwenden, um eine Teilmenge von Protokollen nach einer bestimmten Stadt oder Region (Kundenstandort), Kunden-ASN (ISP) und AWS Quellstandort zu filtern. Internet Monitor veröffentlicht detaillierte Messungen der Verfügbarkeit und der Round-Trip-Zeit in CloudWatch Logs, die Sie mit Logs Insights untersuchen können. CloudWatch Weitere Informationen zur Genauigkeit des Standorts von Kunden in Internet Monitor finden Sie unter [Geolokalisierungsinformationen und Genauigkeit in Internet Monitor](CloudWatch-IM-inside-internet-monitor.md#IMGeolocationSourceAccuracy). Die Beispiele in diesem Abschnitt können Ihnen helfen, CloudWatch Logs Insights-Abfragen zu erstellen, um mehr über die Messungen und Metriken Ihres eigenen Anwendungsdatenverkehrs zu erfahren. Wenn Sie diese Beispiele in CloudWatch Logs Insights verwenden, *monitorName* ersetzen Sie sie durch Ihren eigenen Monitornamen. **Vorschläge zur Datenverkehrsoptimierung anzeigen** Auf der Registerkarte **Einblicke in den Datenverkehr** in Internet Monitor können Sie Vorschläge zur Optimierung des Datenverkehrs einsehen, gefiltert nach Standort. Um dieselben Informationen zu sehen, die im Abschnitt **Vorschläge zur Traffic-Optimierung** auf dieser Registerkarte angezeigt werden, jedoch ohne den Standortgranularitätsfilter, können Sie die folgende CloudWatch Logs Insights-Abfrage verwenden. 1. Navigieren Sie im AWS-Managementkonsole zu CloudWatch Logs Insights. 1. Wählen Sie für **Log Group** (Protokollgruppe) die Option `/aws/internet-monitor/monitorName/byCity` und `/aws/internet-monitor/monitorName/byCountry` aus und geben Sie dann einen Zeitraum an. 1. Fügen Sie die folgende Abfrage hinzu und führen Sie sie aus. ``` fields @timestamp, clientLocation.city as @city, clientLocation.subdivision as @subdivision, clientLocation.country as @country, `trafficInsights.timeToFirstByte.currentExperience.serviceName` as @serviceNameField, concat(@serviceNameField, ` (`, `serviceLocation`, `)`) as @currentExperienceField, concat(`trafficInsights.timeToFirstByte.ec2.serviceName`, ` (`, `trafficInsights.timeToFirstByte.ec2.serviceLocation`, `)`) as @ec2Field, `trafficInsights.timeToFirstByte.cloudfront.serviceName` as @cloudfrontField, concat(`clientLocation.networkName`, ` (AS`, `clientLocation.asn`, `)`) as @networkName | filter ispresent(`trafficInsights.timeToFirstByte.currentExperience.value`) | stats avg(`trafficInsights.timeToFirstByte.currentExperience.value`) as @averageTTFB, avg(`trafficInsights.timeToFirstByte.ec2.value`) as @ec2TTFB, avg(`trafficInsights.timeToFirstByte.cloudfront.value`) as @cloudfrontTTFB, sum(`bytesIn` + `bytesOut`) as @totalBytes, latest(@ec2Field) as @ec2, latest(@currentExperienceField) as @currentExperience, latest(@cloudfrontField) as @cloudfront, count(*) by @networkName, @city, @subdivision, @country | display @city, @subdivision, @country, @networkName, @totalBytes, @currentExperience, @averageTTFB, @ec2, @ec2TTFB, @cloudfront, @cloudfrontTTFB | sort @totalBytes desc ``` **Internetverfügbarkeit und RTT anzeigen (p50, p90 und p95)** Um die Internetverfügbarkeit und die Round-Up-Zeit (p50, p90 und p95) für den Datenverkehr anzuzeigen, können Sie die folgende CloudWatch Logs Insights-Abfrage verwenden. **Region des Endbenutzers:** Chicago, IL, Vereinigte Staaten **Endbenutzernetzwerk (ASN):** AS7018 **AWS Servicestandort:** Region USA Ost (Nord-Virginia) Um die Protokolle anzuschauen, gehen Sie wie folgt vor: 1. Navigieren Sie in der AWS-Managementkonsole zu CloudWatch Logs Insights. 1. Wählen Sie für **Log Group** (Protokollgruppe) die Option `/aws/internet-monitor/monitorName/byCity` und `/aws/internet-monitor/monitorName/byCountry` aus und geben Sie dann einen Zeitraum an. 1. Fügen Sie die folgende Abfrage hinzu und führen Sie sie aus. Die Abfrage gibt alle Leistungsdaten für Benutzer zurück, die AS7018 im ausgewählten Zeitraum eine Verbindung von Chicago, IL, in Richtung Region USA Ost (Nord-Virginia) hergestellt haben. ``` fields @timestamp, internetHealth.availability.experienceScore as availabilityExperienceScore, internetHealth.availability.percentageOfTotalTrafficImpacted as percentageOfTotalTrafficImpacted, internetHealth.performance.experienceScore as performanceExperienceScore, internetHealth.performance.roundTripTime.p50 as roundTripTimep50, internetHealth.performance.roundTripTime.p90 as roundTripTimep90, internetHealth.performance.roundTripTime.p95 as roundTripTimep95 | filter clientLocation.country == `United States` and clientLocation.city == `Chicago` and serviceLocation == `us-east-1` and clientLocation.asn == 7018 ``` Weitere Informationen finden Sie unter [Analysieren von Protokolldaten mit CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html). # Verwenden Sie Contributor Insights, um Top-Standorte zu identifizieren und ISPs CloudWatch Contributor Insights kann Ihnen dabei helfen, die wichtigsten Kundenstandorte und ASNs (in der Regel Internetdienstanbieter oder ISPs) für Ihre AWS Anwendung zu ermitteln. Verwenden Sie die folgenden Beispielregeln für Contributor Insights, um mit Regeln zu beginnen, die mit Internet Monitor nützlich sind. Weitere Informationen finden Sie unter [Erstellen Sie eine Contributor Insights-Regel in CloudWatch](ContributorInsights-CreateRule.md). Weitere Informationen zur Genauigkeit des Standorts von Kunden in Internet Monitor finden Sie unter [Geolokalisierungsinformationen und Genauigkeit in Internet Monitor](CloudWatch-IM-inside-internet-monitor.md#IMGeolocationSourceAccuracy). **Anmerkung** Internet Monitor speichert Daten zu Internetmessungen alle fünf Minuten. Nachdem Sie eine Contributor-Insights-Regel eingerichtet haben, müssen Sie den Zeitraum auf fünf Minuten anpassen, um ein Diagramm zu sehen. **Sehen Sie sich die wichtigsten Standorte an, die von einer ASNs Beeinträchtigung der Verfügbarkeit betroffen sind** Sie können die folgende Contributor Insights-Regel im Syntaxeditor verwenden, um sich die Standorte der Kunden anzusehen, die am häufigsten von einem Rückgang der Verfügbarkeit ASNs betroffen waren. Ersetzen Sie es *monitor-name* durch Ihren eigenen Monitornamen. ``` { "Schema": { "Name": "CloudWatchLogRule", "Version": 1 }, "AggregateOn": "Sum", "Contribution": { "Filters": [ { "Match": "$.clientLocation.city", "IsPresent": true } ], "Keys": [ "$.clientLocation.city", "$.clientLocation.networkName" ], "ValueOf": "$.awsInternetHealth.availability.percentageOfTotalTrafficImpacted" }, "LogFormat": "JSON", "LogGroupNames": [ "/aws/internet-monitor/monitor-name/byCity" ] } ``` **Sehen Sie sich die Standorte der wichtigsten Kunden an, die von Latenzproblemen ASNs betroffen waren** Sie können die folgende Contributor Insights-Regel im Syntaxeditor verwenden, um sich die Standorte der Kunden anzusehen, die von einer Erhöhung der Round-Trip-Zeit (Latenz) ASNs betroffen sind. Ersetzen Sie es *monitor-name* durch Ihren eigenen Monitornamen. ``` { "Schema": { "Name": "CloudWatchLogRule", "Version": 1 }, "AggregateOn": "Sum", "Contribution": { "Filters": [ { "Match": "$.clientLocation.city", "IsPresent": true } ], "Keys": [ "$.clientLocation.city", "$.clientLocation.networkName" ], "ValueOf": "$.awsInternetHealth.performance.percentageOfTotalTrafficImpacted" }, "LogFormat": "JSON", "LogGroupNames": [ "/aws/internet-monitor/monitor-name/byCity" ] } ``` **Sehen Sie sich die Standorte der wichtigsten Kunden an, die vom Gesamtanteil des Traffics ASNs betroffen sind** Sie können die folgende Contributor Insights-Regel im Syntaxeditor verwenden, um die Standorte mit den meisten Kunden anzuzeigen, die vom Gesamtanteil des Traffics ASNs betroffen sind. Ersetzen Sie es *monitor-name* durch Ihren eigenen Monitornamen. ``` { "Schema": { "Name": "CloudWatchLogRule", "Version": 1 }, "AggregateOn": "Sum", "Contribution": { "Filters": [ { "Match": "$.clientLocation.city", "IsPresent": true } ], "Keys": [ "$.clientLocation.city", "$.clientLocation.networkName" ], "ValueOf": "$.percentageOfTotalTraffic" }, "LogFormat": "JSON", "LogGroupNames": [ "/aws/internet-monitor/monitor-name/byCity" ] } ``` # Sehen Sie sich Internet Monitor-Metriken an oder stellen Sie Alarme unter CloudWatch Metriken ein Mithilfe der Optionen Alarme und Metriken in der CloudWatch Konsole können Sie CloudWatch Alarme für Internet CloudWatch Monitor-Metriken anzeigen oder einrichten. Internet Monitor veröffentlicht Metriken in Ihrem Konto, einschließlich Metriken für Leistung, Verfügbarkeit, Round-Trip-Zeit und Durchsatz (Bytes pro Sekunde). Alle Messwerte für Ihren Monitor finden Sie im CloudWatch Metrik-Dashboard im benutzerdefinierten Namespace`AWS/InternetMonitor`. Beispiele für die Verwendung mehrerer dieser Metriken zur Bestimmung der Werte für die Auswahl einer Höchstgrenze für Stadtnetze für Ihren Monitor finden Sie unter [Auswählen des Maximalwerts für Stadtnetze](IMCityNetworksMaximum.md). Weitere Informationen zum Einrichten von Alarmen für Internet Monitor finden Sie unter [Erstellen von Alarmen mit Internet Monitor](CloudWatch-IM-create-alarm.md). Die Metriken werden für den gesamten Internetverkehr zu Ihren VPCs Network Load Balancern, CloudFront Distributionen oder WorkSpaces Verzeichnissen im Monitor sowie für den gesamten Datenverkehr zu allen AWS-Region überwachten Internet-Edge-Standorten zusammengefasst. Regionen werden durch den Servicestandort definiert, bei dem es sich entweder um alle Standorte oder um eine bestimmte Region handeln kann, z. B. `us-east-1`. Hinweis: *Städtenetzwerke bestehen* aus Paaren von Client-Standorten und denen, die die Kunden nutzen (in ASNs der Regel Internetdienstanbieter oder). ISPs Internet Monitor bietet die folgenden Metriken. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonCloudWatch/latest/monitoring/CloudWatch-IM-view-cw-tools-metrics-dashboard.html) Weitere Informationen finden Sie unter [Metriken bei Amazon CloudWatch](working_with_metrics.md). # Verwenden von Amazon Athena, um Internetmessungen in Amazon-S3-Protokolldateien abzufragen Sie können Amazon Athena verwenden, um die Internetmessungen abzufragen und anzuzeigen, die Internet Monitor in einem Amazon-S3-Bucket veröffentlicht. Internet Monitor bietet die Möglichkeit, Internet-Messwerte für Ihre Anwendung in einem S3-Bucket für den mit dem Internet verbundenen Datenverkehr für Ihre überwachten Stadtnetzwerke (Kundenstandorte und ASNs in der Regel Internetdienstanbieter oder) zu veröffentlichen. ISPs Unabhängig davon, ob Sie Messungen auf S3 veröffentlichen, veröffentlicht Internet Monitor automatisch alle fünf Minuten Internet-Messungen in CloudWatch Logs für die 500 größten Stadtnetzwerke (nach Verkehrsaufkommen) für jeden Monitor. In diesem Kapitel erfahren Sie, wie Sie in Athena eine Tabelle für Internetmessungen in einer S3-Protokolldatei erstellen. Anschließend finden Sie [Beispielabfragen](#CloudWatch-IM-view-cw-tools.S3_athena.athena-sample-queries), um verschiedene Ansichten der Messungen zu sehen. Sie können beispielsweise nach Ihren 10 am stärksten betroffenen Stadtnetze nach Latenzauswirkungen abfragen. ## Verwenden von Amazon Athena zum Erstellen einer Tabelle für Internetmessungen in Internet Monitor Um Athena mit Ihren S3-Protokolldateien von Internet Monitor zu verwenden, erstellen Sie zunächst eine Tabelle für die Internetmessungen. Folgen Sie den Schritten in diesem Verfahren, um eine Tabelle in Athena auf der Grundlage der S3-Protokolldateien zu erstellen. Anschließend können Sie Athena-Abfragen für die Tabelle ausführen, z. B. [diese Beispielabfragen für Internetmessungen](#CloudWatch-IM-view-cw-tools.S3_athena.athena-sample-queries), um Informationen über Ihre Messungen zu erhalten. **So erstellen Sie eine Athena-Tabelle** 1. Öffnen Sie die Athena-Konsole unter [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/). 1. Geben Sie im Athena-Abfrage-Editor eine Abfrageanweisung ein, um eine Tabelle mit Internetmessungen von Internet Monitor zu erstellen. Ersetzen Sie den Wert für den Parameter LOCATION durch den Speicherort des S3-Buckets, in dem Ihre Internetmessungen von Internet Monitor gespeichert sind. ``` CREATE EXTERNAL TABLE internet_measurements ( version INT, timestamp INT, clientlocation STRING, servicelocation STRING, percentageoftotaltraffic DOUBLE, bytesin INT, bytesout INT, clientconnectioncount INT, internethealth STRING, trafficinsights STRING ) PARTITIONED BY (year STRING, month STRING, day STRING) ROW FORMAT SERDE 'org.openx.data.jsonserde.JsonSerDe' LOCATION 's3://amzn-s3-demo-bucket/bucket_prefix/AWSLogs/account_id/internetmonitor/AWS_Region/' TBLPROPERTIES ('skip.header.line.count' = '1'); ``` 1. Geben Sie eine Anweisung ein, um eine Partition zum Lesen der Daten zu erstellen. Die folgende Abfrage erstellt zum Beispiel eine einzelne Partition für ein bestimmtes Datum und einen bestimmten Ort: ``` ALTER TABLE internet_measurements ADD PARTITION (year = 'YYYY', month = 'MM', day = 'dd') LOCATION 's3://amzn-s3-demo-bucket/bucket_prefix/AWSLogs/account_id/internetmonitor/AWS_Region/YYYY/MM/DD'; ``` 1. Klicken Sie auf **Ausführen**. **Athena-Beispielanweisungen für Internetmessungen** Im Folgenden finden Sie ein Beispiel für eine Anweisung zur Erstellung einer Tabelle: ``` CREATE EXTERNAL TABLE internet_measurements ( version INT, timestamp INT, clientlocation STRING, servicelocation STRING, percentageoftotaltraffic DOUBLE, bytesin INT, bytesout INT, clientconnectioncount INT, internethealth STRING, trafficinsights STRING ) PARTITIONED BY (year STRING, month STRING, day STRING) ROW FORMAT SERDE 'org.openx.data.jsonserde.JsonSerDe' LOCATION 's3://internet-measurements/TestMonitor/AWSLogs/1111222233332/internetmonitor/us-east-2/' TBLPROPERTIES ('skip.header.line.count' = '1'); ``` Im Folgenden finden Sie ein Beispiel für eine Anweisung zum Erstellen einer Partition zum Lesen der Daten: ``` ALTER TABLE internet_measurements ADD PARTITION (year = '2023', month = '04', day = '07') LOCATION 's3://internet-measurements/TestMonitor/AWSLogs/1111222233332/internetmonitor/us-east-2/2023/04/07/' ``` ## Beispiele für Amazon-Athena-Abfragen zur Verwendung mit Internetmessungen in Internet Monitor Dieser Abschnitt enthält Beispielabfragen, die Sie mit Amazon Athena verwenden können, um Informationen über die in Amazon S3 veröffentlichten Internetmessungen Ihrer Anwendung zu erhalten. **Fragen Sie die Standorte Ihrer 10 Kunden ab, die am häufigsten betroffen sind (nach Gesamtanteil des Traffics) und ASNs** Führen Sie diese Athena-Abfrage aus, um Ihre 10 am stärksten betroffenen Stadtnetzwerke (nach Gesamtanteil des Datenverkehrs) zurückzugeben, d. h. Kundenstandorte und ASNs in der Regel Internetdienstanbieter. ``` SELECT json_extract_scalar(clientLocation, '$.city') as city, json_extract_scalar(clientLocation, '$.networkname') as networkName, sum(percentageoftotaltraffic) as percentageoftotaltraffic FROM internet_measurements GROUP BY json_extract_scalar(clientLocation, '$.city'), json_extract_scalar(clientLocation, '$.networkname') ORDER BY percentageoftotaltraffic desc limit 10 ``` **Fragen Sie Ihre 10 (nach Verfügbarkeit) am häufigsten betroffenen Kundenstandorte ab und ASNs ** Führen Sie diese Athena-Abfrage aus, um Ihre 10 am stärksten betroffenen Stadtnetzwerke (nach Gesamtanteil des Datenverkehrs) zurückzugeben, d. h. Kundenstandorte und ASNs in der Regel Internetdienstanbieter. ``` SELECT json_extract_scalar(clientLocation, '$.city') as city, json_extract_scalar(clientLocation, '$.networkname') as networkName, sum( cast( json_extract_scalar( internetHealth, '$.availability.percentageoftotaltrafficimpacted' ) as double ) ) as percentageOfTotalTrafficImpacted FROM internet_measurements GROUP BY json_extract_scalar(clientLocation, '$.city'), json_extract_scalar(clientLocation, '$.networkname') ORDER BY percentageOfTotalTrafficImpacted desc limit 10 ``` **Fragen Sie Ihre 10 (nach Latenz) am stärksten betroffenen Kundenstandorte ab und ASNs ** Führen Sie diese Athena-Abfrage aus, um Ihre 10 (nach Latenzauswirkungen) am stärksten betroffenen Stadtnetzwerke zurückzugeben, d. h. Kundenstandorte und ASNs in der Regel Internetdienstanbieter. ``` SELECT json_extract_scalar(clientLocation, '$.city') as city, json_extract_scalar(clientLocation, '$.networkname') as networkName, sum( cast( json_extract_scalar( internetHealth, '$.performance.percentageoftotaltrafficimpacted' ) as double ) ) as percentageOfTotalTrafficImpacted FROM internet_measurements GROUP BY json_extract_scalar(clientLocation, '$.city'), json_extract_scalar(clientLocation, '$.networkname') ORDER BY percentageOfTotalTrafficImpacted desc limit 10 ``` **Fragen Sie die wichtigsten Verkehrsdaten für Ihre Kundenstandorte ab und ASNs ** Führen Sie diese Athena-Abfrage aus, um Verkehrshighlights wie Verfügbarkeitsbewertung, Leistungsbewertung und Zeit bis zum ersten Byte für Ihre Stadtnetzwerke, d. h. Kundenstandorte und in der Regel Internetdienstanbieter ASNs, zurückzugeben. ``` SELECT json_extract_scalar(clientLocation, '$.city') as city, json_extract_scalar(clientLocation, '$.subdivision') as subdivision, json_extract_scalar(clientLocation, '$.country') as country, avg(cast(json_extract_scalar(internetHealth, '$.availability.experiencescore') as double)) as availabilityScore, avg(cast(json_extract_scalar(internetHealth, '$.performance.experiencescore') as double)) performanceScore, avg(cast(json_extract_scalar(trafficinsights, '$.timetofirstbyte.currentexperience.value') as double)) as averageTTFB, sum(bytesIn) as bytesIn, sum(bytesOut) as bytesOut, sum(bytesIn + bytesOut) as totalBytes FROM internet_measurements where json_extract_scalar(clientLocation, '$.city') != 'N/A' GROUP BY json_extract_scalar(clientLocation, '$.city'), json_extract_scalar(clientLocation, '$.subdivision'), json_extract_scalar(clientLocation, '$.country') ORDER BY totalBytes desc limit 100 ``` Weitere Informationen zur Verwendung von Athena finden Sie im [Amazon Athena-Benutzerhandbuch](https://docs.aws.amazon.com/athena/latest/ug/). # Verwenden der Internet-Monitor-Abfrageschnittstelle *Eine Möglichkeit, mehr über den Internetverkehr für Ihre AWS Anwendung zu erfahren, ist die Verwendung der Internet Monitor-Abfrageschnittstelle.* Um die Abfrageschnittstelle zu verwenden, erstellen Sie eine Abfrage mit von Ihnen ausgewählten Datenfiltern und führen dann die Abfrage aus, um eine Teilmenge Ihrer Internet-Monitor-Daten zurückzugeben. Wenn Sie die Daten untersuchen, die die Abfrage zurückgibt, erhalten Sie Einblicke in die Leistung Ihrer Anwendung im Internet. Sie können alle Messwerte, die Internet Monitor mit Ihrem Monitor erfasst, abfragen und untersuchen, darunter Verfügbarkeits- und Leistungswerte, übertragene Byte, Round-Trip-Zeiten und Time to First Byte (TTFB). Internet Monitor verwendet die Abfrageschnittstelle, um die Daten bereitzustellen, die Sie im Dashboard der Internet-Monitor-Konsole untersuchen können. Mithilfe der Suchoptionen im Dashboard – auf der Seite **Analyse** oder der Seite **Optimierung** – können Sie Internetdaten für Ihre Anwendung abfragen und filtern. Wenn Sie mehr Flexibilität beim Durchsuchen und Filtern Ihrer Daten wünschen, als das Dashboard bietet, können Sie die Abfrageschnittstelle selbst verwenden, indem Sie Internet Monitor-API-Operationen mit dem AWS Command Line Interface oder mit einem AWS SDK verwenden. In diesem Abschnitt werden die Abfragetypen vorgestellt, die Sie mit der Abfrageschnittstelle verwenden können, und die Filter, die Sie angeben können, um eine Teilmenge von Daten zu erstellen, um Einblicke in den Internetverkehr für Ihre Anwendung zu erhalten. **Topics** + [So benutzt man die Abfrageschnittstelle](#CloudWatch-IM-view-cw-tools-cwim-query-use-query) + [Abfragebeispiele](#CloudWatch-IM-view-cw-tools-cwim-query-example-queries) + [Abfrageergebnisse abrufen](#CloudWatch-IM-view-cw-tools-cwim-query-get-data) + [Fehlerbehebung](#CloudWatch-IM-view-cw-tools-cwim-query-troubleshooting) ## So benutzt man die Abfrageschnittstelle Sie erstellen eine Abfrage mit der Abfrageschnittstelle, indem Sie einen *Abfragetyp* auswählen und dann Filterwerte angeben, um eine bestimmte gewünschte Teilmenge Ihrer Protokolldateidaten zurückzugeben. Anschließend können Sie mit der Datenteilmenge arbeiten, um weiter zu filtern und zu sortieren, Berichte zu erstellen usw. Der Abfrageprozess funktioniert wie folgt: 1. Wenn Sie eine Abfrage ausführen, gibt Internet Monitor eine `query ID` zurück, der für die Abfrage eindeutig ist. In diesem Abschnitt werden die verfügbaren Abfragetypen und Optionen zum Filtern von Daten in Abfragen beschrieben. Um zu verstehen, wie das funktioniert, können Sie sich auch den Abschnitt mit [Abfragebeispielen](#IMQueryInterfaceExamples) ansehen. 1. Bei der [GetQueryResults](https://docs.aws.amazon.com/internet-monitor/latest/api/API_GetQueryResults.html)API-Operation, um Datenergebnisse für die Abfrage zurückzugeben, geben Sie die Abfrage-ID zusammen mit Ihrem Monitornamen an. Jeder Abfragetyp gibt einen anderen Satz von Datenfeldern zurück. Weitere Informationen finden Sie unter [Abfrageergebnisse abrufen](#IMGetQueryData). Die Abfrageschnittstelle bietet die folgenden Abfragetypen. Jeder Abfragetyp gibt einen anderen Satz von Informationen über Ihren Datenverkehr aus den Protokolldateien zurück, wie in der Abbildung gezeigt. + **Messungen:** Zeigt die Verfügbarkeitsbewertung, die Leistungsbewertung, den Gesamtdatenverkehr und die Round-Trip-Zeiten in Intervallen von 5 Minuten an. + **Top-Standorte:** Stellt Verfügbarkeitsbewertung, Leistungsbewertung, Gesamtdatenverkehr und Time to First Byte (TTFB)-Informationen für die Kombinationen aus Top-Standorten und ASNs bereit, die Sie überwachen, sortiert nach Verkehrsaufkommen. + **Details zu den wichtigsten Standorten:** Stellt TTFB für Amazon CloudFront, Ihre aktuelle Konfiguration und die leistungsstärkste Amazon EC2 EC2-Konfiguration in Intervallen von 1 Stunde bereit. + **Allgemeine Verkehrsvorschläge:** Stellt TTFB unter Verwendung eines gewichteten 30-Tage-Durchschnitts für den gesamten Verkehr an jedem überwachten AWS Standort bereit. + **Allgemeine Informationen zu Verkehrsvorschlägen:** Stellt TTFB unter Verwendung eines gewichteten 30-Tage-Durchschnitts für jeden Top-Standort für einen vorgeschlagenen Standort bereit. AWS + **Routing-Vorschläge: Gibt** die prognostizierte durchschnittliche Round-Trip-Zeit (RTT) von einem IP-Präfix zu einem AWS Standort für einen DNS-Resolver an. Die RTT wird in Intervallen von einer Stunde über einen Zeitraum von einer Stunde berechnet. Sie können die Daten anhand spezifischer Kriterien zusätzlich filtern. Bei den meisten Abfragetypen, mit Ausnahme von Routing-Vorschlägen, können Sie eines oder mehrere der folgenden Filterkriterien angeben: + **AWS Standort:** Als AWS Standort können Sie einen CloudFront oder einen angeben AWS-Region, z. B. `us-east-2` + **ASN:** Geben Sie die autonome Systemnummer (ASN) eines DNS-Resolvers an (in der Regel ein ISP), z. B. 4225. + **Kundenstandort:** Geben Sie als Standort eine Stadt, eine Metro-Region, eine Unterteilung oder ein Land an. + **Vorgeschlagener AWS Standort:** Geben Sie eine AWS-Region, z. B.`us-east-2`, oder eine AWS lokale Zone an. Sie können diesen Filter für den Abfragetyp „Details zu allgemeinen Vorschlägen zum Datenverkehr“ verwenden. + **Geo:** Geben Sie `geo` für einige Abfragen an. Dies ist für Abfragen erforderlich, die den `Top locations`-Abfragetyp verwenden, ist aber für andere Abfragetypen nicht zulässig. Informationen darüber, wann `geo` für Filterparameter angegeben werden muss, finden Sie im Abschnitt mit [Abfragebeispielen](#IMQueryInterfaceExamples). Beim Abfragetyp „Routing-Vorschläge“ können Sie die Daten zusätzlich filtern, indem Sie eines oder mehrere der folgenden Kriterien angeben: + **Aktueller AWS Standort:** Geben Sie einen an AWS-Region, z. `us-east-2` B. + **Vorgeschlagener AWS Standort:** Geben Sie eine AWS-Region, z. B.`us-east-2`, oder eine AWS lokale Zone an. + **IPv4 Präfix:** Geben Sie ein IPv4 Präfix im Standardformat an, ähnlich wie`192.0.2.0/24`. + **Monitor-ARN:** Geben Sie den ARN für einen bestimmten Monitor an. + **DNS-Resolver-IP:** Geben Sie die IP-Adresse eines DNS-Resolvers an. + **DNS-Resolver-ISP:** Geben Sie den Namen eines DNS-Resolvers an (in der Regel ein ISP), z. B. `Cloudflare`. + **DNS-Resolver-ASN:** Geben Sie die autonome Systemnummer (ASN) eines DNS-Resolvers an (in der Regel ein ISP), z. B. 4225. Die Operatoren, die Sie zum Filtern Ihrer Daten verwenden können, sind `EQUALS` und `NOT_EQUALS`. Einzelheiten zum Filtern von Parametern finden Sie unter [FilterParameter](https://docs.aws.amazon.com/internet-monitor/latest/api/API_FilterParameter.html)API-Vorgang. Einzelheiten zu den Operationen der Abfrageschnittstelle finden Sie unter den folgenden API-Operationen im API-Referenzhandbuch von Internet Monitor: + Informationen zum Erstellen und Ausführen einer Abfrage finden Sie unter [StartQuery](https://docs.aws.amazon.com/internet-monitor/latest/api/API_StartQuery.html)API-Vorgang. + Informationen zum Beenden einer Abfrage finden Sie unter [StopQuery](https://docs.aws.amazon.com/internet-monitor/latest/api/API_StopQuery.html)API-Vorgang. + Informationen zum Zurückgeben von Daten für eine von Ihnen erstellte Abfrage finden Sie unter [GetQueryResults](https://docs.aws.amazon.com/internet-monitor/latest/api/API_GetQueryResults.html)API-Vorgang. + Informationen zum Abrufen des Status einer Abfrage finden Sie unter [GetQueryStatus](https://docs.aws.amazon.com/internet-monitor/latest/api/API_GetQueryStatus.html)API-Vorgang. ## Abfragebeispiele Um eine Abfrage zu erstellen, mit der Sie einen gefilterten Datensatz aus der Protokolldatei Ihres Monitors abrufen können, verwenden Sie den [StartQuery](https://docs.aws.amazon.com/internet-monitor/latest/api/API_StartQuery.html)API-Vorgang. Sie geben einen Abfragetyp und Filterparameter für die Abfrage an. Anschließend, wenn Sie den API-Vorgang der Internet-Monitor-Abfrageschnittstelle verwenden, um mithilfe der Abfrage Ergebnisse zu erhalten, wird die Teilmenge Ihrer Daten abgerufen, mit der Sie arbeiten möchten. Schauen wir uns einige Beispiele an, um zu veranschaulichen, wie Abfragetypen und Filterparameter funktionieren. **Beispiel 1** Nehmen wir an, Sie möchten alle Protokolldateidaten Ihres Monitors für ein bestimmtes Land abrufen, mit Ausnahme einer Stadt. Das folgende Beispiel zeigt Filterparameter für eine Abfrage, die Sie mit dem Vorgang `StartQuery` für dieses Szenario erstellen könnten. ``` { 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"] }, ] } ``` **Beispiel 2** Als weiteres Beispiel wird angenommen, Sie möchten Ihre Top-Standorte nach Metropolregion gefiltert anzeigen. Sie könnten die folgende Beispielabfrage für dieses Szenario verwenden. ``` { MonitorName: "TestMonitor" StartTime: "2023-07-12T20:00:00Z" EndTime: "2023-07-12T21:00:00Z" QueryType: "TOP_LOCATIONS" FilterParameters: [ { Field: "geo", Operator: "EQUALS", Values: ["metro"] }, ] } ``` **Beispiel 3** Nehmen wir nun an, Sie möchten sich die Top-Kombinationen aus Städten und Netzwerken in der Metropolregion Los Angeles ansehen. Geben Sie dazu `geo=city` an und setzen Sie `metro` auf Los Angeles. Jetzt gibt die Abfrage die Top-Städtenetze in der Metropolregion Los Angeles zurück anstatt der Top-Ergebnisse für Metro\$1-Netzwerke insgesamt. Hier ist die Beispielabfrage, die Sie verwenden könnten: ``` { 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"] } ] } ``` **Beispiel 4** Nehmen wir als Nächstes an, dass Sie TTFB-Daten für eine bestimmte Unterteilung (z. B. einen US-Bundesstaat) abrufen möchten. Im Folgenden finden Sie eine Beispielabfrage für dieses Szenario: ``` { 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"] }, ] } ``` **Beispiel 5** Angenommen, Sie möchten TTFB-Daten für jeden Standort abrufen, an dem Ihre Anwendung Client-Datenverkehr hat. Im Folgenden finden Sie eine Beispielabfrage für dieses Szenario: ``` { 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], ... ``` **Beispiel 6** Nehmen wir an, Sie möchten TTFB-Daten für ein bestimmtes neues AWS-Region Objekt abrufen. Im Folgenden finden Sie eine Beispielabfrage für dieses Szenario: ``` { 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] ``` **Beispiel 7** Bei diesem letzten Beispiel sollen Daten für bestimmte DNS-Resolver abgerufen werden. Im Folgenden finden Sie eine Beispielabfrage für dieses Szenario: ``` { 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] ``` ## Abfrageergebnisse abrufen Nachdem Sie eine Abfrage definiert haben, können Sie eine Reihe von Ergebnissen mit der Abfrage zurückgeben, indem Sie einen weiteren Internet Monitor-API-Vorgang ausführen, [GetQueryResults](https://docs.aws.amazon.com/internet-monitor/latest/api/API_GetQueryResults.html). Bei der Ausführung von `GetQueryResults` geben Sie die Abfrage-ID für die von Ihnen definierte Abfrage zusammen mit dem Namen Ihres Monitors an. `GetQueryResults` ruft Daten für die angegebene Abfrage in einen Ergebnissatz ab. Vergewissern Sie sich beim Ausführen einer Abfrage, dass die Ausführung der Abfrage abgeschlossen ist, bevor Sie `GetQueryResults` verwenden, um die Ergebnisse anzusehen. Mithilfe des [GetQueryStatus](https://docs.aws.amazon.com/internet-monitor/latest/api/API_GetQueryStatus.html)API-Vorgangs können Sie feststellen, ob die Abfrage abgeschlossen wurde. Wenn der `Status` für die Abfrage `SUCCEEDED` ist, können Sie mit der Überprüfung der Ergebnisse fortfahren. Wenn Ihre Abfrage abgeschlossen ist, können Sie die folgenden Informationen verwenden, um die Ergebnisse zu überprüfen. Jeder Abfragetyp, den Sie zum Erstellen einer Abfrage verwenden, enthält einen eindeutigen Satz von Datenfeldern aus den Protokolldateien, wie in der folgenden Liste beschrieben: **Messungen** Der Abfragetyp `measurements` gibt die folgenden Daten zurück: `timestamp, availability, performance, bytes_in, bytes_out, rtt_p50, rtt_p90, rtt_p95` **Top-Standorte** Der Abfragetyp `top locations` gruppiert Daten nach Standort und stellt die über den Zeitraum gemittelten Daten bereit. Die zurückgegebenen Daten umfassen Folgendes: `aws_location, city, metro, subdivision, country, asn, availability, performance, bytes_in, bytes_out, current_fbl, best_ec2, best_ec2_region, best_cf_fbl` Beachten Sie, dass `city`, `metro` und `subdivision` nur zurückgegeben werden, wenn Sie diesen Standorttyp für das `geo`-Feld wählen. Je nach dem Standorttyp, den Sie angeben, werden die folgenden Standortfelder für `geo` zurückgegeben: ``` city = city, metro, subdivision, country metro = metro, subdivision, country subdivision = subdivision, country country = country ``` **Top-Standort-Details** Der Abfragetyp `top locations details` gibt Daten nach Stunden gruppiert zurück. Die Abfrage gibt die folgenden Daten zurück: `timestamp, current_service, current_fbl, best_ec2_fbl, best_ec2_region, best_cf_fbl` **Allgemeine Vorschläge zum Datenverkehr** Der Abfragetyp `overall traffic suggestions` gibt Daten nach Stunden gruppiert zurück. Die Abfrage gibt die folgenden Daten zurück: `current_aws_location, proposed_aws_location, average_fbl, traffic, optimized_traffic_excluding_cf, optimized_traffic_including_cf` **Details zu allgemeinen Vorschlägen zum Datenverkehr** Der Abfragetyp `overall traffic suggestions details` gibt Daten nach Stunden gruppiert zurück. Die Abfrage gibt die folgenden Daten zurück: `aws_location, city, metro, subdivision, country, asn, traffic, current_aws_location, fbl_data` **Routing-Vorschläge** Der Abfragetyp `routing suggestions` gibt Daten nach Stunden gruppiert zurück. Die Abfrage gibt die folgenden Daten zurück: `dns_resolver_ip, dns_resolver_asn, dns_resolver_isp, ipv4_prefixes, current_aws_location, current_latency, proposed_aws_location, proposed_latency` Wenn Sie den API-Vorgang `GetQueryResults` ausführen, gibt Internet Monitor in der Antwort Folgendes zurück: + Ein *Datenzeichenfolge-Array*, das die Ergebnisse enthält, die die Abfrage zurückgibt. Die Informationen werden in Arrays zurückgegeben, die auf das Feld `Fields` ausgerichtet sind. Dies wird auch durch den API-Aufruf zurückgegeben. Mithilfe des `Fields`-Felds können Sie die Informationen aus dem `Data`-Repository analysieren und sie dann für Ihre Zwecke weiter filtern oder sortieren. + Ein *Array von Feldern*, das die Felder auflistet, für die die Abfrage Daten zurückgegeben hat (in der `Data`-Feldantwort). Jedes Element im Array ist ein Name-Datentyp-Paar, z. B. `availability_score`-`float`. ## Fehlerbehebung Wenn bei der Verwendung von API-Vorgängen für die Abfrageschnittstelle Fehler zurückgegeben werden, stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen für die Verwendung von Internet Monitor verfügen. Stellen Sie insbesondere sicher, dass Sie über die folgenden Berechtigungen verfügen: ``` internetmonitor:StartQuery internetmonitor:GetQueryStatus internetmonitor:GetQueryResults internetmonitor:StopQuery ``` Diese Berechtigungen sind in der empfohlenen AWS Identity and Access Management Richtlinie für die Verwendung des Internet Monitor-Dashboards in der Konsole enthalten. Weitere Informationen finden Sie unter [AWS verwaltete Richtlinien für Internet Monitor](CloudWatch-IM-permissions.md).