hutson/homelab-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Auto-sync: 20260116-152013

Browse Source
This commit is contained in:
Hutson
2026-01-16 15:20:14 -05:00
parent 8c1cbf3dac
commit 4535969566
1 changed files with 34 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

53
MONITORING.md
View File

@@ -98,7 +98,11 @@ Monitors Claude Code token usage across all machines to track subscription consu
```
Claude Code (MacBook/Mac Mini)
│
▼ (OpenTelemetry Prometheus exporter :9464)
▼ (OTLP HTTP push)
│
OTEL Collector (docker-host:4318)
│
▼ (Remote Write)
│
Prometheus (docker-host:9090)
│
@@ -108,10 +112,7 @@ Prometheus (docker-host:9090)
```
**Monitored Devices**:
| Device | IP Address | Metrics Port |
|--------|------------|--------------|
| MacBook | 10.10.10.147 | 9464 |
| Mac Mini | 10.10.10.123 | 9464 |
All Claude Code sessions on any device automatically push metrics via OTLP.
**What's monitored**:
- Token usage (input/output/cache) over time
@@ -131,8 +132,8 @@ Prometheus (docker-host:9090)
| No Metrics | Scrape fails for 5min | Info |
**Configuration Files**:
- Claude settings: `~/.claude/settings.json` (on each Mac)
- Prometheus scrape: `/opt/monitoring/prometheus/prometheus.yml` (docker-host)
- Claude settings: `~/.claude/settings.json` (on each Mac - synced via Syncthing)
- OTEL Collector: `/opt/monitoring/otel-collector/config.yaml` (docker-host)
- Alert rules: `/opt/monitoring/prometheus/rules/claude-code.yml` (docker-host)
**Claude Code Settings** (in `~/.claude/settings.json`):
@@ -140,24 +141,38 @@ Prometheus (docker-host:9090)
{
"env": {
"CLAUDE_CODE_ENABLE_TELEMETRY": "1",
"OTEL_METRICS_EXPORTER": "prometheus",
"OTEL_EXPORTER_PROMETHEUS_PORT": "9464",
"OTEL_METRICS_EXPORTER": "otlp",
"OTEL_EXPORTER_OTLP_ENDPOINT": "http://10.10.10.206:4318",
"OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
"OTEL_METRIC_EXPORT_INTERVAL": "60000"
}
}
```
**Prometheus Scrape Config**:
**OTEL Collector Config** (`/opt/monitoring/otel-collector/config.yaml`):
```yaml
- job_name: "claude-code"
scrape_interval: 60s
static_configs:
- targets: ["10.10.10.147:9464"]
labels:
device: "macbook"
- targets: ["10.10.10.123:9464"]
labels:
device: "mac-mini"
receivers:
otlp:
protocols:
grpc:
endpoint: 0.0.0.0:4317
http:
endpoint: 0.0.0.0:4318
processors:
batch:
timeout: 10s
exporters:
prometheusremotewrite:
endpoint: "http://prometheus:9090/api/v1/write"
service:
pipelines:
metrics:
receivers: [otlp]
processors: [batch]
exporters: [prometheusremotewrite]
```
**Useful PromQL Queries**: