> For the complete documentation index, see [llms.txt](https://learn.vispeahen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.vispeahen.com/kumanda-tablosu/plugin-listesi/gorsel-bilesenler/gauge-chart-gosterge-tablosu.md).

# Gauge Chart: Gösterge Tablosu

Gösterge Tablosu (Gauge Chart) bileşeni, tek bir metrik değerini bir hız göstergesi (kadran) formatında, belirli bir minimum-maksimum ölçek ve hedef sınırları içerisinde görselleştiren en klasik ve net KPI aracıdır.

Bu bileşen; sistem çalışma süreleri (uptime), hedef gerçekleşme kotaları, hız/performans skorları, risk seviyeleri veya kapasite kullanım oranları gibi 'Şu an neredeyiz ve tehlike/hedef sınırına ne kadar uzağız?' sorusuna anında yanıt verilmesi gereken senaryolar için tasarlanmıştır.

Bileşenin en büyük avantajı, sadece mevcut değeri bir sayı olarak vermekle kalmayıp, bu değerin genel ölçek (0-100 vb.) içindeki konumunu ve hedefe (referans çizgisine) olan mesafesini tek bir ibre hareketiyle son derece anlaşılır bir şekilde sunmasıdır.

{% hint style="info" %}
**Not:** Gösterge Tablosu, zaman içindeki trendleri (geçmişten bugüne değişim) göstermez; sadece o anki (anlık) anlık durumun fotoğrafını çeker. Eğilimleri veya kırılımları görmek için Çizgi (Line) veya Sütun (Column) grafikleriyle desteklenmesi önerilir.
{% endhint %}

## Gösterge Tablosu Grafiğinin Eklenmesi

Gösterge Tablosu Grafiği eklemek için **Plugin Listesi** içerisinden **Gösterge Tablosu** bileşeni seçilir ve kumanda tablosuna eklenir.

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FMb2LxomZQhh8LRvpXdbn%2Fimage.png?alt=media&amp;token=a7676638-20dd-4c9a-92de-eb1b550dad5a" alt=""><figcaption></figcaption></figure>

Grafik eklendikten sonra Ölçü Değeri, Maksimum, Minimum ve Hedef alanları eşleştirilerek ve eksen sınırları belirlenerek yapılandırma tamamlanır.

## Gösterge Tablosu Grafiği Araçları

Güneş Işını Grafiği seçildiğinde üst menüde aşağıdaki araçlar görüntülenir.

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2Fd8t2A1lLlJFNI3Q3Bau7%2Fimage.png?alt=media&amp;token=87917b0e-cefd-4db9-8c3a-429f7cc1a673" alt=""><figcaption></figcaption></figure>

1. **Araçları Aç/Kapat:** Görsel ile ilgili düzenleme yapılan ikonların açıp kapatıldığı ikondur.
2. **Veri:** Kullanıcının kendi verileriyle görseli şekillendireceği alandır.
3. **Ayarlar:** Görselin renk/başlık gibi biçimsel özelliklerinin değiştirildiği alandır.
4. **Koşulsal Formatlama:** Grafik üzerinde tanımlanan belirli bir kural neticesinde verileri gözle daha kolay bir şekilde taramak için renksel biçimlendirmeler yapılan alandır
5. **Navigasyon:** Görselden belirlenen parametreye göre navigasyon verilen alandır.
6. **Yenile:** Veri alanı ile grafiğin çalışması ve grafiğin yenilenmesini sağlar.
7. **Kaldır:** Görseli silmek için kullanılan alandır. “Kaldır” ikonuna tıklandığında “Bu görseli silmek istiyor musunuz?” şeklinde uyarı çıkmaktadır.

> **Not:** Koşulsal Formatlama, Etkileşim ve Navigasyon ayarları tüm görsel bileşenlerde ortak olarak kullanıldığından ilgili bölümler ayrı başlık altında açıklanmaktadır.

## Veri Yapılandırması

Gösterge Tablosu Grafiğinin oluşturulabilmesi için kullanılacak veri alanlarının tanımlanması gerekmektedir. Bu işlem **Veri** ekranı üzerinden gerçekleştirilir.

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FWAWJjPp0leM4dPNY69eh%2Fimage.png?alt=media&amp;token=d7f2ee8e-7252-4d4c-ba1e-6a6cbca689d2" alt=""><figcaption></figcaption></figure>

<mark style="color:green;">**Tablolar & Kolonlar**</mark>
: Seçili modelde var olan tablo ve kolonların bulunduğu alandır.
&#x20;**Tablolar & Kolonlar** bölümünde yer alan kolonlar, sağ tarafta bulunan bölümlere sürükle-bırak ile eklenir.

<mark style="color:green;">**Kolon Eşleştirmeleri**</mark>

* **Sıralama ve Limit:** Kolon verisinin artan/azalan şekilde sıralamasının yapıldığı alandır.
* &#x20;**Ölçü Değeri:** Gösterge üzerinde ibrenin (veya doluluk barının) işaret edeceği, analiz edilen asıl gerçekleşen veridir. Grafiğin merkezinde okunan ve mevcut durumu gösteren temel sayıdır (Örneğin; anlık satış tutarı, güncel ciro veya mevcut üretim adedi).
* **Maksimum:** Gösterge kadranının ulaşabileceği en üst sınırı ve tam kapasiteyi belirleyen alandır. Grafiğin bittiği noktayı (skalanın sağ veya üst ucunu) ifade eder.
* **Minimum:** Göstergenin alt sınırını veya başlangıç noktasını belirleyen alandır. Grafiğin başladığı yerdir ve ölçüme nereden başlanacağını gösterir (Genellikle 0 veya belirli bir taban limit olarak ayarlanır).
* **Hedef:** Ölçü değerinin ulaşması beklenen amacı veya kritik referans noktasını (kota, bütçe hedefi vb.) belirler. Gösterge üzerinde genellikle renkli bir bant, çizgi veya özel bir işaret ile vurgulanır; böylece mevcut durumun hedefin ne kadar gerisinde veya ilerisinde olduğu hızlıca analiz edilebilir.
* **Saklı Alan:** Grafikte görüntülenmeyecek ancak sıralama veya hesaplama işlemlerinde kullanılacak kolonların eklenmesini sağlar.

## Yapılandırma Ayarları

Gösterge Tablosu Grafiğine ait görünüm ve davranış ayarları **Ayarlar** ekranı üzerinden yönetilir.

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FVONKiXl99WfTUqD0jqRn%2Fimage.png?alt=media&amp;token=69da505d-e1a5-478e-b10b-7455ac215520" alt=""><figcaption></figcaption></figure>

<mark style="color:green;">**Genel Görünüm**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FT3rR2V9z4G4PrwzxHE0o%2Fimage.png?alt=media&amp;token=7f45b693-5355-4f1d-b6a7-b23c31f03e4a" alt=""><figcaption></figcaption></figure>

* **Arkaplan Rengi:** Grafiğin arka plan rengini belirlemenizi sağlar. Renk seçimi, mevcut palet üzerinden yapılabilir.
* **Palet:** Grafik, seçilen renk paletine göre renklendirilir.

<mark style="color:green;">**Grafik**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FeqmS7hyIZMq13vxjxWoK%2Fimage.png?alt=media&amp;token=fbd635c0-198e-45cd-ac00-5f19026c4acb" alt=""><figcaption></figcaption></figure>

* **Grafik Tipi:** Gösterge grafiğinin hangi biçimde görüntüleneceğini belirler.
  * Dairesel – Gösterge daire formunda görselleştirilir.
  * Yatay – Gösterge yatay bir ilerleme çubuğu şeklinde gösterilir.
  * Dikey – Gösterge dikey bir ilerleme çubuğu şeklinde gösterilir.
* **Yazı Stili:** Grafikteki metinler için kullanılacak yazı tipini (font) belirler.
* **Ölçüm Gösterimi:** Gösterge grafiğindeki değerin nasıl gösterileceğini belirler.
  * Sayısal: Ölçüm değeri sayısal olarak gösterilir.
  * Yüzdesel: Ölçüm değeri yüzdesel olarak gösterilir.
* **Koşulsal Formatlamayı Göster:** Koşulsal formatlama varsa ve bu seçenek seçildiyse koşullar grafik üzerinde gösterilir.

<mark style="color:green;">**Dairesel Grafik Ayarları**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FsE9XgNijOXntZaAdzyJP%2Fimage.png?alt=media&amp;token=95985db8-3e67-473f-867d-443531f6cae7" alt=""><figcaption></figcaption></figure>

* **İç Yarıçap:** Gösterge veya dairesel grafiğin merkezindeki boşluğun (deliğin) genişliğini oran olarak belirleyen alandır. Bu değer büyüdükçe ortadaki boşluk artar ve grafik daha ince bir halka görünümü kazanır. Görseldeki "90" değeri, iç boşluğun oldukça geniş tutulduğunu ifade eder.
* **Değer Kolu:** Gösterge kadranı üzerinde, mevcut ölçü değerini işaret eden ibrenin veya okun görsel tasarımını belirleyen alandır.
  * Üçgen: Gösterge üzerindeki ibrenin, ölçülen değeri işaret eden uç kısmının (veya tamamının) üçgen formunda tasarlandığı seçenektir.&#x20;
  * Klasik: İbrenin, geleneksel hız veya basınç göstergelerinde olduğu gibi, genellikle tabandan uca doğru incelen standart bir çubuk veya çizgi formunda olduğu tasarımdır.&#x20;
  * Yok: Grafikte mevcut durumu işaret eden fiziksel bir ibrenin veya kolun (okun) bulunmadığı seçenektir.

<mark style="color:green;">**Eksen**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FuotgN2tmaavbKNOc2n38%2Fimage.png?alt=media&amp;token=191fe15c-db2f-4933-a05b-19c13a84a6a1" alt=""><figcaption></figcaption></figure>

* **Değerleri Eksen Üzerinde Göster:** Bu seçenek işaretlendiğinde, grafik üzerinde gösterilen ölçüm değeri ile birlikte minimum, maksimum ve varsa hedef değerler de gösterilir.

<mark style="color:green;">**Göstergeler**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2Fv7uFGpHUw2wtaPoT3o96%2Fimage.png?alt=media&amp;token=079eb6da-8868-427a-8f34-185491a05333" alt=""><figcaption></figcaption></figure>

* **Göstergeleri Göster:** Bu seçenek işaretlendiğinde, göstergeler grafikte yer alır. Seçili değilse alttaki ayarlar devre dışı kalır.
* **Ölçüm İsimlerini Göster:** Bu seçenek işaretlendiğinde, gösterge altında ölçüme ait isim (etiket) bilgisi görüntülenir.
* **Ölçüm Değerlerini Göster:** Bu seçenek işaretlendiğinde, gösterge altında ölçüm değeri görüntülenir.
* **Ölçüm Gösterimi:** Gösterge grafiğinde ölçüm değerinin nasıl gösterileceğini belirler.
  * Sayısal: Ölçüm değeri yalnızca sayı olarak gösterilir.
  * Yüzdesel: Ölçüm değeri yüzde oranı olarak gösterilir.
  * Yüzdesel-Sayısal: Ölçüm değeri hem yüzde hem sayı olarak birlikte gösterilir.
* **Gösterge Yazı Boyutu:** Gösterge alanında yer alan metinlerin boyutunu belirler. Otomatik veya manuel olarak ayarlanabilir.&#x20;
  * Otomatik seçildiğinde yazı boyutu grafik alanına sığacak şekilde sistem tarafından hesaplanır.&#x20;
  * Manuel seçimde ise yazılar, kullanıcının belirttiği değerde sabit olarak görüntülenir.
* **Gösterge Konumu:** Ölçüm ismi ve değer bilgisinin gösterge grafiği içinde nerede konumlanacağını (sağ/sol/üst/alt) belirler.

<mark style="color:green;">**Hedef**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2F3TX0Jpt5gTE8Br4folre%2Fimage.png?alt=media&amp;token=2f183c8c-dd3e-4e0d-8229-85a5409e445d" alt=""><figcaption></figcaption></figure>

* **Hedefi Göster:** Bu seçenek, grafik üzerinde bir hedef değerin görsel olarak gösterimini sağlar. Veri alanında bir hedef değeri tanımlanmışsa ya da statik bir hedef aralığı girilecekse, bu alan işaretlenerek grafiğe yansıtılır. Bu seçenek kaldırıldığında, Statik Hedef dahil olmak üzere hedefe ait tüm ayarlar pasif hâle gelir.
* **Statik Hedef:** Bu seçenek işaretlendiğinde, hedef değerin manuel olarak sabit bir aralık şeklinde tanımlanması sağlanır.
  * Etiket: Hedef gösteriminin yanında yer alacak açıklayıcı metin bilgisi girilir.
  * Değer Türü: Hedefin grafik üzerinde sayısal ya da yüzdesel olarak gösterileceği belirlenir.
  * Başlangıç: Hedefin tek bir çizgi veya noktadan ziyade bir aralık (bölge) olarak gösterilmek istendiği durumlarda, gösterge kadranı üzerindeki hedef bandının (renkli vurgu alanının) başlayacağı alt sayısal sınırı belirleyen alandır.
  * Bitiş: Gösterge üzerindeki hedef bandının sona ereceği üst sayısal sınırı belirleyen alandır.
  * Renk: Hedef alanını vurgulamak için kullanılacak renk seçilir.

<mark style="color:green;">**Animasyon**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FPCE1n25kIWs9l2b6VXhU%2Fimage.png?alt=media&amp;token=fe63540a-78d7-472c-a66d-01a197e07862" alt=""><figcaption></figcaption></figure>

* **Animasyon:** Gösterge grafik yüklendiğinde ya da veri değiştiğinde değerin nasıl bir geçiş animasyonu ile gösterileceğini belirler. (Doğrusal, Kübik, vb.)
* **Süre:** Animasyonun ne kadar sürede tamamlanacağını belirler. Değer saniye cinsindendir.

<mark style="color:green;">**Başlık Ayarları**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FdfHMpf5CCpZtcobUl3C5%2Fimage.png?alt=media&amp;token=a437252c-eb1d-4f29-bbab-168ab12d42a9" alt=""><figcaption></figcaption></figure>

* **Başlık:** Grafiğe verilecek başlığın tanımlandığı alandır.
* **Başlık Hizası:** Grafik başlığının sola, ortaya veya sağa hizalanmasını sağlar.
* **Başlık Yazı Stilleri:** Grafik başlığının kalın, italik veya altı çizili gibi yazı stilleriyle biçimlendirilmesini sağlar.
* **Başlık Yazı Stili:** Grafik başlığında kullanılacak yazı tipini (font) belirlemenizi sağlar.
* **Başlık Yazı Rengi:** Grafik başlığının metin renginin değiştirilmesini sağlar.
* **Başlık özelliklerini rapordaki diğer pluginlere uygula:** Tanımlanan başlık ayarlarının (stil, renk, hizalama vb.) aynı dashboard içindeki diğer grafik bileşenlerinin başlıklarına da otomatik olarak uygulanmasını sağlar.

<mark style="color:green;">**Veri Yok Ayarları**</mark>

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2FpNvk8JQkFeKyTwxLyalT%2Fimage.png?alt=media&amp;token=9329b5a8-5f22-4210-86f8-c48ddb3ea25b" alt=""><figcaption></figcaption></figure>

* **Veri Yok Açıklaması:** Veri gelmediğinde kullanıcıya gösterilecek mesajı belirler. Default olarak *“Seçilen kriterlerde veri bulunamadı. Plugin görselleştirilemedi.” mesajı görünür.*
* **Veri Yok Yazı Stilleri:** Mesajı **kalın** , *italik* veya altı çizili yapmanı sağlar.
* **Veri Yok Yazı Stili:** Yazı tipini/fontunu belirler.&#x20;
* **Veri Yok Yazı Boyutu:** Mesajın font büyüklüğünü belirler.&#x20;
* **Veri Yok Yazı Rengi:** Mesajın hangi renkte gösterileceğini belirler.

## Kullanım Örneği

<figure><img src="https://3143653407-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0vZHisAf5833eglFw2GE%2Fuploads%2F2wf3GxA3R1O8PSQT3lWf%2Fimage.png?alt=media&amp;token=0926a7b2-cf95-4752-ba77-6b453bd2ea45" alt=""><figcaption></figcaption></figure>

Gösterge (Gauge) grafiği, tek bir sayısal ölçü değerinin, belirlenen minimum ve maksimum sınırlar arasındaki konumunu ve varsa belirli bir hedefe göre durumunu yarım daire veya kadran şeklinde görselleştirmeyi sağlar. Veriler, geleneksel bir hız göstergesinde olduğu gibi bir ibre veya doluluk alanı ile ifade edilir.

Örnekte **Sistem Uptime Oranı** verisi gösterilmektedir. Grafiğin kadranı **%0 ile %100** arasında tanımlanmıştır. Yeşil dolgu alanı, mevcut değerin skala üzerindeki konumunu gösterirken, kadrandaki işaretçi sistemin mevcut performans seviyesini temsil etmektedir.

Grafikte ayrıca **%54,49** seviyesinde mavi bir referans çizgisi bulunmaktadır. Bu değer, mevcut sistem performansının karşılaştırıldığı hedef veya referans noktası olarak kullanılmaktadır.

Grafiğin alt kısmında yer alan **“Mevcut Değer: 78”** kutucuğu, ölçülen değerin güncel sonucunu doğrudan göstermektedir. Böylece kullanıcı, mevcut değeri hem sayısal olarak okuyabilir hem de gösterge üzerindeki konumunu görsel olarak değerlendirebilir.

Gösterge grafiği özellikle aşağıdaki durumlarda kullanılabilir:

* Belirli bir hedefe veya referans değere ne kadar yaklaşıldığının ya da hedefin ne kadar gerisinde/ilerisinde kalındığının anlık olarak takip edilmesi,
* Mevcut durumun tanımlanmış alt ve üst limitler arasındaki konumunun değerlendirilmesi,
* Sistem performansı, uptime oranı, kapasite kullanımı veya benzeri metriklerin kolay okunabilir bir kadran görünümüyle raporlanması.

Bu örnekte kullanılan alanlar:

* **Maksimum:** 100 — Gösterge kadranının üst sınırını belirtir.
* **Minimum:** 0 — Göstergenin başlangıç ve alt sınırını belirtir.
* **Ölçü Değeri:** 78 — Grafiğin alt kısmında **Mevcut Değer** olarak gösterilen güncel ölçüm değeridir.
* **Hedef / Referans Değer:** %54,49 — Kadran üzerinde mavi çizgi ile gösterilen ve mevcut durumun karşılaştırılmasında kullanılan referans noktasıdır.

Bu yapı sayesinde kullanıcı, sistemin mevcut performans seviyesini belirlenen sınırlar içerisinde hızlı bir şekilde değerlendirebilir ve referans değerle karşılaştırarak mevcut durum hakkında kolayca yorum yapabilir.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://learn.vispeahen.com/kumanda-tablosu/plugin-listesi/gorsel-bilesenler/gauge-chart-gosterge-tablosu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.