Cara menghubungkan Tablestore ke Grafana - Tablestore

Setelah menghubungkan Tablestore ke Grafana, gunakan Grafana untuk memvisualisasikan data di Tablestore.

Prasyarat

Anda telah melakukan operasi berikut di Konsol Resource Access Management (RAM):
Anda telah membuat Pengguna RAM dan memberikan izin kepada Pengguna RAM untuk mengelola Tablestore (AliyunOTSFullAccess).
Peringatan
Jika pasangan AccessKey dari akun Alibaba Cloud Anda bocor, sumber daya cloud Anda berisiko. Kami sarankan menggunakan pasangan AccessKey dari Pengguna RAM untuk melakukan operasi. Ini mengurangi risiko keamanan jika pasangan AccessKey bocor.
Anda telah melakukan operasi berikut di Konsol Tablestore:
- Anda telah mengaktifkan Tablestore dan membuat instans.
- Anda telah membuat tabel data dan tabel deret waktu.
- Anda telah membuat pemetaan untuk tabel dan pemetaan untuk model multi-nilai.
Anda telah menginstal Grafana open source versi 8.0.0 atau lebih baru. Topik ini menggunakan Grafana v10.4.2 sebagai contoh. Untuk informasi lebih lanjut, lihat dokumentasi resmi Grafana.

Informasi latar belakang

Grafana adalah platform visualisasi dan analitik open source yang mendukung kueri data dan visualisasi untuk berbagai sumber data seperti Prometheus, Graphite, OpenTSDB, InfluxDB, Elasticsearch, MySQL, dan PostgreSQL. Untuk informasi lebih lanjut, lihat dokumentasi resmi Grafana.

Setelah menghubungkan Tablestore ke Grafana, gunakan Grafana untuk menghasilkan panel dasbor berdasarkan data tabel dan menampilkan data secara real-time.

Catatan penggunaan

Gunakan Grafana untuk memvisualisasikan data Tablestore di wilayah berikut: Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Beijing), Tiongkok (Zhangjiakou), Tiongkok (Shenzhen), dan Singapura.

Langkah 1: Instal plug-in Tablestore

Windows

Unduh paket plug-in Grafana untuk Tablestore.
Ekstrak paket tersebut dan pindahkan file plug-in ke direktori plugins-bundled instalasi Grafana Anda.
Modifikasi file konfigurasi Grafana.
1. Gunakan editor teks untuk membuka file konfigurasi defaults.ini di direktori conf.
2. Di bagian [plugins] file konfigurasi, atur parameter allow_loading_unsigned_plugins.
```
allow_loading_unsigned_plugins = aliyun-tablestore-grafana-datasource
```
Di Task Manager, mulai ulang proses grafana-server.exe.

Mac/Linux

Jalankan perintah berikut untuk mengunduh paket plug-in Grafana untuk Tablestore.

wget https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20220527/ygdf/tablestore-grafana-plugin-1.0.0.zip

Ekstrak paket tersebut ke direktori plug-in Grafana.
Jalankan perintah yang sesuai dengan metode instalasi Grafana Anda.
- Jika Anda menginstal Grafana dari Yellowdog Updater, Modified (YUM) repository atau paket RPM Package Manager (RPM) (Linux saja): unzip tablestore-grafana-plugin-1.0.0.zip -d /var/lib/grafana/plugins
- Jika Anda menginstal Grafana dari file .zip: unzip tablestore-grafana-plugin-1.0.0.zip -d {PATH_TO}/grafana-{VERSION}/data/plugins
  Catatan
  Dalam perintah, {PATH_TO}/grafana-{VERSION} menentukan jalur instalasi Grafana, dan {VERSION} menentukan nomor versi Grafana.
Modifikasi file konfigurasi Grafana.
1. Buka file konfigurasi.
  - Jika Anda menginstal Grafana dari YUM repository atau paket RPM (Linux saja): /etc/grafana/grafana.ini
  - Jika Anda menginstal Grafana dari file .zip: {PATH_TO}/grafana-{VERSION}/conf/defaults.ini
    Catatan
    Dalam jalur tersebut, {PATH_TO}/grafana-{VERSION} menentukan jalur instalasi Grafana, dan {VERSION} menentukan nomor versi Grafana.
2. Di bagian [plugins] file konfigurasi, atur parameter allow_loading_unsigned_plugins.
```
allow_loading_unsigned_plugins = aliyun-tablestore-grafana-datasource
```
Mulai ulang Grafana.
1. Jalankan perintah kill untuk menghentikan proses Grafana.
2. Jalankan perintah yang sesuai dengan metode instalasi Anda untuk memulai Grafana.
  - Jika Anda menginstal Grafana dari YUM repository atau paket RPM (Linux saja): systemctl restart grafana-server
  - Jika Anda menginstal Grafana dari file .zip: ./bin/grafana-server web

Langkah 2: Konfigurasikan sumber data

Masuk ke Grafana.
1. Di browser, masukkan http://<x.x.x.x>:3000/ untuk membuka halaman masuk Grafana.
  Catatan
  <x.x.x.x> menentukan alamat IP server tempat Grafana diterapkan. Sebagai contoh, jika Grafana diinstal di lingkungan Windows, alamat masuknya adalah http://localhost:3000.
2. Masukkan Email atau nama pengguna dan Kata sandi Anda, lalu klik Log in.
  Catatan
  Nama pengguna dan kata sandi default keduanya adalah admin. Saat Anda masuk untuk pertama kali, Anda akan diminta untuk mengubah kata sandi.
Di halaman utama Grafana, klik ikon di sudut kiri atas.
Di panel navigasi di sebelah kiri, pilih Connections > Data sources.
Di halaman Data sources, klik + Add new data source.
Di halaman Add data source, di bagian Lainnya, klik aliyun-tablestore-grafana-datasource.

Di halaman Settings, konfigurasikan parameter seperti yang dijelaskan dalam tabel berikut.

Parameter	Contoh	Deskripsi
Nama	aliyun-tablestore-grafana-datasource	Nama sumber data. Anda dapat memasukkan nama kustom. Nilai defaultnya adalah aliyun-tablestore-grafana-datasource.
Endpoint	https://myinstance.cn-hangzhou.ots.aliyuncs.com	Endpoint dari instans Tablestore. Masukkan endpoint dari instans yang ingin Anda akses. Untuk informasi lebih lanjut, lihat Endpoint.
Instans	myinstance	Nama instans Tablestore.
AccessId	************************	ID AccessKey dari akun Alibaba Cloud atau Pengguna RAM yang memiliki izin untuk mengakses Tablestore.
AccessKey	********************************	Rahasia AccessKey dari akun Alibaba Cloud atau Pengguna RAM yang memiliki izin untuk mengakses Tablestore.

Klik Save & test.
Jika koneksi berhasil, pesan Data source is working akan ditampilkan.

Langkah 3: Buat panel dasbor

Di halaman utama Grafana, klik ikon di sudut kiri atas.
Di panel navigasi di sebelah kiri, klik Dashboards.
Di halaman Dashboards, klik New lalu pilih New dashboard.
Di halaman New dashboard, klik + Add visualization.
Di kotak dialog Select data source, pilih sumber data Tablestore yang telah dikonfigurasi.

Di halaman Edit, konfigurasikan kondisi kueri di bagian Query.

Tabel berikut menjelaskan parameter.

Parameter	Contoh	Deskripsi
Kueri	`SELECT * FROM your_table WHERE $__unixMicroTimeRangeFilter(_time)AND _m_name = "your_measurement" AND tag_value_at(_tags, "your_tag")="your_tag_value"LIMIT 1000`	Pernyataan kueri SQL. Untuk informasi lebih lanjut, lihat Kueri data. Penting Dalam klausa WHERE, Anda harus menggunakan makro yang telah ditentukan sebelumnya untuk menyaring data berdasarkan rentang waktu, seperti `$__unixMicroTimeRangeFilter` dalam contoh. Untuk melihat lebih banyak makro waktu, klik "Tampilkan Bantuan" di halaman konfigurasi. Jika Anda ingin menampilkan data dalam grafik deret waktu, kueri harus mengembalikan kolom waktu yang direpresentasikan oleh timestamp numerik. Anda juga harus mengonfigurasi nama kolom waktu.
Format Sebagai	Timeseries	Format hasil. Nilai valid: Timeseries (Default): Grafik deret waktu standar. FlowGraph: Grafik multidimensi. Tabel: Tabel standar.
Kolom Waktu	_time	Nama kolom waktu dalam data yang dikembalikan. Kolom waktu digunakan sebagai sumbu x dari grafik deret waktu. Parameter ini tersedia saat Anda mengatur Format Sebagai menjadi Timeseries atau FlowGraph.
Kolom Agregasi	_field_name#:#_double_value	Mengonversi beberapa baris data satu kolom pada titik waktu yang sama menjadi satu baris data multi-kolom. Ini berguna untuk mengonversi data model nilai tunggal dari kueri SQL deret waktu Tablestore menjadi data model multi-nilai. Parameter ini tersedia saat Anda mengatur Format Sebagai menjadi FlowGraph. Formatnya adalah `<Kolom nama titik data>#:#<Kolom nilai>`.

Klik Run SQL untuk mengeksekusi pernyataan SQL dan kemudian melihat serta men-debug data.
Konfigurasikan dan simpan panel dasbor.
1. Di panel kanan, atur nama, tipe, dan gaya tampilan grafik pemantauan.
2. Di sudut kanan atas, klik Apply.
3. Di sudut kanan atas, klik Save. Di kotak dialog Save dashboard, atur parameter Judul, Deskripsi, dan Folder, lalu klik Save.

Langkah 4: Lihat data pemantauan

Di halaman utama Grafana, klik ikon di sudut kiri atas.
Di panel navigasi di sebelah kiri, pilih Dashboards. Klik dasbor di folder tujuan untuk melihat semua grafik pemantauannya.