CONNECTOR SDK REFERENCE8 of 10

Monitoring & Observability

Track the health, performance and usage of your connector in real time.

OverviewMetricsLoggingTracingHealth ChecksAlertsDashboardsSLIs & SLOsBest Practices

At a glance

Key signals for your connector.

Health

Healthy

Success rate (24h)

98.6%

Requests (24h)

1.23 M

Avg latency (p95)

842 ms

Errors (24h)

18,342

Sync lag (max)

02m 13s

DLQ depth

127

Connector health

Overall statusHealthy

Uptime (30d)99.97%

Connector processRunning

External systemHealthy

AuthenticationValid

Outbound connectivityOK

Last successful sync1 min ago

Next scheduled syncin 4 min

Throughput & errors

00:0004:0008:0012:0016:0020:00

Latency (p50 / p95 / p99)

00:0004:0008:0012:0016:0020:00

Synchronization lag

Average lag00m 42s

P95 lag01m 58s

Max lag02m 13s

TrendingImproving

Top resources by activity (24h)

Patient435,18999.2%3,576

Observation321,77398.9%3,361

MedicationRequest190,44298.1%1,785

Encounter112,06398.5%4,670

DocumentReference76,22197.8%1,695

Queues & retries

Retry queue depth342 ↓7.3%

Retry rate (24h)2.18%

DLQ depth127 ↑5.0%

Oldest DLQ message1h 23m ago

Structured log example (JSON)

jsonCopy

{"timestamp":"2026-08-31T14:22:31Z","level":"INFO","message":"Read resources success","connector":"acme-ehr-connector","operation":"read","resourceType":"Patient","correlationId":"01H8Z...","durationMs":421,"httpStatus":200}

Trace example

Connector.read(Patient) 120 ms

auth.getAccessToken 60 ms

HTTP GET /patients 780 ms

Map to FHIR Patient 310 ms

Write to Mediloop 690 ms

Commit & emit event 420 ms

Example metric (Prometheus)

prometheusCopy

# HELP mediloop_connector_requests_total
# TYPE mediloop_connector_requests_total counter
mediloop_connector_requests_total{connector="acme-ehr-connector",operation="read",resource="Patient",status="success"} 1234567

# HELP mediloop_connector_request_duration_ms
# TYPE mediloop_connector_request_duration_ms histogram