💻
💻
💻
💻
Cheet Sheets
Ask or search…
K
🦯

Selectors & Matchers

PromQL'de "selector" ve "matcher" kavramları, zaman serisi verilerinin filtrelenmesinde kullanılır. Selector, etiket adları ve değerleri kullanarak belirli zaman serilerini seçmek için kullanılan bir dizi etiket eşleştirmesidir. Matcher, belirli bir etiket eşleştirmesini ifade eder.
Örneğin, aşağıdaki PromQL sorgusu bir selector ve iki adet matcher içerir:
process_cpu_seconds_total{instance='10.90.0.144:9100',job='node_exporter'}
selector;
process_cpu_seconds_total
Bu bölüm, "process_cpu_seconds_total" zaman serisi için bir selector görevi görür.
matchers;
{instance='10.90.0.144:9100', job='node_exporter'}
Bu bölüm, filtrelemek için kullanılan bir matcher veya etiket eşleştiricisidir. Bu örnekte, "instance" etiketi "10.90.0.144:9100" ve "job" etiketi "node_exporter" olan zaman serileri seçilir.

Matcher Types

Equality Matcher

PromQL'de Equality Matcher, belirli bir etiketin belirli bir değere eşit olmasını sağlar. "=" veya "==" sembolü, eşitlik karşılaştırması için kullanılır.
process_cpu_seconds_total{instance='10.90.0.144:9100',job='node_exporter'}
Yukarıdaki sorguda aşağıdaki gibi Equality Matchers kullanılmıştır:
instance='10.90.0.144:9100'
job='node_exporter'
Yukarıdaki sorgu, "instance" etiketi "10.90.0.144:9100" ve "job" etiketi "node_exporter" olan zaman serilerini seçer. "=" sembolü, etiketin belirtilen değere eşit olması gerektiğini belirtir. Bu nedenle, bu iki etiket eşitlik karşılaştırması ile sorgulanmaktadır.

Negative Equality Matcher

Belirli bir etiketin belirli bir değere eşit olmamasını sağlar. "!=" sembolü, eşit olmama karşılaştırması için kullanılır.
Örneğin, "http_requests_total" zaman serisinde, "method" etiketi "POST" olmayan zaman serilerini seçmek istediğimizi varsayalım. Bunun için aşağıdaki sorgu kullanılabilir:
http_requests_total{method!="POST"}
Bu sorgu, "http_requests_total" zaman serisi için "method" etiketi "POST" olmayan tüm zaman serilerini seçer. "!=" sembolü, etiketin belirtilen değere eşit olmaması gerektiğini belirtir.
Veya diğer bir örnek,
process_cpu_seconds_total{job!='node_exporter'}
Yukarıdaki sorgu, "process_cpu_seconds_total" zaman serisinde "job" etiketi "node_exporter" olmayan tüm zaman serilerini seçer. "!=" sembolü, etiketin belirtilen değere eşit olmaması gerektiğini belirtir ve bu şekilde Negative Equality Matcher kullanılmış olur.

Regular expression matcher

Regular expression matcher, belirli bir etiketi belirli bir regular expression ile eşleştirmek için kullanılır.
Aşağıdaki sorgu, "prometheus_http_requests_total" zaman serisinde, "handler" etiketi "/api" ile başlayan herhangi bir karakter dizisiyle devam eden tüm zaman serilerini seçmek için kullanılır. "=~" sembolü, etiketin belirtilen regular expression ile eşleşmesi gerektiğini belirtir.
prometheus_http_requests_total{handler=~"/api.*"}
"prometheus_http_requests_total" zaman serisi, HTTP isteklerinin toplam sayısını içeren bir zaman serisidir. Bu sorgu, sadece "/api" ile başlayan istekleri sayacak şekilde filtreleme yapar.
Yani, bu regular expression "/api" ile başlayan ve sonrasında herhangi bir karakter dizisiyle devam eden tüm değerleri seçer.
Veya başka bir örneğe geçersek,
node_disk_io_now{device=~"sd(a|b)"}
Bu sorgu, "node_disk_io_now" zaman serisinde, "device" etiketi "sda" veya "sdb" olan tüm zaman serilerini seçmek için kullanılır. "=~" sembolü, etiketin belirtilen regular expression ile eşleşmesi gerektiğini belirtir.
Regular expression kısmı, "sd(a|b)" şeklinde tanımlanmıştır. Burada, "(a|b)" parantez içindeki "|" operatörüyle ayrılmış iki seçenekten herhangi birini temsil eder. Yani, bu regular expression "sda" veya "sdb" değerlerini seçer.
Bu sorgu, disk giriş/çıkış işlemlerinin anlık değerlerini tutan "node_disk_io_now" zaman serisi için, "/dev/sda" veya "/dev/sdb" diski için ayrı ayrı olmak yerine, her iki diski de kapsayan bir sonuç verir.

Negative regular expression matcher

Negative regular expression matcher, belirtilen değeri içermeyen etiket değerlerini seçmek için kullanılır. Matcher, "=~!" sembolü kullanılarak tanımlanır.
node_disk_io_now{device!~"sd(a|b)"}
Yukarıdaki sorgu, "node_disk_io_now" zaman serisinde, "device" etiketi "sda" veya "sdb" değerlerini içermeyen tüm zaman serilerini seçmek için kullanılır. "=~!" sembolü, etiketin belirtilen regular expression ile eşleşmeyen değerleri seçmek için kullanılır.
Regular expression kısmı, "sd(a|b)" şeklinde tanımlanmıştır. Burada, "(a|b)" parantez içindeki "|" operatörüyle ayrılmış iki seçenekten herhangi birini temsil eder. Yani, bu regular expression "sda" veya "sdb" değerlerini içeren etiket değerlerini seçer.
Özetle bu sorgu, disk giriş/çıkış işlemlerinin anlık değerlerini tutan "node_disk_io_now" zaman serisi için, "/dev/sda" veya "/dev/sdb" diskleri hariç, herhangi bir diski kapsayan sonuçlar verir.
Veya başka bir örnek verelim,
node_disk_read_bytes_total{device!~"sd(a|b)"}[2m]
Yukarıdaki sorgu "node_disk_read_bytes_total" metrik adına sahip tüm zaman serilerini seçerken "device" etiketi "sda" veya "sdb" olanları hariç tutar ve son 2 dakikaya ait verileri getirir.
Özetle, bu sorgu "node_disk_read_bytes_total" metrik adına sahip tüm zaman serilerini seçer ve "device" etiketi "sda" veya "sdb" olan zaman serileri hariç diğer tüm zaman serileri seçilir. Sonrasında son 2 dakikaya ait verileri getirir.
Bonus Sorgu;
avg_over_time(windows_logical_disk_free_bytes{volume!~"C:"}[1m])/1024/1024/1024
Bu sorgu Windows işletim sistemi üzerindeki C sürücüsü harici tüm disklerin son 1 dakika içinde ortalama boş alanını gigabyte cinsinden verir.
  • windows_logical_disk_free_bytes{volume!~"C:"}: C sürücüsü haricindeki tüm disklerin boş alanı verir.
  • [1m]: Bu ifade son 1 dakika içindeki verileri sorgulayacağımızı belirtir.
  • avg_over_time(): Belirtilen zaman aralığı içindeki değerlerin ortalamasını alır.
  • /1024/1024/1024: Byte cinsinden verilen disk boyutunu gigabyte cinsine çevirir.
-----------------------------------------------------------------------------------------------------
prometheus_http_requests_total{handler=~"/a.*"}[1m]
Yukarıdaki sorgu, son 1 dakika içinde "/a" ile başlayan handler'lar için yapılan HTTP isteklerinin toplam sayısını döndürür. =~ operatorü regular expression matcher'ını temsil eder. [1m] ifadesi son 1 dakika içindeki verileri sorguladığını belirtir.
windows_service_state{state!~".*d"}
Yukarıdaki sorgu, "state" etiketi "d" ile bitmeyen Windows hizmetlerinin durumunu gösterir. !~ kullanılarak negatif bir regular expression araması yapılır. Bu sorgunun sonucu, "state" etiketi "d" ile bitmeyen tüm Windows hizmetlerinin durumlarını içerecektir.