From a12c7bfb44ad4e03f2c653d20f0cc050e01a2727 Mon Sep 17 00:00:00 2001
From: Martin Dimitrov <martin3dimitrov@gmail.com>
Date: Sun, 15 Dec 2024 13:00:48 -0800
Subject: [PATCH] add common handler decorator and metrics for buzzer client

---
 .gitea/workflows/build-homeassistant.yaml     |   7 +-
 bun.lockb                                     | Bin 409296 -> 413960 bytes
 packages/doorman-api/package.json             |   5 +-
 .../doorman-api/src/common/DoormanHandler.ts  |  91 ++++++++++++++++++
 .../src/common/DoormanHandlerContext.ts       |  11 +++
 packages/doorman-client/.env.example          |   6 +-
 packages/doorman-client/package.json          |  12 ++-
 .../src/functions/buzzer-activated.ts         |  28 +++++-
 .../src/metrics/BuzzerActivatedMetrics.ts     |  54 +++++++++++
 .../doorman-client/src/types/TwilioContext.ts |   6 +-
 .../doorman-client/src/utils/DoormanUtils.ts  |  19 ++--
 .../doorman-client/src/utils/TwimlUtils.ts    |   6 +-
 12 files changed, 215 insertions(+), 30 deletions(-)
 create mode 100644 packages/doorman-api/src/common/DoormanHandler.ts
 create mode 100644 packages/doorman-api/src/common/DoormanHandlerContext.ts
 create mode 100644 packages/doorman-client/src/metrics/BuzzerActivatedMetrics.ts

diff --git a/.gitea/workflows/build-homeassistant.yaml b/.gitea/workflows/build-homeassistant.yaml
index 949640e..24b1942 100644
--- a/.gitea/workflows/build-homeassistant.yaml
+++ b/.gitea/workflows/build-homeassistant.yaml
@@ -15,7 +15,6 @@ jobs:
       token: ${{ github.token }}
   deploy-gitainer:
     needs: docker
-    runs-on: ubuntu-22.04
-    steps:
-      - name: Call Gitainer stack webhooks
-        run: curl --request POST http://192.168.1.150:9080/api/stacks/doorman-homeassistant?pretty
\ No newline at end of file
+    uses: martin/chromart-gitea-actions/.gitea/workflows/gitainer-deploy.yaml@main
+    with:
+      stack_name: doorman-homeassistant
diff --git a/bun.lockb b/bun.lockb
index e3ed26c6c14fade4a1bb395f31156b4855ec034c..ec7491bed9eeda5730b166a5af102336dc35c861 100755
GIT binary patch
delta 40443
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%0D=)CY>F-8AW9l
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%0D8JCQ(mA-I9}q5O##c-7d0PUgl0%71?TFdO=|bm
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
WVXBMPm!C`epi4;!s)a%qo%;hFxPv$V

delta 36791
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
Dw@LQ-

diff --git a/packages/doorman-api/package.json b/packages/doorman-api/package.json
index 329afb2..cd0da9e 100644
--- a/packages/doorman-api/package.json
+++ b/packages/doorman-api/package.json
@@ -12,14 +12,15 @@
   },
   "dependencies": {
     "@aws-sdk/client-dynamodb": "^3.609.0",
-    "@twilio-labs/serverless-runtime-types": "^4.0.1",
     "@twilio/runtime-handler": "1.3.0",
     "discord.js": "^14.16.3",
+    "prom-client": "^15.1.3",
     "twilio": "^3.56"
   },
   "devDependencies": {
     "twilio-run": "^3.5.4",
-    "concurrently": "^9.1.0"
+    "concurrently": "^9.1.0",
+    "@twilio-labs/serverless-runtime-types": "^3.0.0"
   },
   "engines": {
     "node": "18"
diff --git a/packages/doorman-api/src/common/DoormanHandler.ts b/packages/doorman-api/src/common/DoormanHandler.ts
new file mode 100644
index 0000000..a813a33
--- /dev/null
+++ b/packages/doorman-api/src/common/DoormanHandler.ts
@@ -0,0 +1,91 @@
+import { ServerlessCallback, ServerlessFunctionSignature } from "@twilio-labs/serverless-runtime-types/types";
+import { PrometheusContentType, Registry, Pushgateway, Summary } from "prom-client";
+import { DoormanLambdaContext } from "./DoormanHandlerContext";
+
+export type BaseEvent = { request: { cookies: {}; headers: {}; }; }
+
+export type DoormanLambda<T extends DoormanLambdaContext, U extends BaseEvent> = (
+  context: Parameters<ServerlessFunctionSignature<T, U>>[0],
+  event: Parameters<ServerlessFunctionSignature<T, U>>[1],
+  callback: Parameters<ServerlessFunctionSignature<T, U>>[2],
+  metricsRegistry: Registry<PrometheusContentType>,
+) => void;
+
+export enum CommonMetrics {
+  RUNTIME = "FunctionRuntime",
+};
+
+/**
+ * A decorator for twilio handlers. It provides a metrics registry and 
+ * should implement timeout and cleanup jobs based on lambda timeout
+ * @param handler 
+ */
+export function withMetrics<T extends DoormanLambdaContext, U extends BaseEvent>(
+  functionName: string,
+  handler: DoormanLambda<T, U>
+): ServerlessFunctionSignature<T, U> {
+  return async (context, event, callback) => {
+    console.log("[CommonHandler] creating metrics registry");
+    const metricsRegistry = new Registry();
+    const pushGateway = new Pushgateway(context.PUSHGATEWAY_URL, {}, metricsRegistry);
+
+    metricsRegistry.registerMetric(new Summary({
+      name: CommonMetrics.RUNTIME,
+      help: "Runtime of the function",
+    }));
+
+    const summaryTimer = (metricsRegistry.getSingleMetric(CommonMetrics.RUNTIME) as Summary).startTimer();
+
+    const startTime = Date.now();
+    console.log(`[CommonHandler] started handler at ${startTime}`);
+
+    const handlerResponsePromise: Promise<Parameters<ServerlessCallback>> = new Promise(async (resolve, reject) => {
+      // intercept the callbackResult
+      let callbackResult: Parameters<ServerlessCallback> | undefined;
+      const tempCallback: ServerlessCallback = (err, payload) => {
+        callbackResult = [err, payload];
+      }
+
+      await handler(context, event, tempCallback, metricsRegistry);
+
+      if (!callbackResult) {
+        reject("No callback was given");
+      }
+      resolve(callbackResult as Parameters<ServerlessCallback>);
+    });
+
+    console.time("[CommonHandler] nested handler time");
+
+    const result = await handlerResponsePromise;
+
+    console.timeEnd("[CommonHandler] nested handler time");
+
+    const endTime = Date.now();
+    const remainingTime = 10000 - (endTime - startTime);
+
+    console.log(`[CommonHandler] there is ${remainingTime} ms left to send metrics`);
+
+    let metricsTimeout = setTimeout(() => {
+      console.log("[CommonHandler] cutting it too close, abandoning metrics");
+      callback(...result);
+    }, remainingTime - 250);
+
+    summaryTimer();
+
+    console.log("[CommonHandler] attempting to push metrics...");
+    try {
+      await pushGateway.push({
+        jobName: functionName,
+        groupings: {
+          stage: context.STAGE,
+        },
+      });
+      console.log("[CommonHandler] pushed metrics successfully");
+    } catch (e: any) {
+      console.log("[CommonHandler] failed to push metrics, quietly discarding them", e);
+    }
+    
+    clearTimeout(metricsTimeout);
+    callback(...result);
+  };
+};
diff --git a/packages/doorman-api/src/common/DoormanHandlerContext.ts b/packages/doorman-api/src/common/DoormanHandlerContext.ts
new file mode 100644
index 0000000..ba9c64e
--- /dev/null
+++ b/packages/doorman-api/src/common/DoormanHandlerContext.ts
@@ -0,0 +1,11 @@
+import { EnvironmentVariables } from "@twilio-labs/serverless-runtime-types/types";
+
+export enum Stage {
+  DEV = "dev",
+  PROD = "prod",
+};
+
+export interface DoormanLambdaContext extends EnvironmentVariables {
+  PUSHGATEWAY_URL: string;
+  STAGE: string;
+};
diff --git a/packages/doorman-client/.env.example b/packages/doorman-client/.env.example
index 03505de..fd99292 100644
--- a/packages/doorman-client/.env.example
+++ b/packages/doorman-client/.env.example
@@ -2,4 +2,8 @@ DOORMAN_URL=https://doorman.chromart.cc
 
 # twilio auth
 ACCOUNT_SID=
-AUTH_TOKEN=
\ No newline at end of file
+AUTH_TOKEN=
+
+# metrics
+PUSHGATEWAY_URL=https://metrics.chromart.cc
+STAGE=prod
\ No newline at end of file
diff --git a/packages/doorman-client/package.json b/packages/doorman-client/package.json
index 3e2e755..1c957ab 100644
--- a/packages/doorman-client/package.json
+++ b/packages/doorman-client/package.json
@@ -11,21 +11,23 @@
     "deploy": "twilio-run deploy --load-system-env --env .env.example --service-name buzzer --environment=prod --override-existing-project"
   },
   "dependencies": {
-    "@twilio-labs/serverless-runtime-types": "^3.0.0",
     "@twilio/runtime-handler": "1.3.0",
-    "node-fetch": "2",
-    "twilio": "^3.56"
+    "node-fetch": "^2.7.0",
+    "prom-client": "^15.1.3",
+    "prometheus-remote-write": "^0.5.0",
+    "twilio": "^3.84.1"
   },
   "devDependencies": {
     "@types/bun": "latest",
     "concurrently": "^9.1.0",
-    "twilio-run": "^3.5.4"
+    "twilio-run": "^3.5.4",
+    "@twilio-labs/serverless-runtime-types": "^3.0.0"
   },
   "engines": {
     "node": "18"
   },
   "type": "commonjs",
   "peerDependencies": {
-    "typescript": "^5.0.0"
+    "typescript": "^5.2.2"
   }
 }
\ No newline at end of file
diff --git a/packages/doorman-client/src/functions/buzzer-activated.ts b/packages/doorman-client/src/functions/buzzer-activated.ts
index 3b589ab..a401178 100644
--- a/packages/doorman-client/src/functions/buzzer-activated.ts
+++ b/packages/doorman-client/src/functions/buzzer-activated.ts
@@ -15,8 +15,14 @@ import VoiceResponse from 'twilio/lib/twiml/VoiceResponse';
 import { DoorStatus } from '../../../doorman-api/src/types/DoorStatus';
 import { StatusResponse } from '../../../doorman-api/src/functions/api/door/status';
 import { InfoResponseClient } from '../../../doorman-api/src/functions/api/door/info';
+import { withMetrics } from '../../../doorman-api/src/common/DoormanHandler';
+import { Counter, Summary } from 'prom-client';
+import { BuzzerActivatedMetrics, registerMetrics } from '../metrics/BuzzerActivatedMetrics';
 
-export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent> = async function(context, event, callback) {
+export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent> = withMetrics('buzzer-activated', async function(context, event, callback, metricsRegistry) {
+  // metrics
+  registerMetrics(metricsRegistry);
+  
   let invokeId = `[${randomUUID()}]`;
   let configString = event.config;
   let config: InfoResponseClient | undefined;
@@ -37,6 +43,7 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
   if (!config || !config.door) {
     let twiml = new Twilio.twiml.VoiceResponse();
     twiml.reject();
+    (metricsRegistry.getSingleMetric(BuzzerActivatedMetrics.CALL_REJECTED) as Counter).inc({ From: event.From }, 1);
     callback(null, twiml);
     return;
   }
@@ -47,7 +54,7 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
     msg + u + ')'
   );
 
-  await notifyDiscord(context, msgs, config.discordUsers, config.discordUsers.map(() => ""));
+  await notifyDiscord(context, msgs, config.discordUsers, config.discordUsers.map(() => ""), metricsRegistry);
 
   let discordLock = false;
   let intervals: Timer[] = [];
@@ -55,10 +62,14 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
 
   const unlockPromise = new Promise<VoiceResponse>((resolve, reject) => {
     intervals.push(setInterval(() => {
+      (metricsRegistry.getSingleMetric(BuzzerActivatedMetrics.POLL_ATTEMPTS) as Counter).inc({ door: config.door }, 1);
+      const recordPollLatency = (metricsRegistry.getSingleMetric(BuzzerActivatedMetrics.POLL_LATENCY) as Summary).startTimer({ door: config.door });
+      
       fetch(context.DOORMAN_URL + `/api/door/status?door=${config.door}`)
         .then(res => res.json())
         .then(async (rawBody) => {
           let body = rawBody as StatusResponse;
+          recordPollLatency();
           if (body?.status === DoorStatus.OPEN) {
             clearInterval(intervals[0]);
             const twiml = doorOpenTwiml(config);
@@ -68,7 +79,9 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
               console.log(
                 invokeId, "UnlockPromise: I was the fastest, so I will attempt to notify discord users before resolving with unlock"
               );
-              await notifyAllDiscord(context, config, `🔓 Doorman buzzed someone up @ Door "${config.door}"`, JSON.stringify(body.fingerprint));
+              (metricsRegistry.getSingleMetric(BuzzerActivatedMetrics.API_UNLOCK) as Counter).inc({ door: config.door }, 1);
+              await notifyAllDiscord(context, config, `🔓 Doorman buzzed someone up @ Door "${config.door}"`, metricsRegistry, JSON.stringify(body.fingerprint));
+  
               resolve(twiml);
             } else {
               console.log(
@@ -86,6 +99,7 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
 
       if (!discordLock) {
         discordLock = true;
+        (metricsRegistry.getSingleMetric(BuzzerActivatedMetrics.DIAL_THROUGH) as Counter).inc({ door: config.door }, 1);
 
         console.log(
           invokeId, "GracefulFallbackPromise: I was the fastest, so I will attempt to notify discord users before resolving with a call"
@@ -93,7 +107,8 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
         await notifyAllDiscord(
           context, 
           config, 
-          `📞 Somebody buzzed the door and it dialed through to fallback phone numbers @ Door "${config.door}"`
+          `📞 Somebody buzzed the door and it dialed through to fallback phone numbers @ Door "${config.door}"`,
+          metricsRegistry,
         );
         resolve(twiml);
       } else {
@@ -106,6 +121,9 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
 
   const ungracefulFallbackPromise = new Promise<VoiceResponse>((resolve, reject) => {
     timeouts.push(setTimeout(async () => {
+      (metricsRegistry.getSingleMetric(BuzzerActivatedMetrics.RESULT_NOTIFICATION_FATE_UNKNOWN) as Counter).inc({ door: config.door }, 1);
+      (metricsRegistry.getSingleMetric(BuzzerActivatedMetrics.DIAL_THROUGH) as Counter).inc({ door: config.door }, 1);
+
       const twiml = dialFallbackTwiml(config);
       console.error(
         invokeId, "UngracefulFallbackPromise: Cutting it too close to timeout! Skipping notifying users and calling fallback"
@@ -119,4 +137,4 @@ export const handler: ServerlessFunctionSignature<TwilioContext, BuzzerDialEvent
   timeouts.forEach(timeout => clearTimeout(timeout));
   intervals.forEach(interval => clearInterval(interval));
   callback(null, twiml);
-};
+});
diff --git a/packages/doorman-client/src/metrics/BuzzerActivatedMetrics.ts b/packages/doorman-client/src/metrics/BuzzerActivatedMetrics.ts
new file mode 100644
index 0000000..2ca24a0
--- /dev/null
+++ b/packages/doorman-client/src/metrics/BuzzerActivatedMetrics.ts
@@ -0,0 +1,54 @@
+import { Counter, Registry, Summary } from "prom-client";
+
+export enum BuzzerActivatedMetrics {
+  CALL_REJECTED = "CallRejected",
+  API_UNLOCK = "ApiUnlocked",
+  DIAL_THROUGH = "DialThrough",
+  RESULT_NOTIFICATION_FATE_UNKNOWN = "ResultNotificationFateUnknown",
+  POLL_ATTEMPTS = "PollAttempts",
+  POLL_LATENCY = "PollLatency",
+  NOTIFY_LATENCY = "NotifyLatency",
+}
+
+export const registerMetrics = (metricsRegistry: Registry) => {
+  metricsRegistry.registerMetric(new Counter({
+    name: BuzzerActivatedMetrics.CALL_REJECTED,
+    help: "A call is rejected because the dialer / door is not registered",
+    labelNames: ["From"],
+  }));
+
+  metricsRegistry.registerMetric(new Counter({
+    name: BuzzerActivatedMetrics.API_UNLOCK,
+    help: "Door was unlocked with the API",
+    labelNames: ["door"],
+  }));
+
+  metricsRegistry.registerMetric(new Counter({
+    name: BuzzerActivatedMetrics.DIAL_THROUGH,
+    help: "Dialed through to fallback numbers",
+    labelNames: ["door"],
+  }));
+
+  metricsRegistry.registerMetric(new Counter({
+    name: BuzzerActivatedMetrics.RESULT_NOTIFICATION_FATE_UNKNOWN,
+    help: "Discord result notification may or may not have been delivered due to time constraints",
+    labelNames: ["door"],
+  }));
+
+  metricsRegistry.registerMetric(new Counter({
+    name: BuzzerActivatedMetrics.POLL_ATTEMPTS,
+    help: "Number of times the door status was polled",
+    labelNames: ["door"],
+  }));
+
+  metricsRegistry.registerMetric(new Summary({
+    name: BuzzerActivatedMetrics.POLL_LATENCY,
+    help: "Latency for the door status poll",
+    labelNames: ["door"],
+  }));
+
+  metricsRegistry.registerMetric(new Summary({
+    name: BuzzerActivatedMetrics.NOTIFY_LATENCY,
+    help: "Latency for notify api calls",
+  }));
+}
diff --git a/packages/doorman-client/src/types/TwilioContext.ts b/packages/doorman-client/src/types/TwilioContext.ts
index 674ded7..78ff976 100644
--- a/packages/doorman-client/src/types/TwilioContext.ts
+++ b/packages/doorman-client/src/types/TwilioContext.ts
@@ -1,5 +1,5 @@
-import { EnvironmentVariables } from "@twilio-labs/serverless-runtime-types/types";
+import { DoormanLambdaContext } from "../../../doorman-api/src/common/DoormanHandlerContext";
 
-export interface TwilioContext extends EnvironmentVariables {
+export interface TwilioContext extends DoormanLambdaContext {
   DOORMAN_URL: string;
-}
+};
diff --git a/packages/doorman-client/src/utils/DoormanUtils.ts b/packages/doorman-client/src/utils/DoormanUtils.ts
index 9b6aa42..d03e638 100644
--- a/packages/doorman-client/src/utils/DoormanUtils.ts
+++ b/packages/doorman-client/src/utils/DoormanUtils.ts
@@ -1,8 +1,10 @@
+import { register, Registry, Summary } from "prom-client";
+import { InfoResponseClient } from "../../../doorman-api/src/functions/api/door/info";
 import { TwilioContext } from "../types/TwilioContext";
-import { DoorConfig } from "../types/DoorConfig";
 import { lambdaFastHttp } from "./LambdaUtils";
+import { BuzzerActivatedMetrics } from "../metrics/BuzzerActivatedMetrics";
 
-export async function getConfig(context: TwilioContext, buzzer: string): Promise<DoorConfig | undefined> {
+export async function getConfig(context: TwilioContext, buzzer: string): Promise<InfoResponseClient | undefined> {
   return await fetch(context.DOORMAN_URL + `/api/door/info?buzzer=${buzzer}`)
     .then(res => res.json())
     .catch(err => {
@@ -10,12 +12,15 @@ export async function getConfig(context: TwilioContext, buzzer: string): Promise
     });
 }
 
-export function notifyDiscord(context: TwilioContext, msg: string[], u: string[], optionalJsonStr: string[]){
-  return lambdaFastHttp(context.DOORMAN_URL + 
+export async function notifyDiscord(context: TwilioContext, msg: string[], u: string[], optionalJsonStr: string[], metricsRegistry: Registry){
+  const endTimer = (metricsRegistry.getSingleMetric(BuzzerActivatedMetrics.NOTIFY_LATENCY) as Summary).startTimer();
+  const res = await lambdaFastHttp(context.DOORMAN_URL + 
     `/api/door/notify?discordUser=${encodeURIComponent(JSON.stringify(u))}&msg=${encodeURIComponent(JSON.stringify(msg))}&json=${encodeURIComponent(JSON.stringify(optionalJsonStr))}`,
-  ).catch(err => console.log(err))
+  ).catch(err => console.log(err));
+  endTimer();
+  return res;
 }
 
-export async function notifyAllDiscord(context: TwilioContext, config: DoorConfig, msg: string, optionalJsonStr: string = "") {
-  return notifyDiscord(context, config.discordUsers.map(() => msg), config.discordUsers, config.discordUsers.map(() => optionalJsonStr));
+export async function notifyAllDiscord(context: TwilioContext, config: InfoResponseClient, msg: string, metricsRegistry: Registry, optionalJsonStr: string = "") {
+  return notifyDiscord(context, config.discordUsers.map(() => msg), config.discordUsers, config.discordUsers.map(() => optionalJsonStr), metricsRegistry);
 }
\ No newline at end of file
diff --git a/packages/doorman-client/src/utils/TwimlUtils.ts b/packages/doorman-client/src/utils/TwimlUtils.ts
index 9bfdc95..2cb09fc 100644
--- a/packages/doorman-client/src/utils/TwimlUtils.ts
+++ b/packages/doorman-client/src/utils/TwimlUtils.ts
@@ -1,7 +1,7 @@
 import VoiceResponse from 'twilio/lib/twiml/VoiceResponse';
-import { DoorConfig } from '../types/DoorConfig';
+import { InfoResponseClient } from '../../../doorman-api/src/functions/api/door/info';
 
-export function doorOpenTwiml(config: DoorConfig): VoiceResponse {
+export function doorOpenTwiml(config: InfoResponseClient): VoiceResponse {
   const twiml = new Twilio.twiml.VoiceResponse();
 
   twiml.play('https://buzzer-2439-prod.twil.io/buzzing_up_boosted.mp3');
@@ -12,7 +12,7 @@ export function doorOpenTwiml(config: DoorConfig): VoiceResponse {
   return twiml;
 }
 
-export function dialFallbackTwiml(config: DoorConfig): VoiceResponse {
+export function dialFallbackTwiml(config: InfoResponseClient): VoiceResponse {
   const twiml = new Twilio.twiml.VoiceResponse();
 
   let dial = twiml.dial({