No description
  • Go 93.6%
  • Makefile 5.1%
  • Dockerfile 1.3%
Find a file
zemdregon d62f2def9b
Some checks are pending
CI / lint (push) Waiting to run
CI / test (push) Waiting to run
CI / build (push) Waiting to run
CI / docker (push) Blocked by required conditions
chore(deps): bump docker/setup-buildx-action to v4
Self-hosted CI workflows only.
2026-08-10 18:14:57 -05:00
.github/workflows chore(deps): bump docker/setup-buildx-action to v4 2026-08-10 18:14:57 -05:00
cmd/module chore: add CI/LICENSE and align module bootstrap 2026-07-22 19:09:33 -05:00
internal Advertise settings capability (v0.1.2). 2026-08-10 04:52:55 -05:00
.env.example chore: add CI/LICENSE and align module bootstrap 2026-07-22 19:09:33 -05:00
.gitignore Initial commit 2026-07-03 12:03:10 -05:00
.golangci.yml feat: env-configurable log rotation (LOG_MAX_SIZE_MB/BACKUPS) (#4) 2026-08-09 20:20:56 -05:00
CHANGELOG.md Advertise settings capability (v0.1.2). 2026-08-10 04:52:55 -05:00
COMPATIBILITY.md feat: env-configurable log rotation (LOG_MAX_SIZE_MB/BACKUPS) (#4) 2026-08-09 20:20:56 -05:00
Dockerfile Initial commit 2026-07-03 12:03:10 -05:00
go.mod Add SettingsProvider for live log path and rotation knobs. (#5) 2026-08-10 03:37:37 -05:00
go.sum Add SettingsProvider for live log path and rotation knobs. (#5) 2026-08-10 03:37:37 -05:00
LICENSE chore: add CI/LICENSE and align module bootstrap 2026-07-22 19:09:33 -05:00
Makefile Initial commit 2026-07-03 12:03:10 -05:00
muxcore.json Advertise settings capability (v0.1.2). 2026-08-10 04:52:55 -05:00
README.md feat: env-configurable log rotation (LOG_MAX_SIZE_MB/BACKUPS) (#4) 2026-08-09 20:20:56 -05:00

Logging File

File-backed structured logging provider with JSONL output, log rotation, and dynamic level control.

Key Features

  • JSONL (JSON Lines) log format with timestamps
  • Automatic log rotation (size + backup count; env-configurable)
  • Dynamic log level adjustment at runtime via gRPC (SetLevel)
  • Optional stdout mirroring
  • Sensitive field redaction (contracts.SensitiveLogFieldNames)

Configuration

Env Var Default Description
LOG_FILE_PATH /var/lib/logging-file/module.log Log file path
LOG_GRPC_ADDR :9620 gRPC listen address
LOG_STDOUT false Mirror logs to stdout (true to enable)
LOG_LEVEL info Minimum log level (debug, info, warn, error)
LOG_MAX_SIZE_MB 100 Rotate when active file reaches this size (MiB)
LOG_MAX_BACKUPS 3 Number of rotated files to keep (module.log.1.N)
MUXCORE_MODULE_ID logging-file Module identity (SDK)
MUXCORE_INSECURE_DISABLE_TLS false Disable TLS for module↔core gRPC (true for local dev)

Invalid or non-positive LOG_MAX_SIZE_MB / LOG_MAX_BACKUPS values are ignored (defaults apply).

Capability

logging, logging.file — File-backed structured logging

Dependencies

  • github.com/Muxcore-Media/core — contracts, module SDK, logging proto
  • google.golang.org/grpc — LogService gRPC server