Exemples d'utilisation de la CLI avec Network Flow Monitor - Amazon CloudWatch
Création d'une surveillanceAfficher les détails du contrôleCréation d'un scopeSuppression 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 le périmètreAfficher la liste des moniteurs associés à un compteAfficher la liste des champs d'application d'un compteVoir la liste des tags d'un moniteurDémarrage et arrêt de requêtesMarquer un moniteurSupprimer une étiquette d'un moniteurMettre à jour 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 d'API avec Network Flow Monitor, consultez le Guide de référence de l'API 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éation d'un moniteur dans Network Flow Monitor.

Afficher les détails du contrôle

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éation d'un scope

L'create-scopeexemple suivant crée une étendue 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'delete-monitorexemple suivant supprime un moniteur nommé Demo dans votre compte.

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

Cette commande ne produit aucun résultat.

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

Suppression d'une portée

L'delete-scopeexemple suivant supprime la portée spécifiée.

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

Cette commande ne produit aucun résultat.

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

Obtenir des informations sur un moniteur

L'get-monitorexemple 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'get-query-results-workload-insights-top-contributors-dataexemple renvoie les données pour 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'get-query-results-workload-insights-top-contributorsexemple 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'get-query-status-monitor-top-contributorsexemple suivant montre l'état 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'get-query-status-workload-insights-top-contributors-dataexemple suivant montre l'état 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'get-query-results-workload-insights-top-contributorsexemple suivant montre l'état 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 Évaluez les flux réseau à l'aide d'informations sur la charge.

Voir les informations sur le périmètre

L'get-scopeexemple suivant affiche des informations sur une étendue, telles que le statut, 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.

Afficher la liste des moniteurs associés à un compte

L'list-monitorsexemple 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.

Afficher la liste des champs d'application d'un compte

L'list-scopesexemple suivant répertorie toutes les étendues 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 tags d'un moniteur

L'list-tags-for-resourceexemple 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 Marquer vos ressources Amazon CloudWatch .

Démarrage et arrêt de requêtes

Les sections suivantes fournissent des exemples de commandes CLI pour démarrer et arrêter des requêtes dans Network Flow Monitor.

start-query-monitor-top-contributeurs

L'start-query-monitor-top-contributorsexemple suivant lance 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 Évaluez les flux réseau à l'aide d'informations sur la charge.

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

L'start-query-workload-insights-top-contributors-dataexemple suivant lance 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 Évaluez les flux réseau à l'aide d'informations sur la charge.

start-query-workload-insights-meilleurs contributeurs

L'start-query-workload-insights-top-contributorsexemple suivant lance 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 Évaluez les flux réseau à l'aide d'informations sur la charge.

stop-query-monitor-top-contributeurs

L'stop-query-monitor-top-contributorsexemple 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 aucun résultat.

Pour de plus amples informations, veuillez consulter Évaluez les flux réseau à l'aide d'informations sur la charge.

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

Ce qui suit stop-query-workload-insights-top-contributors-data 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 aucun résultat.

Pour de plus amples informations, veuillez consulter Évaluez les flux réseau à l'aide d'informations sur la charge.

stop-query-workload-insights-meilleurs contributeurs

L'stop-query-workload-insights-top-contributorsexemple 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 aucun résultat.

Pour de plus amples informations, veuillez consulter Évaluez les flux réseau à l'aide d'informations sur la charge.

Marquer un moniteur

Ce qui suit tag-resource ajoute une balise 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 aucun résultat.

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

Supprimer une étiquette d'un moniteur

L'untag-resourceexemple suivant supprime une balise sur le 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 aucun résultat.

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

Mettre à jour un moniteur existant

L'update-monitorexemple 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.