obsidian-observability

name	obsidian-observability
description	Implement structured logging, metrics, error tracking, and a debug panel for Obsidian plugins. Use when adding debug logging, tracking plugin performance, building a diagnostics view, or setting up error reporting. Trigger with phrases like "obsidian logging", "obsidian monitoring", "obsidian debug panel", "track obsidian plugin performance".
allowed-tools	Read, Write, Edit, Bash(npm:*)
version	1.13.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["obsidian","monitoring","debugging","performance","logging"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Obsidian Observability

Overview

Implement production observability for Obsidian plugins: a structured logger with levels and ring buffer history, a metrics collector with counters/gauges/timers, an error tracker with deduplication, and a debug sidebar panel that displays all of it in real time. Every component is copy-pasteable and uses only Obsidian's built-in APIs.

Prerequisites

• Working Obsidian plugin (see obsidian-core-workflow-a)
• TypeScript strict mode enabled
• Familiarity with ItemView for the debug panel

Instructions

Step 1: Structured Logger with Levels and History

// src/services/logger.ts
type LogLevel = 'debug' | 'info' | 'warn' | 'error';

const LEVEL_PRIORITY: Record<LogLevel, number> = {
  debug: 0, info: 1, warn: 2, error: 3,
};

interface LogEntry {
  timestamp: number;
  level: LogLevel;
  message: string;
  data?: unknown;
}

export class Logger {
  private history: LogEntry[] = [];
  private maxHistory = 200;
  private level: ;
   : ;

  () {
    . = ;
    . = level;
  }

  () { . = level; }

  () { .(, msg, data); }
  ()  { .(, msg, data); }
  ()  { .(, msg, data); }
  () { .(, msg, data); }

  
  (: ):   {
     start = performance.();
      {
       ms = performance.() - start;
      .();
       ms;
    };
  }

  
  (?: ): [] {
     count ? ..(-count) : [....];
  }

  
  ():  {
     .(., , );
  }

   () {
     ([level] < [.]) ;

     :  = { : .(), level, message, data };
    ..(entry);
     (.. > .) {
      ..(, .. - .);
    }

     fn = level ===  ? .
             : level ===  ? .
             : level ===  ? .
             : .;
     (data !== ) {
      (., message, data);
    }  {
      (., message);
    }
  }
}