Contoh menggunakan CLI dengan Amazon CloudWatch Internet Monitor - Amazon CloudWatch
Membuat sebuah monitorMelihat detail monitorMembuat daftar peristiwa kondisi kesehatanLihat peristiwa kondisi kesehatan spesifikTampilkan daftar monitorMengedit monitorHapus monitor

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh menggunakan CLI dengan Amazon CloudWatch Internet Monitor

Bagian ini mencakup contoh untuk menggunakan operasi AWS Command Line Interface dengan Amazon CloudWatch Internet Monitor.

Sebelum memulai, pastikan Anda masuk untuk menggunakan AWS akun yang sama AWS CLI dengan Amazon Virtual Private Clouds (VPCs), Network Load Balancers, CloudFront distribusi Amazon, atau WorkSpaces direktori Amazon yang ingin Anda pantau. Monitor Internet tidak mendukung pengaksesan sumber daya di seluruh akun. Untuk informasi selengkapnya tentang penggunaan AWS CLI, lihat Referensi AWS CLI Perintah. Untuk informasi selengkapnya tentang menggunakan API tindakan dengan Amazon CloudWatch Internet Monitor, lihat Panduan API Referensi Monitor CloudWatch Internet Amazon.

Membuat sebuah monitor

Saat Anda membuat monitor di Monitor Internet, beri nama dan kaitkan sumber daya dengan monitor untuk menunjukkan di mana lalu lintas internet aplikasi Anda berada. Anda tentukan persentase lalu lintas yang merincikan berapa banyak lalu lintas aplikasi Anda yang terpantau. Itu juga menentukan jumlah jaringan kota, yaitu lokasi klien danASNs, biasanya penyedia layanan internet atauISPs, yang dipantau. Anda juga dapat memilih untuk menetapkan batasan jumlah maksimum jaringan kota untuk memantau sumber daya aplikasi Anda, untuk membantu mengontrol tagihan Anda. Untuk informasi selengkapnya, lihat Pilih batas maksimum jaringan kota.

Terakhir, Anda dapat memilih apakah Anda ingin menerbitkan semua pengukuran internet untuk aplikasi Anda ke Amazon S3. Pengukuran internet untuk 500 jaringan kota teratas (berdasarkan volume lalu lintas) secara otomatis dipublikasikan ke CloudWatch Log oleh Internet Monitor, tetapi Anda dapat memilih untuk mempublikasikan semua pengukuran ke S3 juga.

Untuk membuat monitor dengan AWS CLI, Anda menggunakan create-monitor perintah. Perintah berikut membuat monitor yang memantau 100% lalu lintas tetapi menetapkan batas jaringan kota maksimum 10.000, menambahkan VPC sumber daya, dan memilih untuk mempublikasikan pengukuran internet ke Amazon S3.

catatan

Internet Monitor menerbitkan ke CloudWatch Log pengukuran internet setiap lima menit untuk 500 jaringan kota teratas (lokasi klien danASNs, biasanya penyedia layanan internet atauISPs) yang mengirim lalu lintas ke setiap monitor. Secara opsional, Anda dapat memilih untuk menerbitkan pengukuran internet untuk semua jaringan kota yang dipantau (hingga 500.000 batas layanan jaringan kota) ke bucket Amazon S3. Untuk informasi selengkapnya, lihat Publikasikan pengukuran internet ke Amazon S3 di Amazon CloudWatch Internet Monitor.

aws internetmonitor --create-monitor monitor-name "TestMonitor" \
				--traffic-percentage-to-monitor 100 \
				--max-city-networks-to-monitor 10000 \
				--resources "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889" \
				--internet-measurements-log-delivery S3Config="{BucketName=amzn-s3-demo-bucket,LogDeliveryStatus=ENABLED}"

{
"Arn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
 "Status": "ACTIVE"
}
catatan

Anda tidak dapat mengubah nama monitor.

Melihat detail monitor

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

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

Membuat daftar peristiwa kondisi kesehatan

Ketika performa menurun untuk lalu lintas internet aplikasi Anda, Monitor Internet membuat peristiwa kondisi kesehatan di monitor Anda. Untuk melihat daftar peristiwa kesehatan saat ini dengan AWS CLI, gunakan list-health-events perintah

aws internetmonitor list-health-events --monitor-name "TestMonitor"
{
    "HealthEvents": [
        {
            "EventId": "2022-06-20T01-05-05Z/latency", 
            "Status": "RESOLVED", 
            "EndedAt": "2022-06-20T01:15:14Z", 
            "ServiceLocations": [
                {
                    "Name": "us-east-1"
                }
            ], 
            "PercentOfTotalTrafficImpacted": 1.21, 
            "ClientLocations": [
                {
                    "City": "Lockport", 
                    "PercentOfClientLocationImpacted": 60.370000000000005, 
                    "PercentOfTotalTraffic": 2.01, 
                    "Country": "United States", 
                    "Longitude": -78.6913, 
                    "AutonomousSystemNumber": 26101, 
                    "Latitude": 43.1721, 
                    "Subdivision": "New York", 
                    "NetworkName": "YAHOO-BF1"
                }
            ], 
            "StartedAt": "2022-06-20T01:05:05Z", 
            "ImpactType": "PERFORMANCE", 
            "EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-05-05Z/latency"
        }, 
        {
            "EventId": "2022-06-20T01-17-56Z/latency", 
            "Status": "RESOLVED", 
            "EndedAt": "2022-06-20T01:30:23Z", 
            "ServiceLocations": [
                {
                    "Name": "us-east-1"
                }
            ], 
            "PercentOfTotalTrafficImpacted": 1.29, 
            "ClientLocations": [
                {
                    "City": "Toronto", 
                    "PercentOfClientLocationImpacted": 75.32, 
                    "PercentOfTotalTraffic": 1.05, 
                    "Country": "Canada", 
                    "Longitude": -79.3623, 
                    "AutonomousSystemNumber": 14061, 
                    "Latitude": 43.6547, 
                    "Subdivision": "Ontario", 
                    "CausedBy": {
                        "Status": "ACTIVE", 
                        "Networks": [
                            {
                                "AutonomousSystemNumber": 16509, 
                                "NetworkName": "Amazon.com"
                            }
                        ], 
                        "NetworkEventType": "AWS"
                    }, 
                    "NetworkName": "DIGITALOCEAN-ASN"
                }, 
                {
                    "City": "Lockport", 
                    "PercentOfClientLocationImpacted": 22.91, 
                    "PercentOfTotalTraffic": 2.01, 
                    "Country": "United States", 
                    "Longitude": -78.6913, 
                    "AutonomousSystemNumber": 26101, 
                    "Latitude": 43.1721, 
                    "Subdivision": "New York", 
                    "NetworkName": "YAHOO-BF1"
                }, 
                {
                    "City": "Hangzhou", 
                    "PercentOfClientLocationImpacted": 2.88, 
                    "PercentOfTotalTraffic": 0.7799999999999999, 
                    "Country": "China", 
                    "Longitude": 120.1612, 
                    "AutonomousSystemNumber": 37963, 
                    "Latitude": 30.2994, 
                    "Subdivision": "Zhejiang", 
                    "NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
                }
            ], 
            "StartedAt": "2022-06-20T01:17:56Z", 
            "ImpactType": "PERFORMANCE", 
            "EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-17-56Z/latency"
        }, 
        {
            "EventId": "2022-06-20T01-34-20Z/latency", 
            "Status": "RESOLVED", 
            "EndedAt": "2022-06-20T01:35:04Z", 
            "ServiceLocations": [
                {
                    "Name": "us-east-1"
                }
            ], 
            "PercentOfTotalTrafficImpacted": 1.15, 
            "ClientLocations": [
                {
                    "City": "Lockport", 
                    "PercentOfClientLocationImpacted": 39.45, 
                    "PercentOfTotalTraffic": 2.01, 
                    "Country": "United States", 
                    "Longitude": -78.6913, 
                    "AutonomousSystemNumber": 26101, 
                    "Latitude": 43.1721, 
                    "Subdivision": "New York", 
                    "NetworkName": "YAHOO-BF1"
                }, 
                {
                    "City": "Toronto", 
                    "PercentOfClientLocationImpacted": 29.770000000000003, 
                    "PercentOfTotalTraffic": 1.05, 
                    "Country": "Canada", 
                    "Longitude": -79.3623, 
                    "AutonomousSystemNumber": 14061, 
                    "Latitude": 43.6547, 
                    "Subdivision": "Ontario", 
                    "CausedBy": {
                        "Status": "ACTIVE", 
                        "Networks": [
                            {
                                "AutonomousSystemNumber": 16509, 
                                "NetworkName": "Amazon.com"
                            }
                        ], 
                        "NetworkEventType": "AWS"
                    }, 
                    "NetworkName": "DIGITALOCEAN-ASN"
                },
                {
                    "City": "Hangzhou", 
                    "PercentOfClientLocationImpacted": 2.88, 
                    "PercentOfTotalTraffic": 0.7799999999999999, 
                    "Country": "China", 
                    "Longitude": 120.1612, 
                    "AutonomousSystemNumber": 37963, 
                    "Latitude": 30.2994, 
                    "Subdivision": "Zhejiang", 
                    "NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
                }
            ], 
            "StartedAt": "2022-06-20T01:34:20Z", 
            "ImpactType": "PERFORMANCE", 
            "EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-34-20Z/latency"
        }
    ]
}

Lihat peristiwa kondisi kesehatan spesifik

Untuk melihat informasi lebih rinci tentang acara kesehatan tertentu denganCLI, jalankan get-health-event perintah dengan nama monitor Anda dan ID acara kesehatan.

aws internetmonitor get-monitor --monitor-name "TestMonitor" --event-id "health-event/TestMonitor/2021-06-03T01:02:03Z/latency" 
{
    "EventId": "2022-06-20T01-34-20Z/latency", 
    "Status": "RESOLVED", 
    "EndedAt": "2022-06-20T01:35:04Z", 
    "ServiceLocations": [
        {
            "Name": "us-east-1"
        }
    ], 
    "EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-34-20Z/latency", 
    "LastUpdatedAt": "2022-06-20T01:35:04Z", 
    "ClientLocations": [
        {
            "City": "Lockport", 
            "PercentOfClientLocationImpacted": 39.45, 
            "PercentOfTotalTraffic": 2.01, 
            "Country": "United States", 
            "Longitude": -78.6913, 
            "AutonomousSystemNumber": 26101, 
            "Latitude": 43.1721, 
            "Subdivision": "New York", 
            "NetworkName": "YAHOO-BF1"
        }, 
        {
            "City": "Toronto", 
            "PercentOfClientLocationImpacted": 29.770000000000003, 
            "PercentOfTotalTraffic": 1.05, 
            "Country": "Canada", 
            "Longitude": -79.3623, 
            "AutonomousSystemNumber": 14061, 
            "Latitude": 43.6547, 
            "Subdivision": "Ontario", 
            "CausedBy": {
                "Status": "ACTIVE", 
                "Networks": [
                    {
                        "AutonomousSystemNumber": 16509, 
                        "NetworkName": "Amazon.com"
                    }
                ], 
                "NetworkEventType": "AWS"
            }, 
            "NetworkName": "DIGITALOCEAN-ASN"
        }, 
        {
            "City": "Shenzhen", 
            "PercentOfClientLocationImpacted": 4.07, 
            "PercentOfTotalTraffic": 0.61, 
            "Country": "China", 
            "Longitude": 114.0683, 
            "AutonomousSystemNumber": 37963, 
            "Latitude": 22.5455, 
            "Subdivision": "Guangdong", 
            "NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
        }, 
        {
            "City": "Hangzhou", 
            "PercentOfClientLocationImpacted": 2.88, 
            "PercentOfTotalTraffic": 0.7799999999999999, 
            "Country": "China", 
            "Longitude": 120.1612, 
            "AutonomousSystemNumber": 37963, 
            "Latitude": 30.2994, 
            "Subdivision": "Zhejiang", 
            "NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
        }
    ], 
    "StartedAt": "2022-06-20T01:34:20Z", 
    "ImpactType": "PERFORMANCE", 
    "PercentOfTotalTrafficImpacted": 1.15
}

Tampilkan daftar monitor

Untuk melihat daftar semua monitor di akun Anda denganCLI, jalankan list-monitors perintah.

aws internetmonitor list-monitors
{
    "Monitors": [
        {
            "MonitorName": "TestMonitor",
            "ProcessingStatus": "OK",
            "Status": "ACTIVE"
        }
    ],
    "NextToken": " zase12"
}

Mengedit monitor

Untuk memperbarui informasi tentang monitor Anda dengan menggunakanCLI, gunakan update-monitor perintah dan tentukan nama monitor untuk diperbarui. Misalnya, Anda dapat memperbarui persentase lalu lintas untuk memantau, batas jumlah maksimum jaringan kota untuk memantau, menambah atau menghapus sumber daya yang digunakan Internet Monitor untuk memantau lalu lintas, dan mengubah status monitor dari ACTIVE keINACTIVE, atau sebaliknya. Perhatikan bahwa Anda tidak dapat mengubah nama monitor.

Respons untuk call update-monitor menampilkan hanya MonitorArn dan Status.

Contoh berikut menunjukkan cara penggunaan perintah update-monitor untuk mengubah jumlah maksimum jaringan kota untuk dipantau menjadi 50000:

aws internetmonitor update-monitor --monitor-name "TestMonitor" --max-city-networks-to-monitor 50000
{
    "MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
    "Status": " ACTIVE "
}

Contoh berikut menunjukkan cara menambahkan dan menghapus sumber daya:

aws internetmonitor update-monitor --monitor-name "TestMonitor" \
				--resources-to-add "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889" \
				--resources-to-remove "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-2222444455556666"
{
    "MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
    "Status": "ACTIVE"
}

Contoh berikut menunjukkan cara penggunaan perintah update-monitor untuk mengubah jumlah status monitor menjadi INACTIVE:

aws internetmonitor update-monitor --monitor-name "TestMonitor" --status "INACTIVE"
{
    "MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
    "Status": "INACTIVE"
}

Hapus monitor

Anda dapat menghapus monitor CLI dengan menggunakan delete-monitor perintah. Pertama, Anda harus mengatur monitor menjadi tidak aktif. Untuk melakukan itu, gunakan perintah update-monitor untuk mengubah status menjadi INACTIVE. Konfirmasikan bahwa monitor tidak aktif dengan menggunakan perintah get-monitor dan periksa statusnya.

Ketika status monitorINACTIVE, maka Anda dapat menggunakan CLI untuk menjalankan delete-monitor perintah untuk menghapus monitor. Respons untuk panggilan delete-monitor yang berhasil adalah kosong.

aws internetmonitor delete-monitor --monitor-name "TestMonitor"
{}