ores.telemetry.core

Table of Contents

Diagram

ores.telemetry.core component diagram

Figure 1: ores.telemetry.core

Summary

ores.telemetry.core is the observability library for ORE Studio. It provides structured logging via Boost.Log with trace and span ID correlation (aligned with OpenTelemetry semantics), JSON Lines file exporters, and domain types for log records and resource identity (host, service, version). All other components link against this library to emit structured, correlated logs. Telemetry data is forwarded to ores.telemetry.service for centralised storage and querying.

Inputs

  • Log events emitted by other components via the Boost.Log sink interface.
  • Configuration for log level, output file path, and service identity.

Outputs

  • JSON Lines log files written to the configured export path.
  • Structured log_record objects forwarded to ores.telemetry.service via the hybrid exporter for database persistence.

Entry points

  • include/ores.telemetry.core/log/ — Boost.Log initialisation and lifecycle.
  • include/ores.telemetry.core/generators/ — trace/span ID generators.
  • include/ores.telemetry.core/domain/ — log_record, trace_id, span_id, resource.
  • include/ores.telemetry.core/exporting/ — file and hybrid exporters.

Dependencies

  • Boost.Log — structured logging sink infrastructure.
  • nats.c — NATS client used by the hybrid exporter to forward records.

See also

Emacs 29.1 (Org mode 9.6.6)