Detektory a kánonické problémy

Architektúra detektorov

Detector (detektor)

Detector je algoritmus, ktorý analyzuje vymedzenú množinu údajov a vytvára formalizované zistenie.

Detektor neriadi vykonávanie prác a negeneruje ľubovoľný text. Jeho výstup má štruktúrovaný formát.

detector_id: archive.tail_gap.v3
detector_version: '3.2.1'
run_id: 'run-20260723-0400'
asset_id: 'station-5690'
observed_at: '2026-07-23T04:00:00Z'

finding:
  canon: no_hourly_archive
  detected: true
  severity: critical
  confidence: 0.98
  value: 73
  unit: 'hours'
  threshold: 24
  baseline: 0

evidence:
  last_valid_hour: '2026-07-20T03:00:00Z'
  expected_end: '2026-07-23T04:00:00Z'
  missing_hours: 73

Reťazec Detector → Canon → Issue

flowchart TD
  D["Detector"] -->|"klasifikácia"| C["Canon"]
  C -->|"riadenie"| I["Operational Issue"]

• Detector — konkrétny algoritmus;
• Canon — stabilný typ prevádzkového problému;
• Operational Issue — inštancia problému v konkrétnom kontexte.

Ten istý kánon môže potvrdiť viacero rôznych detektorov.

Príklad:

flowchart TD
  D1["archive.tail_gap.v3"] --> CANON["no_hourly_archive"]
  D2["archive.coverage.v2"] --> CANON
  D3["archive.delivery_queue.v1"] --> CANON
  D4["session.freshness.v4"] --> CANON
  CANON --> ISSUE["OHM-2026-001842"]

Triedy detektorov

Požiadavky na každý detektor

Každý produkčný detektor má:

• jedinečný detector_id;
• sémantickú verziu;
• deklarovaný účel;
• vlastníka;
• opis vstupných údajov;
• kontrolované prahové hodnoty;
• pravidlá vylúčenia;
• požiadavky na minimálnu vzorku;
• DQ-brány;
• vzorec pre severity;
• vzorec pre mieru istoty;
• zodpovedajúci kánon;
• množinu Evidence;
• testy;
• kontrolnú vzorku;
• odhad falošne pozitívnych zistení;
• dátum uvedenia do prevádzky;
• denník zmien;
• režim vypnutia a spätné vrátenie (rollback).

Kontrolné brány kvality údajov (DQ-brány)

Detektor nesmie vykazovať vysokú mieru istoty, ak sú zdrojové údaje neúplné alebo protirečivé.

Príklady brán:

Zdravie detektorov (Detector Health)

OHM sleduje kvalitu samotných detektorov.

Kľúčové ukazovatele:

• počet spustení;
• podiel potvrdených spustení;
• podiel falošne pozitívnych zistení;
• podiel manuálnych zrušení;
• podiel opätovných otvorení;
• rozdelenie miery istoty;
• drift vstupných údajov;
• zmena štruktúry vzorky;
• priemerný čas do potvrdenia;
• verzia algoritmu;
• počet aktívnych Issues podľa verzie.

Kánonické problémy

Canon je stabilná biznisová klasifikácia problému, ktorá nezávisí od konkrétnej implementácie detektora.

Prečo sú kánony potrebné

Bez kánonov analytický systém rýchlo degeneruje na súbor nesúrodých hlásení:

• archive_missing
• no_archive
• archive_gap
• hourly_data_absent
• delivery_error

Kánon zjednocuje všetky tieto rovnocenné signály pod jediným identifikátorom: canon: no_hourly_archive.

To zabezpečuje:

• jednotný workflow;
• jednotné SLA;
• zrozumiteľnú analytiku;
• stabilné KPI;
• spoločnú databázu znalostí;
• porovnateľnosť medzi verziami;
• preklad rozhrania bez zmeny logiky;
• integráciu s externými systémami.

Štruktúra kánonu

canon_id: no_hourly_archive
name: 'Hourly archive is missing'
domain: archive
default_owner_zone: backend_integration
default_priority: P1
actionable: true
verification_mode: data
sla_policy: archive_p1
suppression_group: communication_archive
knowledge_tags:
  - archive
  - delivery
  - communication

Základná sada kánonov

Verziovanie kánonov

Zmena textu alebo prekladu si nevyžaduje zmenu identifikátora.

Nová verzia kánonu je potrebná, ak sa mení:

• biznisový význam;
• pravidlo priradenia;
• kritérium actionability;
• spôsob verifikácie;
• princíp SLA;
• logika zlučovania s inými problémami.

Analytika kvality detektorov

Operational Health Matrix hodnotí nielen zariadenia, ale aj kvalitu vlastných analytických algoritmov.

Pre každý Detector systém počíta:

• Accuracy;
• Precision;
• Recall;
• False Positive Rate;
• False Negative Rate;
• priemernú mieru istoty;
• Drift;
• Stability;
• priemerný čas verifikácie;
• podiel prijatých odporúčaní.

Takýto prístup umožňuje priebežne zlepšovať analytický model Platformy IIoT bez narušenia reprodukovateľnosti výsledkov.

Samotné portfólio detektorov sa rozvíja podľa etapovej roadmapy: nové detektory sa zavádzajú vo vlnách a každá vlna sa otvára podľa pripravenosti príslušných API platformy.