Connect ke sumber ServiceNow data - Amazon Managed Grafana

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 Kelola akses ke plugin Enterprise.

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.

Fitur

  • Kueri

    • Kueri Stat API

    • Kueri API Tabel

      • Insiden, Perubahan, dan tabel lainnya

  • Peringatan

  • 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, padav1.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 ditampilkan1. Jika bendera diaktifkan, nilai yang ditampilkan akan menjadi1 - High.

Menurut dokumentasi ServiceNow API, 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)
Kegiatan yang Harus Dihasilkan
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 #! /api_doc? v=newYork&id=R_SGSYS-DateGenerate_s_s

Operator (umum, berbasis string)
  • Dimulai Dengan

  • Berakhir Dengan

  • Suka

  • Tidak Suka

  • Setara

  • Tidak Sama

  • 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 Benar/Salah

  • 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 FieldInilah 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

Kelompokkan 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 jenisnyaQuery, 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 $ {category}, 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:

$<varname>Contoh dengan variabel template bernamahostname:

[[varname]]Contoh dengan variabel template bernamahostname:

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

Menggunakan proxy HTTP

Saat menggunakan proxy HTTP, Grafana Terkelola Amazon akan memerlukan variabel lingkungan berikut yang disetel ke lokasi proxy:

  • HTTP_PROXY (atau http_proxy)

    • Jalur lengkap - http://host:port

    • atau hanya: host:port

  • HTTPS_PROXY(atauhttps_proxy):

    • Jalur lengkap - https://host:port

    • atau hanya: host:port

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 di 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 ACL ke semua tabel yang harus diakses oleh Grafana.

Akses administrator diperlukan untuk melakukan tindakan berikut.

  1. Administrator yang masuk perlu meningkatkan akses ke security_admin.

    1. Di panel navigasi kanan atas, pilih ikon profil. Ikon profil memiliki indikator tanda sisipan dropdown.

    2. Dari daftar dropdown, pilih Elevate Roles.

    3. Dari modal yang ditampilkan, pilih kotak centang security_admin.

    4. Pilih OK.

  2. 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

    2. Pilih Baru di bagian atas.

    3. Masukkan nama untuk peran dan deskripsi yang relevan.

    4. Pilih Kirim.

  3. Buat pengguna baru atau modifikasi pengguna yang sudah ada dengan peran yang diperlukan.

    1. Peran yang Anda buat di Langkah 2

    2. personalize_dictionary

    3. personalize_choices

    4. cmdb_read (ini akan memberikan akses baca ke semua tabel cmdb)

  4. Buat ACL Tabel untuk tabel dan bidang yang diperlukan.

    1. Buat ACL untuk tabel sys_db_object.

      1. Di kolom header pencarian kedua Nama, masukkansys_db_object, dan tekan Enter.

      2. Hasil yang disaring harus menunjukkan Tabel. Pilih Tabel untuk menavigasi ke catatan.

      3. Pada bagian tab, pilih Kontrol.

      4. Pada bagian bawah halaman, pastikan bahwa Access Controls adalah tab yang dipilih.

      5. Pilih Baru untuk membuat ACL baru.

      6. Ubah pilihan Operasi untuk membaca.

      7. Di bagian Memerlukan Peran di bagian bawah layar, pilih (klik dua kali) Sisipkan Baris Baru, dan cari peran yang Anda buat.

      8. Setelah Anda memilih peran yang Anda buat, pilih tanda centang hijau.

      9. Pilih Kirim di bagian bawah layar untuk membuat ACL, lalu pilih Lanjutkan saat modal muncul.

  5. Buat ACL untuk bidang sys_db_object 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_db_object, pilih tab Kolom di grup tab yang paling dekat dengan bagian atas layar.

    2. Temukan nama bidang dan pilih.

    3. Di bagian tab bawah, pilih Baru di tab Access Controls.

    4. Ubah operasi untuk membaca

    5. Pilih (klik dua kali) sisipkan teks baris di bagian bawah tabel “Memerlukan peran”.

    6. Cari peran yang Anda buat, dan pilih tanda centang hijau.

    7. Pilih Kirim.

    8. Pastikan Anda telah mengulangi langkah-langkah ini untuk semua bidang yang diperlukan: Name, Label, Display Name, dan Extends table.

  6. 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_db_object.