Versions in this module Expand all Collapse all v0 v0.2.0 Jun 29, 2026 v0.1.0 Jun 25, 2026 Changes in this version + const AlertSeverityCritical + const AlertSeverityWarning + const AlertStateDetected + const AlertStateResolved + const AlertStateTriggered + const DefaultTimeout + const ErrorReportGroupByError + const ErrorReportGroupByNode + const ErrorReportTimeModeAbsolute + const ErrorReportTimeModeRelative + const ErrorReportViewGraph + const ErrorReportViewList + const ErrorReportViewOverview + const InventoryReportOrderAsc + const InventoryReportOrderDesc + const InventoryReportSortByComputeZone + const InventoryReportSortByGPUCount + const InventoryReportSortByGPUType + const InventoryReportSortByGeoLocation + const InventoryReportSortByHostname + const InventoryReportSortByIntegrityCheck + const InventoryReportSortByNodeGroup + const InventoryReportSortByNodeUUID + const InventoryReportSortByPrivateIP + const InventoryReportSortByPublicIP + const NodeAgentOffline + const NodeAgentOnline + const NodeAgentUnknown + const NodeFirmwareFailed + const NodeFirmwarePassed + const NodeFirmwareUnknown + const NodeGroupHealthDegraded + const NodeGroupHealthHealthy + const NodeGroupHealthUnhealthy + const NodeGroupHealthUnknown + const NodeGroupOrderAsc + const NodeGroupOrderDesc + const NodeGroupSortByGPUUtil + const NodeGroupSortByHealth + const NodeGroupSortByNodes + const NodeGroupViewBasic + const NodeGroupViewDetail + const NodeHealthDegraded + const NodeHealthHealthy + const NodeHealthUnhealthy + const NodeHealthUnknown + const NodeIntegrityDegraded + const NodeIntegrityFailed + const NodeIntegrityPassed + const NodeIntegrityPending + const NodeIntegrityUnknown + const NodeIntegrityUnsupported + const NodeIntegrityUnverified + const NodeIntegrityVerified + const NodeOrderAsc + const NodeOrderDesc + const NodeSortByAgentStatus + const NodeSortByComputeZone + const NodeSortByGPUCount + const NodeSortByGPUType + const NodeSortByHealthStatus + const NodeSortByHostname + const NodeSortByIntegrityCheck + const NodeSortByNodeGroup + const NodeSortByUUID + const NodeViewBasic + const NodeViewDetail + const ReportFormatCSV + const ReportFormatJSON + var ErrInvalidBundle = errors.New("invalid signature bundle: expected a Sigstore .sig.bundle file") + var ErrInvalidKey = errors.New("invalid public key: expected a PEM-encoded public key") + var ErrMissingBaseURL = errors.New("base URL is required") + var ErrMissingServiceKey = errors.New("service key is required") + var ErrVerificationFailed = errors.New("signature verification failed: the report does not match the signature") + func VerifySignedReport(csv, bundleJSON, publicKeyPEM []byte) error + type APIError struct + Details string + Message string + Status string + StatusCode int + func (e *APIError) Error() string + type Alert struct + Component string + ComponentDisplayName string + DetectedAt string + Error string + EventTimestamp string + FiredAt string + LastUpdated string + Message string + NodeUUID string + Severity string + State string + TriggeredAt string + UUID string + type AlertSeverity string + func (severity AlertSeverity) Valid() bool + type AlertState string + func (state AlertState) Valid() bool + type AlertTimelineDetails struct + AlertUUID string + Component string + ComponentDisplayName string + NodeUUID string + RawJSON []byte + Timeline []AlertTimelineEvent + type AlertTimelineEvent struct + Actions []SuggestedAction + AlertStatus string + Error string + EventTimestamp string + EventType string + ExtraInfo map[string]any + Message string + type AlertTimelineNode struct + HostStatus string + Hostname string + LastAlertTime string + NodeUUID string + type AlertTimelineNodeAlert struct + AlertStatus string + AlertUUID string + Component string + ComponentDisplayName string + LastEventTime string + type AlertTimelineNodesPage struct + HasMore bool + Nodes []AlertTimelineNode + Page int + PageSize int + RawJSON []byte + Total int + type AlertsPage struct + Alerts []Alert + Page int + PageCursorNext string + PageSize int + RawJSON []byte + Total int + type BlockDevice struct + FSType string + MountPoint string + Name string + Parents []string + PartUUID string + Size *int + Type string + Used *int + WWN string + type CPUInfo struct + Architecture string + LogicalCores string + Manufacturer string + Type string + type Client struct + func NewClient(baseURL, serviceKey string, opts ...Option) (*Client, error) + func (c *Client) BaseURL() string + func (c *Client) DescribeAlertTimeline(ctx context.Context, nodeUUID, alertUUID string) (AlertTimelineDetails, error) + func (c *Client) DescribeNode(ctx context.Context, nodeUUID string) (NodeDetails, error) + func (c *Client) FetchSigningKey(ctx context.Context) ([]byte, error) + func (c *Client) GetErrorReport(ctx context.Context, opts ErrorReportOptions) (ErrorReport, error) + func (c *Client) GetInventoryReport(ctx context.Context, opts InventoryReportOptions) (InventoryReport, error) + func (c *Client) ListAlertTimelineNodes(ctx context.Context, opts ListAlertTimelineNodesOptions) (AlertTimelineNodesPage, error) + func (c *Client) ListAlerts(ctx context.Context, opts ListAlertsOptions) (AlertsPage, error) + func (c *Client) ListComputeZones(ctx context.Context, opts ListComputeZonesOptions) (ComputeZonesPage, error) + func (c *Client) ListNodeAlertTimeline(ctx context.Context, opts ListNodeAlertTimelineOptions) (NodeAlertTimelinePage, error) + func (c *Client) ListNodeGroups(ctx context.Context, opts ListNodeGroupsOptions) (NodeGroupsPage, error) + func (c *Client) ListNodes(ctx context.Context, opts ListNodesOptions) (NodesPage, error) + func (c *Client) ServiceKeyConfigured() bool + type ComputeZone struct + GeoLocation *GeoLocation + ID string + Name string + NodeCount *int + Type string + type ComputeZoneView string + const ComputeZoneViewBasic + const ComputeZoneViewDetail + func (view ComputeZoneView) Valid() bool + type ComputeZonesPage struct + ComputeZones []ComputeZone + HasMore bool + Page int + PageSize int + RawJSON []byte + Total int + type DiskInfo struct + BlockDevices []BlockDevice + ContainerRootDisk string + type ErrorReport struct + Errors []ErrorReportError + Graph *ErrorReportGraph + GroupBy ErrorReportGroupBy + HasMore bool + Nodes []ErrorReportNode + Overview *ErrorReportOverview + Page int + PageSize int + RawCSV []byte + RawJSON []byte + Total int + View ErrorReportView + type ErrorReportError struct + Count *int + Name string + NodeCount *int + SuggestedAction *SuggestedAction + type ErrorReportGraph struct + Result []ErrorTimeSeries + TimeRange *TimeRange + type ErrorReportGroupBy string + func (groupBy ErrorReportGroupBy) Valid() bool + type ErrorReportNode struct + Errors []string + Hostname string + NodeUUID string + type ErrorReportOptions struct + ComputeZoneIDs []string + EndTime string + Errors []string + Format ReportFormat + GroupBy ErrorReportGroupBy + NodeGroupIDs []string + Page *int + PageSize *int + StartTime string + Step string + Tags []string + TimeMode ErrorReportTimeMode + View ErrorReportView + Window string + type ErrorReportOverview struct + TotalErrorNodes *int + TotalErrorTypes *int + TotalErrors *int + type ErrorReportTimeMode string + func (mode ErrorReportTimeMode) Valid() bool + type ErrorReportView string + func (view ErrorReportView) Valid() bool + type ErrorTimeSeries struct + Error string + Values string + type GPUDevice struct + BoardID *int + BusID string + ChassisSN string + GPUIndex string + MinorID string + SerialNumber string + UUID string + VBIOSVersion string + type GPUInfo struct + Architecture string + GPUs []GPUDevice + Manufacturer string + Memory string + Product string + type GeoLocation struct + City string + Country string + Latitude *float32 + Longitude *float32 + Region string + type InventoryNode struct + ComputeZone string + FirmwareCheck string + GPUCount *int + GPUType string + GeoLocation *GeoLocation + Hostname string + IntegrityCheck string + IntegrityCheckReason string + LastIntegrityCheckTime string + LastUpdatedTime string + NodeGroup string + NodeUUID string + PrivateIP string + PublicIP string + SerialNumbers []string + type InventoryReport struct + Filename string + HasMore bool + Nodes []InventoryNode + Page int + PageSize int + RawCSV []byte + RawJSON []byte + RawSigned []byte + Total int + type InventoryReportOptions struct + ComputeZoneIDs []string + EndTime string + Format ReportFormat + NodeGroupIDs []string + Order InventoryReportSortOrder + Page *int + PageSize *int + Signed bool + SortBy InventoryReportSortBy + StartTime string + Tags []string + type InventoryReportSortBy string + func (sortBy InventoryReportSortBy) Valid() bool + type InventoryReportSortOrder string + func (order InventoryReportSortOrder) Valid() bool + type ListAlertTimelineNodesOptions struct + Active bool + Page *int + PageSize *int + type ListAlertsOptions struct + Component string + NodeUUID string + Page *int + PageSize *int + Severity AlertSeverity + State AlertState + type ListComputeZonesOptions struct + Page *int + PageSize *int + View ComputeZoneView + ZoneIDs []string + type ListNodeAlertTimelineOptions struct + Active bool + NodeUUID string + Page *int + PageSize *int + type ListNodeGroupsOptions struct + GPUTypes []string + HealthStatuses []NodeGroupHealthStatus + NodeGroupIDs []string + Order NodeGroupSortOrder + Page *int + PageSize *int + SortBy NodeGroupSortBy + View NodeGroupView + type ListNodesOptions struct + AgentStatuses []NodeAgentStatus + FirmwareChecks []NodeFirmwareCheck + HealthStatuses []NodeHealthStatus + Hostname string + IntegrityChecks []NodeIntegrityCheck + NodeUUIDs []string + Order NodeSortOrder + Page *int + PageSize *int + SortBy NodeSortBy + View NodeView + type MemoryInfo struct + TotalBytes string + type NICInfo struct + PrivateIPInterfaces []NICInterface + type NICInterface struct + IP string + Interface string + MAC string + type Node struct + AgentStatus string + ComputeZone string + FirmwareCheck string + GPUCount *int + GPUType string + Health string + Hostname string + IntegrityCheck string + IntegrityCheckReason string + LastIntegrityCheckTime string + LastUpdatedTime string + NodeGroup string + PrivateIP string + PublicIP string + UUID string + type NodeAgentStatus string + func (status NodeAgentStatus) Valid() bool + type NodeAlertTimelinePage struct + Alerts []AlertTimelineNodeAlert + HasMore bool + Hostname string + NodeUUID string + Page int + PageSize int + RawJSON []byte + Total int + type NodeDetails struct + ComputeZoneID string + DegradedComponentCount *int + EnrolledAt string + GeoLocation *GeoLocation + HealthyComponentCount *int + NodeGroupID string + RawJSON []byte + Resources *NodeResources + SystemInfo *SystemInfo + Tags []string + UnhealthyComponentCount *int + type NodeFirmwareCheck string + func (check NodeFirmwareCheck) Valid() bool + type NodeGroup struct + ComputeZoneID string + ComputeZoneName string + Health string + HealthPercentage *float32 + ID string + Name string + NodeCount *int + type NodeGroupHealthStatus string + func (status NodeGroupHealthStatus) Valid() bool + type NodeGroupSortBy string + func (sortBy NodeGroupSortBy) Valid() bool + type NodeGroupSortOrder string + func (order NodeGroupSortOrder) Valid() bool + type NodeGroupView string + func (view NodeGroupView) Valid() bool + type NodeGroupsPage struct + HasMore bool + NodeGroups []NodeGroup + Page int + PageSize int + RawJSON []byte + Total int + type NodeHealthStatus string + func (status NodeHealthStatus) Valid() bool + type NodeIntegrityCheck string + func (check NodeIntegrityCheck) Valid() bool + type NodeResources struct + CPUInfo *CPUInfo + DiskInfo *DiskInfo + GPUInfo *GPUInfo + MemoryInfo *MemoryInfo + NICInfo *NICInfo + type NodeSortBy string + func (sortBy NodeSortBy) Valid() bool + type NodeSortOrder string + func (order NodeSortOrder) Valid() bool + type NodeView string + func (view NodeView) Valid() bool + type NodesPage struct + HasMore bool + Nodes []Node + Page int + PageSize int + RawJSON []byte + Total int + type Option func(*Client) + func WithHTTPClient(httpClient *http.Client) Option + func WithTimeout(timeout time.Duration) Option + type ReportFormat string + func (format ReportFormat) Valid() bool + type SuggestedAction struct + Action string + Code string + Persona string + Type string + type SystemInfo struct + AgentVersion string + BootID string + CUDAVersion string + ContainerRuntimeVersion string + DCGMVersion string + GPUDriverVersion string + Hostname string + KernelVersion string + OSImage string + OperatingSystem string + StartedAt string + SystemUUID string + type TimeRange struct + End string + Start string