grafana/packages/grafana-runtime/src/utils/logging.ts

import { captureMessage, captureException, Severity as LogLevel } from '@sentry/browser';
export { LogLevel };

// a bit stricter than what Sentry allows
type Contexts = Record<string, Record<string, number | string | Record<string, string | number>>>;

/**
 * Log a message at INFO level. Depending on configuration might be forwarded to backend and logged to stdout or sent to Sentry
 *
 * @public
 */
export function logInfo(message: string, contexts?: Contexts) {
  captureMessage(message, {
    level: LogLevel.Info,
    contexts,
  });
}

/**
 * Log a message at WARNING level. Depending on configuration might be forwarded to backend and logged to stdout or sent to Sentry
 *
 * @public
 */
export function logWarning(message: string, contexts?: Contexts) {
  captureMessage(message, {
    level: LogLevel.Warning,
    contexts,
  });
}

/**
 * Log a message at DEBUG level. Depending on configuration might be forwarded to backend and logged to stdout or sent to Sentry
 *
 * @public
 */
export function logDebug(message: string, contexts?: Contexts) {
  captureMessage(message, {
    level: LogLevel.Debug,
    contexts,
  });
}

/**
 * Log an error. Depending on configuration might be forwarded to backend and logged to stdout or sent to Sentry
 *
 * @public
 */
export function logError(err: Error, contexts?: Contexts) {
  captureException(err, { contexts });
}