跳转到主要内容
本文档提供了 Dify Enterprise 通过数据推送功能发出的所有遥测信号的快速参考。

资源属性 (Resource Attributes)

附加到每个信号(Span、Metric、Log)上。
属性类型示例
service.namestringdify
host.namestringdify-api-7f8b

链路追踪 (Traces / Spans)

dify.workflow.run

属性类型描述
dify.trace_idstring业务 Trace ID (工作流运行 ID)
dify.tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.workflow.idstring工作流定义 ID
dify.workflow.run_idstring本次运行的唯一 ID
dify.workflow.statusstringsucceeded (成功), failed (失败), stopped (停止) 等
dify.workflow.errorstring失败时的错误信息
dify.workflow.elapsed_timefloat总执行时间(秒)
dify.invoke_fromstringapi, webapp, debug
dify.conversation.idstring会话 ID(可选)
dify.message.idstring消息 ID(可选)
dify.invoked_bystring触发运行的用户 ID
gen_ai.usage.total_tokensint所有节点的总 Token 数(可选)
gen_ai.user.idstring终端用户标识符(可选)
dify.parent.trace_idstring父工作流 Trace ID(可选)
dify.parent.workflow.run_idstring父工作流运行 ID(可选)
dify.parent.node.execution_idstring父节点执行 ID(可选)
dify.parent.app.idstring父应用 ID(可选)

dify.node.execution

属性类型描述
dify.trace_idstring业务 Trace ID
dify.tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.workflow.idstring工作流定义 ID
dify.workflow.run_idstring工作流运行 ID
dify.message.idstring消息 ID(可选)
dify.conversation.idstring会话 ID(可选)
dify.node.execution_idstring唯一节点执行 ID
dify.node.idstring工作流图中的节点 ID
dify.node.typestring节点类型(见附录)
dify.node.titlestring显示标题
dify.node.statusstringsucceeded (成功), failed (失败)
dify.node.errorstring失败时的错误信息
dify.node.elapsed_timefloat执行时间(秒)
dify.node.indexint执行顺序索引
dify.node.predecessor_node_idstring触发节点 ID
dify.node.iteration_idstring迭代 ID(可选)
dify.node.loop_idstring循环 ID(可选)
dify.node.parallel_idstring并行分支 ID(可选)
dify.node.invoked_bystring触发执行的用户 ID
gen_ai.usage.input_tokensint提示词 Token 数(仅限 LLM 节点)
gen_ai.usage.output_tokensint补全 Token 数(仅限 LLM 节点)
gen_ai.usage.total_tokensint总 Token 数(仅限 LLM 节点)
gen_ai.request.modelstringLLM 模型名称(仅限 LLM 节点)
gen_ai.provider.namestringLLM 提供商名称(仅限 LLM 节点)
gen_ai.user.idstring终端用户标识符(可选)

dify.node.execution.draft

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

计数器 (Counters)

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

Token 计数器

指标 (Metric)单位描述
dify.tokens.total{token}消耗的总 Token 数
dify.tokens.input{token}输入 (提示词) Token 数
dify.tokens.output{token}输出 (补全) 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 指标在多个层级发出。理解层级结构可以防止重复计算:
App-level total (应用级总计)
├── workflow          ← 所有 node_execution token 的总和 (不要同时相加)
│   └── node_execution ← 每个节点的细分
├── message           ← 独立 (仅限非工作流聊天应用)
├── rule_generate     ← 独立辅助 LLM 调用
├── code_generate     ← 独立辅助 LLM 调用
├── structured_output ← 独立辅助 LLM 调用
└── instruction_modify← 独立辅助 LLM 调用
关键规则: 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):
# ── 总计 ──────────────────────────────────────────────────
# 应用级总计 (排除 node_execution 以避免重复计算)
sum by (app_id) (dify_tokens_total{operation_type!="node_execution"})

# 单个应用总计
sum (dify_tokens_total{app_id="<app_id>", operation_type!="node_execution"})

# 租户级总计
sum by (tenant_id) (dify_tokens_total{operation_type!="node_execution"})

# ── 下钻分析 ──────────────────────────────────────────────
# 应用的工作流级 Token
sum (dify_tokens_total{app_id="<app_id>", operation_type="workflow"})

# 应用内的节点级细分
sum by (node_type) (dify_tokens_total{app_id="<app_id>", operation_type="node_execution"})

# 应用的模型细分
sum by (model_provider, model_name) (dify_tokens_total{app_id="<app_id>"})

# 每个模型的输入 vs 输出
sum by (model_name) (dify_tokens_input_total{app_id="<app_id>"})
sum by (model_name) (dify_tokens_output_total{app_id="<app_id>"})

# ── 速率 ───────────────────────────────────────────────────
# Token 消耗率 (每小时)
sum(rate(dify_tokens_total{operation_type!="node_execution"}[1h]))

# 每个应用的消耗率
sum by (app_id) (rate(dify_tokens_total{operation_type!="node_execution"}[1h]))
从应用名称查找 app_id (Trace 查询 — Tempo / Jaeger):
{ resource.dify.app.name = "My Chatbot" } | select(resource.dify.app.id)

请求计数器

指标 (Metric)单位描述
dify.requests.total{request}总操作次数
按类型分类的标签:
类型 (Type)附加标签
workflowtenant_id, app_id, status, invoke_from
nodetenant_id, app_id, node_type, model_provider, model_name, status
draft_nodetenant_id, app_id, node_type, model_provider, model_name, status
messagetenant_id, app_id, model_provider, model_name, status, invoke_from
tooltenant_id, app_id, tool_name
moderationtenant_id, app_id
suggested_questiontenant_id, app_id, model_provider, model_name
dataset_retrievaltenant_id, app_id
generate_nametenant_id, app_id
prompt_generationtenant_id, app_id, operation_type, model_provider, model_name, status

错误计数器

指标 (Metric)单位描述
dify.errors.total{error}总失败操作数
按类型分类的标签:
类型 (Type)附加标签
workflowtenant_id, app_id
nodetenant_id, app_id, node_type, model_provider, model_name
draft_nodetenant_id, app_id, node_type, model_provider, model_name
messagetenant_id, app_id, model_provider, model_name
tooltenant_id, app_id, tool_name
prompt_generationtenant_id, app_id, operation_type, model_provider, model_name

其他计数器

指标 (Metric)单位标签
dify.feedback.total{feedback}tenant_id, app_id, rating
dify.dataset.retrievals.total{retrieval}tenant_id, app_id, dataset_id, embedding_model_provider, embedding_model, rerank_model_provider, rerank_model
dify.app.created.total{app}tenant_id, app_id, mode
dify.app.updated.total{app}tenant_id, app_id
dify.app.deleted.total{app}tenant_id, app_id

直方图 (Histograms)

指标 (Metric)单位标签
dify.workflow.durationstenant_id, app_id, status
dify.node.durationstenant_id, app_id, node_type, model_provider, model_name, plugin_name
dify.message.durationstenant_id, app_id, model_provider, model_name
dify.message.time_to_first_tokenstenant_id, app_id, model_provider, model_name
dify.tool.durationstenant_id, app_id, tool_name
dify.prompt_generation.durationstenant_id, app_id, operation_type, model_provider, model_name

结构化日志 (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.app.namestring应用显示名称
dify.workspace.namestring工作区显示名称
dify.workflow.versionstring工作流定义版本
dify.workflow.inputsstring/JSON输入参数(受内容门控控制)
dify.workflow.outputsstring/JSON输出结果(受内容门控控制)
dify.workflow.querystring用户查询文本(受内容门控控制)

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
附加属性类型始终存在描述
dify.app.namestring应用显示名称
dify.workspace.namestring工作区显示名称
dify.invoke_fromstring调用来源
gen_ai.tool.namestring工具名称(仅限工具节点)
dify.node.total_pricefloat成本(仅限 LLM 节点)
dify.node.currencystring货币代码(仅限 LLM 节点)
dify.node.iteration_indexint迭代索引(迭代节点)
dify.node.loop_indexint循环索引(循环节点)
dify.plugin.namestring插件名称(工具/知识库节点)
dify.credential.namestring凭证名称(插件节点)
dify.credential.idstring凭证 ID(插件节点)
dify.dataset.idsJSON array数据集 ID(知识库节点)
dify.dataset.namesJSON array数据集名称(知识库节点)
dify.node.inputsstring/JSON节点输入(受内容门控控制)
dify.node.outputsstring/JSON节点输出(受内容门控控制)
dify.node.process_datastring/JSON处理数据(受内容门控控制)

独立日志 (Standalone Logs)

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

dify.message.run

属性类型描述
dify.event.namestringdify.message.run
dify.event.signalstringmetric_only
trace_idstringOTEL Trace ID (32位十六进制)
span_idstringOTEL Span ID (16位十六进制)
tenant_idstring租户标识符
user_idstring用户标识符(可选)
dify.app_idstring应用标识符
dify.message.idstring消息标识符
dify.conversation.idstring会话 ID(可选)
dify.workflow.run_idstring工作流运行 ID(可选)
dify.invoke_fromstringservice-api, web-app, debugger, explore
gen_ai.provider.namestringLLM 提供商
gen_ai.request.modelstringLLM 模型
gen_ai.usage.input_tokensint输入 Token 数
gen_ai.usage.output_tokensint输出 Token 数
gen_ai.usage.total_tokensint总 Token 数
dify.message.statusstringsucceeded (成功), failed (失败)
dify.message.errorstring错误信息(如果失败)
dify.message.durationfloat持续时间(秒)
dify.message.time_to_first_tokenfloat首字时间 (TTFT)(秒)
dify.message.inputsstring/JSON输入(受内容门控控制)
dify.message.outputsstring/JSON输出(受内容门控控制)

dify.tool.execution

属性类型描述
dify.event.namestringdify.tool.execution
dify.event.signalstringmetric_only
trace_idstringOTEL Trace ID
span_idstringOTEL Span ID
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.message.idstring消息标识符
dify.tool.namestring工具名称
dify.tool.durationfloat持续时间(秒)
dify.tool.statusstringsucceeded (成功), failed (失败)
dify.tool.errorstring错误信息(如果失败)
dify.tool.inputsstring/JSON输入(受内容门控控制)
dify.tool.outputsstring/JSON输出(受内容门控控制)
dify.tool.parametersstring/JSON参数(受内容门控控制)
dify.tool.configstring/JSON配置(受内容门控控制)

dify.moderation.check

属性类型描述
dify.event.namestringdify.moderation.check
dify.event.signalstringmetric_only
trace_idstringOTEL Trace ID
span_idstringOTEL Span ID
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.message.idstring消息标识符
dify.moderation.typestringinput (输入), output (输出)
dify.moderation.actionstringpass (通过), block (拦截), flag (标记)
dify.moderation.flaggedboolean是否被标记
dify.moderation.categoriesJSON array被标记的类别
dify.moderation.querystring内容(受内容门控控制)

dify.suggested_question.generation

属性类型描述
dify.event.namestringdify.suggested_question.generation
dify.event.signalstringmetric_only
trace_idstringOTEL Trace ID
span_idstringOTEL Span ID
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.message.idstring消息标识符
dify.suggested_question.countint问题数量
dify.suggested_question.durationfloat持续时间(秒)
dify.suggested_question.statusstringsucceeded (成功), failed (失败)
dify.suggested_question.errorstring错误信息(如果失败)
dify.suggested_question.questionsJSON array问题(受内容门控控制)

dify.dataset.retrieval

属性类型描述
dify.event.namestringdify.dataset.retrieval
dify.event.signalstringmetric_only
trace_idstringOTEL Trace ID
span_idstringOTEL Span ID
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.message.idstring消息标识符
dify.dataset.idstring数据集标识符
dify.dataset.namestring数据集名称
dify.dataset.embedding_providersJSON array嵌入模型提供商(每个数据集一个)
dify.dataset.embedding_modelsJSON array嵌入模型(每个数据集一个)
dify.retrieval.rerank_providerstring重排模型提供商
dify.retrieval.rerank_modelstring重排模型名称
dify.retrieval.querystring搜索查询(受内容门控控制)
dify.retrieval.document_countint检索到的文档数
dify.retrieval.durationfloat持续时间(秒)
dify.retrieval.statusstringsucceeded (成功), failed (失败)
dify.retrieval.errorstring错误信息(如果失败)
dify.dataset.documentsJSON array文档(受内容门控控制)

dify.generate_name.execution

属性类型描述
dify.event.namestringdify.generate_name.execution
dify.event.signalstringmetric_only
trace_idstringOTEL Trace ID
span_idstringOTEL Span ID
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.conversation.idstring会话标识符
dify.generate_name.durationfloat持续时间(秒)
dify.generate_name.statusstringsucceeded (成功), failed (失败)
dify.generate_name.errorstring错误信息(如果失败)
dify.generate_name.inputsstring/JSON输入(受内容门控控制)
dify.generate_name.outputsstring生成的名称(受内容门控控制)

dify.prompt_generation.execution

属性类型描述
dify.event.namestringdify.prompt_generation.execution
dify.event.signalstringmetric_only
trace_idstringOTEL Trace ID
span_idstringOTEL Span ID
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.prompt_generation.operation_typestring操作类型(见附录)
gen_ai.provider.namestringLLM 提供商
gen_ai.request.modelstringLLM 模型
gen_ai.usage.input_tokensint输入 Token 数
gen_ai.usage.output_tokensint输出 Token 数
gen_ai.usage.total_tokensint总 Token 数
dify.prompt_generation.durationfloat持续时间(秒)
dify.prompt_generation.statusstringsucceeded (成功), failed (失败)
dify.prompt_generation.errorstring错误信息(如果失败)
dify.prompt_generation.instructionstring指令(受内容门控控制)
dify.prompt_generation.outputstring/JSON输出(受内容门控控制)

dify.app.created

属性类型描述
dify.event.namestringdify.app.created
dify.event.signalstringmetric_only
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.app.modestringchat, completion, agent-chat, workflow
dify.app.created_atstring时间戳 (ISO 8601)

dify.app.updated

属性类型描述
dify.event.namestringdify.app.updated
dify.event.signalstringmetric_only
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.app.updated_atstring时间戳 (ISO 8601)

dify.app.deleted

属性类型描述
dify.event.namestringdify.app.deleted
dify.event.signalstringmetric_only
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.app.deleted_atstring时间戳 (ISO 8601)

dify.feedback.created

属性类型描述
dify.event.namestringdify.feedback.created
dify.event.signalstringmetric_only
trace_idstringOTEL Trace ID
span_idstringOTEL Span ID
tenant_idstring租户标识符
dify.app_idstring应用标识符
dify.message.idstring消息标识符
dify.feedback.ratingstringlike (点赞), dislike (点踩), null
dify.feedback.contentstring反馈文本(受内容门控控制)
dify.feedback.created_atstring时间戳 (ISO 8601)

dify.telemetry.rehydration_failed

用于遥测系统健康监控的诊断事件。
属性类型描述
dify.event.namestringdify.telemetry.rehydration_failed
dify.event.signalstringmetric_only
tenant_idstring租户标识符
dify.telemetry.errorstring错误信息
dify.telemetry.payload_typestring载荷类型(见附录)
dify.telemetry.correlation_idstring关联 ID

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

ENTERPRISE_INCLUDE_CONTENT=false 时,这些属性将被替换为引用字符串 (ref:{id_type}={uuid})。
属性信号
dify.workflow.inputsdify.workflow.run
dify.workflow.outputsdify.workflow.run
dify.workflow.querydify.workflow.run
dify.node.inputsdify.node.execution
dify.node.outputsdify.node.execution
dify.node.process_datadify.node.execution
dify.message.inputsdify.message.run
dify.message.outputsdify.message.run
dify.tool.inputsdify.tool.execution
dify.tool.outputsdify.tool.execution
dify.tool.parametersdify.tool.execution
dify.tool.configdify.tool.execution
dify.moderation.querydify.moderation.check
dify.suggested_question.questionsdify.suggested_question.generation
dify.retrieval.querydify.dataset.retrieval
dify.dataset.documentsdify.dataset.retrieval
dify.generate_name.inputsdify.generate_name.execution
dify.generate_name.outputsdify.generate_name.execution
dify.prompt_generation.instructiondify.prompt_generation.execution
dify.prompt_generation.outputdify.prompt_generation.execution
dify.feedback.contentdify.feedback.created

附录 (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。