Skip to main content
本文档提供了 Dify Enterprise 通过数据推送功能发出的所有遥测信号的快速参考。

资源属性 (Resource Attributes)

附加到每个信号(Span、Metric、Log)上。

链路追踪 (Traces / Spans)

dify.workflow.run

dify.node.execution

dify.node.execution.draft

属性与 dify.node.execution 相同。在预览/调试运行时发出。

计数器 (Counters)

所有计数器都是累积的,并以 100% 的准确率发出。

Token 计数器

标签 (Labels): tenant_id, app_id, operation_type, model_provider, model_name, node_type (如果是 node_execution)
警告: 工作流级别的 dify.tokens.total 包含所有 node_execution 的 Token。请通过 operation_type 进行过滤以避免重复计算。

Token 层级与查询模式

Token 指标在多个层级发出。理解层级结构可以防止重复计算:
关键规则: workflow Token 已经包含了所有 node_execution 的 Token。切勿将两者相加。
  • Token 指标上的可用标签: tenant_id, app_id, operation_type, model_provider, model_name, node_type
  • 应用名称 仅在 Span 属性 (dify.app.name) 上可用,不在指标标签上 —— 指标查询请使用 app_id
常用查询 (PromQL):
从应用名称查找 app_id (Trace 查询 — Tempo / Jaeger):

请求计数器

按类型分类的标签:

错误计数器

按类型分类的标签:

其他计数器


直方图 (Histograms)


结构化日志 (Structured Logs)

Span 伴随日志 (Span Companion Logs)

伴随 Span 的日志。信号类型: span_detail

dify.workflow.run 伴随日志

通用属性: 所有 Span 属性(见 Traces 部分)加上: 事件属性:
  • dify.event.name: dify.workflow.run
  • dify.event.signal: span_detail
  • trace_id, span_id, tenant_id, user_id

dify.node.execution 和 dify.node.execution.draft 伴随日志

通用属性: 所有 Span 属性(见 Traces 部分)加上: 事件属性:
  • dify.event.name: dify.node.executiondify.node.execution.draft
  • dify.event.signal: span_detail
  • trace_id, span_id, tenant_id, user_id

独立日志 (Standalone Logs)

没有结构化 Span 的日志。信号类型: metric_only

dify.message.run

dify.tool.execution

dify.moderation.check

dify.suggested_question.generation

dify.dataset.retrieval

dify.generate_name.execution

dify.prompt_generation.execution

dify.app.created

dify.app.updated

dify.app.deleted

dify.feedback.created

dify.telemetry.rehydration_failed

用于遥测系统健康监控的诊断事件。

内容门控属性 (Content-Gated Attributes)

ENTERPRISE_INCLUDE_CONTENT=false 时,这些属性将被替换为引用字符串 (ref:{id_type}={uuid})。

附录 (Appendix)

操作类型 (Operation Types)

workflow, node_execution, message, rule_generate, code_generate, structured_output, instruction_modify

节点类型 (Node Types)

start, end, answer, llm, knowledge-retrieval, knowledge-index, if-else, code, template-transform, question-classifier, http-request, tool, datasource, variable-aggregator, loop, iteration, parameter-extractor, assigner, document-extractor, list-operator, agent, trigger-webhook, trigger-schedule, trigger-plugin, human-input

工作流状态 (Workflow Statuses)

running, succeeded, failed, stopped, partial-succeeded, paused

载荷类型 (Payload Types)

workflow, node, message, tool, moderation, suggested_question, dataset_retrieval, generate_name, prompt_generation, app, feedback

空值行为 (Null Value Behavior)

  • Spans: 具有空值的属性将被省略。
  • Logs: 具有空值的属性在 JSON 中显示为 null
  • Content-Gated: 被替换为引用字符串,而不是设置为 null。