Copilot Usage Metrics API: IDE Dışı Araç Kullanımı
GitHub, Copilot usage metrics API’sine totals_by_client adında yeni bir dizi ekledi. Copilot’ı model sağlayıcı olarak kullanan ama editör telemetrisi göndermediği için raporlarda görünmeyen araçların trafiği bu alanla ölçülebiliyor. OpenCode gibi daha önce raporlara hiç yansımayan istemcilerin ürettiği istek ve token hacmi artık kurumsal raporlarda görünüyor. Copilot kullanımının hangi araçtan geldiğini sunucu tarafındaki istek sayımına bakarak görebiliyor, araç desteği ve yönetişim kararlarınızı gerçek kullanıma dayandırabiliyorsunuz.
totals_by_client ne dönduruyor?
Yeni dizi; enterprise, organization, enterprise-user ve organization-user raporlarının hem 1 günlük hem de 28 günlük sürümlerinde var. Toplulaştırılmış 28 günlük raporlarda totals_by_client, her day_totals girdisinin içinde yer alıyor.
Her totals_by_client girdisi tek bir istemciyi temsil ediyor ve şu alanları içeriyor:
client: İstekleri gönderen araç. Örnek değerler:opencode,claude_code,codex,zed,copilot_cli,github_app,cloud_agent,code_review,vscode,jetbrains. Tanınmayan istemcilerotheraltında gruplanıyor.request_count: İstemciden gelen başarılı model isteklerinin sayısı.session_count: İstemciden gelen farklı oturum sayısı.token_usage: Prompt token’ları, çıktı token’ları ve istek başına ortalama token.totals_by_model: Aynı istek ve token metriklerinin model bazında kırılımı.
Model seçim modu
totals_by_model içindeki model_selection_mode alanı, modelin nasıl belirlendiğini gösteriyor:
user_selected: Model doğrudan kullanıcı tarafından istenmiş.auto: Model otomatik seçim tarafından belirlenmiş.product_selected: Modeli ürünün kendisi seçmiş.other: Henüz ayrı ayrı raporlanmayan seçim modları.unknown: Normalleştirilemeyen değerler.
Bu kırılım neden gerekliydi?
Geliştiricilerin Copilot’ı IDE dışındaki araçların arkasındaki model sağlayıcı olarak kullanması yaygınlaştı. Bu araçlar çoğu zaman editör telemetrisi göndermiyor, dolayısıyla kullanımları totals_by_ide içinde görünmüyor ve hesabı tutulamıyordu. İsteklerin sunucu tarafında sayılması bu boşluğu kapatıyor; hangi aracın Copilot kullanımını sürüklediğini görebiliyor, araçlar arasında istek ve token hacmini karşılaştırabiliyorsunuz.
Bu ölçümü, daha önce duyurulan agent app activity ile karıştırmamak gerekiyor. Agent app activity, GitHub üzerinde Claude ve Codex gibi ajan uygulamaları tarafından başlatılan işleri (job) sayıyor. totals_by_client ise Copilot’ı kullanan herhangi bir araçtan gelen model trafiğini, yani istekleri ve token’ları ölçüyor. Biri kaç işin başlatıldığını, diğeri ne kadar model trafiği üretildiğini yanıtlıyor.
Erişim ve dikkat edilmesi gerekenler
Erişim: Veriye enterprise owner ve billing manager rolleri, organization owner rolü ve View Copilot Metrics iznini veren özel organizasyon ya da kurumsal rollere sahip kullanıcılar ulaşabiliyor. Copilot usage metrics politikasının da etkin olması gerekiyor.
Copilot code review ve Copilot cloud agent: Bu istemcilerden gelen istekler product_selected olarak raporlanıyor, çünkü modeli ürün seçiyor. Copilot code review modelleri ise unknown olarak görünüyor.
İstek sayımı: request_count prompt’ları değil model çağrılarını sayıyor. Tek bir prompt birden fazla model çağrısını tetikleyebildiği için bu alanı prompt veya etkileşim sayılarıyla doğrudan karşılaştırmak yanıltıcı olur.
İstemci tanımlama: İstemciler, her istekle birlikte gönderdikleri entegrasyon kimliğiyle (integration ID) ayırt ediliyor. GitHub, client alanının doğrulanmış bir kimlik değil, “best-effort” bir gruplama olarak ele alınmasını belirtiyor. Raporlamada bu alanı kesin bir kimlik kanıtı gibi kullanmamak gerekiyor.
Geriye dönük uyumluluk: Değişiklik eklemeli (additive). Mevcut alanlar olduğu gibi kalıyor, raporlanacak kullanım yoksa totals_by_client boş bir dizi dönüyor. Var olan entegrasyonlar kırılmadan çalışmaya devam ediyor, yine de boş dizi durumunu kodunuzda ele almak yerinde olur.
Raporlamada nasıl değerlendirilebilir?
Yeni alanla birlikte kurumsal tarafta şu türde sorular tek kaynaktan yanıtlanabiliyor. Copilot trafiğinin ne kadarı IDE’den, ne kadarı CLI ya da ajan tabanlı araçlardan geliyor? Hangi araç istek başına daha fazla token tüketiyor? Model seçimini kullanıcı mı yapıyor, yoksa otomatik seçim mi baskın? Bu kırılımlar, desteklenecek araç setini belirlerken ve yönetişim politikalarını şekillendirirken somut bir temel sağlıyor.
Alan bazlı yorumlarda other ve unknown değerlerinin payını ayrıca izlemek faydalı olur; henüz ayrıştırılamayan istemci veya seçim modlarını temsil ettikleri için toplam içindeki ağırlıkları analiz doğruluğunu etkileyebilir.
Kaynaklar ve İleri Okuma
- Usage metrics API adds usage from tools like OpenCode — GitHub Changelog
- Copilot usage metrics API dokümantasyonu
- Copilot usage metrics API adds agent app activity
- Copilot Usage Metrics API’ye Ajan Bazlı Aktivite Kırılımı
- Copilot Usage Metrics API ile Kullanıcı Bazlı AI Kredisi
20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.
Yorum gönder