dify/api/tasks
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
..
annotation refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
rag_pipeline refactor(api): clarify published RAG pipeline invoke naming (#30644) 2026-01-06 23:48:06 +09:00
workflow_cfs_scheduler feat: introduce trigger functionality (#27644) 2025-11-12 17:59:37 +08:00
__init__.py feat: mypy for all type check (#10921) 2024-12-24 18:38:51 +08:00
add_document_to_index_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
async_workflow_tasks.py revert: revert human input relevant code (#31766) 2026-01-30 19:18:49 +08:00
batch_clean_document_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
batch_create_segment_to_index_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
clean_dataset_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
clean_document_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
clean_notion_document_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
create_segment_to_index_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
deal_dataset_index_update_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
deal_dataset_vector_index_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
delete_account_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
delete_conversation_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
delete_segment_from_index_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
disable_segment_from_index_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
disable_segments_from_index_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
document_indexing_sync_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
document_indexing_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
document_indexing_update_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
duplicate_document_indexing_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
enable_segment_to_index_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
enable_segments_to_index_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
enterprise_telemetry_task.py refactor(telemetry): simplify by eliminating TelemetryFacade 2026-02-05 22:41:09 -08:00
generate_summary_index_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
mail_account_deletion_task.py remove bare list, dict, Sequence, None, Any (#25058) 2025-09-06 03:32:23 +08:00
mail_change_mail_task.py remove bare list, dict, Sequence, None, Any (#25058) 2025-09-06 03:32:23 +08:00
mail_email_code_login.py remove bare list, dict, Sequence, None, Any (#25058) 2025-09-06 03:32:23 +08:00
mail_inner_task.py fix: remote code execution in email endpoints (#25753) 2025-09-18 16:45:34 +08:00
mail_invite_member_task.py remove bare list, dict, Sequence, None, Any (#25058) 2025-09-06 03:32:23 +08:00
mail_owner_transfer_task.py remove bare list, dict, Sequence, None, Any (#25058) 2025-09-06 03:32:23 +08:00
mail_register_task.py Feat/email register refactor (#25369) 2025-09-12 10:24:54 +08:00
mail_reset_password_task.py Feat/email register refactor (#25369) 2025-09-12 10:24:54 +08:00
ops_trace_task.py refactor(telemetry): simplify by eliminating TelemetryFacade 2026-02-05 22:41:09 -08:00
process_tenant_plugin_autoupgrade_check_task.py chore: increase plugin cache ttl to 1 hour (#31552) 2026-01-26 19:48:33 +08:00
recover_document_indexing_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
regenerate_summary_index_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
remove_app_and_related_data_task.py feat: archive workflow run logs backend (#31310) 2026-01-23 13:11:56 +08:00
remove_document_from_index_task.py feat: Add summary index for knowledge. (#31625) 2026-01-29 13:47:35 +08:00
retry_document_indexing_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
sync_website_document_indexing_task.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
trigger_processing_tasks.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
trigger_subscription_refresh_tasks.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
workflow_draft_var_tasks.py fix: drop useless logger code (#26650) 2025-10-09 09:24:10 +08:00
workflow_execution_tasks.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
workflow_node_execution_tasks.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00
workflow_schedule_tasks.py refactor: use session factory instead of call db.session directly (#31198) 2026-01-21 13:43:06 +08:00