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 Counters)

ラベル (Labels): tenant_id, app_id, operation_type, model_provider, model_name, node_type (node_execution の場合)
警告: ワークフローレベルの dify.tokens.total には、すべての node_execution トークンが含まれています。二重計上を避けるため、operation_type でフィルタリングしてください。

トークン階層とクエリパターン

トークンメトリックは複数のレイヤーで送信されます。階層構造を理解することで、二重計上を防ぐことができます:
重要なルール: workflow トークンには、すでにすべての node_execution トークンが含まれています。決して両方を合計しないでください。
  • トークンメトリックで使用可能なラベル: tenant_id, app_id, operation_type, model_provider, model_name, node_type
  • アプリ名 はスパン属性(dify.app.name)でのみ利用可能で、メトリックラベルにはありません。メトリッククエリには app_id を使用してください。
一般的なクエリ (PromQL):
アプリ名から app_id を検索する (Trace クエリ — Tempo / Jaeger):

リクエストカウンター (Request Counters)

タイプ別のラベル:

エラーカウンター (Error Counters)

タイプ別のラベル:

その他のカウンター (Other Counters)


ヒストグラム (Histograms)


構造化ログ (Structured Logs)

スパンコンパニオンログ (Span Companion Logs)

スパンに付随するログ。シグナルタイプ: span_detail

dify.workflow.run コンパニオンログ

共通属性: すべてのスパン属性(トレースセクション参照)に加えて: イベント属性:
  • 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 コンパニオンログ

共通属性: すべてのスパン属性(トレースセクション参照)に加えて: イベント属性:
  • dify.event.name: dify.node.execution または dify.node.execution.draft
  • dify.event.signal: span_detail
  • trace_id, span_id, tenant_id, user_id

スタンドアロンログ (Standalone Logs)

構造化スパンを持たないログ。シグナルタイプ: 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値の動作 (Null Value Behavior)

  • Spans: Null値を持つ属性は省略されます。
  • Logs: Null値を持つ属性はJSON内で null として表示されます。
  • Content-Gated: nullに設定されるのではなく、参照文字列に置き換えられます。