

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Panel grafik simpul
<a name="v9-panels-node-graph"></a>

****  
**Topik dokumentasi ini dirancang untuk ruang kerja Grafana yang mendukung Grafana versi 9.x.**  
Untuk ruang kerja Grafana yang mendukung Grafana versi 10.x, lihat. [Bekerja di Grafana versi 10](using-grafana-v10.md)  
Untuk ruang kerja Grafana yang mendukung Grafana versi 8.x, lihat. [Bekerja di Grafana versi 8](using-grafana-v8.md)

Panel grafik simpul memvisualisasikan grafik atau jaringan yang diarahkan. Ini menggunakan tata letak gaya terarah untuk memposisikan node secara efektif sehingga dapat membantu menampilkan peta infrastruktur yang kompleks, hierarki, atau menjalankan diagram.

## Persyaratan data
<a name="v9-panels-node-graph-requirements"></a>

Panel grafik node membutuhkan bentuk data tertentu untuk dapat menampilkan node dan tepinya. Tidak semua sumber data atau kueri dapat divisualisasikan di panel ini.

Visualisasi grafik Node terdiri dari *node* dan *tepi*.
+ Sebuah *node* ditampilkan sebagai lingkaran. Sebuah node mungkin mewakili aplikasi, layanan, atau apa pun yang relevan dari perspektif aplikasi.
+ *Tepi* ditampilkan sebagai garis yang menghubungkan dua node. Koneksi mungkin permintaan, operasi, atau hubungan lain antara dua node.

Baik node dan edge dapat memiliki metadata atau statistik terkait. Sumber data mendefinisikan informasi dan nilai apa yang ditampilkan, sehingga sumber data yang berbeda dapat menunjukkan jenis nilai yang berbeda atau tidak menunjukkan beberapa nilai.

## Node
<a name="v9-panels-node-graph-nodes"></a>

Biasanya, node menunjukkan dua nilai statistik di dalam node dan dua pengidentifikasi tepat di bawah node, biasanya nama dan jenis. Node juga dapat menunjukkan set nilai lain sebagai lingkaran warna di sekitar node, dengan bagian warna yang berbeda mewakili nilai yang berbeda yang harus menambahkan hingga 1. Misalnya, Anda dapat memiliki persentase kesalahan yang diwakili oleh bagian merah dari lingkaran.

Detail tambahan dapat ditampilkan dalam menu konteks, yang ditampilkan saat Anda memilih node. Ada juga tautan tambahan di menu konteks yang dapat menargetkan bagian lain dari ruang kerja Grafana atau tautan eksternal apa pun.

**catatan**  
Grafik node hanya dapat menampilkan 1.500 node. Jika batas ini dilintasi, peringatan terlihat di sudut kanan atas, dan beberapa node akan disembunyikan. Anda dapat memperluas bagian tersembunyi dari grafik dengan mengklik penanda **node tersembunyi** dalam grafik.

## Tepi
<a name="v9-panels-node-graph-edges"></a>

Tepi juga dapat menunjukkan statistik saat Anda mengarahkan kursor ke tepi. Mirip dengan node, Anda dapat membuka menu konteks dengan detail dan tautan tambahan dengan memilih tepi.

Sumber data pertama yang mendukung visualisasi ini adalah sumber AWS X-Ray data untuk fitur peta layanannya. Untuk informasi selengkapnya, lihat [Connect ke sumber AWS X-Ray data](x-ray-data-source.md).

## Menavigasi grafik simpul
<a name="v9-panels-node-graph-navigation"></a>

Anda dapat menggeser dalam grafik simpul dengan memilih di luar node atau tepi mana pun dan menyeret pointer.

Anda dapat memperbesar dengan menggunakan tombol di sudut kiri atas grafik simpul.

**Node tersembunyi**

Jumlah node yang ditampilkan pada waktu tertentu terbatas untuk mempertahankan kinerja yang wajar. Node yang berada di luar batas ini tersembunyi di balik penanda yang dapat diklik yang menunjukkan perkiraan jumlah node tersembunyi yang terhubung ke tepi itu. Anda dapat memilih penanda untuk memperluas grafik di sekitar simpul itu.

**Tampilan kisi**

Anda dapat beralih ke tampilan grid untuk memiliki gambaran yang lebih baik dari node yang paling menarik dalam grafik. Tampilan grid menunjukkan node dalam grid tanpa tepi dan dapat diurutkan berdasarkan statistik yang ditunjukkan di dalam node atau oleh statistik yang diwakili oleh batas berwarna dari node.

Untuk mengurutkan node, pilih statistik di dalam legenda. Penanda di sebelah nama stat menunjukkan stat mana yang saat ini digunakan untuk menyortir dan menyortir arah.

Pilih node dan kemudian **Tampilkan dalam tata letak Grafik** opsi untuk beralih kembali ke tata letak grafik dengan fokus pada simpul yang dipilih, untuk menunjukkannya dalam konteks grafik lengkap.

## Data API
<a name="v9-panels-node-graph-data-api"></a>

Visualisasi ini membutuhkan bentuk data tertentu yang akan dikembalikan dari sumber data agar dapat menampilkannya dengan benar.

Grafik Node minimal membutuhkan bingkai data yang menggambarkan tepi grafik. Secara default, grafik node akan menghitung node dan statistik apa pun berdasarkan bingkai data ini. Secara opsional, bingkai data kedua yang menjelaskan node dapat dikirim jika ada kebutuhan untuk menampilkan metadata spesifik node yang lebih spesifik. Anda harus mengatur `frame.meta.preferredVisualisationType = 'nodeGraph'` pada kedua frame data atau menamainya `nodes` dan `edges` masing-masing untuk grafik node untuk dirender.

**Tepi data dari struktur**

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  id  |  string  |  Pengidentifikasi unik tepi.  | 
|  sumber  |  string  |  Id dari simpul sumber.  | 
|  target  |  string  |  Id dari target.  | 

Bidang opsional:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  mainstat  |  string/nomor  |  Stat pertama ditampilkan di overlay saat melayang di atas tepi. Ini bisa berupa string yang menunjukkan nilai apa adanya atau bisa berupa angka. Jika itu adalah angka, unit apa pun yang terkait dengan bidang itu juga ditampilkan  | 
|  Secondarystat  |  string/nomor  |  Sama seperti MainStat, tetapi ditampilkan tepat di bawahnya.  | 
|  detail\$1\$1\$1  |  string/nomor  |  Bidang apa pun yang diawali dengan `detail__` akan ditampilkan di header menu konteks saat diklik di tepi. Gunakan `config.displayName` untuk label yang lebih mudah dibaca manusia.  | 

**Node data dari struktur**

Bidang yang diperlukan:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  id  |  string  |  Pengidentifikasi unik dari node. ID ini direferensikan oleh edge di bidang sumber dan targetnya.  | 

Bidang opsional:


| Nama bidang | Tipe | Deskripsi | 
| --- | --- | --- | 
|  title  |  string  |  Nama node terlihat tepat di bawah node.  | 
|  subjudul  |  string  |  Tambahan, nama, jenis atau pengenal lain yang ditampilkan di bawah judul.  | 
|  mainstat  |  string/nomor  |  Stat pertama ditampilkan di dalam node itu sendiri. Ini bisa berupa string yang menunjukkan nilai apa adanya atau angka. Jika itu adalah angka, unit apa pun yang terkait dengan bidang itu juga ditampilkan.  | 
|  Secondarystat  |  string/nomor  |  Sama seperti MainStat, tetapi ditampilkan di bawahnya di dalam node.  | 
|  busur\$1\$1\$1  |  number  |  Setiap bidang yang diawali dengan `arc__` akan digunakan untuk membuat lingkaran warna di sekitar node. Semua nilai dalam bidang ini harus menambahkan hingga 1. Anda dapat menentukan warna menggunakan`config.color.fixedColor`.  | 
|  detail\$1\$1\$1  |  string/nomor  |  Setiap bidang yang diawali dengan `detail__` akan ditampilkan di header menu konteks saat diklik pada node. Gunakan `config.displayName` untuk label yang lebih mudah dibaca manusia.  | 