clickup-observability

name	clickup-observability
description	Monitor ClickUp API integrations with metrics, tracing, structured logging, and alerting using Prometheus, OpenTelemetry, and Grafana. Trigger: "clickup monitoring", "clickup metrics", "clickup observability", "monitor clickup", "clickup alerts", "clickup tracing", "clickup dashboard".
allowed-tools	Read, Write, Edit
version	1.6.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","productivity","clickup"]
compatibility	Designed for Claude Code

ClickUp Observability

Overview

Monitor ClickUp API v2 integrations with metrics (request rate, latency, errors, rate limit usage), distributed tracing, and alerting.

Key Metrics

Metric	Type	Labels	Description
clickup_requests_total	Counter	method, endpoint, status	Total API requests
clickup_request_duration_seconds	Histogram	method, endpoint	Request latency
clickup_errors_total	Counter	status_code, error_type	Errors by type
clickup_rate_limit_remaining	Gauge	token_hash	Rate limit headroom
clickup_rate_limit_resets_total	Counter		Times we hit 429

Prometheus Instrumentation

import { Registry, Counter, Histogram, Gauge } from 'prom-client';

const registry = new Registry();

const requestCounter = new Counter({
  name: 'clickup_requests_total',
  help: 'Total ClickUp API v2 requests',
  labelNames: ['method', 'endpoint', 'status'] as const,
  registers: [registry],
});

const requestDuration = new Histogram({
  : ,
  : ,
  : [, ]  ,
  : [, , , , , , ],
  : [registry],
});

 rateLimitGauge =  ({
  : ,
  : ,
  : [registry],
});

 errorCounter =  ({
  : ,
  : ,
  : [, ]  ,
  : [registry],
});