Skip to content
SHC Docs

Logs module

Layer 8. Node. Node It follows containers on a node.

Source: modules/logs/.

CLIshc logs
Subcommands0
HTTP endpointssee the route reference
Events emittedNone
Error codessee the error code reference
Service classesService
Cross-module depsapp, node
modules/logs/
├── router.go
├── service.go
├── types.go
└── commands/

Routes are listed in the generated route reference; request/response notes live in the API reference.

The logs module reads a deployment’s container logs. Service.GetLogs returns a snapshot and Service.StreamLogs follows output; StackResolver provides the runtime and owning node. Remote reads go through RemoteClient.

deployment.go finds containers through their shc.* deployment labels, independent of the compose project that created them. An optional service filter selects that app service’s replicas. A multi-container snapshot merges timestamped lines and prefixes each with the replica name.

The executor reads each container through the runtime’s log command. Local and remote reads both return what the container wrote, unmasked. The module does not own the audit log or the events stream.