docs: update all documentation for session changes
CLAUDE.md: - Agent registry auto-heal note (in-memory, JWT fallback) - Usage analytics (ClickHouse usage_events table) HOWTO.md: - Architecture diagram: added deploy-demo (NodePort 30092) and cameleer-demo namespace - Access URLs: added Deploy Demo - Agent registry: server restart resilience documentation - Route control: CommandGroupResponse note ui/README.md: - Fixed outdated generate-api command - Added DS version (v0.1.26) - Fixed VITE_API_TARGET (30081 not 30090) - Added key features section (cmd-k, LIVE mode, route control, event icons) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
9
HOWTO.md
9
HOWTO.md
@@ -343,10 +343,14 @@ curl -s -X POST http://localhost:8081/api/v1/agents/agent-1/commands/{commandId}
|
||||
|
||||
**Agent lifecycle:** LIVE (heartbeat within 90s) → STALE (missed 3 heartbeats) → DEAD (5min after STALE). DEAD agents kept indefinitely.
|
||||
|
||||
**Server restart resilience:** The agent registry is in-memory and lost on server restart. Agents auto-re-register on their next heartbeat or SSE connection — the server reconstructs registry entries from JWT claims (subject, application). Route catalog uses ClickHouse execution data as fallback until agents re-register with full route IDs. Agents should also handle 404 on heartbeat by triggering a full re-registration.
|
||||
|
||||
**SSE events:** `config-update`, `deep-trace`, `replay`, `route-control` commands pushed in real time. Server sends ping keepalive every 15s.
|
||||
|
||||
**Command expiry:** Unacknowledged commands expire after 60 seconds.
|
||||
|
||||
**Route control responses:** Route control commands return `CommandGroupResponse` with per-agent status, response count, and timed-out agent IDs.
|
||||
|
||||
### Backpressure
|
||||
|
||||
When the write buffer is full (default capacity: 50,000), ingestion endpoints return **503 Service Unavailable**. Already-buffered data is not lost.
|
||||
@@ -440,10 +444,14 @@ cameleer namespace:
|
||||
ClickHouse (StatefulSet, 10Gi PVC) ← clickhouse:8123 (ClusterIP)
|
||||
cameleer3-server (Deployment) ← NodePort 30081
|
||||
cameleer3-ui (Deployment, Nginx) ← NodePort 30090
|
||||
cameleer-deploy-demo (Deployment) ← NodePort 30092
|
||||
Authentik Server (Deployment) ← NodePort 30950
|
||||
Authentik Worker (Deployment)
|
||||
Authentik PostgreSQL (StatefulSet, 1Gi) ← ClusterIP
|
||||
Authentik Redis (Deployment) ← ClusterIP
|
||||
|
||||
cameleer-demo namespace:
|
||||
(deployed Camel applications — managed by cameleer-deploy-demo)
|
||||
```
|
||||
|
||||
### Access (from your network)
|
||||
@@ -453,6 +461,7 @@ cameleer namespace:
|
||||
| Web UI | `http://192.168.50.86:30090` |
|
||||
| Server API | `http://192.168.50.86:30081/api/v1/health` |
|
||||
| Swagger UI | `http://192.168.50.86:30081/api/v1/swagger-ui.html` |
|
||||
| Deploy Demo | `http://192.168.50.86:30092` |
|
||||
| Authentik | `http://192.168.50.86:30950` |
|
||||
|
||||
### CI/CD Pipeline
|
||||
|
||||
Reference in New Issue
Block a user