jackin❯ diagnostics

Synopsis

jackin diagnostics validate

validate emits one governed trace, event, and metric marker and requests a flush from all three OTLP exporters. It succeeds only when each signal records a new exporter success, no signal records a new failure, the governed facade rejects nothing, and the shared bounded flush succeeds. It does not read or write local telemetry files.

Current successful output identifies the endpoint, reports the exporter flush result, and includes the flush time:

telemetry: endpoint http://127.0.0.1:4317
signals:   traces ok  logs ok  metrics ok
delivery:  confirmed (flush 12ms)

delivery: confirmed means the configured OTLP endpoint acknowledged exports for all three signals during this validation window. It does not promise that a downstream backend retained or indexed the data after acknowledgement.

The command exits non-zero when OTEL_SDK_DISABLED=true, no endpoint is configured, providers are inactive, the governed marker is rejected, or any signal cannot be flushed. Confirm that the endpoint is reachable and that OTEL_EXPORTER_OTLP_PROTOCOL is unset or grpc, then retry.

See Run Telemetry for configuration and Application observability for the delivery contract.