docs: add logging infrastructure section to CLAUDE.md
This commit is contained in:
37
CLAUDE.md
37
CLAUDE.md
@@ -379,6 +379,43 @@ Docker health check runs every 30 seconds and restarts container if unhealthy.
|
|||||||
|
|
||||||
**Key Point**: Individual DNS records are NOT created per deployment. The wildcard DNS and SSL are already configured, so Traefik automatically routes `{name}.ai.flexinit.nl` to the correct container based on hostname matching.
|
**Key Point**: Individual DNS records are NOT created per deployment. The wildcard DNS and SSL are already configured, so Traefik automatically routes `{name}.ai.flexinit.nl` to the correct container based on hostname matching.
|
||||||
|
|
||||||
|
## Logging Infrastructure
|
||||||
|
|
||||||
|
AI Stack logging integrates with the existing monitoring stack at `logs.intra.flexinit.nl`.
|
||||||
|
|
||||||
|
### Components
|
||||||
|
|
||||||
|
| Component | Location | Purpose |
|
||||||
|
|-----------|----------|---------|
|
||||||
|
| Log-ingest | `http://ai-stack-log-ingest:3000` (dokploy-network) | Receives events from AI stacks, pushes to Loki |
|
||||||
|
| Loki | `monitor-grafanaloki-qkj16i-loki-1` | Log storage |
|
||||||
|
| Grafana | https://logs.intra.flexinit.nl | Visualization |
|
||||||
|
| Dashboard | `/d/ai-stack-overview` | AI Stack metrics and logs |
|
||||||
|
|
||||||
|
### Datasource UIDs (Grafana)
|
||||||
|
- Loki: `af9a823s6iku8b`
|
||||||
|
- Prometheus: `cf9r1fmfw9xxcf`
|
||||||
|
|
||||||
|
### Configuration
|
||||||
|
|
||||||
|
AI stacks send logs via environment variable:
|
||||||
|
```
|
||||||
|
LOG_INGEST_URL=http://ai-stack-log-ingest:3000/ingest
|
||||||
|
```
|
||||||
|
|
||||||
|
### Local Development
|
||||||
|
|
||||||
|
The `logging-stack/` directory contains a standalone docker-compose for local testing:
|
||||||
|
```bash
|
||||||
|
cd logging-stack && docker-compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
### Credentials
|
||||||
|
|
||||||
|
Grafana service account token stored in BWS:
|
||||||
|
- Key: `GRAFANA_OPENCODE_ACCESS_TOKEN`
|
||||||
|
- BWS ID: `c77e58e3-fb34-41dc-9824-b3ce00da18a0`
|
||||||
|
|
||||||
## Project Status
|
## Project Status
|
||||||
|
|
||||||
✅ **Completed**:
|
✅ **Completed**:
|
||||||
|
|||||||
Reference in New Issue
Block a user