Jelajahi Sumber

docs: heatmap CTE+valideerimine + filelog add_metadata_from_filepath

Ardo 3 minggu lalu
induk
melakukan
58123424bb
1 mengubah file dengan 18 tambahan dan 4 penghapusan
  1. 18 4
      dev/LOEMIND_observability.md

+ 18 - 4
dev/LOEMIND_observability.md

@@ -149,16 +149,30 @@ Sama kehtib heatmap'i „Low/High" legendile. See on **upstream viga**, mitte an
 - Puhta count-heatmap'i jaoks kasuta mõnda muud kuva (nt `table`) kuni upstream-paranduseni.
 - Kui metrika valimine ei täida Value välja automaatselt, trüki käsitsi.
 
-> **PATCH (meil rakendatud):** bind-mount'itud **kaks** chunki:
-> `dev/patches/4719-70b065addcfc053d.js` (jagatud, dashboardid) ja
-> `dev/patches/pages/clickhouse-46029ebbad38b40a.js` (**`/chart` leht**; funktsioonid `N`+`F`).
+> **PATCH (meil rakendatud):** bind-mount'itud **kolm** chunki:
+> `dev/patches/4719-70b065addcfc053d.js` (jagatud, dashboardid),
+> `dev/patches/pages/clickhouse-46029ebbad38b40a.js` (**`/chart` leht**; funktsioonid `N`+`F`) ja
+> `dev/patches/4751-53b929fca5a575a9.js` (heatmap-valideerimine).
 > Patch teeb tühja `valueExpression`'i korral count-põhise min/max'i **ja** bucket-päringu,
 > seega **count-heatmap/graafik töötab ilma Value't täitmata**.
+> **Täiendused (02.10.2026):**
+> - CTE count-selectid (`min_max_calc`/`bucket_calc`) said väljad `valueExpression:""`,
+>   `aggCondition:""`, `aggConditionLanguage:"lucene"` — muidu `common-utils` CTE-skeem andis
+>   **„non-conforming chartConfig object in CTE"**.
+> - `4751-…`: heatmap-valideerimine lubab tühja `valueExpression`, kui `series[0].aggFn==="count"`
+>   — muidu **„Value expression is required for heatmap charts"**.
 > ⚠️ Chunkid on `Cache-Control: immutable` → **vaja hard-refresh** (Ctrl+Shift+R).
-> ⚠️ Patch on seotud **chunk-hashiga** (HyperDX 2.37.0, image `...all-in-one:latest`).
+> ⚠️ Patchid on seotud **chunk-hashiga** (HyperDX 2.37.0, image `...all-in-one:latest`).
 > Image'i uuendusel: võrdle uut chunk-nime ja kohanda patch + mount.
 > Kontroll: `curl .../chunks/pages/clickhouse-*.js | grep 'r||!a'`.
 
+### filelog: „failed to detect a valid log path"
+`container` operatori `add_metadata_from_filepath` (vaikimisi `true`) ootab **Kubernetes'i**
+tee-mustrit (`logpathPattern`); Docker-teed (`/var/lib/docker/containers/<id>/<id>-json.log`)
+ei sobi → iga logirea kohta viga (cadvisor jt). Parandus `otel-collector` config'us:
+`add_metadata_from_filepath: false` (pole k8s). Kontroll:
+`docker logs otel-collector --since 3m | grep -c "failed to detect a valid log path"` → 0.
+
 ### Service Map: trace-instrumentatsioon (TEHTUD 2026-09-27)
 Service Map on **trace-põhine**. Kui URL-is on `?source=<logSourceId>`, näitab UI hoiatust
 „... is a log source, which this page can't show" — vali päises **Traces** või ava