如何创建数据视图以及如何查询StoreView - Simple Log Service

StoreView untuk Metricstore memungkinkan Anda melakukan kueri data lintas beberapa metricstore. Anda dapat mengkueri data dalam StoreView menggunakan PromQL, menghubungkan StoreView ke Grafana, serta mengambil informasi StoreView melalui API.

Prasyarat

Proyek dan metricstore telah dibuat. Untuk informasi selengkapnya, lihat Kelola proyek dan Kelola metricstore.

Buat StoreView dan asosiasikan metricstore

1. Buat StoreView untuk Metricstore

Login ke Konsol Simple Log Service. Di daftar Projects, klik proyek yang dituju.
Di panel navigasi sebelah kiri, pilih Data View > Time Series Data View. Di halaman StoreView, klik untuk membuat StoreView untuk Metricstore.
Di panel Create StoreView, masukkan Storeview Name, tambahkan metricstore yang diasosiasikan, lalu klik OK.
Penting
- Storeview untuk penyimpanan metrik harus berisi penyimpanan metrik dari proyek yang sama.
- StoreView untuk Metricstore mendukung kueri dan analisis lintas beberapa metricstore. Untuk memastikan hasil yang akurat, ikuti rekomendasi berikut:
  - Jangan mengasosiasikan metricstore yang memiliki deret waktu tumpang tindih dengan StoreView yang sama.
  - Jangan mengasosiasikan beberapa metricstore berskala besar untuk komputasi. Misalnya, hindari mengasosiasikan metricstore dengan jumlah shard lebih dari 64.
Atur Storeview Type ke Metric.

2. Kueri StoreView dengan PromQL

Catatan

Setelah Anda mengasosiasikan beberapa metricstore ke StoreView, hasil kueri dan analisis akan diagregasi dari semua metricstore yang diasosiasikan.
StoreView untuk Metricstore tidak mendukung SQL atau pemrosesan yang telah ditentukan sebelumnya. Masukkan pernyataan PromQL langsung di editor kueri. Mesin backend secara otomatis melakukan komputasi lintas semua metricstore yang diasosiasikan.

Di panel dataset di sebelah kiri, pilih dataset test. Di editor kueri, masukkan pernyataan PromQL cpu_count{}, lalu klik Run di pojok kanan atas. Grafik garis untuk metrik tersebut akan muncul di area hasil.

Hubungkan StoreView ke Grafana

Instal dan login ke Grafana. Di panel navigasi sebelah kiri, pilih Configuration > Data Sources.
Di tab Data Sources, klik Add data source. Lalu, pilih Prometheus dan klik Select.

Di tab Settings, konfigurasikan sumber data.

Parameter sumber data

Parameter	Deskripsi
Name	Masukkan nama kustom untuk sumber data. Contohnya: Prometheus-1.
HTTP	URL: URL StoreView di Simple Log Service, dengan format https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}. Ganti {sls-endpoint} dengan endpoint wilayah tempat proyek berada. Ganti {project} dan {storeview} dengan nama proyek dan StoreView Anda. Contohnya: https://sls-prometheus-test.cn-hangzhou.log.aliyuncs.com/prometheus/sls-prometheus-test/test. Catatan Untuk memastikan transmisi data yang aman, Anda harus menggunakan `https`. Whitelisted Cookies: Opsional. Menambahkan cookie ke daftar izin untuk permintaan.
Auth	Nyalakan sakelar Basic auth.
Basic Auth Details	User: ID AccessKey Akun Alibaba Cloud Anda. Password: Rahasia AccessKey Akun Alibaba Cloud Anda. Kami menyarankan agar Anda menggunakan pasangan Kunci Akses Pengguna RAM dengan izin read-only pada proyek tertentu. Untuk informasi selengkapnya, lihat Berikan izin read-only pada proyek tertentu.

Klik Save & Test.

StoreView HTTP API

Ikhtisar

Simple Log Service menyediakan beberapa API untuk mengkueri StoreView untuk Metricstore. API ini kompatibel dengan protokol Prometheus open-source dan mengikuti konvensi direktori /api/v1 yang sama. URL lengkapnya adalah https://{project}.{sls-endpoint}/prometheus/{project}/{storeview}/api/v1/.

Parameter	Wajib	Deskripsi
{project}	Ya	Nama proyek Simple Log Service. Untuk informasi selengkapnya, lihat Kelola proyek.
{sls-endpoint}	Ya	Endpoint wilayah tempat proyek berada.
{storeview}	Ya	Nama StoreView.

API kueri metrik

Instant queries

API Instant Queries mengkueri data 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-parameter tersebut.

Parameter	Wajib	Deskripsi
query	Ya	Ekspresi PromQL. Untuk informasi selengkapnya, lihat Sintaks PromQL.
time	Tidak	Timestamp evaluasi kueri, dalam bentuk Unix timestamp dalam satuan detik. Nilai default adalah waktu saat ini.
timeout	Tidak	Timeout kueri. Nilai dapat ditentukan dalam satuan detik atau menggunakan format durasi waktu seperti `1s`, `2m`, atau `3h` (misalnya, `timeout=10s`). Untuk informasi selengkapnya, lihat Time Durations.
lookback_delta	Tidak	Menyesuaikan flag Prometheus `query.lookback-delta` untuk kueri. Parameter ini menentukan periode lookback maksimum untuk menemukan titik data selama evaluasi PromQL. Nilainya harus menggunakan format durasi waktu, misalnya `lookback_delta=1m`. Nilai default di database deret waktu Layanan Log adalah `3m`. Untuk informasi selengkapnya, lihat Time Durations.

Range queries

API Range Queries mengkueri data metrik 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-parameter tersebut.

Parameter	Wajib	Deskripsi
query	Ya	Ekspresi PromQL. Untuk informasi selengkapnya, lihat Sintaks PromQL.
start	Tidak	Awal rentang kueri, dalam bentuk Unix timestamp dalam satuan detik.
end	Tidak	Akhir rentang kueri, dalam bentuk Unix timestamp dalam satuan detik.
step	Tidak	Langkah resolusi kueri, dalam satuan detik. Anda juga dapat menggunakan format durasi waktu seperti `1s`, `2m`, atau `3h` (misalnya, `step=2m`). Untuk informasi selengkapnya, lihat Time Durations.
timeout	Tidak	Timeout kueri. Anda dapat menentukan nilai dalam satuan detik atau menggunakan format durasi waktu seperti `1s`, `2m`, dan `3h`. Misalnya, `timeout=10s`. Untuk informasi selengkapnya, lihat Time Durations.
lookback_delta	Tidak	Menyesuaikan flag Prometheus `query.lookback-delta` untuk kueri. Parameter ini menentukan periode lookback maksimum untuk menemukan titik data selama evaluasi PromQL. Nilainya harus menggunakan format durasi waktu, misalnya `lookback_delta=1m`. Nilai default di database deret waktu Layanan Log adalah `3m`. Untuk informasi selengkapnya, lihat Time Durations.

Untuk contoh konfigurasi, lihat API kueri metrik.

API kueri metadata

Query series

API Query Series mengembalikan semua deret waktu dan label yang sesuai dengan satu set pemilih label dalam rentang waktu tertentu.

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-parameter tersebut.

Parameter	Wajib	Deskripsi
match[]	Ya	Pemilih deret yang akan dicocokkan. Contohnya: `match[]=up{instance="demo.*"}`. Anda dapat menentukan satu atau beberapa parameter `match[]`.
start	Tidak	Awal rentang kueri, dalam bentuk Unix timestamp dalam satuan detik. Nilai default adalah 5 menit sebelum waktu saat ini.
end	Tidak	Akhir rentang kueri, dalam bentuk Unix timestamp dalam satuan detik. Nilai default adalah waktu saat ini. Penting Jika Anda menentukan nilai kustom untuk parameter start dan end, API akan membatasi kueri ke interval 5 menit sebelum waktu end. Rentang kueri efektifnya adalah [`end` - 5 menit, `end`].
x-sls-disable-range-limit	Tidak	Jika diatur ke `true`, parameter ini melewati batas kueri 5 menit dan menggunakan rentang penuh yang ditentukan oleh `start` dan `end`.
forceMaxMetaTimeRangeSeconds	Tidak	Menentukan rentang waktu kueri maksimum dalam satuan detik. Jika durasi antara `end` dan `start` melebihi nilai ini, rentang kueri akan disesuaikan menjadi (`end` - forceMaxMetaTimeRangeSeconds, `end`). Kami menyarankan untuk menyertakan parameter ini guna memastikan kueri yang efisien.

Query label names

Mengkueri semua nama label yang memenuhi kondisi tertentu dalam rentang waktu.

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-parameter tersebut.

Parameter	Wajib	Deskripsi
match[]	Ya	Pemilih deret yang akan dicocokkan. Contohnya: `match[]=up{instance="demo.*"}`. Anda dapat menentukan nol, satu, atau beberapa parameter `match[]`.
start	Tidak	Awal rentang kueri, dalam bentuk Unix timestamp dalam satuan detik. Nilai default adalah 5 menit sebelum waktu saat ini.
end	Tidak	Akhir rentang kueri, dalam bentuk Unix timestamp dalam satuan detik. Nilai default adalah waktu saat ini. Penting Jika Anda menentukan nilai kustom untuk parameter start dan end, API akan membatasi kueri ke interval 5 menit sebelum waktu end. Rentang kueri efektifnya adalah [`end` - 5 menit, `end`].
x-sls-disable-range-limit	Tidak	Jika diatur ke `true`, parameter ini melewati batas kueri 5 menit dan menggunakan rentang penuh yang ditentukan oleh `start` dan `end`.
forceMaxMetaTimeRangeSeconds	Tidak	Menentukan rentang waktu kueri maksimum dalam satuan detik. Jika durasi antara `end` dan `start` melebihi nilai ini, rentang kueri akan disesuaikan menjadi (`end` - forceMaxMetaTimeRangeSeconds, `end`). Kami menyarankan untuk menyertakan parameter ini guna memastikan kueri yang efisien.

Query label values

API Query Label Values mengembalikan semua nilai untuk label tertentu yang sesuai dengan pemilih yang ditentukan dalam rentang waktu.

Penting

Anda harus mengganti <label_name> di URL API dengan nama label tertentu.

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

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Wajib	Deskripsi
match[]	Ya	Pemilih deret yang akan dicocokkan. Contohnya: `match[]=up{instance="demo.*"}`. Anda dapat menentukan satu atau beberapa parameter `match[]`.
start	Tidak	Awal rentang kueri, dalam bentuk Unix timestamp dalam satuan detik. Nilai default adalah 5 menit sebelum waktu saat ini.
end	Tidak	Akhir rentang kueri, dalam bentuk Unix timestamp dalam satuan detik. Nilai default adalah waktu saat ini. Penting Jika Anda menentukan nilai kustom untuk parameter start dan end, API akan membatasi kueri ke interval 5 menit sebelum waktu end. Rentang kueri efektifnya adalah [`end` - 5 menit, `end`].
x-sls-disable-range-limit	Tidak	Jika diatur ke `true`, parameter ini melewati batas kueri 5 menit dan menggunakan rentang penuh yang ditentukan oleh `start` dan `end`.
forceMaxMetaTimeRangeSeconds	Tidak	Menentukan rentang waktu kueri maksimum dalam satuan detik. Jika durasi antara `end` dan `start` melebihi nilai ini, rentang kueri akan disesuaikan menjadi (`end` - forceMaxMetaTimeRangeSeconds, `end`). Kami menyarankan untuk menyertakan parameter ini guna memastikan kueri yang efisien.

Untuk contoh konfigurasi, lihat API kueri metadata.

Langkah selanjutnya

Kueri StoreView

Di panel navigasi sebelah kiri, pilih Data View > Time Series Data View untuk melihat StoreView yang telah Anda buat.

Perbarui StoreView

Di daftar StoreView, arahkan kursor ke StoreView yang dituju, klik ikon , lalu klik Modify.
Di panel Modify StoreView, Anda dapat memodifikasi metricstore yang diasosiasikan, lalu klik OK.

Setiap store mencakup daftar drop-down project dan metricstore. Anda dapat mengklik + STORE untuk mengasosiasikan lebih banyak metricstore.

Hapus StoreView

Di daftar StoreView, arahkan kursor ke StoreView yang dituju, klik ikon , lalu klik Delete.

Dokumentasi terkait

Untuk sintaks kueri dan analisis data deret waktu, lihat Sintaks kueri dan analisis data deret waktu.
Simple Log Service menyediakan API untuk mengkueri metrik deret waktu dan menulis data metrik ke metricstore. Untuk informasi selengkapnya, lihat Referensi API HTTP Metricstore.