Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Contoh menggunakan CLI dengan Internet Monitor
Bagian ini mencakup contoh untuk menggunakan operasi AWS Command Line Interface With Internet Monitor.
Sebelum memulai, pastikan Anda masuk untuk menggunakan AWS akun yang sama yang memiliki Amazon VPC VPCs, Network Load Balancers, distribusi Amazon, atau direktori CloudFront WorkSpaces Amazon yang ingin Anda pantau. AWS CLI 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 penggunaan tindakan API dengan Internet Monitor, lihat Panduan Referensi API Monitor Internet.
Topik
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 dan ASNs, biasanya penyedia layanan internet atau ISPs, 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 namun menetapkan batas maksimum jaringan kota sebanyak 10.000, menambahkan sumber daya VPC, dan memilih untuk menerbitkan pengukuran internet ke Amazon S3.
catatan
Internet Monitor menerbitkan ke CloudWatch Log pengukuran internet setiap lima menit untuk 500 jaringan kota teratas (lokasi klien dan ASNs, biasanya penyedia layanan internet atau ISPs) 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 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 peristiwa kondisi kesehatan spesifik dengan CLI, jalankan perintah get-health-event dengan nama monitor Anda dan ID peristiwa kondisi 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 dengan CLI, jalankan perintah list-monitors.
aws internetmonitor list-monitors
{ "Monitors": [ { "MonitorName": "TestMonitor", "ProcessingStatus": "OK", "Status": "ACTIVE" } ], "NextToken": " zase12" }
Mengedit monitor
Untuk memperbarui informasi tentang monitor Anda dengan menggunakan CLI, gunakan perintah update-monitor dan tentukan nama monitor yang akan 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 dengan CLI dengan menggunakan perintah delete-monitor. 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 monitor INACTIVE, maka Anda dapat menggunakan CLI untuk menjalankan perintah delete-monitor untuk menghapus monitor. Respons untuk panggilan delete-monitor yang berhasil adalah kosong.
aws internetmonitor delete-monitor --monitor-name "TestMonitor"
{}
