创建监视器查看显示器详细信息创建范围删除监测仪删除范围获取有关监测仪的信息检索特定查询的数据查看范围信息查看账户的监测仪列表查看账户的范围列表查看监测仪的标签列表启动和停止查询标记监测仪从监测仪中移除标签更新现有监测仪

将 CLI 与网络流量监测仪结合使用的示例

本节包括将 Amazon Command Line Interface 与网络流量监测仪操作结合使用的示例。

开始之前，请确保您通过 Amazon 账户登录以使用 Amazon CLI，该账户可提供您想要用于监控网络流量的范围。有关将 API 操作与网络流量监测仪结合使用的更多信息，请参阅 Network Flow Monitor API Reference Guide。

创建监视器

要使用 Amazon CLI 创建监测仪，请使用 create-monitor 命令。以下示例在指定账户中创建了名为 demo 的监测仪。


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

输出：


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

有关更多信息，请参阅在 Network Flow Monitor 中创建监测仪。

查看显示器详细信息

要使用 Amazon CLI 查看有关监测仪的信息，请使用 get-monitor 命令。


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

输出：


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

创建范围

以下 create-scope 示例创建了一个范围，该范围是一组资源，网络流量监测仪将为这些资源生成网络流量指标。


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

输出：



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

有关更多信息，请参阅 Network Flow Monitor 的组件和功能。

删除监测仪

以下 delete-monitor 示例从您的账户中删除了名为 Demo 的监测仪。


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

此命令不生成任何输出。

有关更多信息，请参阅在 Network Flow Monitor 中删除监测仪。

删除范围

以下 delete-scope 示例删除了指定的范围。


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

此命令不生成任何输出。

有关更多信息，请参阅 Network Flow Monitor 的组件和功能。

获取有关监测仪的信息

以下 get-monitor 示例显示有关指定账户中名为 demo 的监测仪的信息。


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

输出：


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

有关更多信息，请参阅 Network Flow Monitor 的组件和功能。

检索特定查询的数据

以下部分提供了用于检索查询状态的示例 CLI 命令。

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

以下 get-query-results-workload-insights-top-contributors-data 示例返回了指定查询的数据。


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

输出：


{
        "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-contributors 示例返回指定查询的数据。


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

输出：


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

以下 get-query-status-monitor-top-contributors 示例显示指定账户中查询的当前状态。


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

输出：


{
        "status": "SUCCEEDED"
    }

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

以下 get-query-status-workload-insights-top-contributors-data 示例显示指定账户中查询的当前状态。


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

输出：


{
        "status": "SUCCEEDED"
    }

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

以下 get-query-results-workload-insights-top-contributors 示例显示指定账户中查询的当前状态。


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

输出：


{
        "status": "SUCCEEDED"
    }

有关更多信息，请参阅利用工作负载见解评估网络流。

查看范围信息

以下 get-scope 示例显示了有关范围的信息，例如状态、标签、名称和目标详细信息等。


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

输出：


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

有关更多信息，请参阅 Network Flow Monitor 的组件和功能。

查看账户的监测仪列表

以下 list-monitors 示例返回了指定账户中的所有监测仪。


aws networkflowmonitor list-monitors

输出：


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

有关更多信息，请参阅 Network Flow Monitor 的组件和功能。

查看账户的范围列表

以下 list-scopes 示例列出了指定账户中的所有范围。


aws networkflowmonitor list-scopes

输出：


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

有关更多信息，请参阅 Network Flow Monitor 的组件和功能。

以下 list-tags-for-resource 示例返回所有与指定资源关联的标签。


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

输出：


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

有关更多信息，请参阅标记 Amazon CloudWatch 资源。

启动和停止查询

以下部分提供了用于在网络流量监测仪中启动和停止查询的示例 CLI 命令。

start-query-monitor-top-contributors

以下 start-query-monitor-top-contributors 示例启动了查询，该查询返回查询 ID 以检索排名靠前的贡献者。


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

输出：


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

有关更多信息，请参阅利用工作负载见解评估网络流。

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

以下 start-query-workload-insights-top-contributors-data 示例启动了查询，该查询返回查询 ID 以检索排名靠前的贡献者。


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

输出：


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

有关更多信息，请参阅利用工作负载见解评估网络流。

start-query-workload-insights-top-contributors

以下 start-query-workload-insights-top-contributors 示例启动了查询，该查询返回查询 ID 以检索排名靠前的贡献者。


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

输出：


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

有关更多信息，请参阅利用工作负载见解评估网络流。

stop-query-monitor-top-contributors

以下 stop-query-monitor-top-contributors 示例停止指定账户中的查询。


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

此命令不生成任何输出。

有关更多信息，请参阅利用工作负载见解评估网络流。

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

以下 stop-query-workload-insights-top-contributors-data 示例停止了指定账户中的查询。


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

此命令不生成任何输出。

有关更多信息，请参阅利用工作负载见解评估网络流。

stop-query-workload-insights-top-contributors

以下 stop-query-workload-insights-top-contributors 示例停止指定账户中的查询。


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

此命令不生成任何输出。

有关更多信息，请参阅利用工作负载见解评估网络流。

标记监测仪

以下 tag-resource 示例向指定账户中的监测仪添加了标签。


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

此命令不生成任何输出。

有关更多信息，请参阅标记 Amazon CloudWatch 资源。

从监测仪中移除标签

以下 untag-resource 示例移除了指定账户中监测仪的标签。


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

此命令不生成任何输出。

有关更多信息，请参阅标记 Amazon CloudWatch 资源。

更新现有监测仪

以下 update-monitor 示例更新了指定账户中名为“Demo”的监测仪。


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"

输出：


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

有关更多信息，请参阅 Network Flow Monitor 的组件和功能。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

API 操作

安装代理