Veri metodolojisi
Alveos’un yazılım dağıtım metriklerini nasıl topladığı, sakladığı, dönüştürdüğü ve etiketlediği.
İlkeler
Her metrik kaynak, anlam, güncellik, kapsam ve dönüşümü belirtmelidir. Eksik veri eksik kalır: Alveos kesintileri tahminle doldurmaz. «Resmî», «doğrulanmış» veya «bağımsız» yalnızca kaynak bu iddiayı gerçekten taşıyorsa kullanılır.
Kaynak sınıfları
- Herkese açık sağlayıcı kaynağı: VS Code Marketplace, Open VSX, GitHub Releases, PyPI ve Packagist gibi doğrudan herkese açık API’ler veya listeler.
- Herkese açık veri kümesi / güvenilir üçüncü taraf: PSF BigQuery veya PypiStats gibi adlandırılmış veri kümeleri.
- Ürünün kendi telemetrisi: bağlı ürün Alveos’a yaşam döngüsü olayları gönderir (Beacon; Streaming Zebra yakında). Sayılar üründen ve yayıncının sayım biçiminden gelir — olay tetikli, bir pazaryerinden çekilmez.
- Elle yayıncı içe aktarımı: örneğin yayıncının verdiği VS Code Publisher Hub verileri. Herkese açık Gallery sayaçlarından ayrı kalır.
Metriklerin anlamı
Kaynağın verdiğini Alveos saklar. Vermediği burada yakalanmaz.
| Kaynak | Verilen ve yakalanan | Eksik |
|---|---|---|
| VS Code Marketplace (Gallery) | Herkese açık sayaçlar (downloadCount, install, updateCount) — edinim |
Şu anda etkin kurulumlar: Gallery bunu vermez, Alveos burada yakalamaz |
| Open VSX | downloadCount (VSIX indirmeleri) |
Etkin kurulumlar, benzersiz kullanıcılar, kaldırmalar: ne verilir ne yakalanır |
| GitHub Releases | Sürüm dosyalarının download_count değeri |
Klonlar, özel depolar, kaynak arşivleri |
| PyPI / PypiStats | Dosya indirmeleri (aynasız günlük dizi) | Benzersiz kullanıcılar ve kurulumlar, çünkü kaynak onları saymaz |
| Packagist | downloads.total / monthly |
Kurulumlar ve benzersiz kullanıcılar |
| Beacon / yaşam döngüsü | Ürünün bildirdiği install, update, uninstall, usage ve build olayları | Pazaryeri sayaçları; uninstall çoğu zaman eksik |
| Publisher Hub (içe aktarma) | Yayıncının verdiği Daily-Stats günleri | Gallery SSOT değil; site VSIX yalnızca dosyada sütun varsa |
Farklı anlamdaki sayaçlar sessizce aynı metrik gibi gösterilmez.
Toplama, güncellik ve boşluklar
Herkese açık mağazaları Alveos günde bir kez 05:20 Europe/Berlin saatinde çeker. Saklanan bugünün UTC günüdür. Başarısız bir çekim günü atlar, geçmişi korur ve sıfır yazmaz. Gallery, Open VSX, GitHub, PyPI-JSON, PypiStats ve Packagist üç gün geriye doldurulmaz.
Grafikte: ilk saklanan günden itibaren düz çizgi son bilinen düzeyde kalır (step-hold). Arada bir çekim yoksa Alveos aynı düzeyi kesikli çizer — son bilinen değer, tahmin yok ve gerçek noktaların üstünde trend eğrisi yok. Penceredeki eksik günler işaretlenir. Bağlantıdan önceki günler boşluk değildir.
Son başarılı gün iki veya üç gün önceyse dizi gecikmiş; dördüncü günden itibaren bayat sayılır. Bu bir görüntü etiketidir, geri doldurma değildir.
İki istisna, sonraki çekim başarılı olursa daha yeni günleri yeniden yazar: Streaming Zebra özetteki D−2 ve D−1 değerlerini saklar; PyPI ülkeleri (BigQuery, ücretli tarifeler) son yedi UTC gününü yeniden yazar. Yayıncı içe aktarımı ve Beacon günlük çekim değildir ve kaçırılmış boşluk sayılmaz.
Dönüşüm ve karşılaştırılabilirlik
Alveos ham sağlayıcı değerlerini tutar ve kümülatif sayaç farkları, toplamlar, oranlar, içe aktarılan değerler ve süzülmüş bölümler gibi türetilmiş değerleri etiketler. Aynı teslimatı tanımlayabilecek doğrudan teslimat ve GitHub kanalları ayrı kalır. Streaming Zebra ve Beacon güncellemeleri iki kez eklenmez.
Tekrarlanabilir dışa aktarımlar
CSV ve JSON dışa aktarımları sağlayıcı, dış kimlik, kaynak sınıfı, metrik anlamı, kapsam başlangıcı, ritim, dönüşüm sürümü, kaynak bağlantısı ve satır SHA-256 özetini içerir. Geçmiş anlık görüntüler şu anda UTC günü duyarlılığındadır: fetched_on günü içerir, time_precision day değerindedir ve fetched_at uydurma bir saat yerine boş kalır.
Sağlayıcı referansları
| Kaynak | Çekim | Ritim |
|---|---|---|
| VS Code Gallery, Open VSX, GitHub Releases, PyPI-JSON, PypiStats, Packagist | Cron bugünün UTC gününü saklar | Günlük 05:20 Europe/Berlin |
| PyPI ülkeleri (BigQuery, ücretli tarifeler) | Son yedi UTC gününün upsert’i | Aynı cron |
| Streaming Zebra (yakında) | Özet; D−2 ve D−1 onarır | Aynı cron |
| Beacon | Ürün gönderir | Olay tetikli, günlük çekim değil |
| Publisher Hub | xlsx içe aktarma | İçe aktarmada |
- VS Code Marketplace
- Open VSX
- GitHub Release Assets API
- BigQuery’de herkese açık PyPI verileri
- Packagist API
Denetlenebilir düzeltmeler
Oturum açmış yayıncılar Veri düzeltmeleri altında zaten saklanmış bir bağlantıyı bildirir: UTC günü, metrik (indirmeler, kurulumlar veya güncellemeler), önerilen değer ve gerekçe. İstek gözlenen ham değeri kaydeder. Düzeltme kaçırılmış bir çekimi doldurmaz ve bir boşluğa tahmin yazmaz.
İnceleme, kabul, ret, uygulama ve yerine koyma, manipülasyonu görünür kılan bir hash zincirine yalnızca eklenen olaylardır. Uygulanan düzeltme sürümlü bir okuma katmanıdır; sağlayıcı anlık görüntüsü değişmez. Grafikler, toplamlar ve dışa aktarımlar etkin katmanı kullanır. CSV/JSON, correction_request_ids ve correction_original_json ile isteği ve özgün sağlayıcı değerlerini adlandırır. Daha yeni bir onay eski katmanı geri alır ama her iki denetim geçmişini saklar.
Sorular veya şüpheli veri hataları: support@alveos.eu.