feat: Identify client type in metrics

Author: oliversalzburg

packages/kitten-analysts/examples/2108acbb-2feb-427b-92ca-add74a2a8c10.json

@@ -64,6 +64,8 @@ export interface KittenAnalystsMessage<
    */
   data?: TData;
 
+  client_type: "backend" | "browser" | "headless";
+
   /**
    * The HTTP URL that identifies the context of the client that sent the message.
    */
@@ -181,7 +183,12 @@ export class KittenAnalysts {
 
     this.ws.onopen = () => {
       cinfo("WS connection established.");
-      this.postMessage({ type: "connected", location: this.location, guid: game.telemetry.guid });
+      this.postMessage({
+        type: "connected",
+        client_type: this.location.includes("headless.html") ? "headless" : "browser",
+        location: this.location,
+        guid: game.telemetry.guid,
+      });
     };
 
     this.ws.onmessage = event => {
@@ -246,11 +253,12 @@ export class KittenAnalysts {
         );
 
         return {
-          type: message.type,
-          location: this.location,
+          client_type: this.location.includes("headless.html") ? "headless" : "browser",
+          data: [...bonfire, ...space, ...religion],
           guid: game.telemetry.guid,
+          location: this.location,
           responseId: message.responseId,
-          data: [...bonfire, ...space, ...religion],
+          type: message.type,
         };
 
         break;
@@ -265,11 +273,12 @@ export class KittenAnalysts {
         }));
 
         return {
-          type: message.type,
-          location: this.location,
+          client_type: this.location.includes("headless.html") ? "headless" : "browser",
+          data,
           guid: game.telemetry.guid,
+          location: this.location,
           responseId: message.responseId,
-          data,
+          type: message.type,
         };
 
         break;
@@ -285,11 +294,12 @@ export class KittenAnalysts {
         );
 
         return {
-          type: message.type,
-          location: this.location,
+          client_type: this.location.includes("headless.html") ? "headless" : "browser",
+          data,
           guid: game.telemetry.guid,
+          location: this.location,
           responseId: message.responseId,
-          data,
+          type: message.type,
         };
 
         break;
@@ -308,20 +318,22 @@ export class KittenAnalysts {
   reportFrameListener = (event: Event): void => {
     const location = window.location.toString().replace(/#$/, "");
     this.postMessage({
-      type: "reportFrame",
-      location,
-      guid: game.telemetry.guid,
+      client_type: location.includes("headless.html") ? "headless" : "browser",
       data: (event as CustomEvent<unknown>).detail,
+      guid: game.telemetry.guid,
+      location,
+      type: "reportFrame",
     });
   };
 
   reportSavegameListener = (event: Event): void => {
     const location = window.location.toString().replace(/#$/, "");
     this.postMessage({
-      type: "reportSavegame",
-      location,
-      guid: game.telemetry.guid,
+      client_type: location.includes("headless.html") ? "headless" : "browser",
       data: (event as CustomEvent<unknown>).detail,
+      guid: game.telemetry.guid,
+      location,
+      type: "reportSavegame",
     });
   };
 

packages/kitten-analysts/examples/a708b0ad-5f94-4466-8a2e-1d381117d0e0.json

@@ -48,7 +48,7 @@ const ks_iterate_duration = new Histogram({
   name: "ks_iterate_duration",
   help: "How long each iteration of KS took.",
   buckets: [...linearBuckets(0, 1, 100), ...exponentialBuckets(100, 1.125, 30)],
-  labelNames: ["guid", "location", "manager"],
+  labelNames: ["client_type", "guid", "location", "manager"],
 });
 
 // KGNet Savegame Storage
@@ -68,8 +68,10 @@ interface KGNetSaveFromGame {
 }
 interface KGNetSaveUpdate {
   guid: string;
-  "metadata[archived]"?: string;
-  "metadata[label]"?: string;
+  metadata?: {
+    archived: string;
+    label: string;
+  };
 }
 interface KGNetSaveFromAnalysts {
   telemetry: {
@@ -187,7 +189,12 @@ export class KittensGameRemote {
           console.info(`=> Received frame report (${message.location}).`, delta);
 
           ks_iterate_duration.observe(
-            { guid: message.guid, location: message.location, manager: "all" },
+            {
+              client_type: message.location.includes("headless.html") ? "headless" : "browser",
+              guid: message.guid,
+              location: message.location,
+              manager: "all",
+            },
             delta,
           );
           for (const [measurement, timeTaken] of Object.entries(payload.measurements)) {
@@ -196,7 +203,12 @@ export class KittensGameRemote {
             }
 
             ks_iterate_duration.observe(
-              { guid: message.guid, location: message.location, manager: measurement },
+              {
+                client_type: message.location.includes("headless.html") ? "headless" : "browser",
+                guid: message.guid,
+                location: message.location,
+                manager: measurement,
+              },
               timeTaken,
             );
           }
@@ -256,12 +268,13 @@ export class KittensGameRemote {
   }
 
   sendMessage<TMessage extends KittenAnalystsMessageId>(
-    message: Omit<KittenAnalystsMessage<TMessage>, "location" | "guid">,
+    message: Omit<KittenAnalystsMessage<TMessage>, "client_type" | "location" | "guid">,
   ): Promise<Array<KittenAnalystsMessage<TMessage> | null>> {
     const clientRequests = [...this.sockets.values()].map(socket =>
       this.#sendMessageToSocket(
         {
           ...message,
+          client_type: "backend",
           guid: "ka-backend",
           location: this.location,
         },
@@ -466,6 +479,7 @@ routerNetwork.post("/kgnet/save/upload", context => {
       .toHeadless({
         type: "injectSavegame",
         data: savegame,
+        client_type: "backend",
         location: `ws://${(remote.wss.address() as AddressInfo | null)?.address ?? "localhost"}:9093/`,
         guid: "ka-backend",
       })
@@ -487,12 +501,12 @@ routerNetwork.post("/kgnet/save/update", context => {
     const gameGUID = gameSave.guid;
     const existingSave = saveStore.get(gameGUID);
     if (isNil(existingSave)) {
-      console.warn(`Couldn't find existing savegame with ID '${gameGUID}'!`);
+      console.warn(`=> Couldn't find existing savegame with ID '${gameGUID}'! Update is ignored.`);
       return;
     }
 
-    existingSave.archived = gameSave["metadata[archived]"] === "true";
-    existingSave.label = gameSave["metadata[label]"] ?? existingSave.label;
+    existingSave.archived = gameSave.metadata?.archived === "true";
+    existingSave.label = gameSave.metadata?.label ?? existingSave.label;
     writeFileSync(`${LOCAL_STORAGE_PATH}/${gameGUID}.json`, JSON.stringify(existingSave));
     saveStore.set(gameGUID, existingSave);
     console.debug(`=> Savegame persisted to disc.`);

packages/kitten-analysts/examples/ka-internal-savestate.json

@@ -23,7 +23,13 @@ export const gaugeFactory = <
   name: string;
   labelNames: Array<string>;
   require: TMessage;
-  extract: (guid: string, location: string, element: TData[number], subject: Gauge) => void;
+  extract: (
+    client_type: "backend" | "browser" | "headless",
+    guid: string,
+    location: string,
+    element: TData[number],
+    subject: Gauge,
+  ) => void;
 }) =>
   new Gauge({
     help: instructions.help,
@@ -46,7 +52,13 @@ export const gaugeFactory = <
           continue;
         }
         for (const entity of mustExist(clientResponse.data) as TData) {
-          instructions.extract(clientResponse.guid, clientResponse.location, entity, this);
+          instructions.extract(
+            clientResponse.client_type,
+            clientResponse.guid,
+            clientResponse.location,
+            entity,
+            this,
+          );
         }
       }
     },

packages/kitten-analysts/source/KittenAnalysts.ts

@@ -8,11 +8,12 @@ export const kg_building_on = (cache: MessageCache, remote: KittensGameRemote) =
     remote,
     help: "How many of the given building are turned on.",
     name: "kg_building_on",
-    labelNames: ["guid", "name", "label", "location", "tab"],
+    labelNames: ["client_type", "client_type", "guid", "name", "label", "location", "tab"],
     require: "getBuildings",
-    extract(guid, location, element, subject) {
+    extract(client_type, guid, location, element, subject) {
       subject.set(
         {
+          client_type,
           guid,
           label: ucfirst(element.label),
           location,

packages/kitten-analysts/source/entrypoint-backend.ts

@@ -8,11 +8,12 @@ export const kg_building_value = (cache: MessageCache, remote: KittensGameRemote
     remote,
     help: "How many of the given building have been built.",
     name: "kg_building_value",
-    labelNames: ["guid", "name", "label", "location", "tab"],
+    labelNames: ["client_type", "guid", "name", "label", "location", "tab"],
     require: "getBuildings",
-    extract(guid, location, element, subject) {
+    extract(client_type, guid, location, element, subject) {
       subject.set(
         {
+          client_type,
           guid,
           label: ucfirst(element.label),
           location,

packages/kitten-analysts/source/metrics/factory.ts

@@ -8,15 +8,16 @@ export const kg_buildings_constructed = (cache: MessageCache, remote: KittensGam
     remote,
     help: "How many buildings you have constructed.",
     name: "kg_buildings_constructed",
-    labelNames: ["guid", "label", "location", "type"],
+    labelNames: ["client_type", "guid", "label", "location", "type"],
     require: "getStatistics",
-    extract(guid, location, element, subject) {
+    extract(client_type, guid, location, element, subject) {
       if (element.name !== "buildingsConstructed") {
         return;
       }
 
       subject.set(
         {
+          client_type,
           guid,
           label: ucfirst(element.label),
           location,

packages/kitten-analysts/source/metrics/kg_building_on.ts

@@ -8,15 +8,16 @@ export const kg_challenges_completed_total = (cache: MessageCache, remote: Kitte
     remote,
     help: "Amount of challenges you have completed.",
     name: "kg_challenges_completed_total",
-    labelNames: ["guid", "label", "location", "type"],
+    labelNames: ["client_type", "guid", "label", "location", "type"],
     require: "getStatistics",
-    extract(guid, location, element, subject) {
+    extract(client_type, guid, location, element, subject) {
       if (element.name !== "totalChallengesCompleted") {
         return;
       }
 
       subject.set(
         {
+          client_type,
           guid,
           label: ucfirst(element.label),
           location,