Bladeren bron

docs: custom collector ei tohi base-komponente üle kirjutada (prometheus/ohmu, filelog/ohmu)

Ardo 3 weken geleden
bovenliggende
commit
2e3978798f
1 gewijzigde bestanden met toevoegingen van 11 en 0 verwijderingen
  1. 11 0
      dev/LOEMIND_observability.md

+ 11 - 0
dev/LOEMIND_observability.md

@@ -42,6 +42,17 @@ Skeem luuakse ametliku kollektori schema-seed'iga.
 | `dev/config/alert-relay/alert_relay.py` | HyperDX webhook → Telegram |
 | `dev/.env` | `HYPERDX_INGEST_KEY`, `TELEGRAM_BOT_TOKEN` jm (gitignore'itud) |
 
+> ⚠️ **Custom collector-config ei tohi base/remote-komponente üle kirjutada.**
+> Ametlik `clickstack-otel-collector` (supervisor/OpAMP) defineerib baasis juba `prometheus`
+> (self-metrics), `otlp/hyperdx`, `clickhouse`, `memory_limiter`, `batch` jm. Kui
+> `CUSTOM_OTELCOL_CONFIG_FILE` defineerib sama nimega komponendi (nt `prometheus`), jääb
+> **custom versioon rakendamata** (vaikselt) → host-metrikad ei liigu (kinnitatud 2026-10-03:
+> `node_*`/`container_*`/`llamacpp:*` külmusid).
+> **Reegel:** anna custom-komponentidele unikaalne nimi, nt **`prometheus/ohmu`**, **`filelog/ohmu`**,
+> ja viita pipeline'is sellele. Baasi `memory_limiter`/`batch`/`clickhouse` jäävad kasutatavaks.
+> Diagnoos: `docker exec otel-collector sh -c 'wget -qO- localhost:8888/metrics' | grep receiver=`
+> (peab olema `receiver="prometheus/ohmu"`).
+
 ### ClickStack env (olulised)
 - App: `MONGO_URI=mongodb://clickstack-db:27017/hyperdx`, `HYPERDX_API_KEY=...`, `OPAMP_PORT=4320`,
   `OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318`,