Menggunakan antarmuka kueri Amazon CloudWatch Internet Monitor

Opsi untuk memahami lebih lanjut tentang lalu lintas internet untuk AWS aplikasi Anda adalah dengan menggunakan antarmuka kueri Amazon CloudWatch Internet Monitor. Untuk menggunakan antarmuka kueri, buatlah sebuah kueri dengan filter data yang Anda pilih, lalu jalankan kueri untuk menampilkan subset data Monitor Internet Anda. Menjelajahi data yang ditampilkan kueri akan memberikan Anda wawasan tentang bagaimana aplikasi Anda berjalan di internet.

Anda dapat menanyakan dan menjelajahi semua metrik yang ditangkap Internet Monitor dengan monitor Anda, termasuk skor ketersediaan dan kinerja, byte yang ditransfer, waktu pulang-pergi, dan waktu ke byte pertama (). TTFB

Monitor Internet menggunakan antarmuka kueri untuk menyediakan data yang dapat Anda jelajahi di dasbor konsol Monitor Internet. Dengan menggunakan opsi penelusuran di dasbor — pada halaman Analisis atau halaman Optimalkan — Anda dapat melakukan kueri dan memfilter data internet untuk aplikasi Anda.

Jika Anda ingin lebih banyak fleksibilitas untuk menjelajahi dan memfilter data Anda daripada yang disediakan dasbor, Anda dapat menggunakan antarmuka kueri sendiri, dengan menggunakan API operasi Internet Monitor dengan AWS Command Line Interface atau dengan file AWS SDK. Bagian ini memperkenalkan jenis-jenis kueri yang dapat Anda gunakan dengan antarmuka kueri, dan filter yang dapat Anda tentukan untuk membuat satu subset data, untuk mendapatkan wawasan tentang lalu lintas internet untuk aplikasi Anda.

Cara menggunakan antarmuka kueri

Buatlah sebuah kueri dengan antarmuka kueri dengan memilih jenis kueri, kemudian tentukan nilai-nilai filter, untuk menampilkan subset tertentu yang diinginkan atas data berkas log Anda. Kemudian, Anda dapat mengerjakan subset data tersebut untuk memfilter dan mengurutkan lebih lanjut, membuat laporan, dan sebagainya.

Proses kueri bekerja seperti ini:

1. Saat Anda menjalankan sebuah kueri, Monitor Internet menampilkan query ID yang unik untuk kueri. Bagian ini menjelaskan jenis-jenis kueri yang tersedia, dan opsi untuk memfilter data dalam kueri. Untuk memahami cara kerjanya, Anda juga dapat meninjau bagian contoh kueri.

2. Anda menentukan ID kueri dengan nama monitor Anda dengan GetQueryResultsAPIoperasi untuk mengembalikan hasil data untuk kueri. Setiap jenis query menampilkan satu set bidang data yang berbeda. Untuk mempelajari selengkapnya, silakan lihat Mendapatkan hasil kueri.

Antarmuka kueri memberikan tiga jenis kueri berikut. Setiap jenis kueri menampilkan sekumpulan informasi yang berbeda tentang lalu lintas Anda dari berkas log, sebagaimana yang ditunjukkan.

• Pengukuran: Memberikan skor ketersediaan, skor kinerja, total lalu lintas, dan waktu pulang pergi, dengan interval 5 menit.

• Lokasi teratas: Memberikan skor ketersediaan, skor kinerja, lalu lintas total, dan waktu ke informasi byte (TTFB) pertama, untuk lokasi teratas dan ASN kombinasi yang Anda pantau, berdasarkan volume lalu lintas.

• Detail lokasi teratas: Menyediakan TTFB untuk Amazon CloudFront, konfigurasi Anda saat ini, dan EC2 konfigurasi Amazon berkinerja terbaik, dengan interval 1 jam.

• Saran lalu lintas keseluruhan: MenyediakanTTFB, menggunakan rata-rata tertimbang 30 hari, untuk semua lalu lintas di setiap AWS lokasi yang dipantau.

• Rincian saran lalu lintas keseluruhan: MenyediakanTTFB, menggunakan rata-rata tertimbang 30 hari, untuk setiap lokasi teratas, untuk lokasi yang diusulkan AWS .

Dengan masing-masing tipe kueri ini, Anda dapat memfilter data dengan lebih baik dengan menentukan satu atau beberapa dari kriteria berikut ini:

• AWS lokasi: Untuk AWS lokasi, Anda dapat menentukan CloudFront atau Wilayah AWS, sepertius-east-2,us-west-2, dan sebagainya.

• ASN: TentukanASN, yang biasanya merupakan layanan internet provide (ISP).

• Lokasi klien: Untuk lokasi, tentukan sebuah kota, metro, subdivisi, atau negara.

• Geo: Tentukan geo untuk beberapa kueri. Ini diperlukan untuk kueri-kueri yang menggunakan jenis kueri Top locations, tetapi tidak diizinkan untuk jenis kueri lainnya. Untuk memahami kapan harus menentukan geo parameter filter, silakan lihat bagian contoh kueri.

Operator yang dapat Anda gunakan untuk memfilter data Anda adalah EQUALS dan NOT_EQUALS. Untuk detail tentang parameter penyaringan, lihat FilterParameterAPIoperasi.

Untuk melihat detail tentang operasi antarmuka kueri, lihat API operasi berikut di Panduan API Referensi Monitor CloudWatch Internet Amazon:

• Untuk membuat dan menjalankan kueri, lihat StartQueryAPIoperasi.

• Untuk menghentikan kueri, lihat StopQueryAPIoperasinya.

• Untuk mengembalikan data kueri yang telah Anda buat, lihat GetQueryResultsAPIoperasinya.

• Untuk mengambil status kueri, lihat GetQueryStatusAPIoperasi.

Contoh kueri

Untuk membuat kueri yang dapat Anda gunakan untuk mengambil kumpulan data yang difilter dari file log monitor Anda, Anda menggunakan StartQueryAPIoperasi. Tentukan jenis kueri dan parameter filter untuk kueri tersebut. Kemudian, ketika Anda menggunakan API operasi antarmuka kueri Internet Monitor untuk mendapatkan hasil kueri menggunakan kueri, itu akan mengambil subset data Anda yang ingin Anda kerjakan.

Untuk mengilustrasikan cara kerja jenis kueri dan parameter filter, mari kita lihat beberapa contoh.

Contoh 1

Katakanlah Anda ingin mengambil semua data berkas log monitor Anda untuk negara tertentu, kecuali untuk satu kota. Contoh berikut ini menunjukkan parameter filter untuk kueri yang bisa Anda buat dengan operasi StartQuery untuk skenario ini.

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "MEASUREMENTS"
   FilterParameters: [
      {
       Field: "country",
       Operator: "EQUALS",
       Values: ["Germany"]
      },
      {
       Field: "city",
       Operator: "NOT_EQUALS",
       Values: ["Berlin"]
      },
    ]
}

Contoh 2

Contoh lainnya, katakanlah Anda ingin melihat lokasi teratas Anda berdasarkan area metropolitan. Anda dapat menggunakan contoh query berikut untuk skenario ini.

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "TOP_LOCATIONS"
   FilterParameters: [
      {
       Field: "geo",
       Operator: "EQUALS",
       Values: ["metro"]
      },
    ]
}

Contoh 3

Sekarang katakanlah Anda ingin melihat kombinasi jaringan kota teratas di area metro Los Angeles. Untuk melakukan hal itu, tentukan geo=city, kemudian atur metro ke Los Angeles. Sekarang kueri akan menampilkan jaringan kota teratas di area metro Los Angeles alih-alih jaringan metro teratas+ secara keseluruhan.

Berikut contoh kueri yang dapat Anda gunakan:

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "TOP_LOCATIONS"
   FilterParameters: [
      {
       Field: "geo",
       Operator: "EQUALS",
       Values: ["city"]
      },
      {
       Field: "metro",
       Operator: "EQUALS",
       Values: ["Los Angeles"]
      }
    ]
}

Contoh 4

Selanjutnya, katakanlah Anda ingin mengambil TTFB data untuk subdivisi tertentu (misalnya, negara bagian AS).

Berikut adalah contoh kueri untuk skenario ini.

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "TOP_LOCATION_DETAILS"
   FilterParameters: [
      {
       Field: "subdivision",
       Operator: "EQUALS",
       Values: ["California"]
      },
    ]
}

Contoh 5

Sekarang, katakanlah Anda ingin mengambil TTFB data untuk setiap lokasi di mana aplikasi Anda memiliki lalu lintas klien.

Berikut adalah contoh kueri untuk skenario ini.

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "OVERALL_TRAFFIC_SUGGESTIONS"
   FilterParameters: []
}

Results:
[us-east-1, 40, us-west-2, 30],
[us-east-1, 40, us-west-1, 35],
[us-east-1, 40, us-east-1, 44],
[us-east-1, 40, CloudFront, 22],
...
[us-east-2, 44, us-west-2, 30],
[us-east-2, 44, us-west-1, 35],
...

Contoh 6

Terakhir, katakanlah Anda ingin mengambil TTFB data untuk data baru Wilayah AWS tertentu.

Berikut adalah contoh kueri untuk skenario ini.

{
   MonitorName: "TestMonitor"
   StartTime: "2023-07-12T20:00:00Z"
   EndTime: "2023-07-12T21:00:00Z"
   QueryType: "OVERALL_TRAFFIC_SUGGESTIONS_DETAILS"
   FilterParameters: [
      {
       Field: "proposed_aws_location",
       Operator: "EQUALS",
       Values: ["us-west-2"]
      },
   ]
}

Results:
[San Jose, San Jose-Santa Clara, California, United States, 7922, us-east-1, 40, 350, 350, us-west-2, 45]
[San Jose, San Jose-Santa Clara, California, United States, 7922, us-west-1, 35, 450, 450, us-west-2, 45]

Mendapatkan hasil kueri

Setelah Anda menentukan kueri, Anda dapat mengembalikan serangkaian hasil dengan kueri dengan menjalankan API operasi Internet Monitor lainnya, GetQueryResults. Saat menjalankan GetQueryResults, tentukan ID kueri untuk kueri yang telah Anda tetapkan, bersama dengan nama monitor Anda. GetQueryResults akan mengambil data untuk kueri yang telah ditentukan ke dalam rangkaian hasil.

Saat Anda menjalankan sebuah kueri, pastikan kueri telah selesai berjalan sebelum Anda menggunakan GetQueryResults untuk melihat hasilnya. Anda dapat menentukan apakah kueri telah selesai dengan menggunakan GetQueryStatusAPIoperasi. Ketika Status atas kueri adalah SUCCEEDED, Anda dapat melanjutkan dengan meninjau hasilnya.

Saat kueri Anda selesai, Anda bisa menggunakan informasi berikut untuk membantu Anda meninjau hasilnya. Setiap jenis kueri yang Anda gunakan untuk membuat kueri harus menyertakan serangkaian bidang data yang unik dari berkas log, seperti yang dijelaskan dalam daftar berikut:

Pengukuran

Jenis kueri measurements menampilkan data berikut:

timestamp, availability, performance, bytes_in, bytes_out, rtt_p50, rtt_p90, rtt_p95

Lokasi teratas

Jenis kueri top locations mengelompokkan data berdasarkan lokasi, dan menyediakan data rata-rata selama periode waktu. Data yang ditampilkan termasuk hal-hal berikut:

aws_location, city, metro, subdivision, country, asn, availability, performance, bytes_in, bytes_out, current_fbl, best_ec2, best_ec2_region, best_cf_fbl

Perhatikan bahwa city, metro, dan subdivision hanya ditampilkan jika Anda memilih jenis lokasi untuk bidang geo tersebut. Bidang lokasi berikut ini ditampilkan, tergantung pada jenis lokasi yang Anda tentukan untuk geo:

city = city, metro, subdivision, country
metro = metro, subdivision, country
subdivision = subdivision, country
country = country

Detail lokasi teratas

Jenis kueri top locations details menampilkan data yang dikelompokkan jam demi jam. Kueri tersebut menampilkan data berikut:

timestamp, current_service, current_fbl, best_ec2_fbl, best_ec2_region, best_cf_fbl

Ketika Anda menjalankan GetQueryResults API operasi, Internet Monitor mengembalikan berikut ini dalam respons:

• Sebuah array string data yang berisikan hasil yang kueri tampilkan. Informasi dikembalikan dalam array yang selaras dengan Fields bidang, juga dikembalikan oleh panggilan. API Dengan menggunakan bidang Fields, Anda dapat mengurai informasi dari repositori Data dan kemudian memfilter lebih lanjut atau mengurutkannya untuk tujuan Anda.

• Sebuah bidang array terdiri dari bidang-bidang tempat kueri menampilkan data (pada respon bidang Data). Setiap item dalam array adalah pasangan nama-datatype, seperti availability_score-float.

Pemecahan Masalah

Jika kesalahan dikembalikan saat Anda menggunakan API operasi antarmuka kueri, verifikasi bahwa Anda memiliki izin yang diperlukan untuk menggunakan Amazon CloudWatch Internet Monitor. Secara spesifik, pastikan bahwa Anda memiliki izin berikut:

internetmonitor:StartQuery
internetmonitor:GetQueryStatus
internetmonitor:GetQueryResults
internetmonitor:StopQuery

Izin ini disertakan dalam AWS Identity and Access Management kebijakan yang disarankan untuk menggunakan dasbor Internet Monitor di konsol. Untuk informasi selengkapnya, lihat IAMizin untuk Amazon CloudWatch Internet Monitor.