Ana içeriğe geç

Sık Sorulan Sorular ve Troubleshooting

S: Device buffer içinde calibration metası tutuyor muyuz?

Hayır, tutmuyoruz.

Calibration servisi yalnızca mevcut buffers.measurements ölçüm alanlarını günceller.
Ek bir buffers.measurements.calibration meta alanı yazılmaz.
Kalibrasyonun sonucu ve bağlamı Kafka eventleri ve servis logları üzerinden izlenir.

S: Kalibrasyon sırasında Redis içinde yeni buffer mı açılıyor?

Hayır.

Sadece mevcut buffers.measurements alanları in-place güncellenir.
Yeni paralel kalibrasyon buffer alanı oluşturulmaz.

S: `ct_ratio` bulunamazsa servis ne yapar?

Servis uyarı üreterek devam eder:

CT_CONFIG_MISS warning set edilir.
Fallback olarak ct_ratio = 1 kullanılır.
Akış calibration.ready.v1 ile devam edebilir.

S: Kalibrasyon kuralı yoksa ne olur?

İlgili değişken için kalibrasyon pas geçilir ve orijinal değer korunur. Bu hata değildir.

S: CT kalibrasyonu ile diğer kalibrasyonların sırası nedir? Priority bunu değiştirir mi?

Sıra sabittir:

Önce CT dönüşümü uygulanır.
Sonra değişken bazlı gain/offset kalibrasyonu uygulanır (aktifse).

priority bu yürütme sırasını değiştirmez. Sadece CT sonrası, aynı değişken için birden çok aktif aday varsa hangi kuralın seçileceğini belirler.

S: Hangi durumda `calibration.failed.v1` üretilir?

Tipik teknik hata durumları:

Kural store erişilemez (CAL_RULE_STORE_UNAVAILABLE)
Snapshot/şema bozuk (CAL_SNAPSHOT_INVALID)
Hesaplama sırasında beklenmeyen hata (CALCULATION_ERROR)
Redis write başarısız

S: Kafka publish başarısız olursa kalibrasyon kaybolur mu?

Hayır.

Redis güncellemesi başarılıysa kalibre state korunur.
Publish hatası outbox/retry ile tekrar denenir.
Downstream gecikir, veri kaybı oluşmaz.

S: Hangi metrikler kritik izlenmeli?

Metrik	Alarm Eşiği
`calibration_ready_rate`	Ani düşüşte alarm
`calibration_failed_rate`	> %1 ise alarm
`cal_rule_lookup_latency_ms`	Sürekli artışta alarm
`ct_config_miss_rate`	Ani artışta cihaz konfigürasyon incelemesi
`redis_calibration_write_failures`	> 0 ise kritik
`kafka_calibration_publish_failures`	> 0 ise retry/outbox takibi

S: Bu servisin detay akışlarını nerede görebilirim?