全部产品
Search
文档中心

Tablestore:Hubungkan ke Grafana

更新时间:Mar 05, 2026

Setelah menghubungkan Tablestore ke Grafana, Anda dapat menggunakan Grafana untuk memvisualisasikan data Tablestore.

Prasyarat

Informasi latar belakang

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

Setelah menghubungkan Tablestore ke Grafana, Anda dapat membuat panel dasbor berdasarkan data tabel Tablestore dan menampilkannya secara real time.

Catatan penggunaan

Wilayah yang mendukung fitur visualisasi Grafana bergantung pada model data yang digunakan.

  • Model tabel lebar: mendukung semua wilayah.

  • Model deret waktu: mendukung Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Beijing), Tiongkok (Zhangjiakou), Tiongkok (Ulanqab), Tiongkok (Shenzhen), Tiongkok (Chengdu), Tiongkok (Hong Kong), Jepang (Tokyo), Singapura, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Jerman (Frankfurt), Inggris (London), AS (Silicon Valley), AS (Virginia), dan SAU (Riyadh - Partner Region).

Langkah 1: Instal plugin Tablestore

Windows

  1. Unduh paket plugin Grafana Tablestore.

  2. Ekstrak paket plugin Grafana Tablestore dan pindahkan isinya ke direktori data/plugins dalam instalasi Grafana Anda.

  3. Modifikasi file konfigurasi Grafana.

    1. Buka file konfigurasi defaults.ini di direktori conf plugin Grafana dengan editor teks.

    2. Pada bagian [plugins] file konfigurasi, atur parameter allow_loading_unsigned_plugins.

      allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
  4. Restart proses grafana-server.exe di Task Manager.

Mac/Linux

  1. Jalankan perintah berikut untuk mengunduh paket plugin Grafana Tablestore.

    wget https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260203/qbqmxg/aliyun-tablestore-grafana-datasource-adapt-react.zip
  2. Ekstrak paket plugin Grafana Tablestore ke direktori plugin Grafana.

    Jalankan perintah yang sesuai dengan metode instalasi Grafana Anda.

    • Jika Anda menginstal Grafana dari repositori Yellowdog Updater, Modified (YUM) atau paket RPM Package Manager (RPM) (Linux saja): unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d /var/lib/grafana/plugins

    • Jika Anda menginstal Grafana dari file .zip: unzip aliyun-tablestore-grafana-datasource-adapt-react.zip -d {PATH_TO}/grafana-{VERSION}/data/plugins

      Catatan

      Dalam perintah tersebut, {PATH_TO}/grafana-{VERSION} menentukan path instalasi Grafana, dan {VERSION} menentukan nomor versi Grafana.

  3. Modifikasi file konfigurasi Grafana.

    1. Masuk ke direktori dan buka file konfigurasi.

      • Jika Anda menginstal Grafana dari repositori YUM 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 path tersebut, {PATH_TO}/grafana-{VERSION} adalah path instalasi Grafana, dan {VERSION} adalah nomor versi Grafana.

    2. Pada bagian [plugins] file konfigurasi, atur parameter allow_loading_unsigned_plugins.

      allow_loading_unsigned_plugins = 'aliyun-tablestore-grafana-datasource-adapt-react'
  4. Restart 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 repositori YUM 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

  1. Login ke Grafana.

    1. Di browser, masukkan http://<x.x.x.x>:3000/ untuk membuka halaman login Grafana.

      Catatan

      <x.x.x.x> menentukan alamat IP server tempat Grafana diinstal. Misalnya, jika Grafana diinstal di Windows, alamat login-nya adalah http://localhost:3000.

    2. Masukkan Email atau username dan Password Anda, lalu klik Log in.

      Catatan

      Username dan password default keduanya adalah admin. Saat login pertama kali, Anda akan diminta untuk mengubah password.

  2. Di panel navigasi kiri Grafana, pilih Connections > Data sources.

  3. Di halaman Data sources, klik + Add new data source.

  4. Di halaman Add data source, pada bagian Others, klik aliyun-tablestore-grafana-datasource.

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

    Parameter

    Contoh

    Deskripsi

    Name

    aliyun-tablestore-grafana-datasource

    Nama sumber data. Masukkan nama kustom jika diperlukan. Nilai default-nya adalah aliyun-tablestore-grafana-datasource.

    Default

    image

    Tetapkan sumber data Tablestore sebagai sumber data default.

    Endpoint

    https://myinstance.cn-hangzhou.ots.aliyuncs.com

    Masukkan endpoint instans Tablestore yang ingin Anda akses.

    Instance

    myinstance

    Nama instans Tablestore.

    AccessId

    ************************

    ID AccessKey akun Alibaba Cloud atau pengguna RAM yang memiliki izin untuk mengakses Tablestore.

    AccessKey

    ********************************

    Rahasia AccessKey akun Alibaba Cloud atau pengguna RAM yang memiliki izin untuk mengakses Tablestore.

  6. Klik Save & test.

    Setelah koneksi berhasil, antarmuka akan menampilkan pesan Data source is working.

    image

Langkah 3: Buat panel dasbor

  1. Di panel navigasi kiri Grafana, klik Dashboards.

  2. Di halaman Dashboards, klik New lalu pilih New dashboard.

    image

  3. Di halaman New dashboard, klik + Add visualization.

  4. Di kotak dialog Select data source, pilih sumber data Tablestore yang telah Anda konfigurasikan.

    image

  5. Di halaman Edit panel, konfigurasikan kondisi kueri di tab Queries.

    Parameter dijelaskan dalam tabel berikut.

    Parameter

    Contoh

    Deskripsi

    Query

    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 selengkapnya, lihat Kueri data.

    Penting
    • Dalam klausa WHERE, Anda harus menggunakan makro yang telah ditentukan untuk memfilter data berdasarkan rentang waktu, seperti $__unixMicroTimeRangeFilter pada contoh. Untuk melihat makro waktu lainnya, klik "Show Help" di halaman konfigurasi.

    • Jika Anda ingin menampilkan data dalam grafik deret waktu, kueri harus mengembalikan kolom waktu yang direpresentasikan oleh timestamp numerik. Selain itu, konfigurasikan nama kolom waktu tersebut.

    Format As

    Timeseries

    Format hasil. Nilai yang valid:

    • Timeseries (Default): Grafik deret waktu standar.

    • FlowGraph: Grafik multidimensi.

    • Table: Tabel standar.

      Catatan

      Jika data tabel tidak memiliki kolom waktu saat Anda mengkuerinya dari model tabel lebar menggunakan SQL, klik Switch to table untuk menampilkan hasil kueri dalam format tabel, atau klik Open visualization suggestions untuk melihat dan memilih opsi visualisasi tambahan yang direkomendasikan.

    Time Column

    _time

    Nama kolom waktu dalam data yang dikembalikan. Kolom waktu digunakan sebagai sumbu-x pada grafik deret waktu. Parameter ini tersedia ketika Anda mengatur Format As ke Timeseries atau FlowGraph.

    Aggregation Column

    _field_name#:#_double_value

    Mengonversi beberapa baris data satu kolom pada titik waktu yang sama menjadi satu baris data multi-kolom. Parameter ini digunakan untuk mengonversi data dari model nilai tunggal menjadi model multi-nilai. Data model nilai tunggal adalah hasil yang diperoleh saat Anda menggunakan SQL untuk mengkueri tabel deret waktu di Tablestore. Parameter ini tersedia ketika Anda mengatur Format As ke FlowGraph. Formatnya adalah <Kolom nama titik data>#:#<Kolom nilai>.

  6. Klik Run SQL untuk menjalankan pernyataan SQL dan melihat atau men-debug hasilnya.

  7. Konfigurasikan dan simpan panel dasbor.

    1. Di panel kanan, tentukan nama, tipe, dan gaya tampilan grafik pemantauan.

      fig_20220426_dashboard

    2. Di pojok kanan atas, klik Save dashboard. Di kotak dialog Save dashboard, tentukan Title, Description, dan Folder untuk dasbor tersebut. Lalu, klik Save.

    3. Di pojok kanan atas, klik Save dashboard. Di kotak dialog Save dashboard, klik Save.

Langkah 4: Lihat data pemantauan

Di panel navigasi kiri Grafana, pilih Dashboards. Klik dasbor di folder tujuan untuk melihat semua grafik pemantauannya.