@oneuptime/common 11.0.1 → 11.0.3

package/UI/Components/LogsViewer/components/LogsFacetSidebar.tsx

@@ -9,6 +9,7 @@ import FacetSection from "./FacetSection";
 import Service from "../../../../Models/DatabaseModels/Service";
 import Host from "../../../../Models/DatabaseModels/Host";
 import DockerHost from "../../../../Models/DatabaseModels/DockerHost";
+import PodmanHost from "../../../../Models/DatabaseModels/PodmanHost";
 import KubernetesCluster from "../../../../Models/DatabaseModels/KubernetesCluster";
 import Dictionary from "../../../../Types/Dictionary";
 import ComponentLoader from "../../ComponentLoader/ComponentLoader";
@@ -21,6 +22,7 @@ export interface LogsFacetSidebarProps {
   serviceMap: Dictionary<Service>;
   hostMap?: Dictionary<Host>;
   dockerHostMap?: Dictionary<DockerHost>;
+  podmanHostMap?: Dictionary<PodmanHost>;
   kubernetesClusterMap?: Dictionary<KubernetesCluster>;
   onIncludeFilter: (facetKey: string, value: string) => void;
   onExcludeFilter: (facetKey: string, value: string) => void;
@@ -42,6 +44,7 @@ const RESOURCE_FACET_KEYS: ReadonlySet<string> = new Set([
   "primaryEntityId",
   "hostId",
   "dockerHostId",
+  "podmanHostId",
   "kubernetesClusterId",
 ]);
 
@@ -126,6 +129,23 @@ function buildDockerHostDisplayMap(
   return map;
 }
 
+function buildPodmanHostDisplayMap(
+  podmanHostMap: Dictionary<PodmanHost> | undefined,
+): Record<string, string> {
+  const map: Record<string, string> = {};
+  if (!podmanHostMap) {
+    return map;
+  }
+  for (const [id, podmanHost] of Object.entries(podmanHostMap)) {
+    const label: string | undefined =
+      podmanHost?.name || podmanHost?.hostIdentifier;
+    if (label) {
+      map[id] = label;
+    }
+  }
+  return map;
+}
+
 function buildClusterDisplayMap(
   clusterMap: Dictionary<KubernetesCluster> | undefined,
 ): Record<string, string> {
@@ -149,6 +169,7 @@ function getFacetTitle(key: string): string {
     primaryEntityId: "Service",
     hostId: "Host",
     dockerHostId: "Docker Host",
+    podmanHostId: "Podman Host",
     kubernetesClusterId: "Kubernetes Cluster",
     traceId: "Trace ID",
     spanId: "Span ID",
@@ -180,6 +201,10 @@ const LogsFacetSidebar: FunctionComponent<LogsFacetSidebarProps> = (
     return buildDockerHostDisplayMap(props.dockerHostMap);
   }, [props.dockerHostMap]);
 
+  const podmanHostDisplayMap: Record<string, string> = useMemo(() => {
+    return buildPodmanHostDisplayMap(props.podmanHostMap);
+  }, [props.podmanHostMap]);
+
   const clusterDisplayMap: Record<string, string> = useMemo(() => {
     return buildClusterDisplayMap(props.kubernetesClusterMap);
   }, [props.kubernetesClusterMap]);
@@ -190,6 +215,7 @@ const LogsFacetSidebar: FunctionComponent<LogsFacetSidebarProps> = (
       "primaryEntityId",
       "hostId",
       "dockerHostId",
+      "podmanHostId",
       "kubernetesClusterId",
     ];
     const otherKeys: Array<string> = Object.keys(props.facetData).filter(
@@ -287,6 +313,8 @@ const LogsFacetSidebar: FunctionComponent<LogsFacetSidebarProps> = (
             valueDisplayMap = hostDisplayMap;
           } else if (key === "dockerHostId") {
             valueDisplayMap = dockerHostDisplayMap;
+          } else if (key === "podmanHostId") {
+            valueDisplayMap = podmanHostDisplayMap;
           } else if (key === "kubernetesClusterId") {
             valueDisplayMap = clusterDisplayMap;
           } else if (key === "severityText") {

package/UI/Components/MonitorTemplateVariables/TemplateVariablesCatalog.ts

@@ -32,10 +32,10 @@ export default class TemplateVariablesCatalog {
     monitorType: MonitorType;
     /**
      * Attribute keys the user has configured on the metric query
-     * (e.g. ["host.name", "region"]). For metric/kubernetes/docker
-     * monitors, these become per-series template variables — one
-     * incident fires per unique value combination, and each incident
-     * can reference the label values via `{{host.name}}` etc.
+     * (e.g. ["host.name", "region"]). For metric/kubernetes/docker/
+     * proxmox/ceph monitors, these become per-series template variables
+     * — one incident fires per unique value combination, and each
+     * incident can reference the label values via `{{host.name}}` etc.
      */
     seriesAttributeKeys?: Array<string> | undefined;
   }): Array<TemplateVariableGroup> {
@@ -52,7 +52,12 @@ export default class TemplateVariablesCatalog {
     if (
       input.monitorType === MonitorType.Metrics ||
       input.monitorType === MonitorType.Kubernetes ||
-      input.monitorType === MonitorType.Docker
+      input.monitorType === MonitorType.Docker ||
+      input.monitorType === MonitorType.Host ||
+      input.monitorType === MonitorType.Podman ||
+      input.monitorType === MonitorType.DockerSwarm ||
+      input.monitorType === MonitorType.Proxmox ||
+      input.monitorType === MonitorType.Ceph
     ) {
       groups.push(
         TemplateVariablesCatalog.seriesLabelsGroup(input.seriesAttributeKeys),
@@ -485,6 +490,11 @@ export default class TemplateVariablesCatalog {
       case MonitorType.Metrics:
       case MonitorType.Kubernetes:
       case MonitorType.Docker:
+      case MonitorType.Host:
+      case MonitorType.Podman:
+      case MonitorType.DockerSwarm:
+      case MonitorType.Proxmox:
+      case MonitorType.Ceph:
         return {
           title: "Metric",
           variables: [

package/UI/Utils/Telemetry/Telemetry.ts

@@ -8,14 +8,16 @@ import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
 import { registerInstrumentations } from "@opentelemetry/instrumentation";
 import { FetchInstrumentation } from "@opentelemetry/instrumentation-fetch";
 import { XMLHttpRequestInstrumentation } from "@opentelemetry/instrumentation-xml-http-request";
-import { Resource } from "@opentelemetry/resources";
+import { resourceFromAttributes } from "@opentelemetry/resources";
 import {
   BatchSpanProcessor,
   TracerConfig,
   WebTracerProvider,
 } from "@opentelemetry/sdk-trace-web";
-import type { SpanExporter } from "@opentelemetry/sdk-trace-base";
-import type { SpanExporter as WebSpanExporter } from "@opentelemetry/sdk-trace-web/node_modules/@opentelemetry/sdk-trace-base/build/src/export/SpanExporter";
+import type {
+  SpanExporter,
+  SpanProcessor,
+} from "@opentelemetry/sdk-trace-base";
 import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
 import URL from "../../../Types/API/URL";
 
@@ -87,14 +89,6 @@ export default class Telemetry {
       Object.keys(OpenTelemetryExporterOtlpHeaders).length > 0;
 
     if (OpenTelemetryExporterOtlpEndpoint && hasHeaders) {
-      const providerConfig: TracerConfig = {
-        resource: new Resource({
-          [ATTR_SERVICE_NAME]: data.serviceName,
-        }),
-      };
-
-      const provider: WebTracerProvider = new WebTracerProvider(providerConfig);
-
       const traceExporter: SpanExporter = new OTLPTraceExporter({
         url: URL.fromString(
           OpenTelemetryExporterOtlpEndpoint?.toString() + "/v1/traces",
@@ -102,17 +96,18 @@ export default class Telemetry {
         headers: OpenTelemetryExporterOtlpHeaders,
       }) as unknown as SpanExporter;
 
-      const webTraceExporter: WebSpanExporter =
-        traceExporter as unknown as WebSpanExporter;
-
-      provider.addSpanProcessor(new BatchSpanProcessor(webTraceExporter));
+      const providerConfig: TracerConfig = {
+        resource: resourceFromAttributes({
+          [ATTR_SERVICE_NAME]: data.serviceName,
+        }),
+        // Stamp global RUM attributes (userId, projectId, ...) onto every span.
+        spanProcessors: [
+          new BatchSpanProcessor(traceExporter),
+          new GlobalAttributeSpanProcessor() as unknown as SpanProcessor,
+        ],
+      };
 
-      // Stamp global RUM attributes (userId, projectId, ...) onto every span.
-      provider.addSpanProcessor(
-        new GlobalAttributeSpanProcessor() as unknown as Parameters<
-          WebTracerProvider["addSpanProcessor"]
-        >[0],
-      );
+      const provider: WebTracerProvider = new WebTracerProvider(providerConfig);
 
       provider.register({
         contextManager: new ZoneContextManager(),

package/UI/Utils/TelemetryService.ts

@@ -23,7 +23,8 @@ export const UNKNOWN_SERVICE_NAME: string = "Unknown Service";
  * primaryEntityType) to something renderable. Either a Service (a real
  * OpenTelemetry service, or the synthetic "Unknown Service" for the
  * unattributed bucket) — or a plain `label` for infrastructure resource
- * types (Host / DockerHost / KubernetesCluster) that have no Service row.
+ * types (Host / DockerHost / KubernetesCluster / ProxmoxCluster /
+ * CephCluster) that have no Service row.
  */
 export interface ResolvedTelemetryResource {
   service?: Service;
@@ -66,8 +67,9 @@ export default class TelemetryServiceUtil {
    * old server-side `service` ORM relation on TelemetryException: a real
    * Service resolves from the loaded list, the unattributed bucket resolves
    * to the synthetic "Unknown Service", and Host / DockerHost /
-   * KubernetesCluster resolve to a type label (no Service row exists for
-   * them). Mirrors how the ClickHouse analytics rows are resolved.
+   * KubernetesCluster / ProxmoxCluster / CephCluster resolve to a type
+   * label (no Service row exists for them). Mirrors how the ClickHouse
+   * analytics rows are resolved.
    */
   public static resolveTelemetryResource(data: {
     primaryEntityId: ObjectID | string | null | undefined;
@@ -100,7 +102,10 @@ export default class TelemetryServiceUtil {
     const typeLabels: Record<string, string> = {
       [ServiceType.Host]: "Host telemetry",
       [ServiceType.DockerHost]: "Docker host telemetry",
+      [ServiceType.PodmanHost]: "Podman host telemetry",
       [ServiceType.KubernetesCluster]: "Kubernetes telemetry",
+      [ServiceType.ProxmoxCluster]: "Proxmox Cluster",
+      [ServiceType.CephCluster]: "Ceph Cluster",
     };
     const label: string | undefined = data.primaryEntityType
       ? typeLabels[data.primaryEntityType.toString()]

package/Utils/Dashboard/Components/DashboardCephOsdListComponent.ts

@@ -0,0 +1,63 @@
+import DashboardCephOsdListComponent from "../../../Types/Dashboard/DashboardComponents/DashboardCephOsdListComponent";
+import { ObjectType } from "../../../Types/JSON";
+import ObjectID from "../../../Types/ObjectID";
+import DashboardBaseComponentUtil from "./DashboardBaseComponent";
+import {
+  ComponentArgument,
+  ComponentInputType,
+} from "../../../Types/Dashboard/DashboardComponents/ComponentArgument";
+import DashboardComponentType from "../../../Types/Dashboard/DashboardComponentType";
+import {
+  CephFiltersSection,
+  getCephCommonArguments,
+} from "./DashboardCephResourceListShared";
+
+export default class DashboardCephOsdListComponentUtil extends DashboardBaseComponentUtil {
+  public static override getDefaultComponent(): DashboardCephOsdListComponent {
+    return {
+      _type: ObjectType.DashboardComponent,
+      componentType: DashboardComponentType.CephOsdList,
+      widthInDashboardUnits: 6,
+      heightInDashboardUnits: 4,
+      topInDashboardUnits: 0,
+      leftInDashboardUnits: 0,
+      componentId: ObjectID.generate(),
+      minHeightInDashboardUnits: 3,
+      minWidthInDashboardUnits: 6,
+      arguments: {
+        maxRows: 25,
+        /*
+         * The classic "OSD wall" — a honeycomb where each cell is an
+         * OSD colored by up/in state — is the view operators expect
+         * for this widget, so honeycomb is the default. The list view
+         * stays one dropdown away.
+         */
+        viewMode: "honeycomb",
+      },
+    };
+  }
+
+  public static override getComponentConfigArguments(): Array<
+    ComponentArgument<DashboardCephOsdListComponent>
+  > {
+    const args: Array<ComponentArgument<DashboardCephOsdListComponent>> =
+      getCephCommonArguments<DashboardCephOsdListComponent>();
+
+    args.push({
+      name: "State",
+      description: "Quick filter by OSD up/in state",
+      required: false,
+      type: ComponentInputType.Dropdown,
+      id: "stateFilter",
+      section: CephFiltersSection,
+      dropdownOptions: [
+        { label: "All", value: "" },
+        { label: "Up only", value: "up" },
+        { label: "Down only", value: "down" },
+        { label: "Out only", value: "out" },
+      ],
+    });
+
+    return args;
+  }
+}

package/Utils/Dashboard/Components/DashboardCephPoolListComponent.ts

@@ -0,0 +1,32 @@
+import DashboardCephPoolListComponent from "../../../Types/Dashboard/DashboardComponents/DashboardCephPoolListComponent";
+import { ObjectType } from "../../../Types/JSON";
+import ObjectID from "../../../Types/ObjectID";
+import DashboardBaseComponentUtil from "./DashboardBaseComponent";
+import { ComponentArgument } from "../../../Types/Dashboard/DashboardComponents/ComponentArgument";
+import DashboardComponentType from "../../../Types/Dashboard/DashboardComponentType";
+import { getCephCommonArguments } from "./DashboardCephResourceListShared";
+
+export default class DashboardCephPoolListComponentUtil extends DashboardBaseComponentUtil {
+  public static override getDefaultComponent(): DashboardCephPoolListComponent {
+    return {
+      _type: ObjectType.DashboardComponent,
+      componentType: DashboardComponentType.CephPoolList,
+      widthInDashboardUnits: 6,
+      heightInDashboardUnits: 4,
+      topInDashboardUnits: 0,
+      leftInDashboardUnits: 0,
+      componentId: ObjectID.generate(),
+      minHeightInDashboardUnits: 3,
+      minWidthInDashboardUnits: 6,
+      arguments: {
+        maxRows: 25,
+      },
+    };
+  }
+
+  public static override getComponentConfigArguments(): Array<
+    ComponentArgument<DashboardCephPoolListComponent>
+  > {
+    return getCephCommonArguments<DashboardCephPoolListComponent>();
+  }
+}

package/Utils/Dashboard/Components/DashboardCephResourceListShared.ts

@@ -0,0 +1,61 @@
+import {
+  ComponentArgument,
+  ComponentArgumentSection,
+  ComponentInputType,
+  EntityFilterModelType,
+} from "../../../Types/Dashboard/DashboardComponents/ComponentArgument";
+import DashboardBaseComponent from "../../../Types/Dashboard/DashboardComponents/DashboardBaseComponent";
+import { getViewModeArgument } from "./DashboardListSharedArgs";
+
+export const CephDisplaySection: ComponentArgumentSection = {
+  name: "Display Options",
+  description: "Configure the widget title and row limit",
+  order: 1,
+};
+
+export const CephFiltersSection: ComponentArgumentSection = {
+  name: "Filters",
+  description: "Narrow down which resources are shown",
+  order: 2,
+  defaultCollapsed: true,
+};
+
+export function getCephCommonArguments<
+  T extends DashboardBaseComponent,
+>(): Array<ComponentArgument<T>> {
+  const args: Array<ComponentArgument<T>> = [];
+
+  args.push({
+    name: "Title",
+    description: "Header shown above the list",
+    required: false,
+    type: ComponentInputType.Text,
+    id: "title" as keyof T["arguments"],
+    section: CephDisplaySection,
+  });
+
+  args.push({
+    name: "Max Rows",
+    description: "Maximum number of rows to show",
+    required: false,
+    type: ComponentInputType.Number,
+    id: "maxRows" as keyof T["arguments"],
+    placeholder: "25",
+    section: CephDisplaySection,
+  });
+
+  args.push(getViewModeArgument<T>(CephDisplaySection));
+
+  args.push({
+    name: "Clusters",
+    description: "Show only resources from the selected Ceph clusters",
+    required: false,
+    type: ComponentInputType.EntityMultiSelectDropdown,
+    id: "cephClusterIds" as keyof T["arguments"],
+    placeholder: "All clusters",
+    section: CephFiltersSection,
+    entityFilterModelType: EntityFilterModelType.CephCluster,
+  });
+
+  return args;
+}

package/Utils/Dashboard/Components/DashboardDockerSwarmNodeListComponent.ts

@@ -0,0 +1,70 @@
+import DashboardDockerSwarmNodeListComponent from "../../../Types/Dashboard/DashboardComponents/DashboardDockerSwarmNodeListComponent";
+import { ObjectType } from "../../../Types/JSON";
+import ObjectID from "../../../Types/ObjectID";
+import DashboardBaseComponentUtil from "./DashboardBaseComponent";
+import {
+  ComponentArgument,
+  ComponentInputType,
+} from "../../../Types/Dashboard/DashboardComponents/ComponentArgument";
+import DashboardComponentType from "../../../Types/Dashboard/DashboardComponentType";
+import {
+  DockerSwarmFiltersSection,
+  getDockerSwarmCommonArguments,
+} from "./DashboardDockerSwarmResourceListShared";
+
+export default class DashboardDockerSwarmNodeListComponentUtil extends DashboardBaseComponentUtil {
+  public static override getDefaultComponent(): DashboardDockerSwarmNodeListComponent {
+    return {
+      _type: ObjectType.DashboardComponent,
+      componentType: DashboardComponentType.DockerSwarmNodeList,
+      widthInDashboardUnits: 6,
+      heightInDashboardUnits: 4,
+      topInDashboardUnits: 0,
+      leftInDashboardUnits: 0,
+      componentId: ObjectID.generate(),
+      minHeightInDashboardUnits: 3,
+      minWidthInDashboardUnits: 6,
+      arguments: {
+        maxRows: 25,
+      },
+    };
+  }
+
+  public static override getComponentConfigArguments(): Array<
+    ComponentArgument<DashboardDockerSwarmNodeListComponent>
+  > {
+    const args: Array<
+      ComponentArgument<DashboardDockerSwarmNodeListComponent>
+    > = getDockerSwarmCommonArguments<DashboardDockerSwarmNodeListComponent>();
+
+    args.push({
+      name: "Role",
+      description: "Show only manager nodes or only worker nodes",
+      required: false,
+      type: ComponentInputType.Dropdown,
+      id: "roleFilter",
+      section: DockerSwarmFiltersSection,
+      dropdownOptions: [
+        { label: "All", value: "" },
+        { label: "Managers only", value: "manager" },
+        { label: "Workers only", value: "worker" },
+      ],
+    });
+
+    args.push({
+      name: "Status",
+      description: "Quick filter by node readiness",
+      required: false,
+      type: ComponentInputType.Dropdown,
+      id: "statusFilter",
+      section: DockerSwarmFiltersSection,
+      dropdownOptions: [
+        { label: "All", value: "" },
+        { label: "Ready only", value: "ready" },
+        { label: "Not ready only", value: "notready" },
+      ],
+    });
+
+    return args;
+  }
+}

package/Utils/Dashboard/Components/DashboardDockerSwarmResourceListShared.ts

@@ -0,0 +1,61 @@
+import {
+  ComponentArgument,
+  ComponentArgumentSection,
+  ComponentInputType,
+  EntityFilterModelType,
+} from "../../../Types/Dashboard/DashboardComponents/ComponentArgument";
+import DashboardBaseComponent from "../../../Types/Dashboard/DashboardComponents/DashboardBaseComponent";
+import { getViewModeArgument } from "./DashboardListSharedArgs";
+
+export const DockerSwarmDisplaySection: ComponentArgumentSection = {
+  name: "Display Options",
+  description: "Configure the widget title and row limit",
+  order: 1,
+};
+
+export const DockerSwarmFiltersSection: ComponentArgumentSection = {
+  name: "Filters",
+  description: "Narrow down which resources are shown",
+  order: 2,
+  defaultCollapsed: true,
+};
+
+export function getDockerSwarmCommonArguments<
+  T extends DashboardBaseComponent,
+>(): Array<ComponentArgument<T>> {
+  const args: Array<ComponentArgument<T>> = [];
+
+  args.push({
+    name: "Title",
+    description: "Header shown above the list",
+    required: false,
+    type: ComponentInputType.Text,
+    id: "title" as keyof T["arguments"],
+    section: DockerSwarmDisplaySection,
+  });
+
+  args.push({
+    name: "Max Rows",
+    description: "Maximum number of rows to show",
+    required: false,
+    type: ComponentInputType.Number,
+    id: "maxRows" as keyof T["arguments"],
+    placeholder: "25",
+    section: DockerSwarmDisplaySection,
+  });
+
+  args.push(getViewModeArgument<T>(DockerSwarmDisplaySection));
+
+  args.push({
+    name: "Clusters",
+    description: "Show only resources from the selected Docker Swarm clusters",
+    required: false,
+    type: ComponentInputType.EntityMultiSelectDropdown,
+    id: "dockerSwarmClusterIds" as keyof T["arguments"],
+    placeholder: "All clusters",
+    section: DockerSwarmFiltersSection,
+    entityFilterModelType: EntityFilterModelType.DockerSwarmCluster,
+  });
+
+  return args;
+}

package/Utils/Dashboard/Components/DashboardDockerSwarmServiceListComponent.ts

@@ -0,0 +1,71 @@
+import DashboardDockerSwarmServiceListComponent from "../../../Types/Dashboard/DashboardComponents/DashboardDockerSwarmServiceListComponent";
+import { ObjectType } from "../../../Types/JSON";
+import ObjectID from "../../../Types/ObjectID";
+import DashboardBaseComponentUtil from "./DashboardBaseComponent";
+import {
+  ComponentArgument,
+  ComponentInputType,
+} from "../../../Types/Dashboard/DashboardComponents/ComponentArgument";
+import DashboardComponentType from "../../../Types/Dashboard/DashboardComponentType";
+import {
+  DockerSwarmFiltersSection,
+  getDockerSwarmCommonArguments,
+} from "./DashboardDockerSwarmResourceListShared";
+
+export default class DashboardDockerSwarmServiceListComponentUtil extends DashboardBaseComponentUtil {
+  public static override getDefaultComponent(): DashboardDockerSwarmServiceListComponent {
+    return {
+      _type: ObjectType.DashboardComponent,
+      componentType: DashboardComponentType.DockerSwarmServiceList,
+      widthInDashboardUnits: 6,
+      heightInDashboardUnits: 4,
+      topInDashboardUnits: 0,
+      leftInDashboardUnits: 0,
+      componentId: ObjectID.generate(),
+      minHeightInDashboardUnits: 3,
+      minWidthInDashboardUnits: 6,
+      arguments: {
+        maxRows: 25,
+      },
+    };
+  }
+
+  public static override getComponentConfigArguments(): Array<
+    ComponentArgument<DashboardDockerSwarmServiceListComponent>
+  > {
+    const args: Array<
+      ComponentArgument<DashboardDockerSwarmServiceListComponent>
+    > =
+      getDockerSwarmCommonArguments<DashboardDockerSwarmServiceListComponent>();
+
+    args.push({
+      name: "Service Mode",
+      description: "Show only replicated services or only global services",
+      required: false,
+      type: ComponentInputType.Dropdown,
+      id: "serviceModeFilter",
+      section: DockerSwarmFiltersSection,
+      dropdownOptions: [
+        { label: "All", value: "" },
+        { label: "Replicated only", value: "replicated" },
+        { label: "Global only", value: "global" },
+      ],
+    });
+
+    args.push({
+      name: "Status",
+      description: "Quick filter by whether the service is fully converged",
+      required: false,
+      type: ComponentInputType.Dropdown,
+      id: "statusFilter",
+      section: DockerSwarmFiltersSection,
+      dropdownOptions: [
+        { label: "All", value: "" },
+        { label: "Converged only", value: "converged" },
+        { label: "Not converged only", value: "notconverged" },
+      ],
+    });
+
+    return args;
+  }
+}

package/Utils/Dashboard/Components/DashboardPodmanContainerListComponent.ts

@@ -0,0 +1,100 @@
+import DashboardPodmanContainerListComponent from "../../../Types/Dashboard/DashboardComponents/DashboardPodmanContainerListComponent";
+import { ObjectType } from "../../../Types/JSON";
+import ObjectID from "../../../Types/ObjectID";
+import DashboardBaseComponentUtil from "./DashboardBaseComponent";
+import {
+  ComponentArgument,
+  ComponentArgumentSection,
+  ComponentInputType,
+  EntityFilterModelType,
+} from "../../../Types/Dashboard/DashboardComponents/ComponentArgument";
+import DashboardComponentType from "../../../Types/Dashboard/DashboardComponentType";
+import { getViewModeArgument } from "./DashboardListSharedArgs";
+
+const DisplaySection: ComponentArgumentSection = {
+  name: "Display Options",
+  description: "Configure the widget title and row limit",
+  order: 1,
+};
+
+const FiltersSection: ComponentArgumentSection = {
+  name: "Filters",
+  description: "Narrow down which containers are shown",
+  order: 2,
+  defaultCollapsed: true,
+};
+
+export default class DashboardPodmanContainerListComponentUtil extends DashboardBaseComponentUtil {
+  public static override getDefaultComponent(): DashboardPodmanContainerListComponent {
+    return {
+      _type: ObjectType.DashboardComponent,
+      componentType: DashboardComponentType.PodmanContainerList,
+      widthInDashboardUnits: 6,
+      heightInDashboardUnits: 4,
+      topInDashboardUnits: 0,
+      leftInDashboardUnits: 0,
+      componentId: ObjectID.generate(),
+      minHeightInDashboardUnits: 3,
+      minWidthInDashboardUnits: 6,
+      arguments: {
+        maxRows: 25,
+      },
+    };
+  }
+
+  public static override getComponentConfigArguments(): Array<
+    ComponentArgument<DashboardPodmanContainerListComponent>
+  > {
+    const args: Array<
+      ComponentArgument<DashboardPodmanContainerListComponent>
+    > = [];
+
+    args.push({
+      name: "Title",
+      description: "Header shown above the container list",
+      required: false,
+      type: ComponentInputType.Text,
+      id: "title",
+      section: DisplaySection,
+    });
+
+    args.push({
+      name: "Max Rows",
+      description: "Maximum number of containers to show",
+      required: false,
+      type: ComponentInputType.Number,
+      id: "maxRows",
+      placeholder: "25",
+      section: DisplaySection,
+    });
+
+    args.push(
+      getViewModeArgument<DashboardPodmanContainerListComponent>(
+        DisplaySection,
+      ),
+    );
+
+    args.push({
+      name: "Hosts",
+      description: "Show only containers from the selected hosts",
+      required: false,
+      type: ComponentInputType.EntityMultiSelectDropdown,
+      id: "podmanHostIds",
+      placeholder: "All hosts",
+      section: FiltersSection,
+      entityFilterModelType: EntityFilterModelType.PodmanHost,
+    });
+
+    args.push({
+      name: "Image Name",
+      description: "Substring of the container image to match (e.g. nginx)",
+      required: false,
+      type: ComponentInputType.Text,
+      id: "imageName",
+      placeholder: "nginx",
+      section: FiltersSection,
+    });
+
+    return args;
+  }
+}