resource-tracker 0.1.4

Lightweight Linux resource and GPU tracker for system and process monitoring.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

use serde::{Deserialize, Serialize};

/// Machine-level host properties collected once at startup.
/// All fields are optional; collection failure is silently swallowed.
/// Used in the Sentinel API registration payload (Section 9.1).
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct HostInfo {
    /// AWS: `/sys/class/dmi/id/board_asset_tag`; fallback: `/etc/machine-id`.
    pub host_id: Option<String>,
    /// Hostname from `gethostname(3)`.
    #[serde(rename = "host_hostname")]
    pub host_name: Option<String>,
    /// First non-loopback IPv4 address from `getifaddrs(3)`.
    pub host_ip: Option<String>,
    /// `"dedicated"` or `"shared"`. Heuristic TBD; currently always `None`.
    #[serde(rename = "host_server_allocation")]
    pub host_allocation: Option<String>,
    /// Count of logical CPUs from `/proc/cpuinfo` processor entries.
    pub host_vcpus: Option<u32>,
    /// CPU model string from `/proc/cpuinfo`.
    pub host_cpu_model: Option<String>,
    /// Total physical RAM: `MemTotal / 1024` from `/proc/meminfo`.
    pub host_memory_mib: Option<u64>,
    /// Name of the first detected GPU/NPU/TPU.
    pub host_gpu_model: Option<String>,
    /// Count of detected GPUs.
    pub host_gpu_count: Option<u32>,
    /// Sum of `vram_total_bytes / 1_048_576` across all GPUs.
    /// Serialized as `host_gpu_memory_mib` to match the Sentinel API field name.
    #[serde(rename = "host_gpu_memory_mib")]
    pub host_gpu_vram_mib: Option<u64>,
    /// Sum of block device capacities in GB (non-loop, non-ram devices).
    pub host_storage_gb: Option<f64>,
}

/// Cloud instance metadata collected via IMDS probes at startup.
/// All fields are `None` on non-cloud hosts or when the IMDS probe times out.
/// Used in the Sentinel API registration payload (Section 9.1).
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct CloudInfo {
    /// Cloud provider identifier.
    pub cloud_vendor_id: Option<String>,
    /// Cloud account ID (usually not available from metadata service).
    pub cloud_account_id: Option<String>,
    /// Cloud region or location string for the active provider (e.g. AWS region, GCP
    /// region derived from zone, Azure `location`, Hetzner `region`, UpCloud `region`).
    pub cloud_region_id: Option<String>,
    /// Cloud availability zone.
    pub cloud_zone_id: Option<String>,
    /// Instance type / size / flavor (machine type on GCP, `vmSize` on Azure).
    /// UpCloud metadata does not expose a type; this field stays `None` there.
    pub cloud_instance_type: Option<String>,
}