@oneuptime/common 11.0.2 → 11.0.3

package/Types/Monitor/HostAlertTemplates.ts

@@ -0,0 +1,455 @@
+import ObjectID from "../ObjectID";
+import MonitorStep from "./MonitorStep";
+import MonitorCriteria from "./MonitorCriteria";
+import MonitorCriteriaInstance from "./MonitorCriteriaInstance";
+import FilterCondition from "../Filter/FilterCondition";
+import { CheckOn, FilterType, EvaluateOverTimeType } from "./CriteriaFilter";
+import MonitorStepHostMonitor from "./MonitorStepHostMonitor";
+import RollingTime from "../RollingTime/RollingTime";
+import MetricsAggregationType from "../Metrics/MetricsAggregationType";
+
+export type HostAlertTemplateCategory = "Resource" | "Host";
+
+export type HostAlertTemplateSeverity = "Critical" | "Warning";
+
+export interface HostAlertTemplateArgs {
+  hostIdentifier: string;
+  onlineMonitorStatusId: ObjectID;
+  offlineMonitorStatusId: ObjectID;
+  defaultIncidentSeverityId: ObjectID;
+  defaultAlertSeverityId: ObjectID;
+  monitorName: string;
+}
+
+export interface HostAlertTemplate {
+  id: string;
+  name: string;
+  description: string;
+  category: HostAlertTemplateCategory;
+  severity: HostAlertTemplateSeverity;
+  getMonitorStep: (args: HostAlertTemplateArgs) => MonitorStep;
+}
+
+export function buildHostMonitorStep(args: {
+  hostMonitor: MonitorStepHostMonitor;
+  offlineCriteriaInstance: MonitorCriteriaInstance;
+  onlineCriteriaInstance: MonitorCriteriaInstance;
+}): MonitorStep {
+  const monitorStep: MonitorStep = new MonitorStep();
+
+  const monitorCriteria: MonitorCriteria = new MonitorCriteria();
+
+  monitorCriteria.data = {
+    monitorCriteriaInstanceArray: [
+      args.offlineCriteriaInstance,
+      args.onlineCriteriaInstance,
+    ],
+  };
+
+  monitorStep.data = {
+    id: ObjectID.generate().toString(),
+    monitorDestination: undefined,
+    doNotFollowRedirects: undefined,
+    monitorDestinationPort: undefined,
+    monitorCriteria: monitorCriteria,
+    requestType: "GET" as any,
+    requestHeaders: undefined,
+    requestBody: undefined,
+    customCode: undefined,
+    screenSizeTypes: undefined,
+    browserTypes: undefined,
+    retryCountOnError: undefined,
+    logMonitor: undefined,
+    traceMonitor: undefined,
+    metricMonitor: undefined,
+    exceptionMonitor: undefined,
+    snmpMonitor: undefined,
+    dnsMonitor: undefined,
+    domainMonitor: undefined,
+    externalStatusPageMonitor: undefined,
+    kubernetesMonitor: undefined,
+    profileMonitor: undefined,
+    hostMonitor: args.hostMonitor,
+  };
+
+  return monitorStep;
+}
+
+export function buildHostOfflineCriteriaInstance(args: {
+  offlineMonitorStatusId: ObjectID;
+  incidentSeverityId: ObjectID;
+  alertSeverityId: ObjectID;
+  monitorName: string;
+  metricAlias: string;
+  filterType: FilterType;
+  value: number;
+  incidentTitle?: string;
+  incidentDescription?: string;
+  criteriaName?: string;
+  criteriaDescription?: string;
+}): MonitorCriteriaInstance {
+  const instance: MonitorCriteriaInstance = new MonitorCriteriaInstance();
+
+  const incidentTitle: string =
+    args.incidentTitle || `${args.monitorName} - Alert Triggered`;
+  const incidentDescription: string =
+    args.incidentDescription ||
+    `${args.monitorName} has triggered an alert condition. See root cause for detailed host information.`;
+
+  instance.data = {
+    id: ObjectID.generate().toString(),
+    monitorStatusId: args.offlineMonitorStatusId,
+    filterCondition: FilterCondition.Any,
+    filters: [
+      {
+        checkOn: CheckOn.MetricValue,
+        filterType: args.filterType,
+        metricMonitorOptions: {
+          metricAggregationType: EvaluateOverTimeType.AnyValue,
+          metricAlias: args.metricAlias,
+        },
+        value: args.value,
+      },
+    ],
+    incidents: [
+      {
+        title: incidentTitle,
+        description: incidentDescription,
+        incidentSeverityId: args.incidentSeverityId,
+        autoResolveIncident: true,
+        id: ObjectID.generate().toString(),
+        onCallPolicyIds: [],
+      },
+    ],
+    alerts: [
+      {
+        title: incidentTitle,
+        description: incidentDescription,
+        alertSeverityId: args.alertSeverityId,
+        autoResolveAlert: true,
+        id: ObjectID.generate().toString(),
+        onCallPolicyIds: [],
+      },
+    ],
+    changeMonitorStatus: true,
+    createIncidents: true,
+    createAlerts: true,
+    name: args.criteriaName || `${args.monitorName} - Unhealthy`,
+    description:
+      args.criteriaDescription || `Criteria for detecting unhealthy state.`,
+  };
+
+  return instance;
+}
+
+export function buildHostOnlineCriteriaInstance(args: {
+  onlineMonitorStatusId: ObjectID;
+  metricAlias: string;
+  filterType: FilterType;
+  value: number;
+}): MonitorCriteriaInstance {
+  const instance: MonitorCriteriaInstance = new MonitorCriteriaInstance();
+
+  instance.data = {
+    id: ObjectID.generate().toString(),
+    monitorStatusId: args.onlineMonitorStatusId,
+    filterCondition: FilterCondition.Any,
+    filters: [
+      {
+        checkOn: CheckOn.MetricValue,
+        filterType: args.filterType,
+        metricMonitorOptions: {
+          metricAggregationType: EvaluateOverTimeType.AnyValue,
+          metricAlias: args.metricAlias,
+        },
+        value: args.value,
+      },
+    ],
+    incidents: [],
+    alerts: [],
+    changeMonitorStatus: true,
+    createIncidents: false,
+    createAlerts: false,
+    name: "Healthy",
+    description: "Criteria for healthy state.",
+  };
+
+  return instance;
+}
+
+export function buildHostMonitorConfig(args: {
+  hostIdentifier: string;
+  metricName: string;
+  metricAlias: string;
+  rollingTime: RollingTime;
+  aggregationType: MetricsAggregationType;
+  attributes?: Record<string, string>;
+}): MonitorStepHostMonitor {
+  return {
+    hostIdentifier: args.hostIdentifier,
+    metricViewConfig: {
+      queryConfigs: [
+        {
+          metricAliasData: {
+            metricVariable: args.metricAlias,
+            title: args.metricAlias,
+            description: args.metricAlias,
+            legend: args.metricAlias,
+            legendUnit: undefined,
+          },
+          metricQueryData: {
+            filterData: {
+              metricName: args.metricName,
+              attributes: args.attributes || {},
+              aggegationType: args.aggregationType,
+              aggregateBy: {},
+            },
+          },
+        },
+      ],
+      formulaConfigs: [],
+    },
+    rollingTime: args.rollingTime,
+  };
+}
+
+// --- Template Definitions ---
+
+const highCpuTemplate: HostAlertTemplate = {
+  id: "host-high-cpu",
+  name: "High CPU Utilization",
+  description: "Alert when host CPU utilization exceeds 80% sustained.",
+  category: "Resource",
+  severity: "Warning",
+  getMonitorStep: (args: HostAlertTemplateArgs): MonitorStep => {
+    const metricAlias: string = "host_cpu";
+
+    return buildHostMonitorStep({
+      hostMonitor: buildHostMonitorConfig({
+        hostIdentifier: args.hostIdentifier,
+        metricName: "system.cpu.utilization",
+        metricAlias,
+        rollingTime: RollingTime.Past5Minutes,
+        aggregationType: MetricsAggregationType.Avg,
+      }),
+      offlineCriteriaInstance: buildHostOfflineCriteriaInstance({
+        offlineMonitorStatusId: args.offlineMonitorStatusId,
+        incidentSeverityId: args.defaultIncidentSeverityId,
+        alertSeverityId: args.defaultAlertSeverityId,
+        monitorName: args.monitorName,
+        metricAlias,
+        filterType: FilterType.GreaterThan,
+        // system.cpu.utilization is a [0, 1] ratio, so 0.8 == 80%.
+        value: 0.8,
+        incidentTitle: `[Host] High CPU Utilization (>80%) - ${args.monitorName}`,
+        incidentDescription: `A monitored host's CPU utilization has exceeded 80%. Sustained high CPU usage can cause performance degradation. Check the root cause for the specific host details.`,
+        criteriaName: "High CPU - Utilization > 80%",
+        criteriaDescription:
+          "Triggers when host CPU utilization exceeds 80% over the monitoring window.",
+      }),
+      onlineCriteriaInstance: buildHostOnlineCriteriaInstance({
+        onlineMonitorStatusId: args.onlineMonitorStatusId,
+        metricAlias,
+        filterType: FilterType.LessThanOrEqualTo,
+        value: 0.8,
+      }),
+    });
+  },
+};
+
+const highMemoryTemplate: HostAlertTemplate = {
+  id: "host-high-memory",
+  name: "High Memory Utilization",
+  description: "Alert when host memory utilization exceeds 85%.",
+  category: "Resource",
+  severity: "Warning",
+  getMonitorStep: (args: HostAlertTemplateArgs): MonitorStep => {
+    const metricAlias: string = "host_memory";
+
+    return buildHostMonitorStep({
+      hostMonitor: buildHostMonitorConfig({
+        hostIdentifier: args.hostIdentifier,
+        metricName: "system.memory.utilization",
+        metricAlias,
+        rollingTime: RollingTime.Past5Minutes,
+        aggregationType: MetricsAggregationType.Avg,
+      }),
+      offlineCriteriaInstance: buildHostOfflineCriteriaInstance({
+        offlineMonitorStatusId: args.offlineMonitorStatusId,
+        incidentSeverityId: args.defaultIncidentSeverityId,
+        alertSeverityId: args.defaultAlertSeverityId,
+        monitorName: args.monitorName,
+        metricAlias,
+        filterType: FilterType.GreaterThan,
+        // system.memory.utilization is a [0, 1] ratio, so 0.85 == 85%.
+        value: 0.85,
+        incidentTitle: `[Host] High Memory Utilization (>85%) - ${args.monitorName}`,
+        incidentDescription: `A monitored host's memory utilization has exceeded 85%. High memory usage can lead to swapping and OOM kills. Check the root cause for the specific host details.`,
+        criteriaName: "High Memory - Utilization > 85%",
+        criteriaDescription:
+          "Triggers when host memory utilization exceeds 85% over the monitoring window.",
+      }),
+      onlineCriteriaInstance: buildHostOnlineCriteriaInstance({
+        onlineMonitorStatusId: args.onlineMonitorStatusId,
+        metricAlias,
+        filterType: FilterType.LessThanOrEqualTo,
+        value: 0.85,
+      }),
+    });
+  },
+};
+
+const highFilesystemUsageTemplate: HostAlertTemplate = {
+  id: "host-high-filesystem",
+  name: "High Filesystem Usage",
+  description: "Alert when host filesystem utilization exceeds 90%.",
+  category: "Resource",
+  severity: "Critical",
+  getMonitorStep: (args: HostAlertTemplateArgs): MonitorStep => {
+    const metricAlias: string = "host_filesystem";
+
+    return buildHostMonitorStep({
+      hostMonitor: buildHostMonitorConfig({
+        hostIdentifier: args.hostIdentifier,
+        metricName: "system.filesystem.utilization",
+        metricAlias,
+        rollingTime: RollingTime.Past5Minutes,
+        /*
+         * Use Max so a single full filesystem trips the threshold instead of
+         * being diluted by averaging across multiple mounted filesystems.
+         */
+        aggregationType: MetricsAggregationType.Max,
+      }),
+      offlineCriteriaInstance: buildHostOfflineCriteriaInstance({
+        offlineMonitorStatusId: args.offlineMonitorStatusId,
+        incidentSeverityId: args.defaultIncidentSeverityId,
+        alertSeverityId: args.defaultAlertSeverityId,
+        monitorName: args.monitorName,
+        metricAlias,
+        filterType: FilterType.GreaterThan,
+        // system.filesystem.utilization is a [0, 1] ratio, so 0.9 == 90%.
+        value: 0.9,
+        incidentTitle: `[Host] High Filesystem Usage (>90%) - ${args.monitorName}`,
+        incidentDescription: `A monitored host's filesystem utilization has exceeded 90%. A full disk can cause application failures and data loss. Check the root cause for the specific host and free up disk space.`,
+        criteriaName: "High Filesystem - Usage > 90%",
+        criteriaDescription:
+          "Triggers when any host filesystem exceeds 90% utilization over the monitoring window.",
+      }),
+      onlineCriteriaInstance: buildHostOnlineCriteriaInstance({
+        onlineMonitorStatusId: args.onlineMonitorStatusId,
+        metricAlias,
+        filterType: FilterType.LessThanOrEqualTo,
+        value: 0.9,
+      }),
+    });
+  },
+};
+
+const highLoadAverageTemplate: HostAlertTemplate = {
+  id: "host-high-load-average",
+  name: "High Load Average (1m)",
+  description:
+    "Alert when the host's 1-minute load average exceeds 4, indicating sustained CPU contention.",
+  category: "Resource",
+  severity: "Warning",
+  getMonitorStep: (args: HostAlertTemplateArgs): MonitorStep => {
+    const metricAlias: string = "host_load_1m";
+
+    return buildHostMonitorStep({
+      hostMonitor: buildHostMonitorConfig({
+        hostIdentifier: args.hostIdentifier,
+        metricName: "system.cpu.load_average.1m",
+        metricAlias,
+        rollingTime: RollingTime.Past5Minutes,
+        aggregationType: MetricsAggregationType.Avg,
+      }),
+      offlineCriteriaInstance: buildHostOfflineCriteriaInstance({
+        offlineMonitorStatusId: args.offlineMonitorStatusId,
+        incidentSeverityId: args.defaultIncidentSeverityId,
+        alertSeverityId: args.defaultAlertSeverityId,
+        monitorName: args.monitorName,
+        metricAlias,
+        filterType: FilterType.GreaterThan,
+        value: 4,
+        incidentTitle: `[Host] High Load Average (1m > 4) - ${args.monitorName}`,
+        incidentDescription: `A monitored host's 1-minute load average has exceeded 4. A sustained high load average indicates CPU contention or runaway processes. Compare against the host's core count and check the root cause.`,
+        criteriaName: "High Load - 1m Average > 4",
+        criteriaDescription:
+          "Triggers when the host's 1-minute load average exceeds 4 over the monitoring window.",
+      }),
+      onlineCriteriaInstance: buildHostOnlineCriteriaInstance({
+        onlineMonitorStatusId: args.onlineMonitorStatusId,
+        metricAlias,
+        filterType: FilterType.LessThanOrEqualTo,
+        value: 4,
+      }),
+    });
+  },
+};
+
+const highProcessCountTemplate: HostAlertTemplate = {
+  id: "host-high-processes",
+  name: "High Process Count",
+  description:
+    "Alert when the host has an unusually high number of processes, which may indicate a fork bomb or resource leak.",
+  category: "Host",
+  severity: "Warning",
+  getMonitorStep: (args: HostAlertTemplateArgs): MonitorStep => {
+    const metricAlias: string = "host_processes";
+
+    return buildHostMonitorStep({
+      hostMonitor: buildHostMonitorConfig({
+        hostIdentifier: args.hostIdentifier,
+        metricName: "system.processes.count",
+        metricAlias,
+        rollingTime: RollingTime.Past5Minutes,
+        aggregationType: MetricsAggregationType.Max,
+      }),
+      offlineCriteriaInstance: buildHostOfflineCriteriaInstance({
+        offlineMonitorStatusId: args.offlineMonitorStatusId,
+        incidentSeverityId: args.defaultIncidentSeverityId,
+        alertSeverityId: args.defaultAlertSeverityId,
+        monitorName: args.monitorName,
+        metricAlias,
+        filterType: FilterType.GreaterThan,
+        value: 2000,
+        incidentTitle: `[Host] High Process Count (>2000) - ${args.monitorName}`,
+        incidentDescription: `A monitored host has an unusually high number of processes (>2000). This may indicate a fork bomb, resource leak, or misconfigured application. Check the host for runaway processes.`,
+        criteriaName: "High Processes - Count > 2000",
+        criteriaDescription: "Triggers when host process count exceeds 2000.",
+      }),
+      onlineCriteriaInstance: buildHostOnlineCriteriaInstance({
+        onlineMonitorStatusId: args.onlineMonitorStatusId,
+        metricAlias,
+        filterType: FilterType.LessThanOrEqualTo,
+        value: 2000,
+      }),
+    });
+  },
+};
+
+export function getAllHostAlertTemplates(): Array<HostAlertTemplate> {
+  return [
+    highCpuTemplate,
+    highMemoryTemplate,
+    highFilesystemUsageTemplate,
+    highLoadAverageTemplate,
+    highProcessCountTemplate,
+  ];
+}
+
+export function getHostAlertTemplatesByCategory(
+  category: HostAlertTemplateCategory,
+): Array<HostAlertTemplate> {
+  return getAllHostAlertTemplates().filter((template: HostAlertTemplate) => {
+    return template.category === category;
+  });
+}
+
+export function getHostAlertTemplateById(
+  id: string,
+): HostAlertTemplate | undefined {
+  return getAllHostAlertTemplates().find((template: HostAlertTemplate) => {
+    return template.id === id;
+  });
+}

package/Types/Monitor/HostMetricCatalog.ts

@@ -0,0 +1,177 @@
+import MetricsAggregationType from "../Metrics/MetricsAggregationType";
+
+export type HostMetricCategory =
+  | "CPU"
+  | "Memory"
+  | "Disk"
+  | "Network"
+  | "Load"
+  | "Processes";
+
+export interface HostMetricDefinition {
+  id: string;
+  friendlyName: string;
+  description: string;
+  metricName: string;
+  category: HostMetricCategory;
+  defaultAggregation: MetricsAggregationType;
+  unit?: string;
+}
+
+/*
+ * These are the real OpenTelemetry host metrics emitted by the OneUptime
+ * Infrastructure Agent's hostmetrics receiver (the Hosts product). The
+ * utilization metrics (system.cpu.utilization, system.memory.utilization,
+ * system.filesystem.utilization) are reported as a [0, 1] ratio by the OTel
+ * host receiver, so the friendly unit is "ratio" — the dashboard auto-scales
+ * these to percent at render time.
+ */
+const hostMetricCatalog: Array<HostMetricDefinition> = [
+  // CPU Metrics
+  {
+    id: "system-cpu-utilization",
+    friendlyName: "CPU Utilization",
+    description:
+      "Host CPU utilization as a ratio (0 to 1). 1.0 = all cores fully busy.",
+    metricName: "system.cpu.utilization",
+    category: "CPU",
+    defaultAggregation: MetricsAggregationType.Avg,
+    unit: "ratio",
+  },
+  {
+    id: "process-cpu-utilization",
+    friendlyName: "Process CPU Utilization",
+    description:
+      "Per-process CPU utilization as a ratio (0 to 1) for processes running on the host.",
+    metricName: "process.cpu.utilization",
+    category: "CPU",
+    defaultAggregation: MetricsAggregationType.Max,
+    unit: "ratio",
+  },
+
+  // Memory Metrics
+  {
+    id: "system-memory-utilization",
+    friendlyName: "Memory Utilization",
+    description:
+      "Host memory utilization as a ratio (0 to 1) of total physical memory in use.",
+    metricName: "system.memory.utilization",
+    category: "Memory",
+    defaultAggregation: MetricsAggregationType.Avg,
+    unit: "ratio",
+  },
+  {
+    id: "system-memory-usage",
+    friendlyName: "Memory Usage",
+    description: "Host memory usage in bytes.",
+    metricName: "system.memory.usage",
+    category: "Memory",
+    defaultAggregation: MetricsAggregationType.Avg,
+    unit: "bytes",
+  },
+
+  // Disk / Filesystem Metrics
+  {
+    id: "system-filesystem-utilization",
+    friendlyName: "Filesystem Utilization",
+    description:
+      "Filesystem utilization as a ratio (0 to 1) of total disk capacity in use.",
+    metricName: "system.filesystem.utilization",
+    category: "Disk",
+    defaultAggregation: MetricsAggregationType.Max,
+    unit: "ratio",
+  },
+  {
+    id: "system-filesystem-usage",
+    friendlyName: "Filesystem Usage",
+    description: "Filesystem usage in bytes.",
+    metricName: "system.filesystem.usage",
+    category: "Disk",
+    defaultAggregation: MetricsAggregationType.Max,
+    unit: "bytes",
+  },
+
+  // Network Metrics
+  {
+    id: "system-network-io",
+    friendlyName: "Network I/O",
+    description:
+      "Cumulative network bytes transferred (received + transmitted) by the host.",
+    metricName: "system.network.io",
+    category: "Network",
+    defaultAggregation: MetricsAggregationType.Sum,
+    unit: "bytes",
+  },
+
+  // Load Average Metrics
+  {
+    id: "system-cpu-load-average-1m",
+    friendlyName: "Load Average (1m)",
+    description: "Host CPU load average over the last 1 minute.",
+    metricName: "system.cpu.load_average.1m",
+    category: "Load",
+    defaultAggregation: MetricsAggregationType.Avg,
+    unit: "count",
+  },
+  {
+    id: "system-cpu-load-average-5m",
+    friendlyName: "Load Average (5m)",
+    description: "Host CPU load average over the last 5 minutes.",
+    metricName: "system.cpu.load_average.5m",
+    category: "Load",
+    defaultAggregation: MetricsAggregationType.Avg,
+    unit: "count",
+  },
+  {
+    id: "system-cpu-load-average-15m",
+    friendlyName: "Load Average (15m)",
+    description: "Host CPU load average over the last 15 minutes.",
+    metricName: "system.cpu.load_average.15m",
+    category: "Load",
+    defaultAggregation: MetricsAggregationType.Avg,
+    unit: "count",
+  },
+
+  // Process Metrics
+  {
+    id: "system-processes-count",
+    friendlyName: "Process Count",
+    description: "Number of processes running on the host.",
+    metricName: "system.processes.count",
+    category: "Processes",
+    defaultAggregation: MetricsAggregationType.Avg,
+    unit: "count",
+  },
+];
+
+export function getAllHostMetrics(): Array<HostMetricDefinition> {
+  return hostMetricCatalog;
+}
+
+export function getHostMetricsByCategory(
+  category: HostMetricCategory,
+): Array<HostMetricDefinition> {
+  return hostMetricCatalog.filter((m: HostMetricDefinition) => {
+    return m.category === category;
+  });
+}
+
+export function getHostMetricById(
+  id: string,
+): HostMetricDefinition | undefined {
+  return hostMetricCatalog.find((m: HostMetricDefinition) => {
+    return m.id === id;
+  });
+}
+
+export function getHostMetricByMetricName(
+  metricName: string,
+): HostMetricDefinition | undefined {
+  return hostMetricCatalog.find((m: HostMetricDefinition) => {
+    return m.metricName === metricName;
+  });
+}
+
+export function getAllHostMetricCategories(): Array<HostMetricCategory> {
+  return ["CPU", "Memory", "Disk", "Network", "Load", "Processes"];
+}

package/Types/Monitor/MetricMonitor/MetricMonitorResponse.ts

@@ -66,6 +66,26 @@ export interface CephResourceBreakdown {
   attributes: Dictionary<string>;
 }
 
+export interface DockerSwarmAffectedResource {
+  /** `container.name` datapoint label — a Swarm task's container is `<service>.<slot>.<taskid>`. */
+  containerName?: string | undefined;
+  /** `container.image.name` datapoint label, when present. */
+  containerImage?: string | undefined;
+  /** `docker.swarm.node.name` datapoint label, when the agent stamps it. */
+  nodeName?: string | undefined;
+  /** `docker.swarm.service.name` datapoint label, when the agent stamps it. */
+  serviceName?: string | undefined;
+  metricValue: number;
+}
+
+export interface DockerSwarmResourceBreakdown {
+  clusterName: string;
+  metricName: string;
+  metricFriendlyName: string;
+  affectedResources: Array<DockerSwarmAffectedResource>;
+  attributes: Dictionary<string>;
+}
+
 export default interface MetricMonitorResponse {
   projectId: ObjectID;
   startAndEndDate?: InBetween<Date>;
@@ -76,6 +96,7 @@ export default interface MetricMonitorResponse {
   kubernetesResourceBreakdown?: KubernetesResourceBreakdown | undefined;
   proxmoxResourceBreakdown?: ProxmoxResourceBreakdown | undefined;
   cephResourceBreakdown?: CephResourceBreakdown | undefined;
+  dockerSwarmResourceBreakdown?: DockerSwarmResourceBreakdown | undefined;
   /**
    * Per-series breakdown when any queryConfig sets groupByAttributeKeys.
    * Each entry carries a fingerprint, the label values identifying that