feat: Normalized server logging (#2567)

* feat: Normalize logging

* Remove scattered console.error + Sentry.captureException

* Remove mention of debug

* cleanup dev output

* Edge cases, docs

* Refactor: Move logger, metrics, sentry under 'logging' folder.
Trying to reduce the amount of things under generic 'utils'

* cleanup, last few console calls

server/logging/logger.js

@@ -0,0 +1,117 @@
+// @flow
+import chalk from "chalk";
+import winston from "winston";
+import env from "../env";
+import Metrics from "../logging/metrics";
+import Sentry from "../logging/sentry";
+
+const isProduction = env.NODE_ENV === "production";
+
+type LogCategory =
+  | "lifecycle"
+  | "collaboration"
+  | "http"
+  | "commands"
+  | "processor"
+  | "email"
+  | "queue"
+  | "database"
+  | "utils";
+
+type Extra = { [key: string]: any };
+
+class Logger {
+  output: any;
+
+  constructor() {
+    this.output = winston.createLogger();
+    this.output.add(
+      new winston.transports.Console({
+        format: isProduction
+          ? winston.format.json()
+          : winston.format.combine(
+              winston.format.colorize(),
+              winston.format.printf(
+                ({ message, label }) =>
+                  `${label ? chalk.bold("[" + label + "] ") : ""}${message}`
+              )
+            ),
+      })
+    );
+  }
+
+  /**
+   * Log information
+   *
+   * @param category A log message category that will be prepended
+   * @param extra Arbitrary data to be logged that will appear in prod logs
+   */
+  info(label: LogCategory, message: string, extra?: Extra) {
+    this.output.info(message, { ...extra, label });
+  }
+
+  /**
+   * Debug information
+   *
+   * @param category A log message category that will be prepended
+   * @param extra Arbitrary data to be logged that will appear in prod logs
+   */
+  debug(label: LogCategory, message: string, extra?: Extra) {
+    this.output.debug(message, { ...extra, label });
+  }
+
+  /**
+   * Log a warning
+   *
+   * @param message A warning message
+   * @param extra Arbitrary data to be logged that will appear in prod logs
+   */
+  warn(message: string, extra?: Extra) {
+    Metrics.increment("logger.warning");
+
+    if (process.env.SENTRY_DSN) {
+      Sentry.withScope(function (scope) {
+        for (const key in extra) {
+          scope.setExtra(key, extra[key]);
+          scope.setLevel(Sentry.Severity.Warning);
+        }
+        Sentry.captureMessage(message);
+      });
+    }
+
+    if (isProduction) {
+      this.output.warn(message, extra);
+    } else {
+      console.warn(message, extra);
+    }
+  }
+
+  /**
+   * Report a runtime error
+   *
+   * @param message A description of the error
+   * @param error The error that occurred
+   * @param extra Arbitrary data to be logged that will appear in prod logs
+   */
+  error(message: string, error: Error, extra?: Extra) {
+    Metrics.increment("logger.error");
+
+    if (process.env.SENTRY_DSN) {
+      Sentry.withScope(function (scope) {
+        for (const key in extra) {
+          scope.setExtra(key, extra[key]);
+          scope.setLevel(Sentry.Severity.Error);
+        }
+        Sentry.captureException(error);
+      });
+    }
+
+    if (isProduction) {
+      this.output.error(message, { error: error.message, stack: error.stack });
+    } else {
+      console.error(message, { error, extra });
+    }
+  }
+}
+
+export default new Logger();