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.
# Beispiele für die Verwendung der CLI mit Internet Monitor
Dieser Abschnitt enthält Beispiele für die Verwendung von Vorgängen AWS Command Line Interface mit Internet Monitor.
Bevor Sie beginnen, stellen Sie sicher, dass Sie sich anmelden, um das AWS CLI mit demselben AWS Konto zu verwenden, das die Amazon VPC-VPCs, Network Load Balancers, CloudFront Amazon-Distributionen oder WorkSpaces Amazon-Verzeichnisse enthält, die Sie überwachen möchten. Internet Monitor unterstützt nicht den kontoübergreifenden Zugriff auf Ressourcen. [Weitere Informationen zur Verwendung von finden Sie in der AWS CLI Befehlsreferenz.AWS CLI](https://docs.aws.amazon.com/cli/latest/index.html) Weitere Informationen zur Verwendung von API-Aktionen mit Internet Monitor finden Sie in der [API-Referenz von Internet Monitor](https://docs.aws.amazon.com/internet-monitor/latest/api/Welcome.html).
**Topics**
+ [Einen Monitor erstellen](#CloudWatch-IM-get-started-CLI-create-mon)
+ [Monitordetails anzeigen](#CloudWatch-IM-get-started-CLI-mon-details)
+ [Auflisten von Zustandsereignissen](#CloudWatch-IM-get-started-CLI-list-events)
+ [Anzeigen bestimmter Zustandsereignisse](#CloudWatch-IM-get-started-CLI-view-event-specific)
+ [Anzeigen der Monitorliste](#CloudWatch-IM-get-started-CLI-monitor-list)
+ [Monitor bearbeiten](#CloudWatch-IM-get-started-CLI-edit-monitor)
+ [Monitor löschen](#CloudWatch-IM-get-started-CLI-delete-monitor)
## Einen Monitor erstellen
Wenn Sie in Internet Monitor einen Monitor erstellen, geben Sie einen Namen an und ordnen dem Monitor Ressourcen zu, um anzuzeigen, wo sich der Internetverkehr Ihrer Anwendung befindet. Sie geben einen Prozentsatz für den Datenverkehr an, der festlegt, wie viel von Ihrem Anwendungsverkehr überwacht wird. Das bestimmt auch die Anzahl der Stadtnetze, also der Kundenstandorte und ASNs, in der Regel Internetdienstanbieter oder ISPs, die überwacht werden. Sie können auch ein Limit für die maximale Anzahl der zu überwachenden Stadtnetze für Ihre Anwendungsressourcen festlegen, um Ihre Kosten zu kontrollieren. Weitere Informationen finden Sie unter [Auswählen einer Höchstgrenze für Stadtnetze](IMCityNetworksMaximum.md).
Schließlich können Sie wählen, ob Sie alle Internetmessungen für Ihre Anwendung in Amazon S3 veröffentlichen möchten. Internet-Messungen für die 500 größten Stadtnetzwerke (nach Verkehrsaufkommen) werden von Internet Monitor automatisch in CloudWatch Logs veröffentlicht. Sie können jedoch festlegen, dass alle Messungen auch in S3 veröffentlicht werden.
Um einen Monitor mit dem zu erstellen AWS CLI, verwenden Sie den `create-monitor` Befehl. Mit dem folgenden Befehl erstellen Sie einen Monitor, der 100 % des Datenverkehrs überwacht, aber ein maximales Stadtnetz-Limit von 10 000 festlegt, eine VPC-Ressource hinzufügt und die Veröffentlichung von Internetmessungen in Amazon S3 vorsieht.
**Anmerkung**
Internet Monitor veröffentlicht in CloudWatch Logs alle fünf Minuten Internet-Messungen für die 500 wichtigsten Stadtnetzwerke (Kundenstandorte und ASNs, in der Regel Internetdienstanbieter oder ISPs), die Datenverkehr an die einzelnen Monitore senden. Optional können Sie Internetmessungen für alle überwachten Stadtnetze (bis zum Limit von 500 000 Stadtnetzen) in einem Amazon-S3-Bucket veröffentlichen. Weitere Informationen finden Sie unter [Veröffentlichen von Internetmessungen in Amazon S3 in Internet Monitor](CloudWatch-IM-get-started.Publish-to-S3.md).
```
aws internetmonitor create-monitor --monitor-name "TestMonitor" \
--traffic-percentage-to-monitor 100 \
--max-city-networks-to-monitor 10000 \
--resources "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889" \
--internet-measurements-log-delivery S3Config="{BucketName=amzn-s3-demo-bucket,LogDeliveryStatus=ENABLED}"
```
```
{
"Arn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"Status": "ACTIVE"
}
```
**Anmerkung**
Sie können den Namen eines Monitors nicht ändern.
## Monitordetails anzeigen
Um Informationen über einen Monitor mit dem anzuzeigen AWS CLI, verwenden Sie den `get-monitor` Befehl.
```
aws internetmonitor get-monitor --monitor-name "TestMonitor"
```
```
{
"ClientLocationType": "city",
"CreatedAt": "2022-09-22T19:27:47Z",
"ModifiedAt": "2022-09-22T19:28:30Z",
"MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"MonitorName": "TestMonitor",
"ProcessingStatus": "OK",
"ProcessingStatusInfo": "The monitor is actively processing data",
"Resources": [
"arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889"
],
"MaxCityNetworksToMonitor": 10000,
"Status": "ACTIVE"
}
```
## Auflisten von Zustandsereignissen
Wenn die Leistung des Internetverkehrs Ihrer Anwendung nachlässt, erstellt Internet Monitor Zustandsereignisse in Ihrem Monitor. Verwenden Sie den `list-health-events` Befehl, um eine Liste der aktuellen Integritätsereignisse mit dem anzuzeigen. AWS CLI
```
aws internetmonitor list-health-events --monitor-name "TestMonitor"
```
```
{
"HealthEvents": [
{
"EventId": "2022-06-20T01-05-05Z/latency",
"Status": "RESOLVED",
"EndedAt": "2022-06-20T01:15:14Z",
"ServiceLocations": [
{
"Name": "us-east-1"
}
],
"PercentOfTotalTrafficImpacted": 1.21,
"ClientLocations": [
{
"City": "Lockport",
"PercentOfClientLocationImpacted": 60.370000000000005,
"PercentOfTotalTraffic": 2.01,
"Country": "United States",
"Longitude": -78.6913,
"AutonomousSystemNumber": 26101,
"Latitude": 43.1721,
"Subdivision": "New York",
"NetworkName": "YAHOO-BF1"
}
],
"StartedAt": "2022-06-20T01:05:05Z",
"ImpactType": "PERFORMANCE",
"EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-05-05Z/latency"
},
{
"EventId": "2022-06-20T01-17-56Z/latency",
"Status": "RESOLVED",
"EndedAt": "2022-06-20T01:30:23Z",
"ServiceLocations": [
{
"Name": "us-east-1"
}
],
"PercentOfTotalTrafficImpacted": 1.29,
"ClientLocations": [
{
"City": "Toronto",
"PercentOfClientLocationImpacted": 75.32,
"PercentOfTotalTraffic": 1.05,
"Country": "Canada",
"Longitude": -79.3623,
"AutonomousSystemNumber": 14061,
"Latitude": 43.6547,
"Subdivision": "Ontario",
"CausedBy": {
"Status": "ACTIVE",
"Networks": [
{
"AutonomousSystemNumber": 16509,
"NetworkName": "Amazon.com"
}
],
"NetworkEventType": "AWS"
},
"NetworkName": "DIGITALOCEAN-ASN"
},
{
"City": "Lockport",
"PercentOfClientLocationImpacted": 22.91,
"PercentOfTotalTraffic": 2.01,
"Country": "United States",
"Longitude": -78.6913,
"AutonomousSystemNumber": 26101,
"Latitude": 43.1721,
"Subdivision": "New York",
"NetworkName": "YAHOO-BF1"
},
{
"City": "Hangzhou",
"PercentOfClientLocationImpacted": 2.88,
"PercentOfTotalTraffic": 0.7799999999999999,
"Country": "China",
"Longitude": 120.1612,
"AutonomousSystemNumber": 37963,
"Latitude": 30.2994,
"Subdivision": "Zhejiang",
"NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
}
],
"StartedAt": "2022-06-20T01:17:56Z",
"ImpactType": "PERFORMANCE",
"EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-17-56Z/latency"
},
{
"EventId": "2022-06-20T01-34-20Z/latency",
"Status": "RESOLVED",
"EndedAt": "2022-06-20T01:35:04Z",
"ServiceLocations": [
{
"Name": "us-east-1"
}
],
"PercentOfTotalTrafficImpacted": 1.15,
"ClientLocations": [
{
"City": "Lockport",
"PercentOfClientLocationImpacted": 39.45,
"PercentOfTotalTraffic": 2.01,
"Country": "United States",
"Longitude": -78.6913,
"AutonomousSystemNumber": 26101,
"Latitude": 43.1721,
"Subdivision": "New York",
"NetworkName": "YAHOO-BF1"
},
{
"City": "Toronto",
"PercentOfClientLocationImpacted": 29.770000000000003,
"PercentOfTotalTraffic": 1.05,
"Country": "Canada",
"Longitude": -79.3623,
"AutonomousSystemNumber": 14061,
"Latitude": 43.6547,
"Subdivision": "Ontario",
"CausedBy": {
"Status": "ACTIVE",
"Networks": [
{
"AutonomousSystemNumber": 16509,
"NetworkName": "Amazon.com"
}
],
"NetworkEventType": "AWS"
},
"NetworkName": "DIGITALOCEAN-ASN"
},
{
"City": "Hangzhou",
"PercentOfClientLocationImpacted": 2.88,
"PercentOfTotalTraffic": 0.7799999999999999,
"Country": "China",
"Longitude": 120.1612,
"AutonomousSystemNumber": 37963,
"Latitude": 30.2994,
"Subdivision": "Zhejiang",
"NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
}
],
"StartedAt": "2022-06-20T01:34:20Z",
"ImpactType": "PERFORMANCE",
"EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-34-20Z/latency"
}
]
}
```
## Anzeigen bestimmter Zustandsereignisse
Um detailliertere Informationen zu einem bestimmten Zustandsereignis mit der CLI zu erhalten, führen Sie den `get-health-event`-Befehl mit Ihrem Monitornamen und einer Zustandsereignis-ID aus.
```
aws internetmonitor get-monitor --monitor-name "TestMonitor" --event-id "health-event/TestMonitor/2021-06-03T01:02:03Z/latency"
```
```
{
"EventId": "2022-06-20T01-34-20Z/latency",
"Status": "RESOLVED",
"EndedAt": "2022-06-20T01:35:04Z",
"ServiceLocations": [
{
"Name": "us-east-1"
}
],
"EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-34-20Z/latency",
"LastUpdatedAt": "2022-06-20T01:35:04Z",
"ClientLocations": [
{
"City": "Lockport",
"PercentOfClientLocationImpacted": 39.45,
"PercentOfTotalTraffic": 2.01,
"Country": "United States",
"Longitude": -78.6913,
"AutonomousSystemNumber": 26101,
"Latitude": 43.1721,
"Subdivision": "New York",
"NetworkName": "YAHOO-BF1"
},
{
"City": "Toronto",
"PercentOfClientLocationImpacted": 29.770000000000003,
"PercentOfTotalTraffic": 1.05,
"Country": "Canada",
"Longitude": -79.3623,
"AutonomousSystemNumber": 14061,
"Latitude": 43.6547,
"Subdivision": "Ontario",
"CausedBy": {
"Status": "ACTIVE",
"Networks": [
{
"AutonomousSystemNumber": 16509,
"NetworkName": "Amazon.com"
}
],
"NetworkEventType": "AWS"
},
"NetworkName": "DIGITALOCEAN-ASN"
},
{
"City": "Shenzhen",
"PercentOfClientLocationImpacted": 4.07,
"PercentOfTotalTraffic": 0.61,
"Country": "China",
"Longitude": 114.0683,
"AutonomousSystemNumber": 37963,
"Latitude": 22.5455,
"Subdivision": "Guangdong",
"NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
},
{
"City": "Hangzhou",
"PercentOfClientLocationImpacted": 2.88,
"PercentOfTotalTraffic": 0.7799999999999999,
"Country": "China",
"Longitude": 120.1612,
"AutonomousSystemNumber": 37963,
"Latitude": 30.2994,
"Subdivision": "Zhejiang",
"NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
}
],
"StartedAt": "2022-06-20T01:34:20Z",
"ImpactType": "PERFORMANCE",
"PercentOfTotalTrafficImpacted": 1.15
}
```
## Anzeigen der Monitorliste
Führen Sie den `list-monitors`-Befehl aus, um eine Liste aller Monitore in Ihrem Konto mit der CLI anzuzeigen.
```
aws internetmonitor list-monitors
```
```
{
"Monitors": [
{
"MonitorName": "TestMonitor",
"ProcessingStatus": "OK",
"Status": "ACTIVE"
}
],
"NextToken": " zase12"
}
```
## Monitor bearbeiten
Um Informationen über Ihren Monitor mithilfe der CLI zu aktualisieren, verwenden Sie den `update-monitor`-Befehl und geben Sie den Namen des zu aktualisierenden Monitors an. Sie können beispielsweise den Prozentsatz des zu überwachenden Datenverkehrs aktualisieren, die maximale Anzahl der zu überwachenden Stadtnetze begrenzen, die Ressourcen, die Internet Monitor zur Überwachung des Datenverkehrs verwendet, hinzufügen oder entfernen und den Überwachungsstatus von `ACTIVE` in `INACTIVE` ändern oder umgekehrt. Beachten Sie, dass Sie den Namen des Monitors nicht mehr ändern können.
Die Antwort auf einen `update-monitor`-Aufruf gibt nur den `MonitorArn` und den `Status` zurück.
Das folgende Beispiel zeigt, wie Sie den Befehl `update-monitor` verwenden, um die maximale Anzahl der zu überwachenden Stadtnetze auf `50000` zu ändern:
```
aws internetmonitor update-monitor --monitor-name "TestMonitor" --max-city-networks-to-monitor 50000
```
```
{
"MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"Status": " ACTIVE "
}
```
Das folgende Beispiel zeigt, wie Sie Ressource hinzufügen und entfernen:
```
aws internetmonitor update-monitor --monitor-name "TestMonitor" \
--resources-to-add "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889" \
--resources-to-remove "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-2222444455556666"
```
```
{
"MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"Status": "ACTIVE"
}
```
Das folgende Beispiel zeigt, wie der Befehl `update-monitor` verwendet wird, um den Monitorstatus auf `INACTIVE` zu ändern:
```
aws internetmonitor update-monitor --monitor-name "TestMonitor" --status "INACTIVE"
```
```
{
"MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"Status": "INACTIVE"
}
```
## Monitor löschen
Sie können einen Monitor mit der CLI löschen, indem Sie den `delete-monitor`-Befehl verwenden. Zunächst müssen Sie den Monitor auf inaktiv einstellen. Verwenden Sie den `update-monitor`-Befehl, um den Status auf `INACTIVE` zu ändern. Vergewissern Sie sich, dass der Monitor inaktiv ist, indem Sie den `get-monitor`-Befehl verwenden und den Status überprüfen.
Wenn der Monitorstatus `INACTIVE` ist, können Sie die CLI verwenden, um den `delete-monitor`-Befehl zum Löschen des Monitors auszuführen. Die Antwort auf einen erfolgreichen `delete-monitor`-Aufruf ist leer.
```
aws internetmonitor delete-monitor --monitor-name "TestMonitor"
```
```
{}
```