Contoh menggunakan CLI dengan Network Flow Monitor

Bagian ini mencakup contoh untuk menggunakan operasi AWS Command Line Interface dengan Network Flow Monitor.

Sebelum memulai, pastikan Anda masuk untuk menggunakan AWS akun AWS CLI dengan yang menyediakan cakupan yang ingin Anda gunakan untuk memantau arus jaringan. Untuk informasi selengkapnya tentang penggunaan tindakan API dengan Network Flow Monitor, lihat Panduan Referensi API Network Flow Monitor.

Membuat sebuah monitor

Untuk membuat monitor dengan AWS CLI, gunakan create-monitor perintah. Contoh berikut membuat monitor bernama demo dalam akun yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Buat monitor di Network Flow Monitor.

Melihat detail monitor

Untuk melihat informasi tentang monitor dengan AWS CLI, gunakan get-monitor perintah.

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

Output:

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

Buat ruang lingkup

create-scopeContoh berikut menciptakan ruang lingkup yang merupakan kumpulan sumber daya yang Network Flow Monitor akan menghasilkan metrik lalu lintas jaringan.

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

Output:

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Network Flow Monitor.

Menghapus sebuah monitor

delete-monitorContoh berikut menghapus monitor bernama Demo di akun Anda.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Hapus monitor di Network Flow Monitor.

Hapus ruang lingkup

delete-scopeContoh berikut menghapus lingkup yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Komponen dan fitur Network Flow Monitor.

Dapatkan informasi tentang monitor

get-monitorContoh berikut menampilkan informasi tentang monitor yang disebutkan demo dalam akun yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Network Flow Monitor.

Mengambil data pada kueri tertentu

Bagian berikut memberikan contoh perintah CLI untuk mengambil status query.

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

get-query-results-workload-insights-top-contributors-dataContoh mengembalikan data untuk query tertentu.

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

Output:

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

get-query-results-workload-insights-top-contributorsContoh berikut mengembalikan data untuk query tertentu.

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

Output:

{
        "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-kontributor teratas

get-query-status-monitor-top-contributorsContoh berikut menampilkan status kueri saat ini di akun yang ditentukan.

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

Output:

{
        "status": "SUCCEEDED"
    }

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

get-query-status-workload-insights-top-contributors-dataContoh berikut menampilkan status kueri saat ini di akun yang ditentukan.

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

Output:

{
        "status": "SUCCEEDED"
    }

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

get-query-results-workload-insights-top-contributorsContoh berikut menampilkan status kueri saat ini di akun yang ditentukan.

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

Output:

{
        "status": "SUCCEEDED"
    }

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja.

Lihat informasi ruang lingkup

get-scopeContoh berikut menampilkan informasi tentang lingkup, seperti status, tag, nama, dan rincian target.

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

Output:

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Network Flow Monitor.

Lihat daftar monitor untuk akun

list-monitorsContoh berikut mengembalikan semua monitor di akun yang ditentukan.

aws networkflowmonitor list-monitors

Output:

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Network Flow Monitor.

Lihat daftar cakupan untuk akun

list-scopesContoh berikut mencantumkan semua cakupan dalam akun yang ditentukan.

aws networkflowmonitor list-scopes

Output:

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Network Flow Monitor.

Lihat daftar tag untuk monitor

list-tags-for-resourceContoh berikut mengembalikan semua tag yang terkait dengan sumber daya yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Menandai sumber daya Amazon CloudWatch Anda.

Memulai dan menghentikan kueri

Bagian berikut memberikan contoh perintah CLI untuk memulai dan menghentikan kueri di Network Flow Monitor.

start-query-monitor-top-kontributor

start-query-monitor-top-contributorsContoh berikut memulai query yang mengembalikan QueryID untuk mengambil kontributor teratas.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja.

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

start-query-workload-insights-top-contributors-dataContoh berikut memulai query yang mengembalikan QueryID untuk mengambil kontributor teratas.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja.

start-query-workload-insights-kontributor teratas

start-query-workload-insights-top-contributorsContoh berikut memulai query yang mengembalikan QueryID untuk mengambil kontributor teratas.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja.

stop-query-monitor-top-kontributor

stop-query-monitor-top-contributorsContoh berikut menghentikan kueri di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja.

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

Berikut ini stop-query-workload-insights-top-contributors-data menghentikan kueri di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja.

stop-query-workload-insights-kontributor teratas

stop-query-workload-insights-top-contributorsContoh berikut menghentikan kueri di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengevaluasi alur jaringan dengan wawasan beban kerja.

Menandai monitor

Berikut ini tag-resource menambahkan tag ke monitor di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai sumber daya Amazon CloudWatch Anda.

Hapus tag dari monitor

untag-resourceContoh berikut menghapus tag ke monitor di akun yang ditentukan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai sumber daya Amazon CloudWatch Anda.

Perbarui monitor yang ada

update-monitorContoh berikut memperbarui monitor bernama ``Demo`` di akun yang ditentukan.

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"

Output:

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

Untuk informasi selengkapnya, lihat Komponen dan fitur Network Flow Monitor.