Copilot Usage Metrics API Eksik Telemetriyi Gösteriyor

Copilot kullanım raporunda kullanıcı aktif görünüyor ama satır sayısı, özellik kırılımı ve model dağılımı boş geliyorsa, sorunun nerede olduğu şimdiye kadar tahminle bulunuyordu. Copilot usage metrics API bu boşluğu artık doğrudan işaretliyor: hangi kullanıcıdan istemci telemetrisi gelmediğini, hangi kullanıcının IDE ya da Copilot eklentisinin kullanım metrikleri için gereken minimum sürümün altında kaldığını raporlardan görebiliyorsunuz. Eksik veriye yol açan kullanıcıları destek kaydı açmadan tek tek bulup gidermek mümkün oluyor.

Yeni gelen alanlar

Güncelleme iki tür alan getiriyor: kullanıcı bazlı iki alan, gün bazlı iki sayaç.

• client_telemetry_present: İlgili gün için o kullanıcıdan istemci telemetrisi alınıp alınmadığını belirtir. Değer false ise Copilot kullanıcının aktivitesini görüyor ama editöründen herhangi bir kullanım olayı (usage event) ulaşmıyor demektir.
• usage_metrics_requirements: Kullanıcının IDE’lerini ve Copilot eklentilerini tek tek listeler, her birini minimum desteklenen sürümlere karşı met, unmet veya unknown olarak işaretler.
• missing_client_telemetry_user_count: O gün client_telemetry_present değeri false olan kullanıcı sayısı.
• below_usage_metrics_minimum_user_count: O gün en az bir IDE’si veya eklentisi minimum sürümün altında olan kullanıcı sayısı.

Kullanıcı bazlı alanlar enterprise ve organization kullanıcı raporlarında, gün bazlı sayaçlar enterprise ve organization raporlarında görünür.

Eksik telemetri raporlamayı nasıl etkiliyor

İstemci telemetrisi gelmeyen kullanıcılar yine de aktif sayılır, ancak bu kullanıcıların raporlarında kod satırı, özellik kırılımı ve model kırılımı gibi ayrıntılar eksik kalır. Toplam aktif kullanıcı sayınız doğru görünürken kullanım derinliğini gösteren metrikler olduğundan düşük raporlanabilir. Benimseme analizini de lisans değerlendirmesini de yanıltan şey budur.

GitHub’ın belirttiği yaygın nedenler şunlar:

• Güncel olmayan editörler veya eklentiler,
• IDE tarafında telemetrinin devre dışı bırakılmış olması,
• Olayların iletilmesini engelleyen proxy veya güvenlik duvarı yapılandırmaları.

Yeni alanlar kaç kullanıcının bu durumlardan etkilendiğini ve kiminle iletişime geçilmesi gerektiğini gösteriyor, yani sorunu destek talebi açmadan kapatma imkanı veriyor.

Kapsam: hangi rapor hangi alanı içeriyor?

Raporu doğru yorumlamak için bu ayrımı bilmek gerekiyor:

• Kullanıcı alanları (client_telemetry_present ve usage_metrics_requirements), enterprise ve organization kullanıcı raporlarında yer alır; hem 1 günlük hem de 28 günlük raporlarda bulunur.
• Sayaçlar (missing_client_telemetry_user_count ve below_usage_metrics_minimum_user_count), enterprise ve organization 1 günlük raporlarında ve 28 günlük raporların her bir day_totals girdisinde görünür.

Erişim için gereken yetkiler

Bu alanlara enterprise owner, enterprise billing manager ve organization owner rolleri erişebilir. View Copilot Metrics iznini veren özel bir organization veya enterprise rolüne sahip olan herkes de verileri görebiliyor. Hepsinin ön koşulu, Copilot usage metrics politikasının etkinleştirilmiş olması.

Sayaçları yorumlarken dikkat edilecekler

Yeni sayaçlar günlük veridir, her sayaç yalnızca tek bir günü kapsar. GitHub burada iki hatalı kullanıma karşı açıkça uyarıyor:

• Bir kullanıcı hem missing_client_telemetry_user_count hem de below_usage_metrics_minimum_user_count içinde sayılabilir. Bu yüzden iki sayacı toplamayın; topladığınızda aynı kullanıcıyı iki kez saymış olursunuz.
• Günlük sayaçları birbirine ekleyerek benzersiz kullanıcı sayısı çıkarmaya çalışmayın. Aynı kullanıcı birden fazla günde tekrar sayılacağı için çıkan toplam tekil kullanıcı sayısını vermez.

Tekil kullanıcı analizi gerekiyorsa sayaçları toplamak yerine kullanıcı bazlı alanlara bakmak gerekir.

İki sinyal birbirinden bağımsız

Sürüm uyumu ile telemetri varlığı ayrı sinyaller. Bir kullanıcı minimum sürüm gereksinimlerinin hepsini karşılıyor olsa bile telemetrisi eksik olabilir; proxy arkasında çalışması böyle bir durum. “Herkes güncel, demek ki veri tamdır” varsayımı bu yüzden doğru değil, iki alanı birlikte değerlendirmek gerekiyor.

Null ve eksik değerlerin anlamı

Null olan veya hiç dönmeyen değerler false ya da sıfır anlamına gelmez, verinin mevcut olmadığını gösterir. Bu ayrım özellikle otomatik raporlama hatlarında önem taşıyor: null değeri sıfıra çevirip grafiğe yazmak “hiç sorun yok” izlenimi yaratır. Güncelleme öncesindeki günler için de herhangi bir değer bulunmuyor; geriye dönük karşılaştırmada bunu hesaba katın.

Pratikte izlenecek akış

Kaynakta tarif edilen akış basit. Önce enterprise veya organization raporundaki günlük sayaçlara bakıp etkilenen kullanıcı hacmini görürsünüz, ardından kullanıcı raporundaki client_telemetry_present ve usage_metrics_requirements alanlarıyla sorunun kaynağının sürüm mü telemetri aktarımı mı olduğunu ayırt edersiniz. usage_metrics_requirements içinde unmet görünen IDE veya eklentiler için güncelleme yönlendirmesi yapılır. Sürümler met olduğu halde telemetri hala gelmiyorsa IDE telemetri ayarı ve ağ tarafındaki proxy/firewall yapılandırması incelenir. unknown değerleri kesin bir uyumsuzluk kanıtı değil, bilginin belirlenemediği durumları ifade eder.

Bu alanların başlangıç noktası ve ayrıntılı şeması için GitHub’ın Copilot usage metrics API dokümantasyonu referans alınmalı.

Kaynaklar ve İleri Okuma

• github.blog
• github.blog

• GitHub Changelog: Usage metrics API flags telemetry and version gaps
• Copilot usage metrics API dokümantasyonu
• Copilot metrics kavramları ve minimum desteklenen sürümler
• Copilot Usage Metrics’te Eksik Ajan Verisi: IDE Güncelleyin
• Copilot Usage Metrics API’ye Ajan Bazlı Aktivite Kırılımı