mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-09-11 14:00:29 +00:00
pulse-triage[bot]
3334cccfd9
Issue #1895 reports parity alerts when mdNumDisks=0 on a pool-only Unraid system. Array service state alone does not establish that a parity array exists. Preserve the optional disk count from collection through canonical runtime conversion and suppress only the no-parity warning for an explicit zero. Missing or malformed counts retain legacy behaviour, and disk failure reasons remain active. Validated focused Unraid tests in hostagent, storagehealth, monitoring, unifiedresources and alerts, including JSON zero preservation and canonical round trip. The new pool-only regression fails against the previous warning condition. Both agent and server need this change; no release or reporter retest is claimed. Change-source: pulse-maintainer
623 lines
29 KiB
Go
623 lines
29 KiB
Go
package host
|
|
|
|
import (
|
|
"fmt"
|
|
"strconv"
|
|
"strings"
|
|
"time"
|
|
|
|
"github.com/rcourtman/pulse-go-rewrite/pkg/diskinventory"
|
|
"github.com/rcourtman/pulse-go-rewrite/pkg/tlsutil"
|
|
)
|
|
|
|
const reportSequenceVersion = "v1"
|
|
|
|
// FormatReportSequenceID returns the opaque report-ordering token carried by a
|
|
// single agent process. The stream ID changes when the agent restarts and the
|
|
// sequence increases for every report collected by that process.
|
|
func FormatReportSequenceID(streamID string, sequence uint64) string {
|
|
streamID = strings.TrimSpace(streamID)
|
|
if streamID == "" || sequence == 0 || strings.Contains(streamID, ":") {
|
|
return ""
|
|
}
|
|
return fmt.Sprintf("%s:%s:%d", reportSequenceVersion, streamID, sequence)
|
|
}
|
|
|
|
// ParseReportSequenceID decodes sequence IDs produced by
|
|
// FormatReportSequenceID. Unknown formats remain valid opaque wire values but
|
|
// are not used for ordering by current servers.
|
|
func ParseReportSequenceID(value string) (streamID string, sequence uint64, ok bool) {
|
|
parts := strings.Split(strings.TrimSpace(value), ":")
|
|
if len(parts) != 3 || parts[0] != reportSequenceVersion {
|
|
return "", 0, false
|
|
}
|
|
streamID = strings.TrimSpace(parts[1])
|
|
if streamID == "" {
|
|
return "", 0, false
|
|
}
|
|
sequence, err := strconv.ParseUint(parts[2], 10, 64)
|
|
if err != nil || sequence == 0 {
|
|
return "", 0, false
|
|
}
|
|
return streamID, sequence, true
|
|
}
|
|
|
|
// Report represents the payload sent by the host module of pulse-agent.
|
|
type Report struct {
|
|
Agent AgentInfo `json:"agent"`
|
|
Host HostInfo `json:"host"`
|
|
Metrics Metrics `json:"metrics"`
|
|
Disks []Disk `json:"disks,omitempty"`
|
|
DiskIO []DiskIO `json:"diskIO,omitempty"`
|
|
Network []NetworkInterface `json:"network,omitempty"`
|
|
Sensors Sensors `json:"sensors,omitempty"`
|
|
RAID []RAIDArray `json:"raid,omitempty"`
|
|
Unraid *UnraidStorage `json:"unraid,omitempty"`
|
|
Ceph *CephCluster `json:"ceph,omitempty"`
|
|
Libvirt *LibvirtInventory `json:"libvirt,omitempty"`
|
|
XCPNG *XCPNGInventory `json:"xcpng,omitempty"`
|
|
ProxmoxLXC *ProxmoxLXCInventory `json:"proxmoxLxc,omitempty"`
|
|
ClusterSensors []ClusterNodeSensors `json:"clusterSensors,omitempty"`
|
|
// AvailabilityResults carries availability checks the agent executed on
|
|
// behalf of the server for targets assigned to it. The server owns failure
|
|
// accounting; the agent only reports what each check observed.
|
|
AvailabilityResults []AvailabilityProbeResult `json:"availabilityResults,omitempty"`
|
|
Tags []string `json:"tags,omitempty"`
|
|
Timestamp time.Time `json:"timestamp"`
|
|
SequenceID string `json:"sequenceId,omitempty"`
|
|
}
|
|
|
|
// LibvirtInventory is the bounded, read-only domain inventory collected from
|
|
// a local libvirt connection. A non-nil inventory with no domains means the
|
|
// connection was readable but currently has no defined guests.
|
|
type LibvirtInventory struct {
|
|
Domains []LibvirtDomain `json:"domains"`
|
|
CollectedAt time.Time `json:"collectedAt"`
|
|
}
|
|
|
|
// LibvirtDomain contains only stable virDomainStats fields. All byte counters
|
|
// are cumulative; the server derives rates between accepted reports.
|
|
type LibvirtDomain struct {
|
|
ID string `json:"id"`
|
|
Name string `json:"name"`
|
|
State string `json:"state"`
|
|
VCPUs int `json:"vcpus,omitempty"`
|
|
CPUTimeNanoseconds uint64 `json:"cpuTimeNanoseconds,omitempty"`
|
|
MemoryCurrentBytes int64 `json:"memoryCurrentBytes,omitempty"`
|
|
MemoryMaximumBytes int64 `json:"memoryMaximumBytes,omitempty"`
|
|
NetworkRXBytes uint64 `json:"networkRxBytes,omitempty"`
|
|
NetworkTXBytes uint64 `json:"networkTxBytes,omitempty"`
|
|
DiskReadBytes uint64 `json:"diskReadBytes,omitempty"`
|
|
DiskWriteBytes uint64 `json:"diskWriteBytes,omitempty"`
|
|
}
|
|
|
|
// XCPNGInventory is the bounded, read-only pool inventory collected through
|
|
// the xe CLI available in an XCP-ng control domain.
|
|
type XCPNGInventory struct {
|
|
PoolUUID string `json:"poolUuid"`
|
|
PoolName string `json:"poolName,omitempty"`
|
|
MasterUUID string `json:"masterUuid,omitempty"`
|
|
LocalHostUUID string `json:"localHostUuid,omitempty"`
|
|
VMs []XCPNGVM `json:"vms"`
|
|
CollectedAt time.Time `json:"collectedAt"`
|
|
}
|
|
|
|
// XCPNGVM contains stable inventory fields returned by xe vm-list. Collection
|
|
// is intentionally observational; no XAPI lifecycle operation is exposed.
|
|
type XCPNGVM struct {
|
|
UUID string `json:"uuid"`
|
|
Name string `json:"name"`
|
|
PowerState string `json:"powerState"`
|
|
VCPUs int `json:"vcpus,omitempty"`
|
|
MemoryActual int64 `json:"memoryActualBytes,omitempty"`
|
|
MemoryStaticMax int64 `json:"memoryStaticMaxBytes,omitempty"`
|
|
ResidentHostUUID string `json:"residentHostUuid,omitempty"`
|
|
}
|
|
|
|
// ProxmoxLXCInventory is the bounded, node-local filesystem inventory
|
|
// collected through the pct CLI on a Proxmox VE host. Only containers the
|
|
// preceding pct list reported running are queried.
|
|
type ProxmoxLXCInventory struct {
|
|
Containers []ProxmoxLXCContainer `json:"containers"`
|
|
CollectedAt time.Time `json:"collectedAt"`
|
|
}
|
|
|
|
// ProxmoxLXCContainer contains direct pct df readings for one local running
|
|
// container. VMID and name are both carried so the server can fail closed
|
|
// when correlating the node-local observation with API inventory.
|
|
type ProxmoxLXCContainer struct {
|
|
VMID int `json:"vmid"`
|
|
Name string `json:"name"`
|
|
Disks []Disk `json:"disks"`
|
|
}
|
|
|
|
// AvailabilityProbeResult is one completed availability check reported by a
|
|
// remote probe agent. Outcome mirrors the shared probe vocabulary
|
|
// ("reachable", "unreachable", "indeterminate"); anything else is treated as
|
|
// indeterminate by the server.
|
|
type AvailabilityProbeResult struct {
|
|
ObservationID string `json:"observationId,omitempty"`
|
|
TargetID string `json:"targetId"`
|
|
ConfigRevision int64 `json:"configRevision,omitempty"`
|
|
Outcome string `json:"outcome"`
|
|
TransportOutcome string `json:"transportOutcome,omitempty"`
|
|
ApplicationOutcome string `json:"applicationOutcome,omitempty"`
|
|
ApplicationStatusCode int `json:"applicationStatusCode,omitempty"`
|
|
ApplicationFailureCode string `json:"applicationFailureCode,omitempty"`
|
|
LatencyMillis int64 `json:"latencyMillis"`
|
|
CheckedAt time.Time `json:"checkedAt"`
|
|
Error string `json:"error,omitempty"`
|
|
Certificate *tlsutil.CertificateObservation `json:"certificate,omitempty"`
|
|
}
|
|
|
|
// ClusterNodeSensors contains temperature sensor data collected from a Proxmox
|
|
// cluster sibling node via SSH. The agent on one node SSHes to peers using the
|
|
// cluster's pre-existing root SSH trust to run `sensors -j`.
|
|
type ClusterNodeSensors struct {
|
|
NodeName string `json:"nodeName"` // Proxmox cluster node name (lowercase)
|
|
Sensors Sensors `json:"sensors"` // Temperature/fan/additional sensor data
|
|
CollectedAt string `json:"collectedAt,omitempty"` // RFC3339 timestamp of collection
|
|
}
|
|
|
|
// AgentInfo describes the reporting agent.
|
|
type AgentInfo struct {
|
|
ID string `json:"id"`
|
|
Version string `json:"version,omitempty"`
|
|
Type string `json:"type,omitempty"` // "unified", "host", or "docker" - empty means legacy
|
|
IntervalSeconds int `json:"intervalSeconds,omitempty"`
|
|
Hostname string `json:"hostname,omitempty"`
|
|
UpdatedFrom string `json:"updatedFrom,omitempty"` // Previous version if recently auto-updated
|
|
CommandsEnabled bool `json:"commandsEnabled,omitempty"` // Whether AI command execution is enabled
|
|
OperationReceiptVersion int `json:"operationReceiptVersion,omitempty"`
|
|
DiskExclude []string `json:"diskExclude,omitempty"` // Disk exclusion patterns from --disk-exclude flag
|
|
AppliedConfig *ConfigFingerprint `json:"appliedConfig,omitempty"`
|
|
Update *UpdateStatus `json:"update,omitempty"`
|
|
Modules []ModuleStatus `json:"modules,omitempty"`
|
|
Privilege *PrivilegeStatus `json:"privilege,omitempty"`
|
|
}
|
|
|
|
// PrivilegeStatus is the agent-authored view of the privilege it actually runs
|
|
// with, so the server can present a least-privilege install as an intentional
|
|
// profile instead of a broken agent. It is informational only: it never grants
|
|
// anything, and the server must not treat a non-root agent as unhealthy on
|
|
// this evidence alone.
|
|
type PrivilegeStatus struct {
|
|
RunningAsRoot bool `json:"runningAsRoot"`
|
|
ServiceUser string `json:"serviceUser,omitempty"`
|
|
CommandAuthority string `json:"commandAuthority,omitempty"`
|
|
// TypedHelper reports that the collector is configured to use the local
|
|
// no-network privilege helper socket. It reports posture only and grants no
|
|
// authority by itself.
|
|
TypedHelper bool `json:"typedHelper,omitempty"`
|
|
// SmartctlHelper reports that a PULSE_SMARTCTL_PATH override is in effect,
|
|
// which a least-privilege install uses to route SMART reads through a
|
|
// scoped privilege helper.
|
|
SmartctlHelper bool `json:"smartctlHelper,omitempty"`
|
|
// PctHelper reports that a PULSE_PCT_PATH override is in effect, which a
|
|
// least-privilege install on a Proxmox node uses to route the read-only
|
|
// pct list/df queries through a scoped privilege helper.
|
|
PctHelper bool `json:"pctHelper,omitempty"`
|
|
}
|
|
|
|
// ModuleNameTypedPrivilegeHelper is the stable report identity for the local
|
|
// no-network helper's aggregate host-telemetry operation health.
|
|
const ModuleNameTypedPrivilegeHelper = "typed-privilege-helper"
|
|
|
|
// ModuleStatus describes whether an enabled Unified Agent module initialized
|
|
// and is actively running. Errors are deliberately bounded to the current
|
|
// operator-facing initialization or operation failure.
|
|
type ModuleStatus struct {
|
|
Name string `json:"name"`
|
|
Enabled bool `json:"enabled"`
|
|
State string `json:"state"`
|
|
LastError string `json:"lastError,omitempty"`
|
|
UpdatedAt time.Time `json:"updatedAt"`
|
|
}
|
|
|
|
// ConfigFingerprint identifies the effective managed configuration applied by
|
|
// the running agent without exposing any configuration values or secrets.
|
|
type ConfigFingerprint struct {
|
|
Version string `json:"version"`
|
|
Hash string `json:"hash"`
|
|
}
|
|
|
|
// UpdateStatus is the agent-authored state of its self-update loop. Server-side
|
|
// version comparison remains authoritative for whether an update is available;
|
|
// this payload explains whether the agent is actually checking and why its last
|
|
// attempt succeeded, failed, or is disabled.
|
|
type UpdateStatus struct {
|
|
State string `json:"state"`
|
|
AutoUpdate bool `json:"autoUpdate"`
|
|
UpdatedFrom string `json:"updatedFrom,omitempty"`
|
|
AvailableVersion string `json:"availableVersion,omitempty"`
|
|
LastCheckedAt *time.Time `json:"lastCheckedAt,omitempty"`
|
|
LastAttemptAt *time.Time `json:"lastAttemptAt,omitempty"`
|
|
LastSuccessAt *time.Time `json:"lastSuccessAt,omitempty"`
|
|
LastError string `json:"lastError,omitempty"`
|
|
}
|
|
|
|
// HostInfo contains platform and identification details about the monitored host.
|
|
type HostInfo struct {
|
|
ID string `json:"id,omitempty"`
|
|
Hostname string `json:"hostname"`
|
|
DisplayName string `json:"displayName,omitempty"`
|
|
MachineID string `json:"machineId,omitempty"`
|
|
Platform string `json:"platform,omitempty"`
|
|
OSName string `json:"osName,omitempty"`
|
|
OSVersion string `json:"osVersion,omitempty"`
|
|
KernelVersion string `json:"kernelVersion,omitempty"`
|
|
Architecture string `json:"architecture,omitempty"`
|
|
CPUModel string `json:"cpuModel,omitempty"`
|
|
CPUCount int `json:"cpuCount,omitempty"`
|
|
UptimeSeconds int64 `json:"uptimeSeconds,omitempty"`
|
|
LoadAverage []float64 `json:"loadAverage,omitempty"`
|
|
ReportIP string `json:"reportIp,omitempty"` // User-specified IP for multi-NIC systems
|
|
PackageUpdates *PackageUpdateStatus `json:"packageUpdates,omitempty"`
|
|
StorageCleanup *StorageCleanupStatus `json:"storageCleanup,omitempty"`
|
|
}
|
|
|
|
// PackageUpdateStatus is the agent-authored, read-only package posture for
|
|
// the host OS. It reports only package identifiers and versions; execution is
|
|
// a separate typed agent operation and never accepts model-authored commands.
|
|
type PackageUpdateStatus struct {
|
|
Supported bool `json:"supported"`
|
|
Manager string `json:"manager,omitempty"`
|
|
InventoryHash string `json:"inventoryHash,omitempty"`
|
|
PendingCount int `json:"pendingCount"`
|
|
Packages []PackageUpdate `json:"packages,omitempty"`
|
|
CheckedAt time.Time `json:"checkedAt,omitempty"`
|
|
RebootRequired bool `json:"rebootRequired,omitempty"`
|
|
Error string `json:"error,omitempty"`
|
|
}
|
|
|
|
// PackageUpdate identifies one package visible in the package manager's
|
|
// bounded upgrade simulation. Values are informational and never executed.
|
|
type PackageUpdate struct {
|
|
Name string `json:"name"`
|
|
InstalledVersion string `json:"installedVersion,omitempty"`
|
|
AvailableVersion string `json:"availableVersion,omitempty"`
|
|
}
|
|
|
|
// StorageCleanupStatus is the agent-authored read-only posture for the
|
|
// bounded package-cache cleanup provider. Paths and cache entry names never
|
|
// leave the agent; the fingerprint binds a later typed cleanup request.
|
|
type StorageCleanupStatus struct {
|
|
Supported bool `json:"supported"`
|
|
Provider string `json:"provider,omitempty"`
|
|
Fingerprint string `json:"fingerprint,omitempty"`
|
|
ReclaimableBytes int64 `json:"reclaimableBytes"`
|
|
CheckedAt time.Time `json:"checkedAt,omitempty"`
|
|
Error string `json:"error,omitempty"`
|
|
}
|
|
|
|
// Metrics encapsulates primary resource metrics for a host.
|
|
type Metrics struct {
|
|
CPUUsagePercent float64 `json:"cpuUsagePercent,omitempty"`
|
|
Memory MemoryMetric `json:"memory,omitempty"`
|
|
}
|
|
|
|
// MemoryMetric captures memory usage statistics in bytes.
|
|
type MemoryMetric struct {
|
|
TotalBytes int64 `json:"totalBytes,omitempty"`
|
|
UsedBytes int64 `json:"usedBytes,omitempty"`
|
|
FreeBytes int64 `json:"freeBytes,omitempty"`
|
|
// CacheBytes is the reclaimable page cache (Available - Free);
|
|
// used + cache + free ≈ total.
|
|
CacheBytes int64 `json:"cacheBytes,omitempty"`
|
|
Usage float64 `json:"usage,omitempty"`
|
|
SwapTotal int64 `json:"swapTotalBytes,omitempty"`
|
|
SwapUsed int64 `json:"swapUsedBytes,omitempty"`
|
|
}
|
|
|
|
// Disk represents disk utilisation metrics.
|
|
type Disk struct {
|
|
Device string `json:"device,omitempty"`
|
|
Mountpoint string `json:"mountpoint,omitempty"`
|
|
Filesystem string `json:"filesystem,omitempty"`
|
|
Type string `json:"type,omitempty"`
|
|
TotalBytes int64 `json:"totalBytes,omitempty"`
|
|
UsedBytes int64 `json:"usedBytes,omitempty"`
|
|
FreeBytes int64 `json:"freeBytes,omitempty"`
|
|
Usage float64 `json:"usage,omitempty"`
|
|
ZFSDatasets []ZFSDataset `json:"zfsDatasets,omitempty"`
|
|
}
|
|
|
|
// ZFSDataset is a bounded, read-only projection of `zfs list` for one pool.
|
|
type ZFSDataset struct {
|
|
Name string `json:"name"`
|
|
Type string `json:"type,omitempty"`
|
|
Mountpoint string `json:"mountpoint,omitempty"`
|
|
UsedBytes int64 `json:"usedBytes,omitempty"`
|
|
AvailableBytes int64 `json:"availableBytes,omitempty"`
|
|
ReferencedBytes int64 `json:"referencedBytes,omitempty"`
|
|
}
|
|
|
|
// DiskIO represents disk I/O statistics for a block device.
|
|
// These are cumulative counters since boot - the backend calculates rates.
|
|
type DiskIO struct {
|
|
Device string `json:"device"` // e.g., "nvme0n1", "sda"
|
|
ReadBytes uint64 `json:"readBytes,omitempty"` // Total bytes read
|
|
WriteBytes uint64 `json:"writeBytes,omitempty"` // Total bytes written
|
|
ReadOps uint64 `json:"readOps,omitempty"` // Total read operations
|
|
WriteOps uint64 `json:"writeOps,omitempty"` // Total write operations
|
|
ReadTime uint64 `json:"readTimeMs,omitempty"` // Total time spent reading (ms)
|
|
WriteTime uint64 `json:"writeTimeMs,omitempty"` // Total time spent writing (ms)
|
|
IOTime uint64 `json:"ioTimeMs,omitempty"` // Total time spent doing I/O (ms)
|
|
}
|
|
|
|
// NetworkInterface summarises network adapter statistics.
|
|
type NetworkInterface struct {
|
|
Name string `json:"name"`
|
|
MAC string `json:"mac,omitempty"`
|
|
Addresses []string `json:"addresses,omitempty"`
|
|
RXBytes uint64 `json:"rxBytes,omitempty"`
|
|
TXBytes uint64 `json:"txBytes,omitempty"`
|
|
SpeedMbps *int64 `json:"speedMbps,omitempty"`
|
|
}
|
|
|
|
// Sensors captures optional sensor readings reported by the agent.
|
|
type Sensors struct {
|
|
TemperatureCelsius map[string]float64 `json:"temperatureCelsius,omitempty"`
|
|
FanRPM map[string]float64 `json:"fanRpm,omitempty"`
|
|
PowerWatts map[string]float64 `json:"powerWatts,omitempty"` // Power consumption (e.g., cpu_package, dram)
|
|
Additional map[string]float64 `json:"additional,omitempty"`
|
|
Custom []CustomSensorMetric `json:"custom,omitempty"`
|
|
GPU []GPUSensor `json:"gpu,omitempty"`
|
|
ThermalState *ThermalState `json:"thermalState,omitempty"`
|
|
SMART []DiskSMART `json:"smart,omitempty"` // S.M.A.R.T. disk data
|
|
}
|
|
|
|
const (
|
|
CustomSensorStatusOK = "ok"
|
|
CustomSensorStatusWarning = "warning"
|
|
CustomSensorStatusCritical = "critical"
|
|
CustomSensorStatusError = "error"
|
|
CustomSensorKindNumber = "number"
|
|
CustomSensorKindBoolean = "boolean"
|
|
CustomSensorKindTimestamp = "timestamp"
|
|
)
|
|
|
|
// CustomSensorMetric is a bounded reading produced by an explicitly configured
|
|
// local executable or HTTP endpoint. The agent owns collection and threshold
|
|
// evaluation.
|
|
type CustomSensorMetric struct {
|
|
ID string `json:"id"`
|
|
Name string `json:"name"`
|
|
Group string `json:"group,omitempty"`
|
|
Subgroup string `json:"subgroup,omitempty"`
|
|
Kind string `json:"kind,omitempty"`
|
|
Unit string `json:"unit,omitempty"`
|
|
Value *float64 `json:"value,omitempty"`
|
|
Status string `json:"status"`
|
|
ObservedAt time.Time `json:"observedAt"`
|
|
EventAt *time.Time `json:"eventAt,omitempty"`
|
|
Error string `json:"error,omitempty"`
|
|
AlertOnError bool `json:"alertOnError,omitempty"`
|
|
Stale bool `json:"stale,omitempty"`
|
|
}
|
|
|
|
// GPUSensor captures direct GPU telemetry reported by a local host agent.
|
|
type GPUSensor struct {
|
|
ID string `json:"id,omitempty"`
|
|
Name string `json:"name,omitempty"`
|
|
TemperatureCelsius *float64 `json:"temperatureCelsius,omitempty"`
|
|
UtilizationPercent *float64 `json:"utilizationPercent,omitempty"`
|
|
MemoryUsedBytes *int64 `json:"memoryUsedBytes,omitempty"`
|
|
MemoryTotalBytes *int64 `json:"memoryTotalBytes,omitempty"`
|
|
}
|
|
|
|
// ThermalState captures OS-level thermal pressure that is not a direct
|
|
// Celsius temperature reading. macOS exposes this kind of signal more
|
|
// reliably than raw sensor temperatures.
|
|
type ThermalState struct {
|
|
Source string `json:"source,omitempty"`
|
|
Pressure string `json:"pressure,omitempty"` // nominal, constrained, or unknown
|
|
ThermalWarningLevel *int `json:"thermalWarningLevel,omitempty"`
|
|
PerformanceWarningLevel *int `json:"performanceWarningLevel,omitempty"`
|
|
CPUPowerStatus *int `json:"cpuPowerStatus,omitempty"`
|
|
LimitsPercent map[string]int `json:"limitsPercent,omitempty"`
|
|
}
|
|
|
|
const (
|
|
ThermalPressureNominal = "nominal"
|
|
ThermalPressureConstrained = "constrained"
|
|
ThermalPressureUnknown = "unknown"
|
|
)
|
|
|
|
// DiskSMART represents S.M.A.R.T. data for a single disk.
|
|
type DiskSMART struct {
|
|
Device string `json:"device"` // Block device name (e.g., sda, nvme0n1)
|
|
Model string `json:"model,omitempty"` // Disk model
|
|
Serial string `json:"serial,omitempty"` // Serial number
|
|
WWN string `json:"wwn,omitempty"` // World Wide Name
|
|
Type string `json:"type,omitempty"` // Transport type: sata, sas, nvme
|
|
Controller string `json:"controller,omitempty"` // Stable controller association when the OS reports one
|
|
Target string `json:"target,omitempty"` // Controller target/HCTL or smartctl member target
|
|
SizeBytes int64 `json:"sizeBytes,omitempty"` // Capacity in bytes (0 when unknown)
|
|
Temperature int `json:"temperature"` // Temperature in Celsius
|
|
Health string `json:"health,omitempty"` // PASSED, FAILED, UNKNOWN
|
|
Standby bool `json:"standby,omitempty"` // True if disk was in standby
|
|
Pool string `json:"pool,omitempty"` // ZFS pool this disk belongs to (empty if not a ZFS member)
|
|
IO *DiskIO `json:"io,omitempty"` // Cumulative kernel counters when attributable to this disk
|
|
Collection *diskinventory.CollectionStatus `json:"collection,omitempty"`
|
|
Attributes *SMARTAttributes `json:"attributes,omitempty"`
|
|
}
|
|
|
|
// SMARTAttributes holds normalized SMART attributes for both SATA and NVMe disks.
|
|
type SMARTAttributes struct {
|
|
PowerOnHours *int64 `json:"powerOnHours,omitempty"`
|
|
PowerCycles *int64 `json:"powerCycles,omitempty"`
|
|
ReallocatedSectors *int64 `json:"reallocatedSectors,omitempty"`
|
|
PendingSectors *int64 `json:"pendingSectors,omitempty"`
|
|
OfflineUncorrectable *int64 `json:"offlineUncorrectable,omitempty"`
|
|
UDMACRCErrors *int64 `json:"udmaCrcErrors,omitempty"`
|
|
PercentageUsed *int `json:"percentageUsed,omitempty"`
|
|
AvailableSpare *int `json:"availableSpare,omitempty"`
|
|
MediaErrors *int64 `json:"mediaErrors,omitempty"`
|
|
UnsafeShutdowns *int64 `json:"unsafeShutdowns,omitempty"`
|
|
}
|
|
|
|
// RAIDArray represents an mdadm RAID array.
|
|
type RAIDArray struct {
|
|
Device string `json:"device"` // e.g., /dev/md0
|
|
Name string `json:"name,omitempty"` // Array name if set
|
|
Level string `json:"level"` // RAID level: raid0, raid1, raid5, raid6, raid10
|
|
State string `json:"state"` // clean, active, degraded, recovering, resyncing, etc.
|
|
TotalDevices int `json:"totalDevices"` // Total number of devices in array
|
|
ActiveDevices int `json:"activeDevices"` // Number of active devices
|
|
WorkingDevices int `json:"workingDevices"` // Number of working devices
|
|
FailedDevices int `json:"failedDevices"` // Number of failed devices
|
|
SpareDevices int `json:"spareDevices"` // Number of spare devices
|
|
UUID string `json:"uuid,omitempty"` // Array UUID
|
|
Devices []RAIDDevice `json:"devices"` // Individual devices in array
|
|
RebuildPercent float64 `json:"rebuildPercent"` // Rebuild/resync progress (0-100)
|
|
RebuildSpeed string `json:"rebuildSpeed,omitempty"` // Rebuild speed (e.g., "50000K/sec")
|
|
// Operation reports the in-progress sync action from /proc/mdstat:
|
|
// "recovery", "resync", "check", or "reshape". Empty when idle.
|
|
Operation string `json:"operation,omitempty"`
|
|
}
|
|
|
|
// RAIDDevice represents a single device in a RAID array.
|
|
type RAIDDevice struct {
|
|
Device string `json:"device"` // e.g., /dev/sda1
|
|
State string `json:"state"` // active, spare, faulty, removed
|
|
Slot int `json:"slot"` // Position in array (-1 if not applicable)
|
|
}
|
|
|
|
// UnraidStorage represents best-effort Unraid array topology collected locally.
|
|
type UnraidStorage struct {
|
|
ArrayStarted bool `json:"arrayStarted"`
|
|
ArrayState string `json:"arrayState,omitempty"`
|
|
SyncAction string `json:"syncAction,omitempty"`
|
|
SyncProgress float64 `json:"syncProgress,omitempty"`
|
|
SyncErrors int64 `json:"syncErrors,omitempty"`
|
|
NumDisks *int `json:"numDisks,omitempty"` // nil means the agent did not report an array disk count.
|
|
NumProtected int `json:"numProtected,omitempty"`
|
|
NumDisabled int `json:"numDisabled,omitempty"`
|
|
NumInvalid int `json:"numInvalid,omitempty"`
|
|
NumMissing int `json:"numMissing,omitempty"`
|
|
Disks []UnraidDisk `json:"disks,omitempty"`
|
|
}
|
|
|
|
// UnraidDisk represents a disk's role and state inside an Unraid array.
|
|
type UnraidDisk struct {
|
|
Name string `json:"name"`
|
|
Device string `json:"device,omitempty"`
|
|
Role string `json:"role,omitempty"`
|
|
Status string `json:"status,omitempty"`
|
|
RawStatus string `json:"rawStatus,omitempty"`
|
|
Model string `json:"model,omitempty"`
|
|
Serial string `json:"serial,omitempty"`
|
|
Filesystem string `json:"filesystem,omitempty"`
|
|
Transport string `json:"transport,omitempty"`
|
|
SizeBytes int64 `json:"sizeBytes,omitempty"`
|
|
UsedBytes int64 `json:"usedBytes,omitempty"`
|
|
FreeBytes int64 `json:"freeBytes,omitempty"`
|
|
Temperature int `json:"temperature,omitempty"`
|
|
SpunDown bool `json:"spunDown,omitempty"`
|
|
ReadCount int64 `json:"readCount,omitempty"`
|
|
WriteCount int64 `json:"writeCount,omitempty"`
|
|
ErrorCount int64 `json:"errorCount,omitempty"`
|
|
Slot int `json:"slot,omitempty"`
|
|
}
|
|
|
|
// CephCluster represents Ceph cluster status collected by the host agent.
|
|
type CephCluster struct {
|
|
FSID string `json:"fsid"`
|
|
Health CephHealth `json:"health"`
|
|
MonMap CephMonitorMap `json:"monMap,omitempty"`
|
|
MgrMap CephManagerMap `json:"mgrMap,omitempty"`
|
|
OSDMap CephOSDMap `json:"osdMap"`
|
|
PGMap CephPGMap `json:"pgMap"`
|
|
Pools []CephPool `json:"pools,omitempty"`
|
|
Services []CephService `json:"services,omitempty"`
|
|
CollectedAt string `json:"collectedAt"`
|
|
}
|
|
|
|
// CephHealth represents Ceph cluster health status.
|
|
type CephHealth struct {
|
|
Status string `json:"status"` // HEALTH_OK, HEALTH_WARN, HEALTH_ERR
|
|
Checks map[string]CephCheck `json:"checks,omitempty"`
|
|
Summary []CephHealthSummary `json:"summary,omitempty"`
|
|
}
|
|
|
|
// CephCheck represents a health check detail.
|
|
type CephCheck struct {
|
|
Severity string `json:"severity"`
|
|
Message string `json:"message,omitempty"`
|
|
Detail []string `json:"detail,omitempty"`
|
|
}
|
|
|
|
// CephHealthSummary represents a health summary message.
|
|
type CephHealthSummary struct {
|
|
Severity string `json:"severity"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
// CephMonitorMap represents Ceph monitor information.
|
|
type CephMonitorMap struct {
|
|
Epoch int `json:"epoch"`
|
|
NumMons int `json:"numMons"`
|
|
Monitors []CephMonitor `json:"monitors,omitempty"`
|
|
}
|
|
|
|
// CephMonitor represents a single Ceph monitor.
|
|
type CephMonitor struct {
|
|
Name string `json:"name"`
|
|
Rank int `json:"rank"`
|
|
Addr string `json:"addr,omitempty"`
|
|
Status string `json:"status,omitempty"`
|
|
}
|
|
|
|
// CephManagerMap represents Ceph manager information.
|
|
type CephManagerMap struct {
|
|
Available bool `json:"available"`
|
|
NumMgrs int `json:"numMgrs"`
|
|
ActiveMgr string `json:"activeMgr,omitempty"`
|
|
Standbys int `json:"standbys"`
|
|
}
|
|
|
|
// CephOSDMap represents OSD status summary.
|
|
type CephOSDMap struct {
|
|
Epoch int `json:"epoch"`
|
|
NumOSDs int `json:"numOsds"`
|
|
NumUp int `json:"numUp"`
|
|
NumIn int `json:"numIn"`
|
|
NumDown int `json:"numDown,omitempty"`
|
|
NumOut int `json:"numOut,omitempty"`
|
|
}
|
|
|
|
// CephPGMap represents placement group statistics.
|
|
type CephPGMap struct {
|
|
NumPGs int `json:"numPgs"`
|
|
BytesTotal uint64 `json:"bytesTotal"`
|
|
BytesUsed uint64 `json:"bytesUsed"`
|
|
BytesAvailable uint64 `json:"bytesAvailable"`
|
|
DataBytes uint64 `json:"dataBytes,omitempty"`
|
|
UsagePercent float64 `json:"usagePercent"`
|
|
DegradedRatio float64 `json:"degradedRatio,omitempty"`
|
|
MisplacedRatio float64 `json:"misplacedRatio,omitempty"`
|
|
ReadBytesPerSec uint64 `json:"readBytesPerSec,omitempty"`
|
|
WriteBytesPerSec uint64 `json:"writeBytesPerSec,omitempty"`
|
|
ReadOpsPerSec uint64 `json:"readOpsPerSec,omitempty"`
|
|
WriteOpsPerSec uint64 `json:"writeOpsPerSec,omitempty"`
|
|
}
|
|
|
|
// CephPool represents a Ceph pool.
|
|
type CephPool struct {
|
|
ID int `json:"id"`
|
|
Name string `json:"name"`
|
|
BytesUsed uint64 `json:"bytesUsed"`
|
|
BytesAvailable uint64 `json:"bytesAvailable"`
|
|
Objects uint64 `json:"objects"`
|
|
PercentUsed float64 `json:"percentUsed"`
|
|
}
|
|
|
|
// CephService represents a Ceph service summary.
|
|
type CephService struct {
|
|
Type string `json:"type"` // mon, mgr, osd, mds, rgw
|
|
Running int `json:"running"`
|
|
Total int `json:"total"`
|
|
Daemons []string `json:"daemons,omitempty"`
|
|
}
|