Exemples d’utilisation de la CLI avec Network Flow Monitor - Amazon CloudWatch
Création d'une surveillanceAfficher les détails du moniteurCréer une portéeSuppression d’un moniteurSuppression d'une portéeObtenir des informations sur un moniteurRécupérer des données sur une requête spécifiqueVoir les informations sur la portéeVoir la liste des moniteurs d’un compteVoir la liste des portées d’un compteVoir la liste des balises pour un moniteurDémarrage et arrêt des requêtesBaliser un moniteurSupprimer un balisage d’un moniteurMise à jour d’un moniteur existant

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exemples d’utilisation de la CLI avec Network Flow Monitor

Cette section contient des exemples d'utilisation des opérations AWS Command Line Interface avec Network Flow Monitor.

Avant de commencer, assurez-vous de vous connecter pour utiliser le AWS CLI AWS compte qui fournit l'étendue que vous souhaitez utiliser pour surveiller les flux réseau. Pour plus d’informations sur l’utilisation des actions de l’API avec Network Flow Monitor, consultez le Guide de référence de l’API de Network Flow Monitor.

Création d'une surveillance

Pour créer un moniteur avec le AWS CLI, utilisez la create-monitor commande. L’exemple suivant crée un moniteur nommé demo dans le compte spécifié.

aws networkflowmonitor create-monitor \
        --monitor-name demo \
        --local-resources type="AWS::EC2::VPC",identifier="arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889"  \
        --scope-arn arn:aws:networkflowmonitor:us-east-1:111122223333:scope/sample-aaaa-bbbb-cccc-44556677889

Sortie :

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

Pour de plus amples informations, veuillez consulter Créer un moniteur dans Network Flow Monitor.

Afficher les détails du moniteur

Pour afficher les informations relatives à un moniteur doté du AWS CLI, utilisez la get-monitor commande.

aws networkflowmonitor get-monitor --monitor-name "TestMonitor"

Sortie :

{
    "ClientLocationType": "city",
    "CreatedAt": "2022-09-22T19:27:47Z",
    "ModifiedAt": "2022-09-22T19:28:30Z",
    "MonitorArn": "arn:aws:networkflowmonitor: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"
}

Créer une portée

L’exemple create-scope suivant crée une portée qui est l’ensemble des ressources pour lesquelles Network Flow Monitor générera des métriques de trafic réseau.

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

Sortie :


    {
        "scopeId": "sample-aaaa-bbbb-cccc-11112222333",
        "status": "IN_PROGRESS",
        "tags": {}
    }

Pour de plus amples informations, veuillez consulter Composants et fonctionnalités de Network Flow Monitor.

Suppression d’un moniteur

L’exemple delete-monitor suivant supprime un moniteur nommé Demo dans votre compte.

aws networkflowmonitor delete-monitor \
        --monitor-name Demo

Cette commande ne produit aucune sortie.

Pour de plus amples informations, veuillez consulter Supprimer un moniteur dans Network Flow Monitor.

Suppression d'une portée

L’exemple delete-scope suivant supprime la portée spécifiée.

aws networkflowmonitor delete-scope \
        --scope-id sample-aaaa-bbbb-cccc-44556677889

Cette commande ne produit aucune sortie.

Pour de plus amples informations, veuillez consulter Composants et fonctionnalités de Network Flow Monitor.

Obtenir des informations sur un moniteur

L’exemple get-monitor suivant affiche des informations sur le moniteur nommé demo dans le compte spécifié.

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

Sortie :

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

Pour de plus amples informations, veuillez consulter Composants et fonctionnalités de Network Flow Monitor.

Récupérer des données sur une requête spécifique

Les sections suivantes fournissent des exemples de commandes CLI pour récupérer les statuts des requêtes.

get-query-results-workload-insights-top-contributors-data

L’exemple get-query-results-workload-insights-top-contributors-data renvoie les données de la requête spécifiée.

aws networkflowmonitor get-query-results-workload-insights-top-contributors-data \
        --scope-id sample-aaaa-bbbb-cccc-11112222333 \
        --query-id sample-dddd-eeee-ffff-44556677889

Sortie :

{
        "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"
    }

get-query-results-workload-insights-top-contributors

L’exemple get-query-results-workload-insights-top-contributors suivant renvoie les données pour la requête spécifiée.

aws networkflowmonitor get-query-results-workload-insights-top-contributors \
        --scope-id sample-aaaa-bbbb-cccc-11112222333 \
        --query-id sample-dddd-eeee-ffff-44556677889

Sortie :

{
        "topContributors": [
            {
                "accountId": "111122223333",
                "localSubnetId": "subnet-SAMPLE1111",
                "localAz": "use1-az6",
                "localVpcId": "vpc-SAMPLE2222",
                "localRegion": "us-east-1",
                "remoteIdentifier": "",
                "value": 333333,
                "localSubnetArn": "arn:aws:ec2:us-east-1:111122223333:subnet/subnet-2222444455556666",
                "localVpcArn": "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889"
            }
        ]
    }

get-query-status-monitor-meilleurs contributeurs

L’exemple get-query-status-monitor-top-contributors suivant affiche le statut actuel de la requête dans le compte spécifié.

aws networkflowmonitor get-query-status-monitor-top-contributors \
        --monitor-name Demo \
        --query-id sample-dddd-eeee-ffff-44556677889

Sortie :

{
        "status": "SUCCEEDED"
    }

get-query-status-workload-insights-top-contributors-data

L’exemple get-query-status-workload-insights-top-contributors-data suivant affiche le statut actuel de la requête dans le compte spécifié.

aws networkflowmonitor get-query-status-workload-insights-top-contributors-data \
        --scope-id sample-aaaa-bbbb-cccc-11112222333 \
        --query-id sample-dddd-eeee-ffff-44556677889

Sortie :

{
        "status": "SUCCEEDED"
    }

get-query-results-workload-insights-top-contributors

L’exemple get-query-results-workload-insights-top-contributors suivant affiche le statut actuel de la requête dans le compte spécifié.

aws networkflowmonitor get-query-status-workload-insights-top-contributors \
        --scope-id sample-aaaa-bbbb-cccc-11112222333 \
        --query-id sample-dddd-eeee-ffff-44556677889

Sortie :

{
        "status": "SUCCEEDED"
    }

Pour de plus amples informations, veuillez consulter Évaluer les flux réseau avec des informations sur la charge de travail.

Voir les informations sur la portée

L’exemple get-scope suivant affiche des informations sur une portée, telles que l’état, les balises, le nom et les détails de la cible.

aws networkflowmonitor get-scope \
        --scope-id sample-aaaa-bbbb-cccc-11112222333

Sortie :

{
        "scopeId": "sample-aaaa-bbbb-cccc-11112222333",
        "status": "SUCCEEDED",
        "scopeArn": "arn:aws:networkflowmonitor:us-east-1:111122223333:scope/sample-aaaa-bbbb-cccc-11112222333",
        "targets": [
            {
                "targetIdentifier": {
                    "targetId": {
                        "accountId": "111122223333"
                    },
                    "targetType": "ACCOUNT"
                },
                "region": "us-east-1"
            }
        ],
        "tags": {}
    }

Pour de plus amples informations, veuillez consulter Composants et fonctionnalités de Network Flow Monitor.

Voir la liste des moniteurs d’un compte

L’exemple list-monitors suivant renvoie tous les moniteurs du compte spécifié.

aws networkflowmonitor list-monitors

Sortie :

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

Pour de plus amples informations, veuillez consulter Composants et fonctionnalités de Network Flow Monitor.

Voir la liste des portées d’un compte

L’exemple list-scopes suivant donne la liste de toutes les portées du compte spécifié.

aws networkflowmonitor list-scopes

Sortie :

{
        "scopes": [
            {
                "scopeId": "sample-aaaa-bbbb-cccc-11112222333",
                "status": "SUCCEEDED",
                "scopeArn": "arn:aws:networkflowmonitor:us-east-1:111122223333:scope/sample-aaaa-bbbb-cccc-11112222333"
            }
        ]
    }

Pour de plus amples informations, veuillez consulter Composants et fonctionnalités de Network Flow Monitor.

Voir la liste des balises pour un moniteur

L’exemple list-tags-for-resource suivant renvoie toutes les balises associées à la ressource spécifiée.

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

Sortie :

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

Pour de plus amples informations, veuillez consulter Étiquette de vos ressources Amazon CloudWatch.

Démarrage et arrêt des requêtes

Les sections suivantes fournissent des exemples de commandes CLI pour le démarrage et l’arrêt des requêtes dans Network Flow Monitor.

start-query-monitor-top-contributeurs

L’exemple start-query-monitor-top-contributors suivant démarre la requête qui renvoie un queryId pour récupérer les principaux contributeurs.

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

Sortie :

{
        "queryId": "sample-dddd-eeee-ffff-44556677889"
    }

Pour de plus amples informations, veuillez consulter Évaluer les flux réseau avec des informations sur la charge de travail.

start-query-workload-insights-top-contributors-data

L’exemple start-query-workload-insights-top-contributors-data suivant démarre la requête qui renvoie un queryId pour récupérer les principaux contributeurs.

aws networkflowmonitor start-query-workload-insights-top-contributors-data \
        --scope-id sample-aaaa-bbbb-cccc-11112222333 \
        --start-time 2024-12-09T19:00:00Z \
        --end-time 2024-12-09T19:15:00Z \
        --metric-name DATA_TRANSFERRED \
        --destination-category UNCLASSIFIED

Sortie :

{
        "queryId": "sample-dddd-eeee-ffff-44556677889"
    }

Pour de plus amples informations, veuillez consulter Évaluer les flux réseau avec des informations sur la charge de travail.

start-query-workload-insights-meilleurs contributeurs

L’exemple start-query-workload-insights-top-contributors suivant démarre la requête qui renvoie un queryId pour récupérer les principaux contributeurs.

aws networkflowmonitor start-query-workload-insights-top-contributors \
        --scope-id sample-aaaa-bbbb-cccc-11112222333 \
        --start-time 2024-12-09T19:00:00Z \
        --end-time 2024-12-09T19:15:00Z \
        --metric-name DATA_TRANSFERRED \
        --destination-category UNCLASSIFIED

Sortie :

{
        "queryId": "sample-dddd-eeee-ffff-44556677889"
    }

Pour de plus amples informations, veuillez consulter Évaluer les flux réseau avec des informations sur la charge de travail.

stop-query-monitor-top-contributeurs

L’exemple stop-query-monitor-top-contributors suivant arrête la requête dans le compte spécifié.

aws networkflowmonitor stop-query-monitor-top-contributors \
        --monitor-name Demo \
        --query-id sample-dddd-eeee-ffff-44556677889

Cette commande ne produit aucune sortie.

Pour de plus amples informations, veuillez consulter Évaluer les flux réseau avec des informations sur la charge de travail.

stop-query-workload-insights-top-contributors-data

L’exemple stop-query-workload-insights-top-contributors-data suivant arrête la requête dans le compte spécifié.

aws networkflowmonitor stop-query-workload-insights-top-contributors-data \ 
        --scope-id sample-aaaa-bbbb-cccc-11112222333 \
        --query-id sample-dddd-eeee-ffff-44556677889

Cette commande ne produit aucune sortie.

Pour de plus amples informations, veuillez consulter Évaluer les flux réseau avec des informations sur la charge de travail.

stop-query-workload-insights-meilleurs contributeurs

L’exemple stop-query-workload-insights-top-contributors suivant arrête la requête dans le compte spécifié.

aws networkflowmonitor stop-query-workload-insights-top-contributors \ 
        --scope-id sample-aaaa-bbbb-cccc-11112222333 \
        --query-id sample-dddd-eeee-ffff-44556677889

Cette commande ne produit aucune sortie.

Pour de plus amples informations, veuillez consulter Évaluer les flux réseau avec des informations sur la charge de travail.

Baliser un moniteur

Le tag-resource suivant ajoute un balisage au moniteur dans le compte spécifié.

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

Cette commande ne produit aucune sortie.

Pour de plus amples informations, veuillez consulter Étiquette de vos ressources Amazon CloudWatch.

Supprimer un balisage d’un moniteur

L’exemple untag-resource suivant supprime un balisage du moniteur dans le compte spécifié.

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

Cette commande ne produit aucune sortie.

Pour de plus amples informations, veuillez consulter Étiquette de vos ressources Amazon CloudWatch.

Mise à jour d’un moniteur existant

L’exemple update-monitor suivant met à jour le moniteur nommé ``Demo`` dans le compte spécifié.

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

Sortie :

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

Pour de plus amples informations, veuillez consulter Composants et fonctionnalités de Network Flow Monitor.