Jalankan Kueri PromQL Cross-Metricstore dengan Storeview - Simple Log Service

Storeview untuk Metricstore memungkinkan Anda melakukan kueri JOIN pada log lintas metricstores. Topik ini menjelaskan cara menggunakan pernyataan PromQL untuk menanyakan data dalam Storeview, menghubungkan Storeview ke Grafana, dan memanggil operasi API untuk mendapatkan informasi Storeview.

Prasyarat

Proyek dan metricstores telah dibuat. Untuk informasi lebih lanjut, lihat Mengelola proyek dan Mengelola metricstore.

Buat Storeview untuk Metricstore dan asosiasikan metricstores

1. Buat Storeview untuk Metricstore

Masuk ke Konsol Layanan Log Sederhana. Di bagian Projects, klik proyek yang ingin Anda kelola.
Di panel navigasi di sebelah kiri, pilih Storeview > Storeview for Metricstore. Pada halaman yang muncul, klik ikon untuk membuat Storeview untuk Metricstore.
Di panel Buat Storeview, tentukan parameter Storeview Name, tambahkan Metricstores yang ingin Anda asosiasikan dengan Storeview, lalu klik OK.
Penting
- Storeview harus berisi Metricstore dari proyek yang sama.
- Storeview untuk Metricstore memungkinkan Anda melakukan kueri JOIN dan analisis pada log lintas metricstores. Untuk memastikan akurasi hasil kueri dan analisis, perhatikan hal-hal berikut:
  - Kami sarankan agar Anda tidak mengasosiasikan metricstores yang memiliki garis waktu duplikat dengan Storeview yang sama.
  - Kami sarankan agar Anda tidak mengasosiasikan beberapa metricstores yang menyimpan sejumlah besar data untuk melakukan perhitungan. Contohnya, jumlah shard dalam metricstore melebihi 64.

2. Gunakan pernyataan PromQL untuk menanyakan Storeview

Catatan

Setelah Anda mengasosiasikan beberapa metricstores dengan Storeview untuk Metricstore, Anda dapat melihat hasil kueri dan analisis lintas beberapa metricstores.
Storeview untuk Metricstore tidak mendukung pernyataan SQL dan pemrosesan yang telah ditentukan sebelumnya. Anda dapat langsung memasukkan pernyataan PromQL di kotak pencarian. Mesin komputasi backend secara otomatis melakukan perhitungan lintas beberapa metricstores. Untuk informasi lebih lanjut, lihat PromQL.

Hubungkan Storeview untuk Metricstore ke Grafana

Instal dan masuk ke Grafana. Untuk informasi lebih lanjut, lihat Instal Grafana. Di panel navigasi di sebelah kiri, pilih Configuration > Data Sources.
Pada tab Data Sources, klik Add data source. Pilih Prometheus dan klik Select.

Pada tab Settings, konfigurasikan parameter. Tabel berikut menjelaskan parameter:

Parameter

Parameter	Deskripsi
Nama	Tentukan nama untuk sumber data berdasarkan kebutuhan bisnis Anda. Contoh: Prometheus-1.
HTTP	URL: Masukkan URL Storeview dalam format https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}. Ganti parameter {sls-enpoint} dengan titik akhir wilayah tempat proyek Layanan Log Sederhana berada. Ganti parameter {project} dan {storeview} dengan nama proyek dan nama Storeview sesuai kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Titik Akhir. Contoh: https://sls-prometheus-test.cn-hangzhou.log.aliyuncs.com/prometheus/sls-prometheus-test/test. Catatan Untuk memastikan keamanan transmisi, Anda harus menggunakan `https`. Whitelisted Cookies: Tambahkan daftar putih. Parameter ini opsional.
Auth	Aktifkan Basic auth.
Detail Auth Dasar	User: Masukkan ID AccessKey akun Alibaba Cloud Anda. Password: Masukkan Rahasia AccessKey yang sesuai dengan ID AccessKey. Kami sarankan agar Anda menggunakan pasangan AccessKey dari Pengguna Resource Access Management (RAM) yang hanya memiliki izin baca saja pada proyek Layanan Log Sederhana. Untuk informasi lebih lanjut, lihat Izin baca saja pada proyek.

Klik Save & Test.

API HTTP Storeview

Ikhtisar

Layanan Log Sederhana menyediakan beberapa operasi API yang dapat Anda gunakan untuk menanyakan Storeview untuk Metricstore. Operasi API tersebut kompatibel dengan protokol Prometheus open source. Operasi API yang disediakan oleh Prometheus dan operasi API terkait Storeview yang disediakan oleh Layanan Log Sederhana disimpan di direktori /api/v1. Anda dapat menggunakan URL berikut untuk memanggil operasi API terkait Storeview yang disediakan oleh Layanan Log Sederhana: https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/. Untuk informasi lebih lanjut, lihat API HTTP. Tabel berikut menjelaskan parameter:

Parameter	Diperlukan	Deskripsi
{project}	Ya	Nama proyek Layanan Log Sederhana. Untuk informasi lebih lanjut, lihat Mengelola proyek.
{sls-endpoint}	Ya	Titik akhir wilayah tempat proyek Layanan Log Sederhana berada. Untuk informasi lebih lanjut, lihat Titik Akhir.
{storeview}	Ya	Storeview yang Anda buat.

Operasi API untuk menanyakan metrik deret waktu

API Kueri Instan

Operasi API Kueri Instan digunakan untuk menanyakan metrik pada titik waktu tertentu.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query

Tabel berikut menjelaskan parameter:

Variabel	Diperlukan	Deskripsi
query	Ya	Pernyataan PromQL. Untuk informasi lebih lanjut, lihat Sintaks PromQL.
time	Tidak	Titik waktu untuk ditanyakan. Nilainya adalah timestamp UNIX yang akurat hingga detik. Nilai default adalah waktu saat ini.
timeout	Tidak	Periode timeout untuk kueri. Satuan: detik. Anda dapat menentukan periode timeout dalam format 1s, 2m, 3h, atau 4d. Nilai 1s berarti 1 detik, nilai 2m berarti 2 menit, nilai 3h berarti 3 jam, dan nilai 4d berarti 4 hari. Contoh: timeout=10s. Untuk informasi lebih lanjut, lihat Durasi Waktu.
lookback_delta	Tidak	Periode lookback maksimum saat Anda memanggil operasi API untuk mengidentifikasi metrik selama perhitungan PromQL. Nilai default 3m digunakan dalam Metricstore Layanan Log Sederhana. Anda dapat menggunakan variabel ini untuk menentukan nilai kustom untuk parameter flag query.lookback-delta. Nilai ini hanya valid untuk kueri saat ini. Nilai tersebut harus mengikuti format durasi waktu. Contoh: lookback_delta=1m. Untuk informasi lebih lanjut, lihat Durasi Waktu.

API Kueri Rentang

Operasi API Kueri Rentang digunakan untuk menanyakan metrik pada beberapa titik waktu dalam rentang waktu tertentu.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query_range
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/query_range

Tabel berikut menjelaskan parameter:

Variabel	Diperlukan	Deskripsi
query	Ya	Pernyataan PromQL. Untuk informasi lebih lanjut, lihat Sintaks PromQL.
start	Tidak	Awal rentang waktu untuk ditanyakan. Nilainya adalah timestamp UNIX yang akurat hingga detik.
end	Tidak	Akhir rentang waktu untuk ditanyakan. Nilainya adalah timestamp UNIX yang akurat hingga detik.
step	Tidak	Interval antara kueri. Satuan: detik. Anda dapat menentukan periode timeout dalam format 1s, 2m, 3h, atau 4d. Nilai 1s berarti 1 detik, nilai 2m berarti 2 menit, nilai 3h berarti 3 jam, dan nilai 4d berarti 4 hari. Contoh: step=2m. Untuk informasi lebih lanjut, lihat Durasi Waktu.
timeout	Tidak	Periode timeout untuk kueri. Satuan: detik. Anda dapat menentukan periode timeout dalam format 1s, 2m, 3h, atau 4d. Nilai 1s berarti 1 detik, nilai 2m berarti 2 menit, nilai 3h berarti 3 jam, dan nilai 4d berarti 4 hari. Contoh: timeout=10s. Untuk informasi lebih lanjut, lihat Durasi Waktu.
lookback_delta	Tidak	Periode lookback maksimum saat Anda memanggil operasi API untuk mengidentifikasi metrik selama perhitungan PromQL. Nilai default 3m digunakan dalam Metricstore Layanan Log Sederhana. Anda dapat menggunakan variabel ini untuk menentukan nilai kustom untuk parameter flag query.lookback-delta. Nilai ini hanya valid untuk kueri saat ini. Nilai tersebut harus mengikuti format durasi waktu. Contoh: lookback_delta=1m. Untuk informasi lebih lanjut, lihat Durasi Waktu.

Untuk informasi lebih lanjut, lihat Operasi API untuk kueri metrik.

Operasi API untuk kueri metadata

API Kueri Seri

Operasi API Kueri Seri digunakan untuk menanyakan semua Storeview yang memenuhi kondisi tertentu dalam periode waktu tertentu dan pasangan numerik berbasis label dari Storeview tersebut.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/series
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/series

Tabel berikut menjelaskan parameter:

Variabel	Diperlukan	Deskripsi
match[]	Ya	Kondisi filter. Contoh: match[]=up{instance="demo.*"}. Anda dapat menentukan satu atau lebih kondisi.
start	Tidak	Awal rentang waktu untuk ditanyakan. Nilainya adalah timestamp UNIX yang akurat hingga detik. Nilai default adalah 5 menit sebelum waktu saat ini.
end	Tidak	Akhir rentang waktu untuk ditanyakan. Nilainya adalah timestamp UNIX yang akurat hingga detik. Nilai default adalah waktu saat ini. Penting Jika Anda menentukan nilai untuk variabel start dan end, Anda dapat memanggil operasi ini untuk menanyakan hanya data yang dihasilkan dalam 5 menit sebelum waktu yang ditentukan oleh variabel end.

API Kueri Nama Label

Operasi API Kueri Nama Label digunakan untuk menanyakan semua nama label yang memenuhi kondisi tertentu dalam periode waktu tertentu.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/labels
POST https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/labels

Tabel berikut menjelaskan parameter:

Variabel	Diperlukan	Deskripsi
match[]	Ya	Kondisi filter. Contoh: match[]=up{instance="demo.*"}. Anda dapat menentukan satu atau lebih kondisi. Anda juga dapat membiarkan variabel kosong.
start	Tidak	Awal rentang waktu untuk ditanyakan. Nilainya adalah timestamp UNIX yang akurat hingga detik. Nilai default adalah 5 menit sebelum waktu saat ini.
end	Tidak	Akhir rentang waktu untuk ditanyakan. Nilainya adalah timestamp UNIX yang akurat hingga detik. Nilai default adalah waktu saat ini. Penting Jika Anda menentukan nilai untuk variabel start dan end, Anda dapat memanggil operasi ini untuk menanyakan hanya data yang dihasilkan dalam 5 menit sebelum waktu yang ditentukan oleh variabel end.

API Kueri Nilai Label

Operasi API Kueri Nilai Label digunakan untuk menanyakan semua nilai label untuk nama label tertentu yang memenuhi kondisi tertentu dalam periode waktu tertentu.

Penting

Ganti parameter <label_name> dalam URL operasi API Kueri Nilai Label dengan nama label yang diperlukan.

GET https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/label/<label_name>/values

Tabel berikut menjelaskan parameter:

Variabel	Diperlukan	Deskripsi
match[]	Ya	Kondisi filter. Contoh: match[]=up{instance="demo.*"}. Anda dapat menentukan satu atau lebih kondisi.
start	Tidak	Awal rentang waktu untuk ditanyakan. Nilainya adalah timestamp UNIX yang akurat hingga detik. Nilai default adalah 5 menit sebelum waktu saat ini.
end	Tidak	Akhir rentang waktu untuk ditanyakan. Nilainya adalah timestamp UNIX yang akurat hingga detik. Nilai default adalah waktu saat ini. Penting Jika Anda menentukan nilai untuk variabel start dan end, Anda dapat memanggil operasi ini untuk menanyakan hanya data yang dihasilkan dalam 5 menit sebelum waktu yang ditentukan oleh variabel end.

Untuk informasi lebih lanjut, lihat Operasi API untuk kueri metadata.

Apa yang harus dilakukan selanjutnya

Menanyakan Storeview untuk Metricstore

Di panel navigasi di sebelah kiri, pilih Storeview > Storeview for Metricstore. Di sini Anda dapat melihat Storeview yang telah dibuat.

Memodifikasi Storeview untuk Metricstore

Dalam daftar Storeview, arahkan pointer ke Storeview yang diinginkan, lalu pilih > Modify.
Pada panel Update Storeview, modifikasi Storeview, lalu klik OK.

Menghapus Storeview untuk Metricstore

Dalam daftar Storeview, arahkan pointer ke Storeview yang diinginkan, lalu pilih > Delete.

Referensi

Layanan Log Sederhana mendukung sintaks untuk kueri dan analisis pada data deret waktu. Untuk informasi lebih lanjut, lihat Sintaks kueri dan analisis pada data metrik.
Layanan Log Sederhana menyediakan beberapa API untuk menanyakan metrik deret waktu atau menulis data metrik ke metricstores. Untuk informasi lebih lanjut, lihat Detail API HTTP terkait metricstore.