Skip to content

chore(config): document production feature matrix for logging integrations #636

Description

@kcenon

What

Document and verify the production feature matrix for logger_system integrations and optional capabilities.

Part of kcenon/common_system#684.

The 2026-05-21 analysis found several production-relevant toggles that should be explicit for release consumers: standalone std::jthread async mode, optional thread_system integration, OpenSSL encryption, compression, structured logging, network writer, and OTLP export.

Why

logger_system is a mid-tier dependency used by higher-level systems for diagnostics and auditability. The default feature set and optional integrations affect binary dependencies, security posture, and runtime behavior. Consumers should not have to infer production support from CMake options alone.

Where

  • cmake/options.cmake
  • cmake/dependencies.cmake
  • README.md
  • docs/CONFIGURATION.md or equivalent configuration docs
  • include/kcenon/logger/**
  • Integration tests covering optional features

How

Approach

  1. Build a matrix of logger capabilities: async mode, thread_system integration, encryption, compression, structured logging, network writer, OTLP, monitoring integration, and crash handling.
  2. For each row, record default value, required dependency, vcpkg feature if any, production support level, and verification command.
  3. Ensure README and configuration docs match the CMake defaults.
  4. Mark any example-only or placeholder capability explicitly.
  5. Open follow-up implementation issues for any production-claimed capability lacking tests.

Acceptance Criteria

Verification

  • Default build configures and tests without optional third-party integrations beyond the documented defaults
  • At least one optional integration preset or documented command is verified

Metadata

Metadata

Assignees

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions