Beispiele für Network Flow Monitor mit AWS CLI

Um einen Monitor zu erstellen

Im folgenden create-monitor Beispiel wird ein Monitor mit demo dem Namen des angegebenen Kontos erstellt.

aws networkflowmonitor create-monitor \
    --monitor-name demo \
    --local-resources type="AWS::EC2::VPC",identifier="arn:aws:ec2:us-east-1:123456789012:vpc/vpc-03ea55eeda25adbb0"  \
    --scope-arn arn:aws:networkflowmonitor:us-east-1:123456789012:scope/e21cda79-30a0-4c12-9299-d8629d76d8cf

Ausgabe:

{
    "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/demo",
    "monitorName": "demo",
    "monitorStatus": "ACTIVE",
    "tags": {}
}

Weitere Informationen finden Sie unter Erstellen eines Monitors in Network Flow Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um einen Bereich zu erstellen

Im folgenden create-scope Beispiel wird ein Bereich erstellt, der eine Reihe von Ressourcen umfasst, für die Network Flow Monitor Metriken zum Netzwerkverkehr generiert.

aws networkflowmonitor create-scope \
    --targets '[{"targetIdentifier":{"targetId":{"accountId":"123456789012"},"targetType":"ACCOUNT"},"region":"us-east-1"}]'

Ausgabe:

{
    "scopeId": "97626f8d-8a21-4b5d-813a-1a0962dd4615",
    "status": "IN_PROGRESS",
    "tags": {}
}

Weitere Informationen finden Sie unter Komponenten und Funktionen von Network Flow Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um einen Monitor zu löschen

Im folgenden delete-monitor Beispiel wird ein Monitor gelöscht, der demo im angegebenen Konto benannt ist.

aws networkflowmonitor delete-monitor \
    --monitor-name demo

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen eines Monitors in Network Flow Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um einen Bereich zu löschen

Im folgenden delete-scope Beispiel wird ein bestimmter Bereich gelöscht.

aws networkflowmonitor delete-scope \
    --scope-id fdc20616-6bb4-4242-a24e-a748e65ca7ac

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Komponenten und Funktionen von Network Flow Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um Informationen über einen Monitor abzurufen

Im folgenden get-monitor Beispiel werden Informationen über den Monitor angezeigt, der demo im angegebenen Konto benannt ist.

aws networkflowmonitor get-monitor \
    --monitor-name Demo

Ausgabe:

{
    "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo",
    "monitorName": "Demo",
    "monitorStatus": "ACTIVE",
    "localResources": [
        {
            "type": "AWS::EC2::VPC",
            "identifier": "arn:aws:ec2:us-east-1:123456789012:vpc/vpc-03ea55eeda25adbb0"
        }
    ],
    "remoteResources": [],
    "createdAt": "2024-12-09T12:21:51.616000-06:00",
    "modifiedAt": "2024-12-09T12:21:55.412000-06:00",
    "tags": {}
}

Weitere Informationen finden Sie unter Komponenten und Funktionen von Network Flow Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um die Daten der wichtigsten Mitwirkenden zu Workload Insights abzurufen

Im folgenden get-query-results-workload-insights-top-contributors-data Beispiel werden die Daten für die angegebene Abfrage zurückgegeben.

aws networkflowmonitor get-query-results-workload-insights-top-contributors-data \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id cc4f4ab3-3103-33b8-80ff-d6597a0c6cea

Ausgabe:

{
    "datapoints": [
        {
            "timestamps": [
                "2024-12-09T19:00:00+00:00",
                "2024-12-09T19:05:00+00:00",
                "2024-12-09T19:10:00+00:00"
            ],
            "values": [
                259943.0,
                194856.0,
                216432.0
            ],
            "label": "use1-az6"
        }
    ],
    "unit": "Bytes"
}

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um die wichtigsten Mitwirkenden bei Workload Insights abzurufen

Das folgende get-query-results-workload-insights-top-contributors Beispiel gibt die Daten für die angegebene Abfrage zurück.

aws networkflowmonitor get-query-results-workload-insights-top-contributors \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id 1fc423d3-b144-37a6-80e6-e2c7d26eea0c

Ausgabe:

{
    "topContributors": [
        {
            "accountId": "123456789012",
            "localSubnetId": "subnet-0a5b30fb95dca2c14",
            "localAz": "use1-az6",
            "localVpcId": "vpc-03ea55eeda25adbb0",
            "localRegion": "us-east-1",
            "remoteIdentifier": "",
            "value": 908443,
            "localSubnetArn": "arn:aws:ec2:us-east-1:123456789012:subnet/subnet-0a5b30fb95dca2c14",
            "localVpcArn": "arn:aws:ec2:us-east-1:123456789012:vpc/vpc-03ea55eeda25adbb0"
        }
    ]
}

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um den Status der Abfrage abzurufen

Im folgenden get-query-status-monitor-top-contributors Beispiel wird der aktuelle Status der Abfrage im angegebenen Konto angezeigt.

aws networkflowmonitor get-query-status-monitor-top-contributors \
    --monitor-name Demo \
    --query-id 5398eabd-bc40-3f5f-aba3-bcb639d3c7ca

Ausgabe:

{
    "status": "SUCCEEDED"
}

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um den Status der Abfrage abzurufen

Im folgenden get-query-status-workload-insights-top-contributors-data Beispiel wird der aktuelle Status der Abfrage im angegebenen Konto angezeigt.

aws networkflowmonitor get-query-status-workload-insights-top-contributors-data \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id 4333754d-8ae1-3f29-b6b7-c36db2e7f8ac

Ausgabe:

{
    "status": "SUCCEEDED"
}

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um den Status der Abfrage abzurufen

Im folgenden get-query-status-workload-insights-top-contributors Beispiel wird der aktuelle Status der Abfrage im angegebenen Konto angezeigt.

aws networkflowmonitor get-query-status-workload-insights-top-contributors \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id f2a87c70-3e5a-362e-8beb-4747d13d8419

Ausgabe:

{
    "status": "SUCCEEDED"
}

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um Informationen über einen Bereich abzurufen

Im folgenden get-scope Beispiel werden Informationen zu einem Bereich angezeigt, z. B. Status, Tags, Name und Zieldetails.

aws networkflowmonitor get-scope \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf

Ausgabe:

{
    "scopeId": "e21cda79-30a0-4c12-9299-d8629d76d8cf",
    "status": "SUCCEEDED",
    "scopeArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:scope/e21cda79-30a0-4c12-9299-d8629d76d8cf",
    "targets": [
        {
            "targetIdentifier": {
                "targetId": {
                    "accountId": "123456789012"
                },
                "targetType": "ACCOUNT"
            },
            "region": "us-east-1"
        }
    ],
    "tags": {}
}

Weitere Informationen finden Sie unter Komponenten und Funktionen von Network Flow Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um eine Liste von Monitoren abzurufen

Im folgenden list-monitors Beispiel werden alle Monitore im angegebenen Konto zurückgegeben.

aws networkflowmonitor list-monitors

Ausgabe:

{
    "monitors": [
        {
            "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo",
            "monitorName": "Demo",
            "monitorStatus": "ACTIVE"
        }
    ]
}

Weitere Informationen finden Sie unter Komponenten und Funktionen von Network Flow Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um eine Liste von Bereichen abzurufen

Das folgende list-scopes Beispiel listet alle Bereiche im angegebenen Konto auf.

aws networkflowmonitor list-scopes

Ausgabe:

{
    "scopes": [
        {
            "scopeId": "fdc20616-6bb4-4242-a24e-a748e65ca7ac",
            "status": "SUCCEEDED",
            "scopeArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:scope/fdc20616-6bb4-4242-a24e-a748e65ca7ac"
        }
    ]
}

Weitere Informationen finden Sie unter Komponenten und Funktionen von Network Flow Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um die Tags aufzulisten

Das folgende list-tags-for-resource Beispiel gibt alle Tags zurück, die der angegebenen Ressource zugeordnet sind.

aws networkflowmonitor list-tags-for-resource \
    --resource-arn arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo

Ausgabe:

{
    "tags": {
        "Value": "Production",
        "Key": "stack"
    }
}

Weitere Informationen finden Sie unter Taggen Ihrer CloudWatch Amazon-Ressourcen im CloudWatch Amazon-Benutzerhandbuch.

Um eine Abfrage zu starten

Im folgenden start-query-monitor-top-contributors Beispiel wird die Abfrage gestartet, die eine Abfrage-ID zurückgibt, um die wichtigsten Mitwirkenden abzurufen.

aws networkflowmonitor start-query-monitor-top-contributors \
    --monitor-name Demo \
    --start-time 2024-12-09T19:00:00Z \
    --end-time 2024-12-09T19:15:00Z \
    --metric-name DATA_TRANSFERRED \
    --destination-category UNCLASSIFIED

Ausgabe:

{
    "queryId": "aecd3a88-0283-35b0-a17d-6e944dc8531d"
}

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um eine Abfrage zu starten

Im folgenden start-query-workload-insights-top-contributors-data Beispiel wird die Abfrage gestartet, die eine Abfrage-ID zurückgibt, um die wichtigsten Mitwirkenden abzurufen.

aws networkflowmonitor start-query-workload-insights-top-contributors-data \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --start-time 2024-12-09T19:00:00Z \
    --end-time 2024-12-09T19:15:00Z \
    --metric-name DATA_TRANSFERRED \
    --destination-category UNCLASSIFIED

Ausgabe:

{
    "queryId": "cc4f4ab3-3103-33b8-80ff-d6597a0c6cea"
}

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um eine Abfrage zu starten

Im folgenden start-query-workload-insights-top-contributors Beispiel wird die Abfrage gestartet, die eine Abfrage-ID zurückgibt, um die wichtigsten Mitwirkenden abzurufen.

aws networkflowmonitor start-query-workload-insights-top-contributors \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --start-time 2024-12-09T19:00:00Z \
    --end-time 2024-12-09T19:15:00Z \
    --metric-name DATA_TRANSFERRED \
    --destination-category UNCLASSIFIED

Ausgabe:

{
    "queryId": "1fc423d3-b144-37a6-80e6-e2c7d26eea0c"
}

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um eine Abfrage zu beenden

Im folgenden stop-query-monitor-top-contributors Beispiel wird die Abfrage im angegebenen Konto beendet.

aws networkflowmonitor stop-query-monitor-top-contributors \
    --monitor-name Demo \
    --query-id aecd3a88-0283-35b0-a17d-6e944dc8531d

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um eine Abfrage zu beenden

Im folgenden stop-query-workload-insights-top-contributors-data Beispiel wird die Abfrage im angegebenen Konto beendet.

aws networkflowmonitor stop-query-workload-insights-top-contributors-data \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id cc4f4ab3-3103-33b8-80ff-d6597a0c6cea

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um eine Abfrage zu beenden

Im folgenden stop-query-workload-insights-top-contributors Beispiel wird die Abfrage im angegebenen Konto beendet.

aws networkflowmonitor stop-query-workload-insights-top-contributors \
    --scope-id e21cda79-30a0-4c12-9299-d8629d76d8cf \
    --query-id 1fc423d3-b144-37a6-80e6-e2c7d26eea0c

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Evaluieren von Netzwerkabläufen mit Workload-Erkenntnissen im CloudWatch Amazon-Benutzerhandbuch.

Um der angegebenen Ressource ein Tag hinzuzufügen

Im folgenden tag-resource Beispiel wird dem Monitor im angegebenen Konto ein Tag hinzugefügt.

aws networkflowmonitor tag-resource \
    --resource-arn arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo \
    --tags Key=stack,Value=Production

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Taggen Ihrer CloudWatch Amazon-Ressourcen im CloudWatch Amazon-Benutzerhandbuch.

Um ein Tag aus der angegebenen Ressource zu entfernen

Im folgenden untag-resource Beispiel wird im angegebenen Konto ein Tag vom Monitor entfernt.

aws networkflowmonitor untag-resource \
    --resource-arn arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo \
    --tag-keys stack

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Taggen Ihrer CloudWatch Amazon-Ressourcen im CloudWatch Amazon-Benutzerhandbuch.

Um einen vorhandenen Monitor zu aktualisieren

Im folgenden update-monitor Beispiel wird der Monitor aktualisiert, der Demo im angegebenen Konto benannt ist.

aws networkflowmonitor update-monitor \
    --monitor-name Demo \
    --local-resources-to-add type="AWS::EC2::VPC",identifier="arn:aws:ec2:us-east-1:123456789012:vpc/vpc-048d08dfbec623f94"

Ausgabe:

{
    "monitorArn": "arn:aws:networkflowmonitor:us-east-1:123456789012:monitor/Demo",
    "monitorName": "Demo",
    "monitorStatus": "ACTIVE",
    "tags": {
        "Value": "Production",
        "Key": "stack"
    }
}

Weitere Informationen finden Sie unter Komponenten und Funktionen von Network Flow Monitor im CloudWatch Amazon-Benutzerhandbuch.