@dxos/observability 0.3.11-main.2f1331c → 0.3.11-main.463e5cd

package/dist/lib/node/chunk-CBMRJXSL.cjs

@@ -0,0 +1,861 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var chunk_CBMRJXSL_exports = {};
+__export(chunk_CBMRJXSL_exports, {
+  OBSERVABILITY_DISABLED_KEY: () => OBSERVABILITY_DISABLED_KEY,
+  OBSERVABILITY_GROUP_KEY: () => OBSERVABILITY_GROUP_KEY,
+  Observability: () => Observability,
+  getObservabilityGroup: () => getObservabilityGroup,
+  getObservabilityState: () => getObservabilityState,
+  getTelemetryIdentifier: () => getTelemetryIdentifier,
+  initializeAppObservability: () => initializeAppObservability,
+  initializeNodeObservability: () => initializeNodeObservability,
+  isObservabilityDisabled: () => isObservabilityDisabled,
+  mapSpaces: () => mapSpaces,
+  setupTelemetryListeners: () => setupTelemetryListeners,
+  showObservabilityBanner: () => showObservabilityBanner,
+  storeObservabilityDisabled: () => storeObservabilityDisabled,
+  storeObservabilityGroup: () => storeObservabilityGroup
+});
+module.exports = __toCommonJS(chunk_CBMRJXSL_exports);
+var import_chunk_ZJRKFREX = require("./chunk-ZJRKFREX.cjs");
+var import_chunk_BHF4PKAP = require("./chunk-BHF4PKAP.cjs");
+var import_chunk_FSAOBKO2 = require("./chunk-FSAOBKO2.cjs");
+var import_async = require("@dxos/async");
+var import_context = require("@dxos/context");
+var import_invariant = require("@dxos/invariant");
+var import_log = require("@dxos/log");
+var import_network_manager = require("@dxos/network-manager");
+var import_services = require("@dxos/protocols/proto/dxos/client/services");
+var import_util = require("@dxos/util");
+var localForage = __toESM(require("localforage"));
+var import_log2 = require("@dxos/log");
+var import_js_yaml = __toESM(require("js-yaml"));
+var import_node_fs = require("node:fs");
+var import_promises = require("node:fs/promises");
+var import_node_path = require("node:path");
+var import_uuid = require("uuid");
+var import_log3 = require("@dxos/log");
+var cli_observability_secrets_default = {
+  SENTRY_DESTINATION: "https://2647916221e643869965e78469479aa4@o4504012000067584.ingest.sentry.io/4504012027265029",
+  TELEMETRY_API_KEY: "B00QG6PtJJrJ0VVFe0H5a6bcUUShKyZM",
+  IPDATA_API_KEY: "73dfdecdf979c18f07d50cf841bbdd9e589f237256326ac8cca23786",
+  DATADOG_API_KEY: null,
+  DATADOG_APP_KEY: null
+};
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/sdk/observability/src/helpers/browser-observability.ts";
+var OBSERVABILITY_DISABLED_KEY = "observability-disabled";
+var OBSERVABILITY_GROUP_KEY = "observability-group";
+var isObservabilityDisabled = async (namespace) => {
+  try {
+    return await localForage.getItem(`${namespace}:${OBSERVABILITY_DISABLED_KEY}`) === "true";
+  } catch (err) {
+    import_log2.log.catch("Failed to check if observability is disabled, assuming it is", err, {
+      F: __dxlog_file,
+      L: 24,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+    return true;
+  }
+};
+var storeObservabilityDisabled = async (namespace, value) => {
+  try {
+    await localForage.setItem(`${namespace}:${OBSERVABILITY_DISABLED_KEY}`, String(value));
+  } catch (err) {
+    import_log2.log.catch("Failed to store observability disabled", err, {
+      F: __dxlog_file,
+      L: 33,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+  }
+};
+var getObservabilityGroup = async (namespace) => {
+  try {
+    return await localForage.getItem(`${namespace}:${OBSERVABILITY_GROUP_KEY}`) ?? void 0;
+  } catch (err) {
+    import_log2.log.catch("Failed to get observability group", err, {
+      F: __dxlog_file,
+      L: 41,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+  }
+};
+var storeObservabilityGroup = async (namespace, value) => {
+  try {
+    await localForage.setItem(`${namespace}:${OBSERVABILITY_GROUP_KEY}`, value);
+  } catch (err) {
+    import_log2.log.catch("Failed to store observability group", err, {
+      F: __dxlog_file,
+      L: 49,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+  }
+};
+var initializeAppObservability = async ({ namespace, config, mode = "basic", tracingEnable = true, replayEnable = true }) => {
+  (0, import_log2.log)("initializeAppObservability", {
+    config
+  }, {
+    F: __dxlog_file,
+    L: 72,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  const group = await getObservabilityGroup(namespace) ?? void 0;
+  const release = `${namespace}@${config.get("runtime.app.build.version")}`;
+  const environment = config.get("runtime.app.env.DX_ENVIRONMENT");
+  const observabilityDisabled = await isObservabilityDisabled(namespace);
+  const { Observability: Observability2 } = await import("./observability-JMKBRR4L.cjs");
+  const observability = new Observability2({
+    namespace,
+    group,
+    mode,
+    config,
+    errorLog: {
+      sentryInitOptions: {
+        environment,
+        release,
+        tracing: tracingEnable,
+        replay: replayEnable,
+        // TODO(wittjosiah): Configure these.
+        sampleRate: 1,
+        replaySampleRate: 0.1,
+        replaySampleRateOnError: 1
+      }
+    }
+  });
+  if (observabilityDisabled) {
+    observability.setMode("disabled");
+    import_log2.log.info("observability disabled", void 0, {
+      F: __dxlog_file,
+      L: 113,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+    return observability;
+  }
+  try {
+    const getIPData = async (config2) => {
+      const IP_DATA_CACHE_TIMEOUT = 6 * 60 * 60 * 1e3;
+      const cachedData = await localForage.getItem("dxos:observability:ipdata");
+      if (cachedData && cachedData.timestamp > Date.now() - IP_DATA_CACHE_TIMEOUT) {
+        return cachedData.data;
+      }
+      const IPDATA_API_KEY = config2.get("runtime.app.env.DX_IPDATA_API_KEY");
+      if (IPDATA_API_KEY) {
+        return fetch(`https://api.ipdata.co?api-key=${IPDATA_API_KEY}`).then((res) => res.json()).then((data) => {
+          localForage.setItem("dxos:observability:ipdata", {
+            data,
+            timestamp: Date.now()
+          }).catch((err) => observability.captureException(err));
+          return data;
+        }).catch((err) => observability.captureException(err));
+      }
+    };
+    observability.initialize();
+    const ipData = await getIPData(config);
+    ipData && observability.addIPDataTelemetryTags(ipData);
+    if (typeof navigator !== "undefined" && navigator.storage?.estimate) {
+      setInterval(async () => {
+        try {
+          const storageEstimate = await navigator.storage.estimate();
+          storageEstimate.usage && observability.setTag("storageUsage", storageEstimate.usage.toString(), "telemetry");
+          storageEstimate.quota && observability.setTag("storageQuota", storageEstimate.quota.toString(), "telemetry");
+        } catch (error) {
+          import_log2.log.warn("Failed to run estimate()", error, {
+            F: __dxlog_file,
+            L: 168,
+            S: void 0,
+            C: (f, a) => f(...a)
+          });
+        }
+      }, 1e4);
+    }
+  } catch (err) {
+    import_log2.log.error("Failed to initialize app observability", err, {
+      F: __dxlog_file,
+      L: 173,
+      S: void 0,
+      C: (f, a) => f(...a)
+    });
+  }
+  return observability;
+};
+var getTelemetryIdentifier = (client) => {
+  if (!client?.initialized) {
+    return void 0;
+  }
+  const identity = client.halo.identity.get();
+  if (identity) {
+    return identity.identityKey.truncate();
+  }
+  return void 0;
+};
+var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/sdk/observability/src/helpers/node-observability.ts";
+var showObservabilityBanner = async (configDir, bannercb) => {
+  const path = (0, import_node_path.join)(configDir, ".observability-banner-printed");
+  if ((0, import_node_fs.existsSync)(path)) {
+    return;
+  }
+  bannercb(
+    // eslint-disable-next-line no-multi-str
+    "Basic observability data will be sent to the DXOS team in order to improve the product. This includes     performance metrics, error logs, and usage data. No personally identifiable information, other than your     public key, is included with this data and no private data ever leaves your devices. To disable sending     observability data, set the environment variable DX_DISABLE_TELEMETRY=true."
+  );
+  await (0, import_promises.writeFile)(path, "", "utf-8");
+};
+var getObservabilityState = async (configDir) => {
+  if ((0, import_node_fs.existsSync)(configDir)) {
+    if (!(0, import_node_fs.statSync)(configDir).isDirectory()) {
+      throw new Error(`Config directory ${configDir} exists but is not a directory`);
+    }
+  } else {
+    await (0, import_promises.mkdir)(configDir, {
+      recursive: true
+    });
+  }
+  const idPath = (0, import_node_path.join)(configDir, "observability.yml");
+  if ((0, import_node_fs.existsSync)(idPath)) {
+    const context = await (0, import_promises.readFile)(idPath, "utf-8");
+    return validate(context) ?? initializeState(idPath);
+  }
+  return initializeState(idPath);
+};
+var initializeState = async (idPath) => {
+  const observabilityState = {
+    installationId: (0, import_uuid.v4)(),
+    group: process.env.DX_TELEMETRY_GROUP ?? void 0,
+    mode: process.env.DX_DISABLE_TELEMETRY ? "disabled" : process.env.DX_TELEMETRY_MODE ?? "basic"
+  };
+  await (0, import_promises.writeFile)(idPath, "# This file is automatically generated by the @dxos/cli.\n" + import_js_yaml.default.dump(observabilityState), "utf-8");
+  return observabilityState;
+};
+var validate = (contextString) => {
+  const context = import_js_yaml.default.load(contextString);
+  if (Boolean(context.installationId) && (0, import_uuid.validate)(context.installationId)) {
+    return {
+      ...context,
+      mode: process.env.DX_DISABLE_TELEMETRY ? "disabled" : context.mode ?? "basic"
+    };
+  }
+};
+var initializeNodeObservability = async ({ namespace, config, installationId, group, mode = "basic", tracingEnable = true, replayEnable = true }) => {
+  (0, import_log3.log)("initializeCliObservability", {
+    config
+  }, {
+    F: __dxlog_file2,
+    L: 120,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  const release = `${namespace}@${config.get("runtime.app.build.version")}`;
+  const environment = config.get("runtime.app.env.DX_ENVIRONMENT");
+  const observability = new Observability({
+    namespace,
+    group,
+    mode,
+    errorLog: {
+      sentryInitOptions: {
+        environment,
+        release,
+        // TODO(wittjosiah): Configure this.
+        sampleRate: 1
+      },
+      logProcessor: true
+    }
+  });
+  observability.setTag("installationId", installationId);
+  const IPDATA_API_KEY = config.get("runtime.app.env.DX_IPDATA_API_KEY");
+  try {
+    const res = await fetch(`https://api.ipdata.co/?api-key=${IPDATA_API_KEY}`);
+    const ipData = await res.json();
+    ipData && observability.addIPDataTelemetryTags(ipData);
+  } catch (err) {
+    observability?.captureException(err);
+  }
+  return observability;
+};
+var mapSpaces = (spaces, options = {
+  verbose: false,
+  truncateKeys: false
+}) => {
+  return spaces.map((space) => {
+    const { open, ready } = space.internal.data.metrics ?? {};
+    const startup = open && ready && ready.getTime() - open.getTime();
+    const pipeline = space.internal.data.pipeline;
+    const startDataMutations = pipeline?.currentEpoch?.subject.assertion.timeframe.totalMessages() ?? 0;
+    const epoch = pipeline?.currentEpoch?.subject.assertion.number;
+    const currentDataMutations = pipeline?.currentDataTimeframe?.totalMessages() ?? 0;
+    const totalDataMutations = pipeline?.targetDataTimeframe?.totalMessages() ?? 0;
+    return {
+      // TODO(nf): truncate keys for DD?
+      key: space.key.truncate(),
+      open: space.isOpen,
+      members: space.members.get().length,
+      objects: space.db.query().objects.length,
+      startup,
+      epoch,
+      // appliedEpoch,
+      startDataMutations,
+      currentDataMutations,
+      totalDataMutations,
+      // TODO(burdon): Negative?
+      progress: (Math.min(Math.abs((currentDataMutations - startDataMutations) / (totalDataMutations - startDataMutations)), 1) * 100).toFixed(0)
+    };
+  });
+};
+var lastFocusEvent = /* @__PURE__ */ new Date();
+var totalTime = 0;
+var setupTelemetryListeners = (namespace, client, observability) => {
+  const clickCallback = (event) => {
+    if (observability.group === "dxos" && event.target && !event.target.id) {
+      console.warn("Click event on element without id:", event.target);
+    }
+    setTimeout(() => observability.event({
+      identityId: getTelemetryIdentifier(client),
+      name: `${namespace}.window.click`,
+      properties: {
+        href: window.location.href,
+        id: event.target?.id,
+        path: event.path?.filter((el) => Boolean(el.tagName)).map((el) => `${el.tagName.toLowerCase()}${el.id ? `#${el.id}` : ""}`).reverse().join(">")
+      }
+    }));
+  };
+  const focusCallback = () => {
+    const now = /* @__PURE__ */ new Date();
+    setTimeout(() => observability.event({
+      identityId: getTelemetryIdentifier(client),
+      name: `${namespace}.window.focus`,
+      properties: {
+        href: window.location.href,
+        timeAway: now.getTime() - lastFocusEvent.getTime()
+      }
+    }));
+    lastFocusEvent = now;
+  };
+  const blurCallback = () => {
+    const now = /* @__PURE__ */ new Date();
+    const timeSpent = now.getTime() - lastFocusEvent.getTime();
+    setTimeout(() => observability.event({
+      identityId: getTelemetryIdentifier(client),
+      name: `${namespace}.window.blur`,
+      properties: {
+        href: window.location.href,
+        timeSpent
+      }
+    }));
+    lastFocusEvent = now;
+    totalTime = totalTime + timeSpent;
+  };
+  const unloadCallback = () => {
+    setTimeout(() => observability.event({
+      identityId: getTelemetryIdentifier(client),
+      name: `${namespace}.page.unload`,
+      properties: {
+        href: window.location.href,
+        timeSpent: totalTime
+      }
+    }));
+  };
+  const errorCallback = (event) => {
+    setTimeout(() => observability.event({
+      identityId: getTelemetryIdentifier(client),
+      name: `${namespace}.window.error`,
+      properties: {
+        href: window.location.href,
+        message: event.message,
+        filename: event.filename,
+        stack: event.error.stack
+      }
+    }));
+  };
+  window.addEventListener("click", clickCallback, true);
+  window.addEventListener("focus", focusCallback);
+  window.addEventListener("blur", blurCallback);
+  window.addEventListener("beforeunload", unloadCallback);
+  window.addEventListener("error", errorCallback);
+  return () => {
+    window.removeEventListener("click", clickCallback, true);
+    window.removeEventListener("focus", focusCallback);
+    window.removeEventListener("blur", blurCallback);
+    window.removeEventListener("beforeunload", unloadCallback);
+    window.removeEventListener("error", errorCallback);
+  };
+};
+var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/sdk/observability/src/observability.ts";
+var SPACE_METRICS_MIN_INTERVAL = 1e3 * 60;
+var DATADOG_IDLE_INTERVAL = 1e3 * 60 * 1;
+var Observability = class {
+  // TODO(nf): make platform a required extension?
+  constructor({ namespace, config, secrets, group, mode, telemetry, errorLog }) {
+    this._mode = "disabled";
+    this._ctx = new import_context.Context();
+    this._tags = /* @__PURE__ */ new Map();
+    this.addIPDataTelemetryTags = (ipData) => {
+      this.setTag("city", ipData.city, "telemetry");
+      this.setTag("region", ipData.region, "telemetry");
+      this.setTag("country", ipData.country, "telemetry");
+      ipData.latitude && this.setTag("latitude", ipData.latitude.toString(), "telemetry");
+      ipData.longitude && this.setTag("longitude", ipData.longitude.toString(), "telemetry");
+    };
+    this._namespace = namespace;
+    this._config = config;
+    this._mode = mode ?? "disabled";
+    this._group = group;
+    this._secrets = this._loadSecrets(config, secrets);
+    this._telemetryBatchSize = telemetry?.batchSize ?? 30;
+    this._errorReportingOptions = errorLog?.sentryInitOptions;
+    this._errorLogProcessor = errorLog?.logProcessor ?? false;
+    if (this._group) {
+      this.setTag("group", this._group);
+    }
+    this.setTag("namespace", this._namespace);
+    if (this._mode === "full") {
+    }
+  }
+  _loadSecrets(config, secrets) {
+    if ((0, import_util.isNode)()) {
+      return cli_observability_secrets_default;
+    } else {
+      (0, import_invariant.invariant)(config, "runtime config is required", {
+        F: __dxlog_file3,
+        L: 115,
+        S: this,
+        A: [
+          "config",
+          "'runtime config is required'"
+        ]
+      });
+      (0, import_log.log)("config", {
+        rtc: this._secrets,
+        config
+      }, {
+        F: __dxlog_file3,
+        L: 116,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      return {
+        DX_ENVIRONMENT: config.get("runtime.app.env.DX_ENVIRONMENT"),
+        DX_RELEASE: config.get("runtime.app.env.DX_RELEASE"),
+        SENTRY_DESTINATION: config.get("runtime.app.env.DX_SENTRY_DESTINATION"),
+        TELEMETRY_API_KEY: config.get("runtime.app.env.DX_TELEMETRY_API_KEY"),
+        IPDATA_API_KEY: config.get("runtime.app.env.DX_IPDATA_API_KEY"),
+        DATADOG_API_KEY: config.get("runtime.app.env.DX_DATADOG_API_KEY"),
+        DATADOG_APP_KEY: config.get("runtime.app.env.DX_DATADOG_APP_KEY"),
+        ...secrets
+      };
+    }
+  }
+  initialize() {
+    this._initMetrics();
+    this._initTelemetry();
+    this._initErrorLogs();
+  }
+  async close() {
+    await this._ctx.dispose();
+  }
+  setMode(mode) {
+    this._mode = mode;
+  }
+  get mode() {
+    return this._mode;
+  }
+  get group() {
+    return this._group;
+  }
+  get enabled() {
+    return this._mode !== "disabled";
+  }
+  //
+  // Tags
+  //
+  setTag(key, value, scope) {
+    if (this.enabled && (scope === void 0 || scope === "all" || scope === "errors")) {
+      (0, import_chunk_FSAOBKO2.setTag)(key, value);
+    }
+    if (!scope) {
+      scope = "all";
+    }
+    this._tags.set(key, {
+      value,
+      scope
+    });
+  }
+  // TODO(wittjosiah): Improve privacy of telemetry identifiers. See `getTelemetryIdentifier`.
+  async setIdentityTags(client) {
+    client.services.services.IdentityService.queryIdentity().subscribe((idqr) => {
+      if (!idqr?.identity?.identityKey) {
+        (0, import_log.log)("empty response from identity service", {
+          idqr
+        }, {
+          F: __dxlog_file3,
+          L: 184,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        return;
+      }
+      this.setTag("identityKey", idqr.identity.identityKey.truncate());
+    });
+    client.services.services.DevicesService.queryDevices().subscribe((dqr) => {
+      if (!dqr || !dqr.devices || dqr.devices.length === 0) {
+        (0, import_log.log)("empty response from device service", {
+          device: dqr
+        }, {
+          F: __dxlog_file3,
+          L: 193,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        return;
+      }
+      (0, import_invariant.invariant)(dqr, "empty response from device service", {
+        F: __dxlog_file3,
+        L: 196,
+        S: this,
+        A: [
+          "dqr",
+          "'empty response from device service'"
+        ]
+      });
+      const thisDevice = dqr.devices.find((device) => device.kind === import_services.DeviceKind.CURRENT);
+      if (!thisDevice) {
+        (0, import_log.log)("no current device", {
+          device: dqr
+        }, {
+          F: __dxlog_file3,
+          L: 200,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        return;
+      }
+      this.setTag("deviceKey", thisDevice.deviceKey.truncate());
+      if (thisDevice.profile?.label) {
+        this.setTag("deviceProfile", thisDevice.profile.label);
+      }
+    });
+  }
+  //
+  // Metrics
+  //
+  _initMetrics() {
+    if (this.enabled && this._secrets.DATADOG_API_KEY) {
+      this._metrics = new import_chunk_ZJRKFREX.DatadogMetrics({
+        apiKey: this._secrets.DATADOG_API_KEY,
+        getTags: () => Object.fromEntries(Array.from(this._tags).filter(([key, value]) => {
+          return value.scope === "all" || value.scope === "metrics";
+        }).map(([key, value]) => [
+          key,
+          value.value
+        ])),
+        // TODO(nf): move/refactor from telementryContext, needed to read CORS proxy
+        config: this._config
+      });
+    } else {
+      (0, import_log.log)("datadog disabled", void 0, {
+        F: __dxlog_file3,
+        L: 230,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+    }
+  }
+  /**
+  * Gauge metric.
+  *
+  * The default implementation uses Datadog.
+  */
+  gauge(name, value, extraTags) {
+    this._metrics?.gauge(name, value, extraTags);
+  }
+  // TODO(nf): Refactor into ObservabilityExtensions.
+  startNetworkMetrics(client) {
+    const updateSignalMetrics = new import_async.Event();
+    updateSignalMetrics.on(this._ctx, async (networkStatus) => {
+      (0, import_log.log)("send signal metrics", void 0, {
+        F: __dxlog_file3,
+        L: 250,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      networkStatus.signaling.forEach(({ server, state }) => {
+        this.gauge("dxos.client.network.signal.connectionState", state, {
+          server
+        });
+      });
+      let swarmCount = 0;
+      const connectionStates = /* @__PURE__ */ new Map();
+      for (const state in import_network_manager.ConnectionState) {
+        connectionStates.set(state, 0);
+      }
+      let totalReadBufferSize = 0;
+      let totalWriteBufferSize = 0;
+      let totalChannelBufferSize = 0;
+      networkStatus.connectionInfo?.forEach((connectionInfo) => {
+        swarmCount++;
+        for (const conn of connectionInfo.connections ?? []) {
+          connectionStates.set(conn.state, (connectionStates.get(conn.state) ?? 0) + 1);
+          totalReadBufferSize += conn.readBufferSize ?? 0;
+          totalWriteBufferSize += conn.writeBufferSize ?? 0;
+          for (const stream of conn.streams ?? []) {
+            totalChannelBufferSize += stream.writeBufferSize ?? 0;
+          }
+        }
+        this.gauge("dxos.client.network.swarm.count", swarmCount);
+        for (const state in import_network_manager.ConnectionState) {
+          this.gauge("dxos.client.network.connection.count", connectionStates.get(state) ?? 0, {
+            state
+          });
+        }
+        this.gauge("dxox.client.network.totalReadBufferSize", totalReadBufferSize);
+        this.gauge("dxos.client.network.totalWriteBufferSize", totalWriteBufferSize);
+        this.gauge("dxos.client.network.totalChannelBufferSize", totalChannelBufferSize);
+      });
+    });
+    client.services.services.NetworkService?.queryStatus().subscribe((networkStatus) => {
+      updateSignalMetrics.emit(networkStatus);
+    });
+  }
+  startSpacesMetrics(client, namespace) {
+    const spaces = client.spaces.get();
+    const subscriptions = /* @__PURE__ */ new Map();
+    this._ctx.onDispose(() => subscriptions.forEach((subscription) => subscription.unsubscribe()));
+    const updateSpaceMetrics = new import_async.Event().debounce(SPACE_METRICS_MIN_INTERVAL);
+    updateSpaceMetrics.on(this._ctx, async () => {
+      (0, import_log.log)("send space update", void 0, {
+        F: __dxlog_file3,
+        L: 302,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      for (const data of mapSpaces(spaces, {
+        truncateKeys: true
+      })) {
+        this.gauge("dxos.client.space.members", data.members, {
+          key: data.key
+        });
+        this.gauge("dxos.client.space.objects", data.objects, {
+          key: data.key
+        });
+        this.gauge("dxos.client.space.epoch", data.epoch, {
+          key: data.key
+        });
+        this.gauge("dxos.client.space.currentDataMutations", data.currentDataMutations, {
+          key: data.key
+        });
+        this.event({
+          identityId: getTelemetryIdentifier(client),
+          name: `${namespace}.space.update`,
+          properties: data
+        });
+      }
+    });
+    const subscribeToSpaceUpdate = (space) => space.pipeline.subscribe({
+      next: () => {
+        updateSpaceMetrics.emit();
+      }
+    });
+    spaces.forEach((space) => {
+      subscriptions.set(space.key.toHex(), subscribeToSpaceUpdate(space));
+    });
+    client.spaces.subscribe({
+      next: async (spaces2) => {
+        spaces2.filter((space) => !subscriptions.has(space.key.toHex())).forEach((space) => {
+          subscriptions.set(space.key.toHex(), subscribeToSpaceUpdate(space));
+        });
+      }
+    });
+    (0, import_async.scheduleTaskInterval)(this._ctx, async () => updateSpaceMetrics.emit(), DATADOG_IDLE_INTERVAL);
+  }
+  async startRuntimeMetrics(client, frequency = DATADOG_IDLE_INTERVAL) {
+    const platform = await client.services.services.SystemService?.getPlatform();
+    (0, import_invariant.invariant)(platform, "platform is required", {
+      F: __dxlog_file3,
+      L: 345,
+      S: this,
+      A: [
+        "platform",
+        "'platform is required'"
+      ]
+    });
+    this.setTag("platform_type", import_services.Platform.PLATFORM_TYPE[platform.type].toLowerCase());
+    if (this._mode === "full") {
+      if (platform.platform) {
+        this.setTag("platform", platform.platform);
+      }
+      if (platform.arch) {
+        this.setTag("arch", platform.arch);
+      }
+      if (platform.runtime) {
+        this.setTag("runtime", platform.runtime);
+      }
+    }
+    (0, import_async.scheduleTaskInterval)(this._ctx, async () => {
+      (0, import_log.log)("platform", void 0, {
+        F: __dxlog_file3,
+        L: 363,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      client.services.services.SystemService?.getPlatform().then((platform2) => {
+        (0, import_log.log)("platform", {
+          platform: platform2
+        }, {
+          F: __dxlog_file3,
+          L: 366,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        if (platform2.memory) {
+          this.gauge("dxos.client.runtime.rss", platform2.memory.rss);
+          this.gauge("dxos.client.runtime.heapTotal", platform2.memory.heapTotal);
+          this.gauge("dxos.client.runtime.heapUsed", platform2.memory.heapUsed);
+        }
+      }).catch((error) => (0, import_log.log)("platform error", {
+        error
+      }, {
+        F: __dxlog_file3,
+        L: 373,
+        S: this,
+        C: (f, a) => f(...a)
+      }));
+    }, frequency);
+  }
+  //
+  // Telemetry
+  //
+  _initTelemetry() {
+    if (this._secrets.TELEMETRY_API_KEY && this._mode !== "disabled") {
+      this._telemetry = new import_chunk_BHF4PKAP.SegmentTelemetry({
+        apiKey: this._secrets.TELEMETRY_API_KEY,
+        batchSize: this._telemetryBatchSize,
+        getTags: () => Object.fromEntries(Array.from(this._tags).filter(([key, value]) => {
+          return value.scope === "all" || value.scope === "telemetry";
+        }).map(([key, value]) => [
+          key,
+          value.value
+        ]))
+      });
+    } else {
+      (0, import_log.log)("segment disabled", void 0, {
+        F: __dxlog_file3,
+        L: 398,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+    }
+  }
+  /**
+  * A telemetry event.
+  *
+  * The default implementation uses Segment.
+  */
+  event(options) {
+    this._telemetry?.event(options);
+  }
+  /**
+  * A telemetry page view.
+  *
+  * The default implementation uses Segment.
+  */
+  page(options) {
+    this._telemetry?.page(options);
+  }
+  //
+  // Error Logs
+  //
+  _initErrorLogs() {
+    if (this._secrets.SENTRY_DESTINATION && this._mode !== "disabled") {
+      import_log.log.info("Initializing Sentry", {
+        dest: this._secrets.SENTRY_DESTINATION,
+        options: this._errorReportingOptions
+      }, {
+        F: __dxlog_file3,
+        L: 427,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      (0, import_chunk_FSAOBKO2.init)({
+        ...this._errorReportingOptions,
+        destination: this._secrets.SENTRY_DESTINATION,
+        scrubFilenames: this._mode !== "full"
+      });
+      if (this._errorReportingOptions?.tracing) {
+        (0, import_chunk_FSAOBKO2.configureTracing)();
+      }
+      if (this._errorLogProcessor) {
+        (0, import_chunk_FSAOBKO2.enableSentryLogProcessor)();
+      }
+      this._tags.forEach((v, k) => {
+        if (v.scope === "all" || v.scope === "errors") {
+          (0, import_chunk_FSAOBKO2.setTag)(k, v.value);
+        }
+      });
+    } else {
+      (0, import_log.log)("sentry disabled", void 0, {
+        F: __dxlog_file3,
+        L: 450,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+    }
+  }
+  /**
+  * Manually capture an exception.
+  *
+  * The default implementation uses Sentry.
+  */
+  captureException(err) {
+    if (this.enabled) {
+      (0, import_chunk_FSAOBKO2.captureException)(err);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OBSERVABILITY_DISABLED_KEY,
+  OBSERVABILITY_GROUP_KEY,
+  Observability,
+  getObservabilityGroup,
+  getObservabilityState,
+  getTelemetryIdentifier,
+  initializeAppObservability,
+  initializeNodeObservability,
+  isObservabilityDisabled,
+  mapSpaces,
+  setupTelemetryListeners,
+  showObservabilityBanner,
+  storeObservabilityDisabled,
+  storeObservabilityGroup
+});
+//# sourceMappingURL=chunk-CBMRJXSL.cjs.map