Directories
¶
| Path | Synopsis |
|---|---|
|
Package buffer holds the agent's report ring: a RAM buffer bounded by both a byte cap (15 MB) and a time horizon (60 min), with drop-oldest on overflow.
|
Package buffer holds the agent's report ring: a RAM buffer bounded by both a byte cap (15 MB) and a time horizon (60 min), with drop-oldest on overflow. |
|
Package collector defines the metric-source contract and the report assembly the run loop drives.
|
Package collector defines the metric-source contract and the report assembly the run loop drives. |
|
cpu
Package cpu reports aggregate CPU utilisation from /proc/stat.
|
Package cpu reports aggregate CPU utilisation from /proc/stat. |
|
disk
Package disk reports per-mount space and inode usage.
|
Package disk reports per-mount space and inode usage. |
|
diskio
Package diskio reports per-device throughput and IOPS from /proc/diskstats.
|
Package diskio reports per-device throughput and IOPS from /proc/diskstats. |
|
gpu
Package gpu reports per-GPU utilization, memory, temperature and power for AMD and NVIDIA cards.
|
Package gpu reports per-GPU utilization, memory, temperature and power for AMD and NVIDIA cards. |
|
load
Package load reports the 1/5/15-minute load averages from /proc/loadavg.
|
Package load reports the 1/5/15-minute load averages from /proc/loadavg. |
|
mem
Package mem reports memory usage from /proc/meminfo plus the cumulative oom_kill counter from /proc/vmstat.
|
Package mem reports memory usage from /proc/meminfo plus the cumulative oom_kill counter from /proc/vmstat. |
|
net
Package net reports per-interface throughput and error rates from /proc/net/dev.
|
Package net reports per-interface throughput and error rates from /proc/net/dev. |
|
probe
Package probe implements the reachability/latency collector: from INSIDE the customer's network the agent probes a server-declared list of targets (tcp/http/https/dns) and reports per-target latency, loss and reachability.
|
Package probe implements the reachability/latency collector: from INSIDE the customer's network the agent probes a server-declared list of targets (tcp/http/https/dns) and reports per-target latency, loss and reachability. |
|
psi
Package psi reports Pressure Stall Information from /proc/pressure/{cpu,io, memory}.
|
Package psi reports Pressure Stall Information from /proc/pressure/{cpu,io, memory}. |
|
registry
Package registry wires the concrete system collectors into a collector Registry.
|
Package registry wires the concrete system collectors into a collector Registry. |
|
self
Package self reports the agent's own resource use for overhead transparency (sys.agent.rss_bytes, sys.agent.cpu_pct).
|
Package self reports the agent's own resource use for overhead transparency (sys.agent.rss_bytes, sys.agent.cpu_pct). |
|
smart
Package smart reports SMART health for the host's storage devices.
|
Package smart reports SMART health for the host's storage devices. |
|
swap
Package swap reports swap usage from /proc/meminfo.
|
Package swap reports swap usage from /proc/meminfo. |
|
system
Package system reports host uptime and a process/zombie count.
|
Package system reports host uptime and a process/zombie count. |
|
Package config owns the agent's runtime configuration: pulling it from the control plane, validating it defensively, and swapping it atomically so a hot-reload is never half-applied.
|
Package config owns the agent's runtime configuration: pulling it from the control plane, validating it defensively, and swapping it atomically so a hot-reload is never half-applied. |
|
Package doctor implements the livck-agent `doctor` verb: a read-only, side-effect-free self-diagnosis an operator runs to answer "why isn't this server reporting?".
|
Package doctor implements the livck-agent `doctor` verb: a read-only, side-effect-free self-diagnosis an operator runs to answer "why isn't this server reporting?". |
|
This file holds the client side of the enroll handshake: the single, client-initiated POST that registers a fresh server with the LIVCK brain and yields the managed token, ingest URL and initial config the agent then reports with.
|
This file holds the client side of the enroll handshake: the single, client-initiated POST that registers a fresh server with the LIVCK brain and yields the managed token, ingest URL and initial config the agent then reports with. |
|
Package event holds the agent's lifecycle event queue and the Emitter interface that other foundation packages (config, buffer) push into.
|
Package event holds the agent's lifecycle event queue and the Emitter interface that other foundation packages (config, buffer) push into. |
|
Package hostinfo builds the two host-fact maps the agent attaches to batches: the report/enroll meta profile (os, distro, kernel, arch, cpu, ram, boot time, virtualization) and the fingerprint used for clone detection (a hashed machine-id, the boot_id and the hostname).
|
Package hostinfo builds the two host-fact maps the agent attaches to batches: the report/enroll meta profile (os, distro, kernel, arch, cpu, ram, boot time, virtualization) and the fingerprint used for clone detection (a hashed machine-id, the boot_id and the hostname). |
|
Package lifecycle detects the discrete host lifecycle events the agent emits as the strong-delivery signal class: boot, unexpected_reboot, clean_shutdown, oom_kill and fs_readonly.
|
Package lifecycle detects the discrete host lifecycle events the agent emits as the strong-delivery signal class: boot, unexpected_reboot, clean_shutdown, oom_kill and fs_readonly. |
|
Package live implements the agent side of Live-Watch: a WSS signal channel to pulse that bursts an instantaneous metric snapshot every few seconds while a browser viewer is watching.
|
Package live implements the agent side of Live-Watch: a WSS signal channel to pulse that bursts an instantaneous metric snapshot every few seconds while a browser viewer is watching. |
|
Package loadgen holds the reusable, testable pieces of the livck-loadgen fake-fleet driver: the catalog-driven synthetic report generator and the sender-side latency/status recorder.
|
Package loadgen holds the reusable, testable pieces of the livck-loadgen fake-fleet driver: the catalog-driven synthetic report generator and the sender-side latency/status recorder. |
|
Package platform holds the injectable Clock, FS and Host abstractions the agent is built on.
|
Package platform holds the injectable Clock, FS and Host abstractions the agent is built on. |
|
platformtest
Package platformtest provides deterministic fakes for the platform abstractions so buffer, sender, config and identity can be tested without a real clock or filesystem.
|
Package platformtest provides deterministic fakes for the platform abstractions so buffer, sender, config and identity can be tested without a real clock or filesystem. |
|
This file is the agent-local aggregation layer, which spans two aggregation levels: the runner sub-samples the cheap collectors every sample_interval and folds each Sample into an aggregator; at the end of the report interval the aggregator collapses every key's sub-samples into one report value using the catalog's agg mode for that key.
|
This file is the agent-local aggregation layer, which spans two aggregation levels: the runner sub-samples the cheap collectors every sample_interval and folds each Sample into an aggregator; at the end of the report interval the aggregator collapses every key's sub-samples into one report value using the catalog's agg mode for that key. |
|
Package sender turns buffered reports and pending events into ingest requests and drives the retry matrix.
|
Package sender turns buffered reports and pending events into ingest requests and drives the retry matrix. |
|
Package update implements the root-side upgrade path of the agent (SERVER-AGENT.md §10.8): the `livck-agent upgrade` verb and the hourly livck-agent-update.timer both land here.
|
Package update implements the root-side upgrade path of the agent (SERVER-AGENT.md §10.8): the `livck-agent upgrade` verb and the hourly livck-agent-update.timer both land here. |
Click to show internal directories.
Click to hide internal directories.