dify/api/core/rag
GareArc 4a9b74f86b
refactor(telemetry): simplify by eliminating TelemetryFacade
**Problem:**
The telemetry system had unnecessary abstraction layers and bad practices
from the last 3 commits introducing the gateway implementation:
- TelemetryFacade class wrapper around emit() function
- String literals instead of SignalType enum
- Dictionary mapping enum → string instead of enum → enum
- Unnecessary ENTERPRISE_TELEMETRY_GATEWAY_ENABLED feature flag
- Duplicate guard checks scattered across files
- Non-thread-safe TelemetryGateway singleton pattern
- Missing guard in ops_trace_task.py causing RuntimeError spam

**Solution:**
1. Deleted TelemetryFacade - replaced with thin emit() function in core/telemetry/__init__.py
2. Added SignalType enum ('trace' | 'metric_log') to enterprise/telemetry/contracts.py
3. Replaced CASE_TO_TRACE_TASK_NAME dict with CASE_TO_TRACE_TASK: dict[TelemetryCase, TraceTaskName]
4. Deleted is_gateway_enabled() and _emit_legacy() - using existing ENTERPRISE_ENABLED + ENTERPRISE_TELEMETRY_ENABLED instead
5. Extracted _should_drop_ee_only_event() helper to eliminate duplicate checks
6. Moved TelemetryGateway singleton to ext_enterprise_telemetry.py:
   - Init once in init_app() for thread-safety
   - Access via get_gateway() function
7. Re-added guard to ops_trace_task.py to prevent RuntimeError when EE=OFF but CE tracing enabled
8. Updated 11 caller files to import 'emit as telemetry_emit' instead of 'TelemetryFacade'

**Result:**
- 322 net lines deleted (533 removed, 211 added)
- All 91 tests pass
- Thread-safe singleton pattern
- Cleaner API surface: from TelemetryFacade.emit() to telemetry_emit()
- Proper enum usage throughout
- No RuntimeError spam in EE=OFF + CE=ON scenario
2026-02-05 22:41:09 -08:00
..
cleaner fix: [xxx](xxx) render as xxx](xxx) (#30392) 2025-12-31 10:30:15 +08:00
data_post_processor Feat/support multimodal embedding (#29115) 2025-12-09 14:41:46 +08:00
datasource feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
docstore chore: use from __future__ import annotations (#30254) 2026-01-06 23:57:20 +09:00
embedding feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
entities feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
extractor fix: SSRF in WordExtractor URL download (credit to @EaEa0001 ) (#31678) 2026-01-29 14:01:21 +08:00
index_processor fix: summary index bug (#31810) 2026-02-02 09:45:17 +08:00
models Feat/support multimodal embedding (#29115) 2025-12-09 14:41:46 +08:00
pipeline chore: use from __future__ import annotations (#30254) 2026-01-06 23:57:20 +09:00
rerank Feat/support multimodal embedding (#29115) 2025-12-09 14:41:46 +08:00
retrieval refactor(telemetry): simplify by eliminating TelemetryFacade 2026-02-05 22:41:09 -08:00
splitter fix 29184 (#29188) 2025-12-18 17:11:52 +08:00
__init__.py Feat/dify rag (#2528) 2024-02-22 23:31:57 +08:00