Struct Issue 

pub struct Issue {

    pub active: bool,
    pub created_at: Timestamp,
    pub description: Option<String>,
    pub device_id: Option<Uuid>,
    pub first_seen: Timestamp,
    pub id: Uuid,
    pub last_seen: Timestamp,
    pub message: String,
    pub ref_: String,
    pub resolved_at: Option<Timestamp>,
    pub resolved_by: Option<String>,
    pub resolved_reason: Option<String>,
    pub server_group_id: Option<Uuid>,
    pub server_id: Option<Uuid>,
    pub severity: Severity,
    pub snoozed_until: Option<Timestamp>,
    pub source: String,
    pub updated_at: Timestamp,
}

A tracked problem or condition on a server, or on a server group as a whole. An issue is opened the first time its source reports it and stays open (accumulating events) until the source reports it as no longer active or an operator resolves it. Issues are the basic unit that drives incidents, Slack notifications, and the fleet health view.

JSON schema

{
 "description": "A tracked problem or condition on a server, or on a server group as a\nwhole. An issue is opened the first time its source reports it and stays\nopen (accumulating events) until the source reports it as no longer\nactive or an operator resolves it. Issues are the basic unit that drives\nincidents, Slack notifications, and the fleet health view.",
 "type": "object",
 "required": [
   "active",
   "created_at",
   "first_seen",
   "id",
   "last_seen",
   "message",
   "ref",
   "severity",
   "source",
   "updated_at"
 ],
 "properties": {
   "active": {
     "description": "Whether the condition behind this issue is still ongoing. Set to\n`false` when the source reports the condition has cleared.",
     "type": "boolean"
   },
   "created_at": {
     "description": "When this issue was first created.",
     "type": "string",
     "format": "date-time"
   },
   "description": {
     "description": "A short, single-line title for the issue, shown as its headline in\nthe UI and in Slack notifications. `None` if no title was given.",
     "type": [
       "string",
       "null"
     ]
   },
   "device_id": {
     "description": "The device that reported this issue, if it was raised by a device\npush. `None` for issues raised by an operator or by the platform\nitself.",
     "type": [
       "string",
       "null"
     ],
     "format": "uuid"
   },
   "first_seen": {
     "description": "When this issue was first reported.",
     "type": "string",
     "format": "date-time"
   },
   "id": {
     "description": "Unique identifier for this issue.",
     "type": "string",
     "format": "uuid"
   },
   "last_seen": {
     "description": "When this issue was most recently reported or updated.",
     "type": "string",
     "format": "date-time"
   },
   "message": {
     "description": "The full body text describing the issue.",
     "type": "string"
   },
   "ref": {
     "description": "A caller-chosen identifier for this issue within its `source`. The\nsame `(source, ref)` pair reported again updates this issue instead\nof creating a new one.",
     "type": "string"
   },
   "resolved_at": {
     "description": "When an operator marked this issue resolved. `None` if it hasn't\nbeen resolved.",
     "type": [
       "string",
       "null"
     ],
     "format": "date-time"
   },
   "resolved_by": {
     "description": "The operator who resolved this issue. `None` if it hasn't been\nresolved.",
     "type": [
       "string",
       "null"
     ]
   },
   "resolved_reason": {
     "description": "The reason given when the issue was resolved (for example: fixed,\nfalse positive, won't fix). `None` if it hasn't been resolved.",
     "type": [
       "string",
       "null"
     ]
   },
   "server_group_id": {
     "description": "The server group this issue is attached to, for a control-plane issue\n(e.g. backup corruption, a failed preflight check) that isn't tied to\nany single server. `None` for an ordinary server-scoped issue.\nGroup-scoped issues are always considered even if an individual\nserver in the group has monitoring turned off.",
     "type": [
       "string",
       "null"
     ],
     "format": "uuid"
   },
   "server_id": {
     "description": "The server this issue is attached to. `None` for a group-scoped issue\n(see `server_group_id`) — exactly one of the two is always set.",
     "type": [
       "string",
       "null"
     ],
     "format": "uuid"
   },
   "severity": {
     "description": "The issue's current severity.",
     "$ref": "#/components/schemas/Severity"
   },
   "snoozed_until": {
     "description": "If set, this issue is snoozed until this time: it's temporarily\nexcluded from incidents and notifications even while still active.",
     "type": [
       "string",
       "null"
     ],
     "format": "date-time"
   },
   "source": {
     "description": "Identifies what raised this issue — a healthcheck, a backup pipeline,\nan operator, etc. Used together with `ref` to detect repeat reports\nof the same underlying problem.",
     "type": "string"
   },
   "updated_at": {
     "description": "When this issue was last modified.",
     "type": "string",
     "format": "date-time"
   }
 }
}

Fields

active: bool

Whether the condition behind this issue is still ongoing. Set to false when the source reports the condition has cleared.

created_at: Timestamp

When this issue was first created.

description: Option<String>

A short, single-line title for the issue, shown as its headline in the UI and in Slack notifications. None if no title was given.

device_id: Option<Uuid>

The device that reported this issue, if it was raised by a device push. None for issues raised by an operator or by the platform itself.

first_seen: Timestamp

When this issue was first reported.

id: Uuid

Unique identifier for this issue.

last_seen: Timestamp

When this issue was most recently reported or updated.

message: String

The full body text describing the issue.

ref_: String

A caller-chosen identifier for this issue within its source. The same (source, ref) pair reported again updates this issue instead of creating a new one.

resolved_at: Option<Timestamp>

When an operator marked this issue resolved. None if it hasn’t been resolved.

resolved_by: Option<String>

The operator who resolved this issue. None if it hasn’t been resolved.

resolved_reason: Option<String>

The reason given when the issue was resolved (for example: fixed, false positive, won’t fix). None if it hasn’t been resolved.

server_group_id: Option<Uuid>

The server group this issue is attached to, for a control-plane issue (e.g. backup corruption, a failed preflight check) that isn’t tied to any single server. None for an ordinary server-scoped issue. Group-scoped issues are always considered even if an individual server in the group has monitoring turned off.

server_id: Option<Uuid>

The server this issue is attached to. None for a group-scoped issue (see server_group_id) — exactly one of the two is always set.

severity: Severity

The issue’s current severity.

snoozed_until: Option<Timestamp>

If set, this issue is snoozed until this time: it’s temporarily excluded from incidents and notifications even while still active.

source: String

Identifies what raised this issue — a healthcheck, a backup pipeline, an operator, etc. Used together with ref to detect repeat reports of the same underlying problem.

updated_at: Timestamp

When this issue was last modified.

Trait Implementations

impl Clone for Issue

fn clone(&self) -> Issue

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Issue

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Issue

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Issue

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.