Redis INFO Komutu ile Sunucu İzleme: Bölümler ve Önemli Alanlar

INFO nasıl çağrılır?

INFO isteğe bağlı olarak bir ya da daha fazla bölüm adı alır. Belgedeki bölüm listesi şöyledir: server, clients, memory, persistence, threads, stats, replication, cpu, commandstats, latencystats, sentinel, cluster, modules, keyspace, keysizes, errorstats ve hotkeys. Bunlara ek olarak üç özel değer vardır: all modüllerin ürettiği bölümler hariç her şeyi, default varsayılan kümeyi, everything ise all ile birlikte modül bölümlerini getirir.

redis-cli INFO
redis-cli INFO memory
redis-cli INFO clients stats
redis-cli INFO everything

Burada dikkat edilecek iki ayrıntı var. Birincisi, Redis 6'dan beri modüller INFO çıktısına kendi bölümlerini ekleyebilir; ancak bu bölümler all verildiğinde bile gelmez, yalnızca yüklü modüllerin listesi görünür. Modül alanlarını görmek için modules ya da everything yazmanız gerekir. İkincisi, belgede deneysel ölçümler içeren bir debug bölümü de anlatılır: bu bölüm INFO ya da INFO ALL çıktısına girmez, yalnızca INFO DEBUG ile döner ve alanları ileriki sürümlerde değişebilir.

Yanıtın biçimi ve güvenli okuma

Komut sayfasına göre RESP2'de yanıt bir bulk string, RESP3'te bir verbatim string'dir. Her özellik alan:değer biçimindedir ve satırlar \r\n ile biter; bazı değerler kendi içinde virgülle ayrılmış anahtar=değer çiftleri taşır (örneğin db0:keys=...,expires=...). Bölüm başlıkları # ile başlar ve bölümler arasında boş satırlar bulunur. Kendi izleme betiğinizi yazarken bu yapıyı satır satır ayrıştırmanız yeterlidir.

Belge burada önemli bir uyarı yapar: alanlar Redis sürümüne göre eklenip kaldırılır. Bu yüzden sağlam bir uygulama tanımadığı alanları atlamalı, beklediği bir alan yoksa çökmemelidir. Örneğin used_memory_lua alanı Redis 7.0'da kullanımdan kaldırılıp used_memory_vm_eval adını aldı; Redis 8.10 ise sıkıştırılmış hash'ler için used_memory_hash_templates gibi yeni alanlar ekledi. Sabit sırayla ya da sabit satır sayısıyla okuma yapan betikler sürüm yükseltmesinden sonra sessizce yanlış değer okur.

server ve clients: kim, ne zamandan beri, kaç bağlantı?

server bölümü kimlik bilgisidir. redis_version sunucunun sürümünü, redis_mode çalışma modunu (standalone, sentinel ya da cluster) gösterir. uptime_in_seconds ve uptime_in_days sunucunun ne zamandır ayakta olduğunu, config_file kullanılan yapılandırma dosyasının yolunu, executable çalışan programın yolunu, process_id işlem kimliğini, tcp_port dinlenen portu verir. Bir komut sunucunuzda yoksa ilk bakacağınız alan redis_version olur; hangi özelliğin hangi sürümle geldiğini Redis 8 yenilikleri yazısında topladık.

clients bölümünde en sık bakılan alan connected_clients'tır; belgeye göre bu sayıya replika bağlantıları dahil değildir. maxclients ise yapılandırmadaki üst sınırdır ve connected_clients, connected_slaves ile cluster_connections toplamı için geçerlidir. blocked_clients, BLPOP ya da BLMOVE gibi engelleyici bir çağrıda bekleyen istemcileri sayar; kuyruk tüketicileri kullanıyorsanız bu sayının yüksek olması normaldir. Redis 7.4 ile gelen pubsub_clients ve watching_clients alanları sırasıyla pub/sub modundaki ve WATCH kullanan istemcileri gösterir. Bağlantıların tek tek nereden geldiğini görmek için CLIENT LIST ve bağlantı yönetimi yazısına bakın.

memory: used_memory, RSS ve parçalanma

used_memory, Redis'in kendi bellek ayırıcısı üzerinden ayırdığı toplam bayttır; used_memory_human aynı değeri okunur biçimde verir. used_memory_rss ise işletim sisteminin gördüğü değerdir, yani top ya da ps araçlarının gösterdiği yerleşik bellek. used_memory_peak tepe kullanımı, Redis 8.2 ile eklenen used_memory_peak_time bu tepenin ne zaman görüldüğünü kaydeder. maxmemory ve maxmemory_policy sınırı ve sınıra ulaşıldığında uygulanacak politikayı yansıtır; politikaların anlamı maxmemory ve eviction politikaları yazısının konusudur.

Belgedeki yorum kuralı şudur: ideal durumda used_memory_rss, used_memory değerinden biraz yüksek olmalıdır. RSS çok daha büyükse dış parçalanma olabilir ve bunu doğrulamak için allocator_frag_ratio ile allocator_frag_bytes alanlarına bakılır. Ters durumda, yani used_memory RSS'ten belirgin biçimde büyükse, belleğin bir kısmı işletim sistemi tarafından takas alanına itilmiş demektir ve belge bu durumda ciddi gecikmeler beklenmesini söyler. Ayrıca Redis bellek bıraktığında bu bellek önce ayırıcıya döner; ayırıcı onu işletim sistemine hemen geri vermeyebilir. Bu yüzden RSS'in yüksek kalması çoğu zaman geçmişteki bir kullanım sıçramasının izidir ve used_memory_peak bunu anlamaya yardım eder.

mem_fragmentation_ratio alanını yorumlarken acele etmeyin. Belgeye göre bu oran yalnızca parçalanmayı değil, işlem ek yüklerini, kodu, paylaşılan kütüphaneleri ve yığını da içerir. Gerçek dış parçalanma ölçüsü allocator_frag_ratio'dur. Toplam fark birkaç megabayt gibi küçük bir değerse 1,5 ve üzeri bir oran sorun işareti sayılmaz. Anahtar bazında bellek ölçümü ve MEMORY STATS gibi komutlar Redis bellek kullanımı ve MEMORY USAGE yazısında anlatılıyor.

persistence: kayıtlar başarılı mı?

persistence bölümü, verinizin diske güvenle yazılıp yazılmadığını gösterir. rdb_last_bgsave_status son RDB kaydının durumunu, rdb_last_save_time son başarılı kaydın zaman damgasını, rdb_changes_since_last_save son SAVE ya da BGSAVE çağrısından bu yana veriyi değiştiren işlem sayısını verir. AOF açıksa aof_last_write_status son AOF yazımının sonucunu bildirir. Belgedeki MISCONF hata sayfası, rdb_last_bgsave_status:err ve aof_last_write_status:err değerlerini sorunun doğrulanma yolu olarak gösterir; bu hata ve çözümü OOM, MISCONF ve READONLY hataları yazısında.

Sunucu açılırken ya da replika birincilden tam kopya alırken loading alanı 1 olur. Yükleme sürerken ek alanlar görünür: loading_loaded_perc yüklenen yüzdeyi, loading_eta_seconds kalan süre tahminini verir. Bu sırada çoğu komut LOADING hatası alır ama INFO çalışmaya devam eder. Belgedeki örnek şöyledir:

> GET mykey
(error) LOADING Redis is loading the dataset in memory
> PING
(error) LOADING Redis is loading the dataset in memory
> INFO persistence
# Persistence
loading:1
...

Yedek alma komutları (BGSAVE, LASTSAVE, BACKUP) ve redis-cli --rdb ile uzaktan yedek Redis yedek alma yazısında ayrıntılı anlatılıyor.

stats: trafik, isabet oranı ve tahliye

stats bölümü sayaçlarla doludur ve çoğu sunucu açıldığından beri birikir. total_connections_received kabul edilen bağlantıları, total_commands_processed işlenen komutları, instantaneous_ops_per_sec saniyedeki komut sayısını gösterir. rejected_connections, maxclients sınırı yüzünden geri çevrilen bağlantıları sayar; bu sayı artıyorsa istemcilerden biri ERR max number of clients reached hatası alıyordur. expired_keys süresi dolan anahtar olaylarını, evicted_keys ise maxmemory sınırı yüzünden tahliye edilen anahtarları sayar.

Önbellek olarak kullanılan bir Redis için en anlamlı iki alan keyspace_hits ve keyspace_misses'tır: ana sözlükte başarılı ve başarısız anahtar aramalarının sayısı. İsabet oranını kendiniz hesaplarsınız: isabetleri, isabet ile ıskaların toplamına bölersiniz. Bu iki sayaç sunucu açılışından beri biriktiği için, kısa bir zaman dilimindeki oranı görmek istiyorsanız iki ölçüm arasındaki farkı kullanın. Önbellek kavramının kendisi önbellek nedir yazısında anlatılıyor.

Diğer yararlı alanlar şunlardır: total_error_replies gönderilen hata yanıtlarının toplamıdır ve belgeye göre hem çalışmadan önce reddedilen hem de çalışırken başarısız olan komutları kapsar. acl_access_denied_auth, acl_access_denied_cmd ve acl_access_denied_key yetki reddi sayılarıdır; şifre denemelerini izlemek için iyi bir göstergedir. latest_fork_usec son fork işleminin mikrosaniye cinsinden süresidir ve RDB kaydı ya da AOF yeniden yazımı sırasında yaşanan duraklamaları açıklayabilir. Redis 8.8 ile slowlog_commands_count ve slowlog_commands_time_ms_max gibi yavaş günlük sayaçları da bu bölüme eklendi; ayrıntısı SLOWLOG ve gecikme izleme yazısında.

replication ve cpu

replication bölümünde role alanı, sunucu kimsenin replikası değilse master, bir birincilin replikasıysa slave değerini alır. Protokolde eski adlandırma korunduğu için bu sözcükleri çıktıda görmeye devam edersiniz. Birincilde connected_slaves bağlı replika sayısını verir ve her replika için slave0, slave1 biçiminde kimlik, adres, port, durum, ofset ve gecikme (lag) içeren bir satır eklenir. Replikada ise master_host, master_port, master_link_status (up ya da down) ve master_last_io_seconds_ago alanları bağlantının sağlığını gösterir. Bağlantı koptuğunda master_link_down_since_seconds eklenir.

cpu bölümü used_cpu_sys ve used_cpu_user ile sunucu sürecinin tüm iş parçacıklarının tükettiği sistem ve kullanıcı CPU süresini, _children ekli alanlarla arka plan süreçlerinin (örneğin kayıt için açılan fork) tüketimini, _main_thread ekli alanlarla da yalnızca ana iş parçacığını verir. Ana iş parçacığının tüketimi sürekli artıyor ve komut sayısı aynı kalıyorsa, pahalı komutları bulmak için komut istatistiklerine geçin.

commandstats, latencystats ve errorstats

INFO commandstats her komut tipi için cmdstat_XXX adlı bir satır döndürür. Satırdaki calls çalıştırmaya ulaşan çağrı sayısı, usec bu çağrıların toplam CPU süresi, usec_per_call çağrı başına ortalama, rejected_calls reddedilen ve failed_calls başarısız çağrılardır. Redis 8.8'den itibaren yavaş günlüğe düşen komutlar için slowlog_count, slowlog_time_ms_sum ve slowlog_time_ms_max da eklenir. Bu bölüm, hangi komutun sunucuyu en çok meşgul ettiğini bulmanın en hızlı yoludur: usec değeri en yüksek komutlar toplam yükü, usec_per_call değeri en yüksek komutlar tekil pahalılığı gösterir.

INFO latencystats komut başına gecikme yüzdeliklerini latency_percentiles_usec_XXX satırlarıyla verir. Varsayılan yüzdelikler p50, p99 ve p999'dur; belge bunları değiştirmek için latency-tracking-info-percentiles ayarını, özelliği açmak için latency-tracking ayarını gösterir (ikisi de varsayılan olarak açıktır). INFO errorstats ise hataları ön eklerine göre sayar: her hata türü için errorstat_ERR, errorstat_WRONGTYPE gibi bir satır ve içinde count değeri bulunur. Sunucu bu bölümün aşırı sayıda farklı hatayla dolduğunu fark ederse bölümü kapatır, tek bir ERRORSTATS_DISABLED satırı gösterir ve hataları sunucu günlüğüne yazar. Hata ön eklerinin anlamları Redis hata mesajları yazısında.

keyspace ve keysizes: veritabanı başına anahtarlar

keyspace bölümü her veritabanı için db0:keys=...,expires=...,avg_ttl=...,subexpiry=... biçiminde bir satır ekler. keys anahtar sayısını, expires süre tanımlanmış anahtar sayısını verir. volatile-* tahliye politikalarından birini kullanıyorsanız expires değerinin sıfır olmaması gerekir; aksi halde Redis'in tahliye edebileceği anahtar yoktur. keysizes bölümü ise string, list, set, hash ve sorted set için boyut dağılımını 2 tabanlı logaritmik bir histogramla gösterir. Belgedeki iki veritabanlı örnek çıktı şöyledir:

# Keysizes
db0_distrib_strings_sizes:2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1,64K=1,128K=1,256K=1,512K=1,1M=1
db0_distrib_lists_items:1=1,2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1,64K=1
db0_distrib_sets_items:1=1,2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1,64K=1
db0_distrib_zsets_items:1=1,2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1,64K=1
db0_distrib_hashes_items:1=1,2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1
db1_distrib_strings_sizes:2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1,64K=1,128K=1,256K=1,512K=1,1M=1
db1_distrib_lists_items:1=1,2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1,64K=1
db1_distrib_sets_items:1=1,2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1,64K=1
db1_distrib_zsets_items:1=1,2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1,64K=1
db1_distrib_hashes_items:1=1,2=1,4=1,8=1,16=1,32=1,64=1,128=1,256=1,512=1,1K=1,2K=1,4K=1,8K=1,16K=1,32K=1

Satırları şöyle okursunuz: db0_distrib_lists_items satırındaki 64=1, eleman sayısı o kovaya düşen bir liste olduğunu söyler. Strings için ölçü bayt cinsinden boyut, diğer tipler için eleman sayısıdır. Bu bölüm, tüm anahtar uzayını taramadan büyük anahtarların var olup olmadığını kabaca görmenizi sağlar; hangi anahtarın büyük olduğunu bulmak için ise redis-cli --bigkeys gibi tarama araçları gerekir.

Son olarak iki küçük bölüm daha var. cluster bölümünde tek bir alan bulunur: cluster_enabled, sunucunun cluster modunda çalışıp çalışmadığını gösterir. Cluster'ın kendi durum alanları CLUSTER INFO ile alınır ve Redis Cluster ve hash slot yazısında anlatılıyor. hotkeys bölümü ise Redis 8.6 ile gelen sık erişilen anahtar takibinin açık olup olmadığını (tracking_active), bu takibin kullandığı belleği ve harcadığı CPU süresini bildirir.

Sayaçlar ne zaman sıfırlanır? CONFIG RESETSTAT

stats, commandstats ve errorstats gibi bölümlerdeki sayaçların çoğu sunucu açıldığında sıfırdan başlar ve yeniden başlatmaya kadar büyür. Sayaçları el ile sıfırlamak için CONFIG RESETSTAT kullanılır. Komut sayfası, sıfırlanan değerlerin tam olmayan bir listesini verir: anahtar uzayı isabet ve ıskaları, süresi dolan anahtar sayısı, komut ve hata istatistikleri, alınan, reddedilen ve tahliye edilen bağlantılar, kalıcılık istatistikleri ve aktif birleştirme (defrag) istatistikleri. Aynı komut LATENCY HISTOGRAM verisini de siler. Yanıtı her zaman OK olan basit bir string'dir.

redis-cli --stat ile canlı izleme

Kendi betiğinizi yazmadan önce redis-cli içindeki sürekli istatistik modunu deneyin. --stat seçeneği her saniye yeni bir satır basar; satırda anahtar sayısı, bellek, istemci sayısı, engellenmiş istemciler, toplam istek sayısı ve parantez içinde bir önceki satırdan bu yana farkı ve bağlantı sayısı görünür. Belgedeki örnek çıktı:

$ redis-cli --stat
------- data ------ --------------------- load -------------------- - child -
keys       mem      clients blocked requests            connections
506        1015.00K 1       0       24 (+0)             7
506        1015.00K 1       0       25 (+1)             7
506        3.40M    51      0       60461 (+60436)      57
506        3.40M    51      0       146425 (+85964)     107
507        3.40M    51      0       233844 (+87419)     157
507        3.40M    51      0       321715 (+87871)     207
508        3.40M    51      0       408642 (+86927)     257
508        3.40M    51      0       497038 (+88396)     257

Örnekte üçüncü satırdan itibaren istemci sayısı 1'den 51'e çıkıyor ve saniyedeki istek farkı 85-88 bin aralığına sıçrıyor; yani bir yük testi başlamış. -i seçeneği satır aralığını saniye cinsinden değiştirir, varsayılan bir saniyedir. Bağlantı seçenekleri (-h, -p, -a, -u) ve diğer özel modlar redis-cli kullanımı yazısında anlatılıyor.

redis-cli --stat -i 5
redis-cli -h 10.0.0.12 -p 6379 --stat

Küçük bir örnek: sabah sağlık kontrolü

Bir VPS üzerinde çalışan tek Redis sunucusu için her sabah birkaç dakikada yapabileceğiniz bir kontrol akışı düşünelim. Aşağıdaki komutlar yalnızca okuma yapar ve sunucuyu değiştirmez:

redis-cli INFO server
redis-cli INFO memory
redis-cli INFO persistence
redis-cli INFO stats
redis-cli INFO keyspace
redis-cli INFO errorstats

INFO server çıktısında uptime_in_seconds beklenmedik biçimde küçükse sunucu gece yeniden başlamış demektir; bu durumda sayaçların da sıfırlandığını unutmayın. INFO memory çıktısında used_memory_human ile maxmemory_human değerlerini karşılaştırın ve sınıra yaklaşıyorsanız politikanın ne olduğuna bakın. INFO persistence çıktısında rdb_last_bgsave_status değerinin ok olması ve rdb_last_save_time değerinin yakın bir zamanı göstermesi gerekir. INFO stats çıktısında rejected_connections ve evicted_keys değerlerinin dünden bu yana artıp artmadığını, isabet oranının düşüp düşmediğini not edin. INFO errorstats çıktısında yeni bir hata türü belirdiyse uygulama günlüklerine bakma zamanı gelmiştir. Linux tarafındaki genel sunucu bakımı için Linux sunucu yönetimi temelleri yazısına da göz atabilirsiniz.

Sık yapılan hatalar

• Alanları sabit sırayla okumak: Sürüm değişince alanlar eklenir ya da kalkar. Ayrıştırıcınız alan adına göre çalışmalı ve bilinmeyen alanları atlamalıdır.
• connected_clients değerini toplam bağlantı sanmak: Bu alan replika bağlantılarını içermez. maxclients sınırı ise replikaları ve cluster bağlantılarını da kapsar.
• mem_fragmentation_ratio değerine tek başına güvenmek: Oran, kod ve kütüphane gibi ek yükleri de içerir; gerçek parçalanma için allocator_frag_ratio ve bayt cinsinden farklara bakın.
• INFO all ile modül alanlarını beklemek: Modül bölümleri yalnızca modules ya da everything ile gelir.
• Birikimli sayacı anlık değer sanmak: keyspace_hits, expired_keys gibi alanlar açılıştan beri birikir. Eğilim görmek için düzenli aralıklarla ölçüp farkı alın.

Sık Sorulan Sorular

INFO komutu sunucuyu yavaşlatır mı?

Komut sayfası INFO için bir maliyet uyarısı içermiyor ve LOADING sırasında bile çalıştığı belirtiliyor. Yine de izleme sisteminizi gereğinden sık sorgu atacak biçimde ayarlamayın; çoğu panel için birkaç saniyede bir ölçüm yeterlidir. Asıl maliyetli izleme aracı MONITOR'dur ve gecikme izleme yazısında neden dikkatli kullanılması gerektiğini anlatıyoruz.

Sunucunun hangi Redis sürümü olduğunu nasıl öğrenirim?

redis-cli INFO server çalıştırıp redis_version alanına bakın. Bir komut ERR unknown command hatası veriyorsa, belgeler de ilk olarak bu alana bakmanızı önerir.

Önbellek isabet oranını nereden görürüm?

INFO stats içindeki keyspace_hits ve keyspace_misses alanlarından hesaplarsınız. Redis bu oranı hazır bir alan olarak vermez; iki sayaç arasındaki oranı kendiniz bulursunuz.

INFO çıktısını programdan nasıl işlerim?

Yanıtı satırlara bölün, # ile başlayan ve boş satırları atlayın, kalan satırları ilk iki nokta üst üste işaretinden ayırın. Değerin içinde virgül ve eşittir varsa (örneğin cmdstat_get ya da db0 satırları) onu ikinci kez ayrıştırın. İstemci kütüphanelerinin çoğu bu işi sizin için yapar; dil bazında kullanım için redis-py ve node-redis yazılarına bakabilirsiniz.

Marka adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen kuruluşlarla bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.

İlgili içerikler: Redis öğrenme rehberi · SLOWLOG ve gecikme izleme · Redis bellek kullanımı · maxmemory ve eviction · CLIENT LIST ve bağlantılar · Redis yedek alma