From 5724b8459d881d06d3a3bdf5b3a8d7e510cf6bd9 Mon Sep 17 00:00:00 2001 From: hsiegeln <37154749+hsiegeln@users.noreply.github.com> Date: Sun, 12 Apr 2026 16:37:46 +0200 Subject: [PATCH] docs: document catalog cleanup, log ingestion logging, and catalog config Co-Authored-By: Claude Opus 4.6 (1M context) --- CLAUDE.md | 5 +++-- HOWTO.md | 1 + 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 8f9bd356..a6da8782 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -88,7 +88,8 @@ java -jar cameleer3-server-app/target/cameleer3-server-app-1.0-SNAPSHOT.jar - `ExecutionController` — GET /api/v1/executions (search + detail) - `SearchController` — POST /api/v1/search, GET /routes, GET /top-errors, GET /punchcard - `LogQueryController` — GET /api/v1/logs (filters: source, application, agentId, exchangeId, level, logger, q, environment, time range) -- `LogIngestionController` — POST /api/v1/data/logs (accepts `List` JSON array, each entry has `source`: app/agent) +- `LogIngestionController` — POST /api/v1/data/logs (accepts `List` JSON array, each entry has `source`: app/agent). Logs WARN for: missing agent identity, unregistered agents, empty payloads, buffer-full drops, deserialization failures. Normal acceptance at DEBUG. +- `CatalogController` — GET /api/v1/catalog (unified app catalog merging PG managed apps + in-memory agents + CH stats), DELETE /api/v1/catalog/{applicationId} (ADMIN: dismiss app, purge all CH data + PG record). Auto-filters discovered apps older than `discoveryttldays` with no live agents. - `ChunkIngestionController` — POST /api/v1/ingestion/chunk/{executions|metrics|diagrams} - `UserAdminController` — CRUD /api/v1/admin/users, POST /{id}/roles, POST /{id}/set-password - `RoleAdminController` — CRUD /api/v1/admin/roles @@ -297,7 +298,7 @@ In SaaS mode, each tenant's server and its deployed apps are isolated at the Doc # GitNexus — Code Intelligence -This project is indexed by GitNexus as **cameleer3-server** (5912 symbols, 14487 relationships, 300 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely. +This project is indexed by GitNexus as **cameleer3-server** (5967 symbols, 15136 relationships, 300 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely. > If any GitNexus tool warns the index is stale, run `npx gitnexus analyze` in terminal first. diff --git a/HOWTO.md b/HOWTO.md index fb4641cf..9034ecb4 100644 --- a/HOWTO.md +++ b/HOWTO.md @@ -447,6 +447,7 @@ Key settings in `cameleer3-server-app/src/main/resources/application.yml`. All c | Setting | Default | Env var | Description | |---------|---------|---------|-------------| +| `cameleer.server.catalog.discoveryttldays` | `7` | `CAMELEER_SERVER_CATALOG_DISCOVERYTTLDAYS` | Days before stale discovered apps auto-hide from sidebar | | `cameleer.server.tenant.id` | `default` | `CAMELEER_SERVER_TENANT_ID` | Tenant identifier | | `cameleer.server.indexer.debouncems` | `2000` | `CAMELEER_SERVER_INDEXER_DEBOUNCEMS` | Search indexer debounce delay (ms) | | `cameleer.server.indexer.queuesize` | `10000` | `CAMELEER_SERVER_INDEXER_QUEUESIZE` | Search indexer queue capacity |