Heartbeat Event Sozlesmeleri

Bu sayfa Heartbeat Servisi tarafindan uretilen eventlerin payload sozlesmelerini ve zorunlu alanlarini verir.

Event Haritasi

Event	Ne zaman kullanilir?	Producer	Consumer	Amac
heartbeat.metrics.updated.v1	Ping sonucunda durum degismeden metrik guncellendiginde	Heartbeat Servisi	Observer/API Projection	Son olcum metriklerini yaymak
heartbeat.status.changed.v1	Durum gecisi oldugunda (online/degraded/offline)	Heartbeat Servisi	Observer/Alarm	Canlilik degisimini duyurmak
heartbeat.failed.v1	Islem teknik hata ile sonlandiginda	Heartbeat Servisi	Observer	Hata gorunurlugu ve retry orchestration

Ortak Envelope

{
  "event": "<name>.v1",
  "meta": {
    "schema_version": 1,
    "trace_id": "hb-2a6c",
    "producer_service": "heartbeat-service",
    "produced_at": "2026-04-14T10:20:01.120Z",
    "process_ms": 7
  },
  "context": {
    "sim_id": 41,
    "iccid": "8945001234567890123"
  },
  "data": {},
  "error": null
}

heartbeat.metrics.updated.v1

Alan	Tip	Zorunlu	Aciklama
event	string	Evet	Sabit deger: heartbeat.metrics.updated.v1
meta.schema_version	integer	Evet	Event sema surumu
meta.trace_id	string	Evet	Dagitik izleme kimligi
meta.producer_service	string	Evet	Sabit deger: heartbeat-service
meta.produced_at	datetime	Evet	Event uretim zamani
context.sim_id	integer	Evet	SIM kimligi
context.iccid	string	Evet	SIM ICCID
data.status	string	Evet	online | degraded | offline
data.ping_time_ms	number/null	Evet	Ping suresi (basarisiz durumda null)
data.consecutive_fail_count	integer	Evet	Ardisik hata sayisi
data.last_checked_at	datetime	Evet	Son kontrol zamani
error	null	Evet	Basari eventinde daima null

heartbeat.status.changed.v1

Alan	Tip	Zorunlu	Aciklama
event	string	Evet	Sabit deger: heartbeat.status.changed.v1
meta.*	object	Evet	Ortak metadata
context.sim_id	integer	Evet	SIM kimligi
context.iccid	string	Evet	SIM ICCID
data.previous_status	string	Evet	Onceki durum
data.current_status	string	Evet	Yeni durum
data.consecutive_fail_count	integer	Evet	Guncel ardisik hata sayisi
data.last_success_at	datetime/null	Evet	Son basarili kontrol
error	null	Evet	Basari eventinde daima null

heartbeat.failed.v1

Alan	Tip	Zorunlu	Aciklama
event	string	Evet	Sabit deger: heartbeat.failed.v1
meta.*	object	Evet	Ortak metadata
context.sim_id	integer/null	Hayir	Hata global asamada ise bos olabilir
context.iccid	string/null	Hayir	Hata global asamada ise bos olabilir
error.failed_stage	string	Evet	target_selection | ping | persist | publish
error.error_code	string	Evet	Makine okunur kod
error.error_message	string	Evet	Aciklama
error.retryable	boolean	Evet	Yeniden denenebilirlik
error.failed_at	datetime	Evet	Hata zamani

Retryable Karar Matrisi

• HEARTBEAT_DB_TRANSIENT: true
• HEARTBEAT_KAFKA_TRANSIENT: true
• HEARTBEAT_TARGET_QUERY_INVALID: false
• HEARTBEAT_CONFIG_INVALID: false
• HEARTBEAT_PING_TIMEOUT: true