

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
<a name="CloudWatch-IM-get-started-CLI"></a>

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](https://docs.aws.amazon.com/cli/latest/index.html). Untuk informasi selengkapnya tentang penggunaan tindakan API dengan Internet Monitor, lihat [Panduan Referensi API Monitor Internet](https://docs.aws.amazon.com/internet-monitor/latest/api/Welcome.html).

**Topics**
+ [Membuat sebuah monitor](#CloudWatch-IM-get-started-CLI-create-mon)
+ [Melihat detail monitor](#CloudWatch-IM-get-started-CLI-mon-details)
+ [Membuat daftar peristiwa kondisi kesehatan](#CloudWatch-IM-get-started-CLI-list-events)
+ [Lihat peristiwa kondisi kesehatan spesifik](#CloudWatch-IM-get-started-CLI-view-event-specific)
+ [Tampilkan daftar monitor](#CloudWatch-IM-get-started-CLI-monitor-list)
+ [Mengedit monitor](#CloudWatch-IM-get-started-CLI-edit-monitor)
+ [Hapus monitor](#CloudWatch-IM-get-started-CLI-delete-monitor)

## Membuat sebuah monitor
<a name="CloudWatch-IM-get-started-CLI-create-mon"></a>

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](IMCityNetworksMaximum.md).

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](CloudWatch-IM-get-started.Publish-to-S3.md).

```
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
<a name="CloudWatch-IM-get-started-CLI-mon-details"></a>

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
<a name="CloudWatch-IM-get-started-CLI-list-events"></a>

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
<a name="CloudWatch-IM-get-started-CLI-view-event-specific"></a>

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
<a name="CloudWatch-IM-get-started-CLI-monitor-list"></a>

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
<a name="CloudWatch-IM-get-started-CLI-edit-monitor"></a>

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` ke`INACTIVE`, 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
<a name="CloudWatch-IM-get-started-CLI-delete-monitor"></a>

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

```
{}
```