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

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 Weitere Informationen zur Verwendung von API-Aktionen mit Internet Monitor finden Sie im Internet Monitor-API-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 Regel ASNs, der 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 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. 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 in der Regel Internetdienstanbieter ISPs) ASNs, 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 Internet-Messungen in Internet Monitor auf Amazon S3 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. 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 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 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"

{}

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