Simple Log Service:Sintaks kueri dan analisis data metrik

Contoh SQL. Untuk informasi selengkapnya, lihat kasus penggunaan SQL.

• Kueri dan analisis semua data.

  *| SELECT * FROM "my_metric_store.prom" WHERE __name__ != '' 

• Untuk metrik http_request_count, kueri data dengan nilai domain pada bidang __labels__ sebesar www.example.com dan peroleh jumlah nilai pada bidang __value__.

  *| SELECT sum(__value__) FROM "my_metric_store.prom" WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com' 

• Untuk metrik http_request_count, kueri data dengan nilai domain pada bidang __labels__ sebesar www.example.com, agregasikan nilai bidang __value__ per jam, dan peroleh jumlah nilainya.

  *| SELECT sum(__value__),date_trunc('hour', __time_nano__/1000000) as t
  FROM "my_metric_store.prom" 
  WHERE __name__='http_request_count' and element_at(__labels__, 'domain')='www.example.com'
  GROUP BY t
  ORDER BY t DESC

Detail sintaks SQL:

• Sintaks SQL untuk data metrik mengikuti sintaks SQL untuk data log (Sintaks analisis). Saat mengkueri data metrik dengan SQL, nama tabel dalam klausa FROM harus dalam format {metrics_store_name}.prom. {metrics_store_name} menunjukkan nama Metricstore yang Anda buat.

  Catatan

  Bungkus nama tabel dalam tanda kutip ganda ("").

• Gunakan fungsi element_at() untuk mendapatkan nilai kunci dari bidang __labels__. Contoh: element_at(__labels__, 'key').

• Untuk informasi selengkapnya tentang skema tabel, lihat Format encoding.

Setiap fungsi PromQL mengembalikan sebuah tabel, mirip dengan user-defined table-valued function (UDTF).

• Skema tabel yang dikembalikan oleh promql_query(string) dan promql_query_range(string, string):

  Bidang	Jenis bidang	Deskripsi
  metric	varchar	Nama metrik. Dapat kosong jika kueri mencakup klausa GROUP BY.
  labels	map<varchar, varchar>	Label dalam bentuk peta pasangan kunci-nilai.
  time	bigint	Waktu.
  value	double	Nilai pada titik waktu tertentu.

  Contoh kueri:

  • Fungsi promql_query(string)

    Masukkan *| select promql_query('up') from metrics di editor kueri dan klik Search & Analyze. Hasil kueri dikembalikan dalam tabel dengan empat kolom: time, metric, labels, dan value, yang menampilkan nilai metrik up dari setiap instans.

  • Fungsi promql_query_range(string, string)

    Jalankan pernyataan SQL select promql_query_range('up', '30s') from metrics untuk mengkueri data rentang metrik PromQL up dengan langkah 30s. Hasil kueri ditampilkan dalam tabel yang menunjukkan data deret waktu.

• Skema tabel yang dikembalikan oleh promql_labels(), promql_labels(string), promql_label_values(string), dan promql_label_values(string, string):

  Bidang	Jenis bidang	Deskripsi
  label	varchar	Kunci label

  Contoh kueri:

  • Fungsi promql_labels()

    *| select promql_labels() from metrics. Hasil kueri mengembalikan kolom label yang berisi lima nama label: code, instance, job, le, dan method.

  • Fungsi promql_labels(string)

    Sebagai contoh, jalankan kueri *| select promql_labels('up') from metrics untuk mengkueri semua nama label metrik up. Hasilnya mencakup __name__, instance, dan job.

  • Fungsi promql_label_values(string)

    Sebagai contoh, jalankan kueri *| select promql_label_values('instance') from metrics. Kolom label dalam hasil kueri mengembalikan tiga alamat instans: demo.promlabs.com:10000, demo.promlabs.com:10001, dan demo.promlabs.com:10002.

  • Fungsi promql_label_values(string, string)

    Contoh kueri: *| select promql_label_values('up{demo!="a"}','instance') from metrics. Hasil kueri mengembalikan kolom label dengan tiga baris: demo.promlabs.com:10000, demo.promlabs.com:10001, dan demo.promlabs.com:10002.

• Skema tabel yang dikembalikan oleh promql_series(string):

  Bidang	Jenis bidang	Deskripsi
  series	map<varchar, varchar>	Deret waktu.

  Contoh kueri:

  Sebagai contoh, jalankan kueri *| select promql_series('up') from metrics. Kolom series dalam hasil berisi tiga baris yang masing-masing sesuai dengan demo.promlabs.com:10001, demo.promlabs.com:10000, dan demo.promlabs.com:10002. Setiap baris merupakan peta yang berisi bidang instance, __name__ (nilai: up), dan job (nilai: demo).