Einen Monitor erstellen Überwachungsdetails anzeigen Auflisten von Zustandsereignissen Anzeigen bestimmter Zustandsereignisse Anzeigen der Monitorliste Monitor bearbeiten Monitor löschen

Beispiele für die Verwendung CLI mit Amazon CloudWatch Internet Monitor

Dieser Abschnitt enthält Beispiele für die Verwendung der Operationen AWS Command Line Interface mit Amazon CloudWatch Internet Monitor.

Bevor Sie beginnen, stellen Sie sicher, dass Sie sich AWS CLI mit demselben AWS Konto anmelden, das die Amazon Virtual Private Clouds (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 CLIAWS CLI Befehlsreferenz. Weitere Informationen zur Verwendung von API Aktionen mit Amazon CloudWatch Internet Monitor finden Sie im Amazon CloudWatch Internet API Monitor-Referenzhandbuch.

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. Dies bestimmt auch die Anzahl der städtischen Netzwerke, d. h. der Standorte der Kunden und, in der RegelASNs, der Internetdienstanbieter oderISPs, 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 Wählen Sie eine Obergrenze für Stadtnetzwerke.

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 automatisch in CloudWatch Logs by Internet Monitor 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. Der folgende Befehl erstellt einen Monitor, der 100% des Datenverkehrs überwacht, aber ein maximales Stadtnetzwerklimit von 10.000 festlegt, eine VPC Ressource hinzufügt und sich dafür entscheidet, Internetmessungen auf Amazon S3 zu veröffentlichen.

Anmerkung

Internet Monitor veröffentlicht und CloudWatch protokolliert alle fünf Minuten Internet-Messungen für die 500 wichtigsten Stadtnetzwerke (Kundenstandorte undASNs, in der Regel Internetdienstanbieter oderISPs), die Datenverkehr an jeden Monitor 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 Internet-Messungen in Amazon S3 in Amazon CloudWatch Internet Monitor veröffentlichen.


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.

Überwachungsdetails 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. Um eine Liste der aktuellen Gesundheitsereignisse mit dem anzuzeigen AWS CLI, verwenden Sie den list-health-events Befehl


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 Gesundheitsereignis mit dem zu erhaltenCLI, führen Sie den get-health-event Befehl mit Ihrem Monitornamen und einer Integritätsereignis-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

Um eine Liste aller Monitore in Ihrem Konto mit dem anzuzeigenCLI, führen Sie den list-monitors Befehl aus.


aws internetmonitor list-monitors


{
    "Monitors": [
        {
            "MonitorName": "TestMonitor",
            "ProcessingStatus": "OK",
            "Status": "ACTIVE"
        }
    ],
    "NextToken": " zase12"
}

Monitor bearbeiten

Um Informationen über Ihren Monitor mithilfe von zu aktualisierenCLI, 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 und die Obergrenze für die maximale Anzahl der zu überwachenden Stadtnetzwerke aktualisieren, die Ressourcen, die Internet Monitor zur Überwachung des Datenverkehrs verwendet, hinzufügen oder entfernen und den Monitorstatus von ACTIVE zu 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 dem löschen, CLI 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 lautetINACTIVE, können Sie den delete-monitor Befehl CLI zum Löschen des Monitors ausführen. Die Antwort auf einen erfolgreichen delete-monitor-Aufruf ist leer.


aws internetmonitor delete-monitor --monitor-name "TestMonitor"

{}

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Veröffentlichen Sie Internet-Messungen auf S3

Internet-Monitor-Dashboard