dify/api/core
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
..
agent refactor(telemetry): migrate to type-safe enum-based event routing with centralized enterprise filtering 2026-02-05 20:15:12 -08:00
app refactor(telemetry): simplify by eliminating TelemetryFacade 2026-02-05 22:41:09 -08:00
base feat: knowledge pipeline (#25360) 2025-09-18 12:49:10 +08:00
callback_handler refactor(telemetry): simplify by eliminating TelemetryFacade 2026-02-05 22:41:09 -08:00
datasource refactor: replace request.args.get with Pydantic BaseModel validation (#31104) 2026-01-27 10:48:42 +08:00
db fix(db): parameterize sessionmaker with Session (#30612) 2026-01-06 15:23:50 +08:00
entities revert: revert human input relevant code (#31766) 2026-01-30 19:18:49 +08:00
errors chore: add ast-grep rule to convert Optional[T] to T | None (#25560) 2025-09-15 13:06:33 +08:00
extension change all to httpx (#26119) 2025-10-10 23:41:16 +08:00
external_data_tool chore: add ast-grep rule to convert Optional[T] to T | None (#25560) 2025-09-15 13:06:33 +08:00
file refactor(typing): Fixup typing A2 - workflow engine & nodes (#31723) 2026-01-31 18:00:56 +09:00
helper refactor(typing): Fixup typing A2 - workflow engine & nodes (#31723) 2026-01-31 18:00:56 +09:00
llm_generator refactor(telemetry): simplify by eliminating TelemetryFacade 2026-02-05 22:41:09 -08:00
logging feat(enterprise): Add OTEL telemetry with slim traces, metrics, and structured logs 2026-02-05 20:12:28 -08:00
mcp chore(typing): reduce ty excludes for A1 (#31721) 2026-01-30 02:38:57 +08:00
memory refactor:Decouple Domain Models from Direct Database Access (#27316) 2025-10-28 09:59:30 +08:00
model_runtime fix(i18n): improve Chinese translation of Max Tokens (#31771) 2026-01-30 20:19:35 +08:00
moderation refactor(telemetry): simplify by eliminating TelemetryFacade 2026-02-05 22:41:09 -08:00
ops refactor(telemetry): migrate to type-safe enum-based event routing with centralized enterprise filtering 2026-02-05 20:15:12 -08:00
plugin revert: revert human input relevant code (#31766) 2026-01-30 19:18:49 +08:00
prompt Feat/support multimodal embedding (#29115) 2025-12-09 14:41:46 +08:00
rag refactor(telemetry): simplify by eliminating TelemetryFacade 2026-02-05 22:41:09 -08:00
repositories revert: revert human input relevant code (#31766) 2026-01-30 19:18:49 +08:00
schemas refactor(typing): Fixup typing A2 - workflow engine & nodes (#31723) 2026-01-31 18:00:56 +09:00
telemetry refactor(telemetry): simplify by eliminating TelemetryFacade 2026-02-05 22:41:09 -08:00
tools feat: Add parent trace context propagation for workflow-as-tool hierarchy 2026-02-05 20:19:29 -08:00
trigger fix(redis): Redis Cluster eval errors by adding hash tags to trigger debug keys (#31701) 2026-01-30 16:05:02 +08:00
variables refactor(variables): clarify base vs union type naming (#30634) 2026-01-13 23:39:34 +09:00
workflow feat(telemetry): add input/output token split to enterprise OTEL traces 2026-02-05 20:12:30 -08:00
__init__.py Fix basedpyright type errors (#25435) 2025-09-10 01:54:26 +08:00
hosting_configuration.py feat: credit pool (#30720) 2026-01-08 13:17:30 +08:00
indexing_runner.py refactor: port api/controllers/console/datasets/datasets_document.py api/controllers/service_api/app/annotation.py api/core/app/app_config/easy_ui_based_app/agent/manager.py api/core/app/apps/pipeline/pipeline_generator.py api/core/workflow/nodes/knowledge_retrieval/knowledge_retrieval_node.py to match case (#31832) 2026-02-02 19:07:30 +09:00
model_manager.py Feat/support multimodal embedding (#29115) 2025-12-09 14:41:46 +08:00
provider_manager.py feat: credit pool (#30720) 2026-01-08 13:17:30 +08:00