convez.ai
PluginDevOps & InfraestruturaIntermediário
cometkim

Claude Code Monitor com Cloudflare Workers

cometkim/cc-monitor-worker

Monitore uso de Claude Code com analytics SQL via Cloudflare Workers

Ver no GitHub
BomPluginScore · de 0 a 100

Plugin para monitorar uso de Claude Code através de Cloudflare Workers e Analytics Engine. Oferece dois modos de rastreamento: OpenTelemetry (oficial) e API Proxy (gateway customizado). Fornece analytics em SQL com autenticação Bearer token, zero-maintenance e deploy em um clique.

Instalação

$npx convez-ai cometkim/cc-monitor-worker

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
23
Forks
2
Acompanhando
1
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Rastrear custos e padrões de uso de Claude Code em tempo real
  • Analisar produtividade e contexto de uso com OpenTelemetry
  • Interceptar requisições API para cálculo exato de custos
  • Monitorar múltiplos agentes de coding (Claude Code, OpenCode)

Veredito

Solução sólida de observabilidade serverless para Claude Code, com duas estratégias complementares (OTEL vs proxy). Ideal para times que precisam rastrear custos e uso, mas exige escolha consciente entre precisão vs contexto conforme necessidade.

README

A tradução para o português deste README ainda está na fila.

Claude Code Monitoring w/ Cloudflare Workers

Monitor your Claude Code usage with Cloudflare Workers and Workers Analytics Engine.

  • Public, Secure endpoint
  • Powerful analytics via SQL
  • Truly Serverless, zero-maintenance

One-click deployment with

Deploy to Cloudflare

Two-modes of Monitoring

There are two option to monitoring your Claude Code usage:

  1. Using OpenTelemetry
  2. Using LLM Gateway

Each has its own needs and pros and cons. You should choose an option based on your needs.

Monitoring via OpenTelemetry

This is officially supported, and recommended way to monitor Claude Code usage.

Claude exports precise activities and use cases into a defined metrics schema. It includes all the context for analyzing costs, productivity, and usage patterns.

However, Claude Code's OTEL integration is not durable. A lot of data will not being collected. It's better suited for tracking trends rather than accurate usage data.

See README_OTEL for more details.

Monitoring via API Proxy

Claude Code also allow to use a custom LLM gateway.

Implementing an LLM gateway allows you to intercept all requests to Claude Code and calculate exact API costs. It can be used to monitor other coding agents such as OpenCode as well.

However, API requests don't include the context of the Claude Code application, making it difficult to analyze accurate usage patterns.

See README_PROXY for more details.

Data Retention

Cloudflare Analytics Engine only stores data for the past three months.

To analyze older data, you must archive it separately.

Security

The endpoint uses Bearer token authentication:

  • Development: Set AUTH_SECRET in .dev.vars
  • Production: Use wrangler secret put AUTH_SECRET

Use strong, randomly generated secrets and rotate secrets regularly.

License

MIT

Ver o original no GitHub

Bom para

Relacionados