Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Connect ke sumber ServiceNow data Ini adalah sumber ServiceNow data yang digunakan untuk terhubung ke ServiceNow instance. **catatan** Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md). Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md). ## Fitur + Kueri + Kueri Stat API + Kueri API Tabel + Insiden, Perubahan, dan tabel lainnya + Pemberitahuan + Anotasi (fitur beta) + Variabel Template ## Konfigurasi Pilih sumber data di panel kiri Grafana. Pilih Tambahkan Sumber Data: Masukkan **servicenow** untuk menemukan plugin sumber data: Masukkan ServiceNow URL: Pilih **Simpan & Uji**. Anda akan melihat pesan hijau dengan "ServiceNow Koneksi OK”. ### Contoh dasbor Dasbor pra-dibuat disertakan dengan plugin dan dapat diimpor melalui halaman konfigurasi sumber data, di bawah tab dasbor. ## Penggunaan Ada dua cara untuk mengembalikan data di editor kueri. + TableAPI + AggregateAPI Pengguna saat ini dapat memilih antara menanyakan tabel yang telah ditentukan sebelumnya, seperti berikut ini: + Perubahan + Insiden Atau, pada`v1.4.0`, daftar tabel dan bidang berbasis API menggunakan opsi **Lainnya (Tabel Kustom)**. Opsi ini akan memungkinkan Anda untuk menanyakan data yang ada di tabel apa pun yang tersedia bagi pengguna yang digunakan untuk mengatur sumber ServiceNow data. Opsi **Tabel Kustom** harus mendukung semua fitur yang sama dengan daftar tabel yang telah ditentukan sebelumnya. ### Kueri TableAPI TableAPI mengembalikan data yang cocok untuk ditampilkan di panel tabel. Ini memungkinkan pemilihan bidang yang diurutkan untuk ditampilkan ditambah opsi pemfilteran. Editor kueri juga menyediakan bidang untuk membatasi jumlah baris yang dikembalikan oleh kueri. Contoh panel tabel yang menunjukkan hasil dari query sebelumnya. #### Tampilkan Baris *Tampilkan* menyediakan pemilih untuk bidang yang akan ditampilkan. Beberapa bidang juga dapat ditentukan. Bidang akan dikembalikan dalam urutan yang tepat yang ditentukan. #### Nilai Tampilan Flag *Nilai Tampilan* akan menyebabkan kueri mengembalikan nilai yang ramah manusia, atau menampilkan vaules, bukan nilai numerik. Misalnya, tingkat keparahan `1` tanpa bendera ini hanya akan ditampilkan`1`. Jika bendera diaktifkan, nilai yang ditampilkan akan menjadi`1 - High`. Menurut [dokumentasi ServiceNow API](https://developer.servicenow.com/dev.do#!/reference/api/orlando/rest/c_TableAPI), ini dapat memiliki dampak kinerja negatif. **catatan** [...] menentukan nilai tampilan dapat menyebabkan masalah kinerja karena tidak membaca langsung dari database dan dapat mencakup referensi bidang dan catatan lain. #### Filter (umum) Baris *Filter* memberikan kemampuan untuk mempersempit baris yang ditampilkan berdasarkan beberapa kriteria bidang dan nilai. Semua filter digabungkan dengan operasi *AND* *atau OR*. Bidang berikut tersedia saat tidak menggunakan tabel kustom (daftar ini akan diperluas di masa mendatang). ``` Active Asset Group Assigned To Escalation Issue Number Description Priority State Type Change Risk Change State Start Date End Date On Hold ``` Saat memilih tabel kustom, bidang secara otomatis diisi dari Service Now API. ##### Filter tanggal | Bidang Waktu | Operator | Nilai | | --- | --- | --- | | Dibuka di | Pada atau Sebelum Hari Ini Tidak Hari Ini Sebelum Pada atau Sebelum Setelah Pada atau Setelah | stempel waktu javascript:GS.Daysago (30) | | Aktivitas Karena | | | | Ditutup Pada | | | | Tanggal Jatuh Tempo | | | | Mulai yang Diharapkan | | | | Waktu Dibuka Kembali | | | | Diselesaikan Pada | | | | Akhir Kerja | | | | Mulai Kerja | | | | Abaikan Waktu | | | Untuk nilai tanggal tambahan, lihat: https://developer.servicenow.com/app.do\$1\$1/ api\$1doc? v=newYork&id=R\$1SGSYS-DateGenerate\$1s\$1s ##### Operator (umum, berbasis string) + Dimulai Dengan + Berakhir Dengan + Suka + Tidak Suka + Sama dengan + Tidak Sama Dengan + Kosong ##### Operator (berbasis waktu) + Hari ini + Tidak Hari Ini + Sebelum + Di atau Sebelum + Setelah + Pada atau Setelah ##### Nilai Pemilihan nilai tergantung pada jenis filter yang dipilih. + Filter Boolean memiliki opsi True/False + Filter teks akan memungkinkan mengetik nilai apa pun + Eskalasi, Prioritas memiliki seperangkat nilai numerik yang tetap #### Urutkan Berdasarkan Baris *Sort By* memberikan kemampuan untuk mempersempit baris yang ditampilkan berdasarkan beberapa kriteria bidang dan nilai. Semua filter digabungkan dengan operasi *AND*. Support untuk operator tambahan akan ditambahkan. #### Kuota Batas baris dapat ditentukan untuk mencegah pengembalian terlalu banyak data. Nilai default adalah 25. #### Bidang Waktu `Time Field`Inilah yang mengubah data kueri Anda menjadi deret waktu. Data Anda ditangani sebagai deret waktu berarti bahwa nilai dalam “bidang waktu” yang Anda pilih yang tidak termasuk dalam rentang waktu dasbor/panel Anda tidak akan ditampilkan. Bidang waktu default yang digunakan adalah “Dibuka Pada”, tetapi dapat diubah ke bidang yang tersedia yang memiliki nilai waktu. Nilai khusus “Abaikan Waktu” disediakan untuk memungkinkan hasil “sampai sekarang” dan juga untuk mengaktifkan filter untuk mengontrol data apa yang ditampilkan. ### Kueri AggregateAPI (Statistik) AggregateAPI akan selalu menampilkan metrik, dengan agregasi berikut: avg, min, max, sum. Pemfilteran juga tersedia untuk mempersempit kueri. #### Tampilkan Baris *Tampilkan* menyediakan pemilih untuk metrik yang akan ditampilkan. Beberapa metrik juga dapat ditentukan. #### Filter (umum) *Filter* Agregat memberikan kemampuan untuk mempersempit metrik yang ditampilkan berdasarkan kriteria bidang dan nilai, mirip dengan opsi tabel. Semua filter digabungkan dengan operasi *AND*. Support untuk operator tambahan akan ditambahkan. Opsi filter stat sama dengan TableAPI. #### Agregasi Ada empat jenis agregasi metrik, ditambah “hitungan”: + Rata-rata + Minimum + Maksimum + Jumlah + Hitung - ini mengembalikan “nomor” metrik yang dikembalikan oleh kueri ##### Grup Oleh Pemilih ini menyediakan kemampuan untuk membagi metrik menjadi agregat yang lebih kecil. Pengelompokan berdasarkan “prioritas” akan mengembalikan metrik dengan “tag” prioritas dan nilai unik dipisahkan. ### Templating Alih-alih hardcoding nama dalam kueri Anda, Anda dapat menggunakan variabel di tempatnya. Variabel ditampilkan sebagai kotak pilih dropdown di bagian atas dasbor. Anda dapat menggunakan kotak dropdown ini untuk mengubah data yang ditampilkan di dasbor Anda. Lihat contoh di bagian **Query Variable** tentang cara menambahkan variabel query dan referensi dengan nilai Template. #### Variabel kueri Jika Anda menambahkan variabel template dari jenisnya`Query`, Anda dapat menulis kueri yang dapat mengembalikan item seperti nama kategori, nama kunci, atau nilai kunci yang ditampilkan sebagai kotak pilih tarik-turun. Misalnya, Anda dapat memiliki variabel yang berisi semua nilai `categories` dengan menentukan kueri seperti ini dalam pengaturan *kueri* variabel template. Saat memilih pengaturan **Kueri**, bagian **Filter** ditampilkan, memungkinkan Anda memilih **Jenis** dan **Bidang**. Saat ini, **Jenis** terbatas pada Insiden dan Perubahan. Saat memilih jenis, Anda diberikan daftar bidang yang berlaku untuk Jenis tersebut. Setelah **Jenis** dan **Bidang** dipilih, pratinjau nilai akan ditampilkan di bagian bawah yang menunjukkan opsi yang tersedia untuk Jenis/Bidang itu. Nilai-nilai tersebut akan ditampilkan dalam daftar dropdown di Dashboard, yang dapat Anda gunakan bersama dengan Templating untuk memfilter data pada Panel Dasbor Anda. Misalnya, jika Anda menambahkan *kategori* bernama Variabel lalu pilih Jenis = Insiden dan Bidang = Kategori, Anda akan melihat daftar opsi untuk Kategori. Jika Anda kemudian menambahkan Filter ke panel, dan pilih Category Equals \$1 \$1category\$1, data panel hanya akan menampilkan data untuk Kategori yang dipilih dari daftar dropdown Dashboard. Impor dasbor **Insiden Berdasarkan Kategori** untuk melihat contoh. #### Menggunakan variabel dalam kueri Ada dua sintaks: `$`Contoh dengan variabel template bernama`hostname`: `[[varname]]`Contoh dengan variabel template bernama`hostname`: ## Peringatan Peringatan Grafana standar didukung. Setiap kueri yang ditentukan dalam panel grafik dapat digunakan untuk menghasilkan peringatan. Berikut ini adalah contoh query dan peringatan. Kueri ini akan mengembalikan grafik dari semua insiden prioritas tinggi kritis terbuka: Peringatan ini akan dimulai ketika ada lebih dari lima insiden prioritas tinggi kritis terbuka: Menguji aturan peringatan akan menampilkan output dari aturan peringatan, dan memilih riwayat status akan menampilkan transisi peringatan dari ok ke pending ke alert. Tampilan grafik akan menunjukkan garis vertikal dan ikon hati di bagian atas akan berubah menjadi oranye saat peringatan tertunda. Setelah kriteria peringatan terpenuhi, aturan beralih ke merah. Pada tampilan grafik, garis vertikal merah akan muncul dan ikon hati di bagian atas akan berubah menjadi merah. ### Menulis insiden untuk peringatan **Fitur beta** + Konfigurasikan Saluran Pemberitahuan untuk sumber ServiceNow data Anda. Ini akan mengonfigurasi [Saluran Pemberitahuan Grafana](https://grafana.com/docs/grafana/latest/alerting/notifications/) yang menggunakan pengguna yang dikonfigurasi untuk membuat insiden pada ServiceNow instance untuk sumber data ini. Tindakan ini mengharuskan pengguna sumber ServiceNow data memiliki izin untuk menulis insiden. ## Anotasi Anotasi Grafana adalah **fitur beta** pada `v1.4.0` sumber data ini. Anotasi memberi Anda kemampuan untuk melapisi peristiwa pada grafik. Kueri Anotasi mendukung opsi yang sama dengan editor kueri standar dengan beberapa perbedaan kecil: + Hanya satu kolom “Tampilkan” yang dapat dipilih. Ini kemungkinan akan diperbaiki dalam perbaikan masa depan. + Bidang waktu diperlukan. ## Pertanyaan yang Sering Diajukan ### Bagaimana jika kita tidak memiliki Plugin Peran ITSM? **Akses administrator diperlukan untuk melakukan tindakan berikut** Opsi 1: Berikan izin admin pengguna Grafana untuk mengizinkan akses ke semua tabel. Opsi 2: Buat peran dan terapkan ACLs ke semua tabel yang harus diakses oleh Grafana. Akses administrator diperlukan untuk melakukan tindakan berikut. 1. Administrator yang masuk perlu meningkatkan akses ke security\$1admin. 1. Di panel navigasi kanan atas, pilih ikon profil. Ikon profil memiliki indikator tanda sisipan dropdown. 1. Dari daftar dropdown, pilih **Elevate** Roles. 1. Dari modal yang ditampilkan, pilih kotak centang **security\$1admin**. 1. Pilih OK. 1. Buat peran baru dengan konvensi penamaan apa pun yang Anda inginkan. 1. Arahkan ke bagian peran di navigasi kiri Keamanan Sistem => Pengguna dan Grup => Peran 1. Pilih **Baru** di bagian atas. 1. Masukkan nama untuk peran dan deskripsi yang relevan. 1. Pilih **Kirim**. 1. Buat pengguna baru atau modifikasi pengguna yang sudah ada dengan peran yang diperlukan. 1. Peran yang Anda buat di Langkah 2 1. personalize\$1dictionary 1. personalize\$1choices 1. cmdb\$1read (ini akan memberikan akses baca ke semua tabel cmdb) 1. Buat Tabel ACLs untuk tabel dan bidang yang diperlukan. 1. Buat ACL untuk tabel sys\$1db\$1object. 1. Di kolom header pencarian kedua **Nama**, masukkan**sys\$1db\$1object**, dan tekan **Enter**. 1. Hasil yang disaring harus menunjukkan **Tabel**. Pilih **Tabel** untuk menavigasi ke catatan. 1. Pada bagian tab, pilih **Kontrol**. 1. Pada bagian bawah halaman, pastikan bahwa **Access Controls** adalah tab yang dipilih. 1. Pilih **Baru** untuk membuat ACL baru. 1. Ubah pilihan **Operasi** untuk membaca. 1. Di bagian **Memerlukan Peran** di bagian bawah layar, pilih (klik dua kali) **Sisipkan Baris Baru**, dan cari peran yang Anda buat. 1. Setelah Anda memilih peran yang Anda buat, pilih tanda centang hijau. 1. Pilih **Kirim** di bagian bawah layar untuk membuat ACL, lalu pilih **Lanjutkan** saat modal muncul. 1. Buat ACLs untuk bidang sys\$1db\$1object tertentu. Langkah-langkah berikut harus diulang untuk masing-masing bidang berikut: Nama, Label, Nama Tampilan, dan Memperpanjang tabel. 1. Saat masih dalam tampilan rekaman tabel untuk sys\$1db\$1object, pilih tab **Kolom** di grup tab yang paling dekat dengan bagian atas layar. 1. Temukan nama bidang dan pilih. 1. Di bagian tab bawah, pilih **Baru** di tab **Access Controls**. 1. Ubah operasi untuk membaca 1. Pilih (klik dua kali) sisipkan teks baris di bagian bawah tabel “Memerlukan peran”. 1. Cari peran yang Anda buat, dan pilih tanda centang hijau. 1. Pilih **Kirim**. 1. Pastikan Anda telah mengulangi langkah-langkah ini untuk semua bidang yang diperlukan: Name, Label, Display Name, dan Extends table. 1. Ulangi langkah-langkah dari 4.1 pada Perubahan, Insiden, dan tabel non-CMDB lainnya yang ingin Anda kueri dari Grafana. Jangan ulangi langkah-langkah dari 4.2; langkah itu hanya diperlukan untuk sys\$1db\$1object.