Observability

vNext observable-by-default prensibiyle (bkz. #7) tasarlanmıştır: bir akış canlıya çıktığı an gözlemlenmektedir, ek enstrümantasyon gerekmez.

Telemetri Veri Akışı

Sinyaller

Distributed Tracing

• Standart: OpenTelemetry (OTLP)
• Instrumentation: HTTP, Dapr (service invocation, pub/sub), DB, Redis, custom spans
• Custom spans & events:
  • workflow.transition — geçiş tetiklenmesi
  • workflow.task.execute — task yürütümü
  • workflow.script.run — Roslyn script çalışması
  • workflow.outbox.publish — outbox event yayını
• Correlation:
  • Parent ↔ child workflow ilişkisi (sub-workflow)
  • HTTP / pub-sub trace context propagation
  • Instance ID + correlation ID her span'de

Structured Logging

• Format: JSON (machine-readable)
• Standart alanlar: timestamp, level, service, domain, workflow_id, instance_id, trace_id, span_id, correlation_id
• Sensitive data: PII alanları redaction layer'dan geçer
• Sink: OpenTelemetry Logs → Elastic (Kibana) / OpenObserve

Metrics

Kategori	Örnek Metrik	Kaynak
HTTP	request rate, latency p50/p95/p99, error rate	Orchestration / Execution API
Workflow	transition count, transition duration, active instance count	Execution API
Task	task execution duration, success/failure, retry count	Execution API
Cache (Redis)	hit/miss ratio, eviction count, latency	Redis exporter
Database (PostgreSQL)	connection pool, slow query, lock wait	PG exporter
Pub/Sub	publish rate, consume lag, DLQ rate	Dapr / broker exporter
Outbox	drain rate, backlog size, publish failure	Outbox worker
Inbox	inbox lag, dedupe hit, apply failure	Inbox worker

Health Endpoints

Servis	Endpoint	Probe Tipi
Orchestration API	:4201/health	liveness + readiness
Execution API	:4202/health	liveness + readiness
Inbox Worker	/health (workers HTTP host)	liveness
Outbox Worker	/health (workers HTTP host)	liveness

Kubernetes deployment'larda livenessProbe ve readinessProbe bu endpoint'lere bağlanır. Health-based traffic sayesinde sağlıksız replica'ya istek gitmez.

SLO Bağlantısı

Product roadmap Now fazında "Operasyonel SLO" işlendi. Bu sayfa o SLO'ların ölçüm altyapısını sağlar:

• Availability: health endpoint + HTTP success rate
• Latency: HTTP p99 + transition duration p99
• Throughput: transition rate + outbox publish rate
• Error budget: error rate + DLQ rate

Detay: Product / Roadmap — Now

Çapraz Bağlantılar

• Çekirdek Prensipler — Observable by Default
• Runtime topolojisi
• Product / Release Strategy — release notes ve SLO standartları
• Gözlemlenebilirlik: Trace, Log ve Metrikler — correlation carrier'ları, reserved header'lar, span ağacı ve script/fan-out metrikleri için domain ekipleri rehberi