PANTAW COLLECTOR · SYSTEM

os collector

Report Linux distribution identity, kernel identity and uptime.

Source and collected facts

Read-only /etc/os-release and /proc/uptime with standard-library platform facts.

distribution ID and display name
version and codename
kernel system, release and machine
hostname
uptime and idle time

Observation contract

Available core identity and uptime produce SUCCESS; missing optional release fields produce PARTIAL; inaccessible core sources produce UNAVAILABLE.

Relevant ReasonCode values: OS_OBSERVED, OS_PARTIAL, INTERNAL_ERROR

All collectors use structured ObservationStatus values and retain unavailable optional fields explicitly.

Graceful unavailability and limits

Containers may report host kernel information and a container-specific hostname.

Permissions and privacy

Permissions. The standard release and procfs files are normally world-readable.

Privacy. Hostname and precise platform identity can identify a node; use sanitized examples publicly.

Sanitized example

{
  "source": "os",
  "status": "SUCCESS",
  "severity": "INFO",
  "reason_code": "OS_OBSERVED",
  "target": "operating-system",
  "metadata": {"os_id":"debian","os_version_id":"13","kernel_system":"Linux","uptime_seconds":86400}
}

Synthetic example. It is not production node data.