@oneuptime/common 10.0.93 → 10.0.94

package/Types/Dashboard/DashboardComponents/ComponentArgument.ts

@@ -12,6 +12,21 @@ export enum ComponentInputType {
   MetricsQueryConfigs = "MetricsQueryConfigs",
   LongText = "Long Text",
   Dropdown = "Dropdown",
+  MultiSelectDropdown = "MultiSelectDropdown",
+  EntityDropdown = "EntityDropdown",
+  EntityMultiSelectDropdown = "EntityMultiSelectDropdown",
+}
+
+export enum EntityFilterModelType {
+  IncidentSeverity = "IncidentSeverity",
+  AlertSeverity = "AlertSeverity",
+  IncidentState = "IncidentState",
+  AlertState = "AlertState",
+  MonitorStatus = "MonitorStatus",
+  Monitor = "Monitor",
+  Label = "Label",
+  KubernetesCluster = "KubernetesCluster",
+  DockerHost = "DockerHost",
 }
 
 export interface ComponentArgumentSection {
@@ -32,4 +47,5 @@ export interface ComponentArgument<T extends DashboardBaseComponent> {
   placeholder?: string | undefined;
   dropdownOptions?: Array<DropdownOption> | undefined;
   section?: ComponentArgumentSection | undefined;
+  entityFilterModelType?: EntityFilterModelType | undefined;
 }

package/Types/Dashboard/DashboardComponents/DashboardAlertListComponent.ts

@@ -9,5 +9,9 @@ export default interface DashboardAlertListComponent extends BaseComponent {
     title?: string | undefined;
     maxRows?: number | undefined;
     stateFilter?: string | undefined;
+    severityIds?: Array<string> | undefined;
+    stateIds?: Array<string> | undefined;
+    monitorIds?: Array<string> | undefined;
+    labelIds?: Array<string> | undefined;
   };
 }

package/Types/Dashboard/DashboardComponents/DashboardDockerContainerListComponent.ts

@@ -0,0 +1,15 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardDockerContainerListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.DockerContainerList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    dockerHostIds?: Array<string> | undefined;
+    imageName?: string | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardDockerHostListComponent.ts

@@ -0,0 +1,14 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardDockerHostListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.DockerHostList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    statusFilter?: string | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardDockerImageListComponent.ts

@@ -0,0 +1,15 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardDockerImageListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.DockerImageList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    dockerHostIds?: Array<string> | undefined;
+    nameSearch?: string | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardDockerNetworkListComponent.ts

@@ -0,0 +1,14 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardDockerNetworkListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.DockerNetworkList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    dockerHostIds?: Array<string> | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardDockerVolumeListComponent.ts

@@ -0,0 +1,14 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardDockerVolumeListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.DockerVolumeList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    dockerHostIds?: Array<string> | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardIncidentListComponent.ts

@@ -9,5 +9,9 @@ export default interface DashboardIncidentListComponent extends BaseComponent {
     title?: string | undefined;
     maxRows?: number | undefined;
     stateFilter?: string | undefined;
+    severityIds?: Array<string> | undefined;
+    stateIds?: Array<string> | undefined;
+    monitorIds?: Array<string> | undefined;
+    labelIds?: Array<string> | undefined;
   };
 }

package/Types/Dashboard/DashboardComponents/DashboardKubernetesCronJobListComponent.ts

@@ -0,0 +1,15 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardKubernetesCronJobListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.KubernetesCronJobList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    kubernetesClusterIds?: Array<string> | undefined;
+    namespaces?: string | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardKubernetesDaemonSetListComponent.ts

@@ -0,0 +1,15 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardKubernetesDaemonSetListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.KubernetesDaemonSetList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    kubernetesClusterIds?: Array<string> | undefined;
+    namespaces?: string | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardKubernetesDeploymentListComponent.ts

@@ -0,0 +1,15 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardKubernetesDeploymentListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.KubernetesDeploymentList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    kubernetesClusterIds?: Array<string> | undefined;
+    namespaces?: string | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardKubernetesJobListComponent.ts

@@ -0,0 +1,15 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardKubernetesJobListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.KubernetesJobList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    kubernetesClusterIds?: Array<string> | undefined;
+    namespaces?: string | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardKubernetesNamespaceListComponent.ts

@@ -0,0 +1,14 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardKubernetesNamespaceListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.KubernetesNamespaceList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    kubernetesClusterIds?: Array<string> | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardKubernetesNodeListComponent.ts

@@ -0,0 +1,15 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardKubernetesNodeListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.KubernetesNodeList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    kubernetesClusterIds?: Array<string> | undefined;
+    readinessFilter?: string | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardKubernetesPodListComponent.ts

@@ -0,0 +1,16 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardKubernetesPodListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.KubernetesPodList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    kubernetesClusterIds?: Array<string> | undefined;
+    namespaces?: string | undefined;
+    podPhases?: Array<string> | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardKubernetesStatefulSetListComponent.ts

@@ -0,0 +1,15 @@
+import ObjectID from "../../ObjectID";
+import DashboardComponentType from "../DashboardComponentType";
+import BaseComponent from "./DashboardBaseComponent";
+
+export default interface DashboardKubernetesStatefulSetListComponent
+  extends BaseComponent {
+  componentType: DashboardComponentType.KubernetesStatefulSetList;
+  componentId: ObjectID;
+  arguments: {
+    title?: string | undefined;
+    maxRows?: number | undefined;
+    kubernetesClusterIds?: Array<string> | undefined;
+    namespaces?: string | undefined;
+  };
+}

package/Types/Dashboard/DashboardComponents/DashboardMonitorListComponent.ts

@@ -9,5 +9,8 @@ export default interface DashboardMonitorListComponent extends BaseComponent {
     title?: string | undefined;
     maxRows?: number | undefined;
     statusFilter?: string | undefined;
+    monitorStatusIds?: Array<string> | undefined;
+    monitorTypes?: Array<string> | undefined;
+    labelIds?: Array<string> | undefined;
   };
 }

package/Types/Docker/DockerInventoryExtractor.ts

@@ -0,0 +1,343 @@
+import OneUptimeDate from "../Date";
+import { JSONObject } from "../JSON";
+import { ParsedDockerResource } from "../../Server/Services/DockerResourceService";
+
+/*
+ * ------------------------------------------------------------------
+ *                     DockerInventoryExtractor
+ * ------------------------------------------------------------------
+ *
+ * Parses a single inventory log record emitted by the OneUptime
+ * Docker Agent's snapshot script. The script polls the local Docker
+ * daemon every 5 minutes for containers / images / networks /
+ * volumes and emits one JSON object per line into a log file that
+ * the OTel filelog receiver forwards as an OTLP log.
+ *
+ * The agreed wire format is a JSON envelope:
+ *
+ *   {
+ *     "kind":  "Container" | "Image" | "Network" | "Volume",
+ *     "data":  { ...native docker payload... }
+ *   }
+ *
+ * The kind discriminator is set as a log record attribute by the
+ * agent's filelog operator chain, but we also keep it inside the
+ * envelope so the parser can sanity-check.
+ *
+ * Each kind has a small dedicated parser that pulls out the fields
+ * we promote to first-class columns on `DockerResource` (name,
+ * containerId, imageName, state, labels, creation timestamp). The
+ * full payload is *not* persisted — it lives on the original log
+ * record in ClickHouse if a user ever needs the raw blob.
+ *
+ * ------------------------------------------------------------------
+ */
+
+export const INVENTORY_KIND_ATTRIBUTE: string = "oneuptime.docker.kind";
+
+export const INVENTORIED_DOCKER_KINDS: ReadonlyArray<string> = [
+  "Container",
+  "Image",
+  "Network",
+  "Volume",
+];
+
+const INVENTORIED_KIND_SET: Set<string> = new Set(
+  INVENTORIED_DOCKER_KINDS.map((k: string) => {
+    return k.toLowerCase();
+  }),
+);
+
+export function isInventoriedDockerKind(kind: string): boolean {
+  return INVENTORIED_KIND_SET.has(kind.toLowerCase());
+}
+
+/*
+ * Map a kind in any common form (lowercase plural, lowercase
+ * singular, or PascalCase) to the canonical PascalCase kind we store
+ * in the database. Returns null for anything we don't model.
+ */
+export function canonicalDockerKind(raw: string): string | null {
+  const trimmed: string = (raw || "").trim().toLowerCase();
+  if (!trimmed) {
+    return null;
+  }
+  const map: Record<string, string> = {
+    container: "Container",
+    containers: "Container",
+    image: "Image",
+    images: "Image",
+    network: "Network",
+    networks: "Network",
+    volume: "Volume",
+    volumes: "Volume",
+  };
+  return map[trimmed] || null;
+}
+
+function parseLogBody(logBody: string): JSONObject | null {
+  try {
+    const parsed: unknown = JSON.parse(logBody);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed as JSONObject;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+function readString(obj: JSONObject, key: string): string | null {
+  const v: unknown = obj[key];
+  if (typeof v === "string" && v.trim().length > 0) {
+    return v.trim();
+  }
+  return null;
+}
+
+function readJSONObject(obj: JSONObject, key: string): JSONObject | null {
+  const v: unknown = obj[key];
+  if (v && typeof v === "object" && !Array.isArray(v)) {
+    return v as JSONObject;
+  }
+  return null;
+}
+
+function parseTimestamp(raw: string | null): Date | null {
+  if (!raw) {
+    return null;
+  }
+  try {
+    const d: Date = OneUptimeDate.fromString(raw);
+    if (isNaN(d.getTime())) {
+      return null;
+    }
+    return d;
+  } catch {
+    return null;
+  }
+}
+
+/*
+ * Container shape emitted by `docker container ls --format json` plus
+ * a few enrichments the agent script adds:
+ *   { Id, Names, Image, State, Status, CreatedAt, Labels }
+ *
+ * Names from the Docker CLI is a slash-prefixed comma-joined string
+ * ("/web,/web-1"). We strip the leading slash and take the first
+ * entry — that's what `docker_stats` reports as `container.name` in
+ * metric attributes, so the row keys stay consistent across paths.
+ */
+function parseContainer(
+  data: JSONObject,
+  lastSeenAt: Date,
+): ParsedDockerResource | null {
+  const rawNames: string | null = readString(data, "Names");
+  const rawName: string | null = readString(data, "Name");
+  const namesField: string = rawNames || rawName || "";
+  const firstName: string = namesField
+    .split(",")
+    .map((n: string) => {
+      return n.trim().replace(/^\//, "");
+    })
+    .filter((n: string) => {
+      return n.length > 0;
+    })[0]!;
+
+  if (!firstName) {
+    return null;
+  }
+
+  const idRaw: string | null = readString(data, "Id");
+  const containerId: string | null = idRaw ? idRaw.substring(0, 12) : null;
+  const imageName: string | null = readString(data, "Image");
+  const state: string | null = readString(data, "State");
+  const labels: JSONObject | null = readJSONObject(data, "Labels");
+  const created: Date | null = parseTimestamp(readString(data, "CreatedAt"));
+
+  return {
+    kind: "Container",
+    name: firstName,
+    containerId,
+    imageName,
+    state: state ? state.toLowerCase() : null,
+    labels,
+    resourceCreationTimestamp: created,
+    lastSeenAt,
+  };
+}
+
+/*
+ * Image shape from `docker image ls --format json`:
+ *   { ID, Repository, Tag, CreatedAt, Labels }
+ *
+ * Name = Repository:Tag (matches what container.image.name emits).
+ * Skip dangling images (Repository=<none> with no tag) — they would
+ * collide on the unique key and are noise in a list view.
+ */
+function parseImage(
+  data: JSONObject,
+  lastSeenAt: Date,
+): ParsedDockerResource | null {
+  const repository: string | null = readString(data, "Repository");
+  const tag: string | null = readString(data, "Tag");
+  const explicitName: string | null = readString(data, "Name");
+
+  let name: string | null = explicitName;
+  if (!name && repository && repository !== "<none>") {
+    name = tag && tag !== "<none>" ? `${repository}:${tag}` : repository;
+  }
+
+  if (!name) {
+    return null;
+  }
+
+  const idRaw: string | null = readString(data, "ID") || readString(data, "Id");
+  const containerId: string | null = idRaw
+    ? idRaw.replace(/^sha256:/, "").substring(0, 12)
+    : null;
+  const labels: JSONObject | null = readJSONObject(data, "Labels");
+  const created: Date | null = parseTimestamp(readString(data, "CreatedAt"));
+
+  return {
+    kind: "Image",
+    name,
+    containerId,
+    imageName: null,
+    state: null,
+    labels,
+    resourceCreationTimestamp: created,
+    lastSeenAt,
+  };
+}
+
+/*
+ * Network shape from `docker network ls --format json`:
+ *   { ID, Name, Driver, Scope, CreatedAt, Labels }
+ */
+function parseNetwork(
+  data: JSONObject,
+  lastSeenAt: Date,
+): ParsedDockerResource | null {
+  const name: string | null = readString(data, "Name");
+  if (!name) {
+    return null;
+  }
+  const idRaw: string | null = readString(data, "ID") || readString(data, "Id");
+  const driver: string | null = readString(data, "Driver");
+  const scope: string | null = readString(data, "Scope");
+  const labels: JSONObject | null = readJSONObject(data, "Labels");
+  const created: Date | null = parseTimestamp(readString(data, "CreatedAt"));
+
+  /*
+   * Driver and scope are surfaced in the State column in the widget
+   * (e.g. "bridge / local"). Encoded as "driver/scope" so we don't
+   * need a new column on the table.
+   */
+  const stateParts: Array<string> = [];
+  if (driver) {
+    stateParts.push(driver);
+  }
+  if (scope) {
+    stateParts.push(scope);
+  }
+
+  return {
+    kind: "Network",
+    name,
+    containerId: idRaw ? idRaw.substring(0, 12) : null,
+    imageName: null,
+    state: stateParts.length > 0 ? stateParts.join("/") : null,
+    labels,
+    resourceCreationTimestamp: created,
+    lastSeenAt,
+  };
+}
+
+/*
+ * Volume shape from `docker volume ls --format json`:
+ *   { Name, Driver, Mountpoint, Scope, Labels, CreatedAt }
+ */
+function parseVolume(
+  data: JSONObject,
+  lastSeenAt: Date,
+): ParsedDockerResource | null {
+  const name: string | null = readString(data, "Name");
+  if (!name) {
+    return null;
+  }
+  const driver: string | null = readString(data, "Driver");
+  const scope: string | null = readString(data, "Scope");
+  const labels: JSONObject | null = readJSONObject(data, "Labels");
+  const created: Date | null = parseTimestamp(readString(data, "CreatedAt"));
+
+  const stateParts: Array<string> = [];
+  if (driver) {
+    stateParts.push(driver);
+  }
+  if (scope) {
+    stateParts.push(scope);
+  }
+
+  return {
+    kind: "Volume",
+    name,
+    containerId: null,
+    imageName: null,
+    state: stateParts.length > 0 ? stateParts.join("/") : null,
+    labels,
+    resourceCreationTimestamp: created,
+    lastSeenAt,
+  };
+}
+
+export interface ExtractedDockerInventoryRecord {
+  resource: ParsedDockerResource;
+}
+
+/**
+ * Parse a single inventory log line. Returns null when the body is
+ * malformed or the kind is not modeled — callers should swallow nulls
+ * silently rather than fail the whole batch.
+ */
+export function extractDockerInventoryResource(data: {
+  kind: string;
+  logBody: string;
+  lastSeenAt: Date;
+}): ExtractedDockerInventoryRecord | null {
+  const canonical: string | null = canonicalDockerKind(data.kind);
+  if (!canonical) {
+    return null;
+  }
+
+  const body: JSONObject | null = parseLogBody(data.logBody);
+  if (!body) {
+    return null;
+  }
+
+  /*
+   * The agent wraps the native docker payload in `{ kind, data }`.
+   * Older snapshot lines or test inputs may be the raw payload — we
+   * accept either by pulling `data` if present, else using the body
+   * directly.
+   */
+  const inner: JSONObject =
+    (readJSONObject(body, "data") as JSONObject) || body;
+
+  let parsed: ParsedDockerResource | null = null;
+  if (canonical === "Container") {
+    parsed = parseContainer(inner, data.lastSeenAt);
+  } else if (canonical === "Image") {
+    parsed = parseImage(inner, data.lastSeenAt);
+  } else if (canonical === "Network") {
+    parsed = parseNetwork(inner, data.lastSeenAt);
+  } else if (canonical === "Volume") {
+    parsed = parseVolume(inner, data.lastSeenAt);
+  }
+
+  if (!parsed) {
+    return null;
+  }
+
+  return { resource: parsed };
+}

package/Utils/Dashboard/Components/DashboardAlertListComponent.ts

@@ -6,6 +6,7 @@ import {
   ComponentArgument,
   ComponentArgumentSection,
   ComponentInputType,
+  EntityFilterModelType,
 } from "../../../Types/Dashboard/DashboardComponents/ComponentArgument";
 import DashboardComponentType from "../../../Types/Dashboard/DashboardComponentType";
 
@@ -67,8 +68,8 @@ export default class DashboardAlertListComponentUtil extends DashboardBaseCompon
     });
 
     componentArguments.push({
-      name: "State",
-      description: "Filter alerts by lifecycle state",
+      name: "Lifecycle State",
+      description: "Quick filter by lifecycle state",
       required: false,
       type: ComponentInputType.Dropdown,
       id: "stateFilter",
@@ -81,6 +82,50 @@ export default class DashboardAlertListComponentUtil extends DashboardBaseCompon
       ],
     });
 
+    componentArguments.push({
+      name: "Severity",
+      description: "Show only alerts matching the selected severities",
+      required: false,
+      type: ComponentInputType.EntityMultiSelectDropdown,
+      id: "severityIds",
+      placeholder: "All severities",
+      section: FiltersSection,
+      entityFilterModelType: EntityFilterModelType.AlertSeverity,
+    });
+
+    componentArguments.push({
+      name: "State",
+      description: "Show only alerts in the selected states",
+      required: false,
+      type: ComponentInputType.EntityMultiSelectDropdown,
+      id: "stateIds",
+      placeholder: "All states",
+      section: FiltersSection,
+      entityFilterModelType: EntityFilterModelType.AlertState,
+    });
+
+    componentArguments.push({
+      name: "Monitors",
+      description: "Show only alerts linked to the selected monitors",
+      required: false,
+      type: ComponentInputType.EntityMultiSelectDropdown,
+      id: "monitorIds",
+      placeholder: "All monitors",
+      section: FiltersSection,
+      entityFilterModelType: EntityFilterModelType.Monitor,
+    });
+
+    componentArguments.push({
+      name: "Labels",
+      description: "Show only alerts tagged with the selected labels",
+      required: false,
+      type: ComponentInputType.EntityMultiSelectDropdown,
+      id: "labelIds",
+      placeholder: "All labels",
+      section: FiltersSection,
+      entityFilterModelType: EntityFilterModelType.Label,
+    });
+
     return componentArguments;
   }
 }