Gunakan antarmuka kueri Internet Monitor - Amazon CloudWatch
Cara menggunakan antarmuka kueriContoh kueriMendapatkan hasil kueriPemecahan Masalah

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

Gunakan antarmuka kueri Internet Monitor

Opsi untuk memahami lebih lanjut tentang lalu lintas internet untuk AWS aplikasi Anda adalah dengan menggunakan antarmuka kueri 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 menjalankan kueri dan menjelajahi semua metrik yang ditangkap Monitor Internet dengan monitor Anda, termasuk skor ketersediaan dan skor performa, byte tertransfer, tempo pulang pergi, dan waktu untuk mendapat 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 operasi Internet Monitor API dengan AWS Command Line Interface atau dengan 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 operasi GetQueryResultsAPI untuk mengembalikan hasil data kueri. Setiap jenis query menampilkan satu set bidang data yang berbeda. Untuk mempelajari selengkapnya, silakan lihat Mendapatkan hasil kueri.

Antarmuka query menyediakan jenis query 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 informasi time to first byte (TTFB), untuk lokasi teratas dan kombinasi ASN 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: Menyediakan TTFB, menggunakan rata-rata tertimbang 30 hari, untuk semua lalu lintas di setiap AWS lokasi yang dipantau.

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

  • Saran perutean: Memberikan prediksi waktu pulang pergi rata-rata (RTT) dari awalan IP menuju AWS lokasi untuk resolver DNS. RTT dihitung pada interval satu jam, selama periode satu jam.

Anda dapat memfilter data lebih banyak dengan menggunakan kriteria tertentu. Dengan sebagian besar jenis kueri, kecuali saran perutean, Anda dapat memfilter dengan menentukan satu atau beberapa kriteria berikut:

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

  • ASN: Tentukan nomor sistem otonom (ASN) dari resolver DNS (biasanya, ISP), misalnya, 4225.

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

  • AWS Lokasi yang diusulkan: Tentukan Wilayah AWS, sepertius-east-2, atau Zona AWS Lokal. Anda dapat menggunakan filter ini dengan jenis kueri detail saran lalu lintas keseluruhan.

  • 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.

Untuk jenis kueri saran perutean, Anda dapat memfilter data lebih lanjut dengan menentukan satu atau beberapa kriteria berikut:

  • AWS Lokasi saat ini: Tentukan Wilayah AWS, sepertius-east-2.

  • AWS Lokasi yang diusulkan: Tentukan Wilayah AWS, sepertius-east-2, atau Zona AWS Lokal.

  • IPv4 awalan: Tentukan IPv4 awalan dalam format standar, mirip dengan. 192.0.2.0/24

  • Monitor ARN: Tentukan ARN untuk monitor tertentu.

  • DNS resolver IP: Tentukan alamat IP dari DNS resolver.

  • DNS resolver ISP: Tentukan nama resolver DNS (biasanya ISP), misalnya,. Cloudflare

  • DNS resolver ASN: Tentukan nomor sistem otonom (ASN) dari resolver DNS, misalnya, 4225.

Operator yang dapat Anda gunakan untuk memfilter data Anda adalah EQUALS dan NOT_EQUALS. Untuk detail tentang parameter pemfilteran, lihat operasi FilterParameterAPI.

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

  • Untuk membuat dan menjalankan kueri, lihat operasi StartQueryAPI.

  • Untuk menghentikan kueri, lihat operasi StopQueryAPI.

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

  • Untuk mengambil status kueri, lihat operasi GetQueryStatusAPI.

Contoh kueri

Untuk membuat kueri yang dapat Anda gunakan untuk mengambil kumpulan data yang difilter dari file log monitor, Anda menggunakan operasi StartQueryAPI. Tentukan jenis kueri dan parameter filter untuk kueri tersebut. Kemudian, ketika Anda menggunakan operasi API antarmuka kueri di Monitor Internet untuk mendapatkan hasil kueri setelah menggunakan kueri, maka Anda mendapatkan subset data 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 data TTFB 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 data TTFB 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

Katakanlah Anda ingin mengambil data TTFB untuk data baru tertentu. Wilayah AWS

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]

Contoh 7

Contoh terakhir adalah mengambil data untuk resolver DNS tertentu.

Berikut adalah contoh kueri untuk skenario ini.

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

Results:
[162.158.180.245, 13335, Cloudflare, [5.4.0.0/14], us-east-2, 200.0, us-east-1, 160.0]
[162.158.180.243, 13313, Cloudflare, [5.4.0.0/10], us-east-2, 150.0, us-east-1, 125.0]

Mendapatkan hasil kueri

Setelah menentukan kueri, Anda dapat mengembalikan serangkaian hasil dengan kueri dengan menjalankan operasi Internet Monitor API 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 operasi GetQueryStatusAPI. 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

Saran lalu lintas keseluruhan

Jenis kueri overall traffic suggestions menampilkan data yang dikelompokkan jam demi jam. Kueri tersebut menampilkan data berikut:

current_aws_location, proposed_aws_location, average_fbl, traffic, optimized_traffic_excluding_cf, optimized_traffic_including_cf

Rincian saran lalu lintas secara keseluruhan

Jenis kueri overall traffic suggestions details menampilkan data yang dikelompokkan jam demi jam. Kueri tersebut menampilkan data berikut:

aws_location, city, metro, subdivision, country, asn, traffic, current_aws_location, fbl_data

Saran perutean

Jenis kueri routing suggestions menampilkan data yang dikelompokkan jam demi jam. Kueri tersebut menampilkan data berikut:

dns_resolver_ip, dns_resolver_asn, dns_resolver_isp, ipv4_prefixes, current_aws_location, current_latency, proposed_aws_location, proposed_latency

Saat Anda menjalankan operasi API GetQueryResults, Monitor Internet akan menampilkan respons sebagai berikut:

  • Sebuah array string data yang berisikan hasil yang kueri tampilkan. Informasi ditampilkan dalam array yang selaras dengan bidang Fields, juga ditampilkan 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 operasi API antarmuka kueri, verifikasi bahwa Anda memiliki izin yang diperlukan untuk menggunakan 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 AWS kebijakan terkelola untuk Internet Monitor.