@oneuptime/common 14.0.3 → 14.0.6

package/build/dist/Utils/Monitor/PlatformResourceIdentity.js

@@ -0,0 +1,323 @@
+/*
+ * Which platform object a set of metric attributes describes.
+ *
+ * Two readers need this answer and must never disagree about it:
+ *
+ *  - the telemetry worker, which scans raw datapoints and names the
+ *    resource behind each one for the "Affected Resources" list;
+ *  - the criteria evaluator, which names the resource behind each series
+ *    a grouped monitor evaluated — from the series' group-by labels, which
+ *    are the same attribute keys the worker reads (a template grouping by
+ *    node groups by `resource.k8s.node.name`).
+ *
+ * Both used to carry their own copy of the attribute keys. Keeping one copy
+ * here is what lets a per-series list and a raw-scan list title the same
+ * node the same way.
+ */
+export default class PlatformResourceIdentity {
+    /**
+     * Read one attribute as a non-empty string. Numbers are stringified —
+     * Ceph's `pool_id` arrives as either.
+     */
+    static readAttribute(attributes, key) {
+        const value = attributes[key];
+        if (typeof value === "string") {
+            return value.length > 0 ? value : undefined;
+        }
+        if (typeof value === "number" && Number.isFinite(value)) {
+            return String(value);
+        }
+        return undefined;
+    }
+    /**
+     * Series labels are whatever keys the user grouped by. The shipped
+     * templates group by the stored, `resource.`-prefixed key; a hand-built
+     * monitor may group by the bare OTel key ("k8s.node.name"). Mirror each
+     * label under its other spelling so either reads as the same identity.
+     * An existing key is never overwritten.
+     */
+    static withBothAttributeSpellings(labels) {
+        const result = Object.assign({}, labels);
+        const resourcePrefix = "resource.";
+        for (const key of Object.keys(labels)) {
+            const otherSpelling = key.startsWith(resourcePrefix)
+                ? key.substring(resourcePrefix.length)
+                : `${resourcePrefix}${key}`;
+            if (otherSpelling && result[otherSpelling] === undefined) {
+                result[otherSpelling] = labels[key];
+            }
+        }
+        return result;
+    }
+    static kubernetes(attributes) {
+        const read = (key) => {
+            return PlatformResourceIdentity.readAttribute(attributes, key);
+        };
+        let workloadType = undefined;
+        let workloadName = undefined;
+        /*
+         * Most specific controller first. A pod created by a Deployment is
+         * also stamped with its ReplicaSet, and the Deployment is the name a
+         * human looks for.
+         */
+        const workloadKeys = [
+            ["resource.k8s.deployment.name", "Deployment"],
+            ["resource.k8s.statefulset.name", "StatefulSet"],
+            ["resource.k8s.daemonset.name", "DaemonSet"],
+            ["resource.k8s.job.name", "Job"],
+            ["resource.k8s.cronjob.name", "CronJob"],
+            ["resource.k8s.replicaset.name", "ReplicaSet"],
+            /*
+             * Not a workload, but the object the HPA templates group by, and a
+             * series titled by it reads far better than one titled by its
+             * namespace.
+             */
+            ["resource.k8s.hpa.name", "HorizontalPodAutoscaler"],
+        ];
+        for (const [key, type] of workloadKeys) {
+            const name = read(key);
+            if (name) {
+                workloadType = type;
+                workloadName = name;
+                break;
+            }
+        }
+        return {
+            podName: read("resource.k8s.pod.name"),
+            namespace: read("resource.k8s.namespace.name"),
+            nodeName: read("resource.k8s.node.name"),
+            containerName: read("resource.k8s.container.name"),
+            workloadType: workloadType,
+            workloadName: workloadName,
+        };
+    }
+    /**
+     * The key the worker dedupes Kubernetes datapoints on: two rows with the
+     * same key are the same resource.
+     */
+    static kubernetesKey(identity) {
+        return [
+            identity.podName || "",
+            identity.namespace || "",
+            identity.nodeName || "",
+            identity.containerName || "",
+            identity.workloadName || "",
+        ].join("|");
+    }
+    /**
+     * Fill in the context a Kubernetes series' own labels do not carry —
+     * its namespace, workload and node — from one of the series' own
+     * datapoints.
+     *
+     * Only what is guaranteed to be the same for EVERY datapoint of the
+     * series is borrowed. A pod runs on one node and belongs to one
+     * workload and one namespace, so a series that names a pod may borrow
+     * all three; a workload lives in one namespace. A series grouped by
+     * node may borrow nothing: a node-level series summed from container
+     * rows (container CPU requests per node) has a different pod and
+     * namespace on every row, and borrowing one would title the node with
+     * an arbitrary tenant. The datapoint must also agree with every field
+     * the series already has, or it is not the series' datapoint at all.
+     */
+    static withKubernetesContext(series, context) {
+        const agrees = PlatformResourceIdentity.agreesOn(series, context, [
+            "podName",
+            "namespace",
+            "nodeName",
+            "containerName",
+            "workloadType",
+            "workloadName",
+        ]);
+        if (!agrees) {
+            return series;
+        }
+        if (series.podName) {
+            return Object.assign(Object.assign({}, series), { namespace: series.namespace || context.namespace, nodeName: series.nodeName || context.nodeName, workloadType: series.workloadName
+                    ? series.workloadType
+                    : context.workloadType, workloadName: series.workloadName || context.workloadName });
+        }
+        if (series.workloadName && !series.containerName) {
+            return Object.assign(Object.assign({}, series), { namespace: series.namespace || context.namespace });
+        }
+        return series;
+    }
+    static proxmox(attributes) {
+        return {
+            resourceId: PlatformResourceIdentity.readAttribute(attributes, "id"),
+            resourceName: PlatformResourceIdentity.readAttribute(attributes, "name"),
+            resourceType: PlatformResourceIdentity.readAttribute(attributes, "pve.type"),
+            scope: PlatformResourceIdentity.readAttribute(attributes, "pve.scope"),
+            nodeName: PlatformResourceIdentity.readAttribute(attributes, "node"),
+        };
+    }
+    static proxmoxKey(identity) {
+        return [
+            identity.resourceId || "",
+            identity.resourceName || "",
+            identity.nodeName || "",
+        ].join("|");
+    }
+    /**
+     * A Proxmox series grouped by `id` names one guest, node or storage;
+     * every datapoint of it carries the same agent-stamped type and scope,
+     * and (on the metadata series) the same name and node.
+     */
+    static withProxmoxContext(series, context) {
+        if (!series.resourceId ||
+            !PlatformResourceIdentity.agreesOn(series, context, ["resourceId", "resourceName", "resourceType", "scope", "nodeName"])) {
+            return series;
+        }
+        return Object.assign(Object.assign({}, series), { resourceName: series.resourceName || context.resourceName, resourceType: series.resourceType || context.resourceType, scope: series.scope || context.scope, nodeName: series.nodeName || context.nodeName });
+    }
+    static vmware(attributes) {
+        const read = (key) => {
+            return PlatformResourceIdentity.readAttribute(attributes, key);
+        };
+        /*
+         * Identity lives in the RESOURCE attributes the vcenter receiver
+         * stamps, stored `resource.`-prefixed. A VM template is a VM with
+         * `isTemplate` in the inventory, so its `vcenter.vm_template.*`
+         * identity folds into the VM fields.
+         */
+        return {
+            datacenterName: read("resource.vcenter.datacenter.name"),
+            clusterName: read("resource.vcenter.cluster.name"),
+            hostName: read("resource.vcenter.host.name"),
+            vmName: read("resource.vcenter.vm.name") ||
+                read("resource.vcenter.vm_template.name"),
+            vmId: read("resource.vcenter.vm.id") ||
+                read("resource.vcenter.vm_template.id"),
+            datastoreName: read("resource.vcenter.datastore.name"),
+            resourcePoolName: read("resource.vcenter.resource_pool.name"),
+            resourcePoolPath: read("resource.vcenter.resource_pool.inventory_path"),
+        };
+    }
+    /**
+     * Dedupe on the full identity tuple: `vcenter.vm.id` alone identifies a
+     * VM, but hosts / datastores / clusters are only unique within their
+     * datacenter and pools within their path.
+     */
+    static vmwareKey(identity) {
+        return [
+            identity.datacenterName || "",
+            identity.clusterName || "",
+            identity.hostName || "",
+            identity.vmId || "",
+            identity.vmName || "",
+            identity.datastoreName || "",
+            identity.resourcePoolPath || identity.resourcePoolName || "",
+        ].join("|");
+    }
+    /**
+     * vSphere is a strict tree — a VM sits on one host in one cluster in one
+     * datacenter — so a series that names an object may borrow the objects
+     * ABOVE it from its own datapoint, never anything beside or below it. A
+     * resource pool may not borrow a host: the VMs in a pool can run on
+     * different hosts.
+     */
+    static withVMwareContext(series, context) {
+        if (!PlatformResourceIdentity.agreesOn(series, context, [
+            "datacenterName",
+            "clusterName",
+            "hostName",
+            "vmName",
+            "vmId",
+            "datastoreName",
+            "resourcePoolName",
+            "resourcePoolPath",
+        ])) {
+            return series;
+        }
+        const above = {
+            datacenterName: series.datacenterName || context.datacenterName,
+            clusterName: series.clusterName || context.clusterName,
+        };
+        if (series.vmName || series.vmId) {
+            return Object.assign(Object.assign(Object.assign({}, series), above), { hostName: series.hostName || context.hostName, vmName: series.vmName || context.vmName, vmId: series.vmId || context.vmId, resourcePoolName: series.resourcePoolName || context.resourcePoolName, resourcePoolPath: series.resourcePoolPath || context.resourcePoolPath });
+        }
+        if (series.resourcePoolName || series.resourcePoolPath) {
+            /*
+             * A pool's own name and inventory path are one object: a series
+             * grouped by the path may borrow the name (and vice versa), so it is
+             * titled the way the raw-scan list titles it.
+             */
+            return Object.assign(Object.assign(Object.assign({}, series), above), { resourcePoolName: series.resourcePoolName || context.resourcePoolName, resourcePoolPath: series.resourcePoolPath || context.resourcePoolPath });
+        }
+        if (series.hostName) {
+            return Object.assign(Object.assign({}, series), above);
+        }
+        if (series.datastoreName || series.clusterName) {
+            return Object.assign(Object.assign({}, series), { datacenterName: above.datacenterName });
+        }
+        return series;
+    }
+    static ceph(attributes) {
+        return {
+            daemon: PlatformResourceIdentity.readAttribute(attributes, "ceph_daemon"),
+            poolId: PlatformResourceIdentity.readAttribute(attributes, "pool_id"),
+            poolName: PlatformResourceIdentity.readAttribute(attributes, "name"),
+            hostname: PlatformResourceIdentity.readAttribute(attributes, "hostname"),
+        };
+    }
+    static cephKey(identity) {
+        return [
+            identity.daemon || "",
+            identity.poolId || "",
+            identity.poolName || "",
+            identity.hostname || "",
+        ].join("|");
+    }
+    /**
+     * A daemon runs on one host and a pool id has one name, so a series that
+     * names either may borrow those from its own datapoint.
+     */
+    static withCephContext(series, context) {
+        if ((!series.daemon && !series.poolId) ||
+            !PlatformResourceIdentity.agreesOn(series, context, ["daemon", "poolId", "poolName", "hostname"])) {
+            return series;
+        }
+        return Object.assign(Object.assign({}, series), { poolName: series.poolName || context.poolName, hostname: series.hostname || context.hostname });
+    }
+    static dockerSwarm(attributes) {
+        /*
+         * Prefixed: the docker_stats receiver puts container identity on the
+         * RESOURCE, so ClickHouse stores `resource.container.name`.
+         */
+        return {
+            containerName: PlatformResourceIdentity.readAttribute(attributes, "resource.container.name"),
+            containerImage: PlatformResourceIdentity.readAttribute(attributes, "resource.container.image.name"),
+            nodeName: PlatformResourceIdentity.readAttribute(attributes, "docker.swarm.node.name"),
+            serviceName: PlatformResourceIdentity.readAttribute(attributes, "docker.swarm.service.name"),
+        };
+    }
+    static dockerSwarmKey(identity) {
+        return [
+            identity.containerName || "",
+            identity.containerImage || "",
+            identity.nodeName || "",
+            identity.serviceName || "",
+        ].join("|");
+    }
+    /**
+     * A Swarm task's container runs one image on one node for one service,
+     * so a series that names the container may borrow all three.
+     */
+    static withDockerSwarmContext(series, context) {
+        if (!series.containerName ||
+            !PlatformResourceIdentity.agreesOn(series, context, ["containerName", "containerImage", "nodeName", "serviceName"])) {
+            return series;
+        }
+        return Object.assign(Object.assign({}, series), { containerImage: series.containerImage || context.containerImage, nodeName: series.nodeName || context.nodeName, serviceName: series.serviceName || context.serviceName });
+    }
+    /*
+     * True when every listed field present on both sides has the same value.
+     */
+    static agreesOn(series, context, fields) {
+        return fields.every((field) => {
+            const a = series[field];
+            const b = context[field];
+            return a === undefined || b === undefined || a === b;
+        });
+    }
+}
+//# sourceMappingURL=PlatformResourceIdentity.js.map

package/build/dist/Utils/Monitor/PlatformResourceIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformResourceIdentity.js","sourceRoot":"","sources":["../../../../Utils/Monitor/PlatformResourceIdentity.ts"],"names":[],"mappings":"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"}

package/build/dist/Utils/NetworkDiscovery/DiscoveredHostNamingDiagnosis.js

@@ -0,0 +1,270 @@
+import { DiscoveredHostNetbiosStatus, DiscoveredHostReverseDnsStatus, readDiscoveredHostNetbiosStatus, readDiscoveredHostReverseDnsStatus, } from "../../Types/NetworkDevice/DiscoveredHostNamingStatus";
+import { DiscoveryScanStatus } from "./DiscoveryScanStatus";
+import { isNetbiosQueryableIPv4Address, normalizeNetbiosName, } from "./NetbiosNameUtil";
+import { normalizeReverseDnsName } from "./ReverseDnsNameUtil";
+import { ScanModeUtil } from "./ScanModeUtil";
+export const UNNAMED_HOST_LABEL = "No name found";
+export const NOT_YET_NAMED_HOST_LABEL = "Not named yet";
+/*
+ * Said for a scan still sweeping. Names are looked up only after the sweep
+ * finishes (Probe/Jobs/Discovery/FetchScans.ts, scanWithDeadline), so every
+ * host a running scan has reported so far is unnamed by construction — the
+ * interesting question has not been asked yet.
+ */
+export const IN_PROGRESS_EXPLANATION = "Names are looked up after the sweep finishes, so hosts found so far are listed by address. Open Review Results again when the scan completes.";
+/*
+ * Said for a scan that failed. A sweep that misses its deadline or throws is
+ * reported without ever reaching the naming passes, so its hosts are the ones
+ * it had uploaded along the way — which carry no names by design.
+ */
+export const FAILED_SCAN_EXPLANATION = "This scan stopped before it looked up names, so its hosts are listed by address. Run it again to name them.";
+/*
+ * One sentence per code. None of them says how many times the probe asked:
+ * a retry has to fit in the naming pass's time budget, so "even on a retry"
+ * could be false for exactly the hosts a slow DNS server pushed past the
+ * deadline. The tip that follows these codes says to rescan, which is the
+ * part the operator can act on.
+ */
+const REVERSE_DNS_SENTENCES = {
+    [DiscoveredHostReverseDnsStatus.NoRecord]: "Reverse DNS: the probe's DNS server has no PTR record for this address.",
+    [DiscoveredHostReverseDnsStatus.UnusableName]: "Reverse DNS: a PTR record came back, but it is not a valid hostname, so it was not used.",
+    [DiscoveredHostReverseDnsStatus.Timeout]: "Reverse DNS: the probe's DNS server did not answer in time.",
+    [DiscoveredHostReverseDnsStatus.ServerFailure]: "Reverse DNS: the probe's DNS server answered with a server failure (SERVFAIL).",
+    [DiscoveredHostReverseDnsStatus.Refused]: "Reverse DNS: the probe's DNS server refused the query.",
+    [DiscoveredHostReverseDnsStatus.Unreachable]: "Reverse DNS: the probe could not reach its DNS server.",
+    [DiscoveredHostReverseDnsStatus.Failed]: "Reverse DNS: the lookup failed on the probe.",
+    [DiscoveredHostReverseDnsStatus.SkippedTimeBudget]: "Reverse DNS: not looked up. The scan ran out of time for name lookups before reaching this address.",
+    [DiscoveredHostReverseDnsStatus.SkippedNoResolver]: "Reverse DNS: not looked up. The probe's DNS server was not answering, so it stopped asking.",
+};
+/*
+ * A row with no reverse-DNS code: stored by a probe older than the codes, or
+ * by one whose pass failed outright. Nothing on the row says which, or why,
+ * so this claims neither.
+ */
+export const REVERSE_DNS_NOT_RECORDED_SENTENCE = "Reverse DNS: no name was recorded for this address.";
+const NETBIOS_SENTENCES = {
+    [DiscoveredHostNetbiosStatus.NoReply]: "NetBIOS: no reply on UDP 137, which is usual for devices that are not Windows, or when a firewall blocks it.",
+    [DiscoveredHostNetbiosStatus.NoUsableName]: "NetBIOS: the device replied, but reported no usable name.",
+    [DiscoveredHostNetbiosStatus.SendFailed]: "NetBIOS: the query could not be sent from the probe.",
+    [DiscoveredHostNetbiosStatus.Skipped]: "NetBIOS: not asked. The lookup stopped before reaching this address.",
+    [DiscoveredHostNetbiosStatus.SkippedHostCap]: "NetBIOS: not asked. The scan reached the probe's NetBIOS host limit.",
+    [DiscoveredHostNetbiosStatus.SkippedIneligibleAddress]: "NetBIOS: not asked. Only private addresses are asked.",
+    [DiscoveredHostNetbiosStatus.SkippedGlobalProbe]: "NetBIOS: not asked. This scan ran on a global probe, and global probes never send NetBIOS queries.",
+};
+export const NETBIOS_OFF_SENTENCE = "NetBIOS: off for this scan.";
+// NetBIOS was on, and yet the row carries no code: an older probe's row.
+export const NETBIOS_NOT_RECORDED_SENTENCE = "NetBIOS: no name was recorded.";
+export const SNMP_NOT_CHECKED_SENTENCE = "SNMP: not checked by this scan.";
+export const SNMP_NO_ANSWER_SENTENCE = "SNMP: no answer with this scan's credentials.";
+export const SNMP_NO_SYSNAME_SENTENCE = "SNMP: the device answered, but reported no name (sysName).";
+/*
+ * The one piece of advice that fits the reverse-DNS code best, when any
+ * does. "No record" gets the one that matters most for the issue this came
+ * from: the probe resolves through ITS OWN DNS server, which need not be the
+ * one the operator checked with, so the comparison worth making is from where
+ * the probe resolves. That is inside its container or pod, not the machine
+ * under it (#3916): a pod's resolver is the cluster DNS, not the node's
+ * /etc/resolv.conf, and a Docker container's can differ from its host's too,
+ * so "from the probe's host" sent the operator to a lookup that could name
+ * the device while the probe's could not. The probe image ships nslookup
+ * (dnsutils, Probe/Dockerfile.tpl), so the advice can be followed as written.
+ */
+export const NO_RECORD_TIP = "The probe uses its own DNS server, which may not be the one you checked with. Run nslookup on this address inside the probe's container or pod to compare.";
+export const TRANSIENT_FAILURE_TIP = "Rescan to try again. If it keeps happening, check the DNS servers the probe uses, inside its container or pod.";
+/*
+ * Offered when the scan left one or both of the ways of asking the DEVICE for
+ * its name switched off. Those are exactly the names the issue asked to see
+ * first — the one configured on the device — so saying where they come from
+ * is the useful answer to "but it has a hostname". Only the sources that were
+ * actually off, and would run if turned on, are named — for NetBIOS that
+ * means the probe is not a global one AND the address is one its lookup
+ * would query at all (isNetbiosQueryableIPv4Address).
+ */
+export const ASK_THE_DEVICE_TIP = "Checking SNMP, or NetBIOS lookup for Windows hosts, asks the device for its own name.";
+export const ASK_THE_DEVICE_SNMP_TIP = "Checking SNMP asks the device for its own name.";
+export const ASK_THE_DEVICE_NETBIOS_TIP = "NetBIOS lookup asks Windows hosts for their own name.";
+/*
+ * The codes that get TRANSIENT_FAILURE_TIP: the lookup failed rather than
+ * answered, so a rescan may name the host, and the DNS servers the probe's
+ * host uses are where to look when it does not.
+ *
+ * SkippedNoResolver is one of them although its address was never looked up
+ * (#3916). The probe stopped asking only because every lookup before it had
+ * failed in these same ways, so the advice is the same. Without it, the hosts
+ * a pass gave up on were the only failed lookups with nothing to check.
+ */
+const TRANSIENT_REVERSE_DNS_STATUSES = new Set([
+    DiscoveredHostReverseDnsStatus.Timeout,
+    DiscoveredHostReverseDnsStatus.ServerFailure,
+    DiscoveredHostReverseDnsStatus.Refused,
+    DiscoveredHostReverseDnsStatus.Unreachable,
+    DiscoveredHostReverseDnsStatus.Failed,
+    DiscoveredHostReverseDnsStatus.SkippedNoResolver,
+]);
+// A string with something in it besides whitespace.
+function hasText(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+/**
+ * True when the row would be named by something other than its address: a
+ * sysName, a usable PTR name or a usable NetBIOS name. Mirrors
+ * getDiscoveredHostFullName's order and its re-normalisation, so the hint is
+ * shown on exactly the rows whose name line is the address.
+ */
+export function isDiscoveredHostNamed(host) {
+    return (hasText(host.sysName) ||
+        Boolean(normalizeReverseDnsName(host.dnsHostname)) ||
+        Boolean(normalizeNetbiosName(host.netbiosName)));
+}
+function describeSnmp(data) {
+    if (data.scan && !ScanModeUtil.isSnmpEnabled(data.scan)) {
+        return SNMP_NOT_CHECKED_SENTENCE;
+    }
+    if (data.host.snmpReachable === false) {
+        return SNMP_NO_ANSWER_SENTENCE;
+    }
+    /*
+     * Answered SNMP — or a row from before `snmpReachable` existed, when every
+     * host listed had answered it. Either way the host is unnamed, so whatever
+     * it said had no sysName in it.
+     */
+    if (data.scan || data.host.snmpReachable === true) {
+        return SNMP_NO_SYSNAME_SENTENCE;
+    }
+    return undefined;
+}
+function describeNetbios(data) {
+    if (data.status) {
+        return NETBIOS_SENTENCES[data.status];
+    }
+    // Without the scan there is no telling whether NetBIOS was ever on.
+    if (!data.scan) {
+        return undefined;
+    }
+    if (data.scan.isNetbiosLookupEnabled !== true) {
+        return NETBIOS_OFF_SENTENCE;
+    }
+    /*
+     * On, but no code: a row from a probe older than the codes. If the scan's
+     * probe is a global one, the lookup was skipped whatever that probe's
+     * version — the global-probe refusal predates the codes.
+     */
+    if (data.isGlobalProbe) {
+        return NETBIOS_SENTENCES[DiscoveredHostNetbiosStatus.SkippedGlobalProbe];
+    }
+    /*
+     * Likewise for an address outside the private and CGNAT ranges (#3916):
+     * the probe's refusal of those shipped in the same change as the
+     * isNetbiosLookupEnabled column, so no probe that honoured the setting
+     * ever asked one.
+     */
+    if (!data.isQueryableAddress) {
+        return NETBIOS_SENTENCES[DiscoveredHostNetbiosStatus.SkippedIneligibleAddress];
+    }
+    return NETBIOS_NOT_RECORDED_SENTENCE;
+}
+/**
+ * Why this discovered host has no name, or undefined when it has one (or has
+ * no address, which its row already explains).
+ *
+ * `isGlobalProbe` is whether the scan's probe is a global one, when the
+ * caller knows. It matters only for rows that carry no NetBIOS code, and for
+ * whether a scan with NetBIOS off is advised to turn it on.
+ */
+export function explainUnnamedDiscoveredHost(data) {
+    var _a, _b;
+    const host = data.host;
+    if (!host || typeof host !== "object") {
+        return undefined;
+    }
+    /*
+     * A row with no address cannot be imported, and says so on its checkbox.
+     * Nullish is checked before stringifying: String(null) is "null", which
+     * would read as an address.
+     */
+    if (host.ipAddress === undefined ||
+        host.ipAddress === null ||
+        !hasText(String(host.ipAddress))) {
+        return undefined;
+    }
+    if (isDiscoveredHostNamed(host)) {
+        return undefined;
+    }
+    const dnsHostnameStatus = readDiscoveredHostReverseDnsStatus(host.dnsHostnameStatus);
+    const netbiosNameStatus = readDiscoveredHostNetbiosStatus(host.netbiosNameStatus);
+    /*
+     * A per-host code means the naming passes ran for this row, whatever the
+     * scan is doing now — a recurring scan keeps its previous run's results
+     * while the next run starts. Only a row with no code at all is explained by
+     * the scan's state.
+     */
+    if (!dnsHostnameStatus && !netbiosNameStatus) {
+        if (((_a = data.scan) === null || _a === void 0 ? void 0 : _a.status) === DiscoveryScanStatus.InProgress) {
+            return {
+                label: NOT_YET_NAMED_HOST_LABEL,
+                text: IN_PROGRESS_EXPLANATION,
+            };
+        }
+        if (((_b = data.scan) === null || _b === void 0 ? void 0 : _b.status) === DiscoveryScanStatus.Failed) {
+            return { label: UNNAMED_HOST_LABEL, text: FAILED_SCAN_EXPLANATION };
+        }
+    }
+    /*
+     * Whether the probe's NetBIOS lookup would send this address a query at
+     * all. It refuses everything but private and CGNAT IPv4, whoever asks.
+     */
+    const isNetbiosQueryableAddress = isNetbiosQueryableIPv4Address(host.ipAddress);
+    const netbiosSentence = describeNetbios({
+        status: netbiosNameStatus,
+        scan: data.scan,
+        isGlobalProbe: data.isGlobalProbe === true,
+        isQueryableAddress: isNetbiosQueryableAddress,
+    });
+    const sentences = [];
+    // The naming order, so the sentences read in the order the sources win.
+    const snmpSentence = describeSnmp({
+        host: host,
+        scan: data.scan,
+    });
+    if (snmpSentence) {
+        sentences.push(snmpSentence);
+    }
+    sentences.push(dnsHostnameStatus
+        ? REVERSE_DNS_SENTENCES[dnsHostnameStatus]
+        : REVERSE_DNS_NOT_RECORDED_SENTENCE);
+    if (netbiosSentence) {
+        sentences.push(netbiosSentence);
+    }
+    if (dnsHostnameStatus === DiscoveredHostReverseDnsStatus.NoRecord) {
+        sentences.push(NO_RECORD_TIP);
+    }
+    else if (dnsHostnameStatus &&
+        TRANSIENT_REVERSE_DNS_STATUSES.has(dnsHostnameStatus)) {
+        sentences.push(TRANSIENT_FAILURE_TIP);
+    }
+    const isSnmpOff = snmpSentence === SNMP_NOT_CHECKED_SENTENCE;
+    /*
+     * NetBIOS is suggested only where turning it on could work. A global probe
+     * never sends NetBIOS queries whatever the scan asks for, so on one this
+     * advice would send the operator to a setting whose only effect is the
+     * "not asked" line on the next scan (#3916). The bundled self-hosted probes
+     * are global, so that is not a rare case. The same goes for an address the
+     * lookup refuses — public space, IPv6, anything not a strict dotted quad —
+     * where the next scan would only say "Only private addresses are asked".
+     */
+    const shouldSuggestNetbios = netbiosSentence === NETBIOS_OFF_SENTENCE &&
+        data.isGlobalProbe !== true &&
+        isNetbiosQueryableAddress;
+    if (isSnmpOff && shouldSuggestNetbios) {
+        sentences.push(ASK_THE_DEVICE_TIP);
+    }
+    else if (isSnmpOff) {
+        sentences.push(ASK_THE_DEVICE_SNMP_TIP);
+    }
+    else if (shouldSuggestNetbios) {
+        sentences.push(ASK_THE_DEVICE_NETBIOS_TIP);
+    }
+    return { label: UNNAMED_HOST_LABEL, text: sentences.join(" ") };
+}
+export default explainUnnamedDiscoveredHost;
+//# sourceMappingURL=DiscoveredHostNamingDiagnosis.js.map

package/build/dist/Utils/NetworkDiscovery/DiscoveredHostNamingDiagnosis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscoveredHostNamingDiagnosis.js","sourceRoot":"","sources":["../../../../Utils/NetworkDiscovery/DiscoveredHostNamingDiagnosis.ts"],"names":[],"mappings":"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"}

package/build/dist/Utils/NetworkDiscovery/DiscoveredHostUtil.js

@@ -1,3 +1,4 @@
+import { readDiscoveredHostNetbiosStatus, readDiscoveredHostReverseDnsStatus, } from "../../Types/NetworkDevice/DiscoveredHostNamingStatus";
 import { normalizeNetbiosName } from "./NetbiosNameUtil";
 import { normalizeReverseDnsName } from "./ReverseDnsNameUtil";
 /*
@@ -121,6 +122,28 @@ export function normalizeDiscoveredHosts(hosts) {
         else {
             delete normalized.netbiosName;
         }
+        /*
+         * The two "why is this host unnamed" codes (OneUptime issue #3916). Not
+         * chosen by the scanned network, but still read out of the same verbatim
+         * jsonb, and the dialog turns them into tooltip copy — so only the exact
+         * codes survive, and anything else is DELETED for the reason the names
+         * above are. A code this build does not know (a newer probe's) goes the
+         * same way and the row falls back to the explanation older rows get.
+         */
+        const dnsHostnameStatus = readDiscoveredHostReverseDnsStatus(host.dnsHostnameStatus);
+        if (dnsHostnameStatus) {
+            normalized.dnsHostnameStatus = dnsHostnameStatus;
+        }
+        else {
+            delete normalized.dnsHostnameStatus;
+        }
+        const netbiosNameStatus = readDiscoveredHostNetbiosStatus(host.netbiosNameStatus);
+        if (netbiosNameStatus) {
+            normalized.netbiosNameStatus = netbiosNameStatus;
+        }
+        else {
+            delete normalized.netbiosNameStatus;
+        }
         cleaned.push(normalized);
     }
     // An address the scan reports as registered is registered on every row.