メインコンテンツへスキップ
このドキュメントは、データプッシュ機能を通じてDify Enterpriseから送信されるすべてのテレメトリシグナルのクイックリファレンスを提供します。

リソース属性 (Resource Attributes)

すべてのシグナル(Span、Metric、Log)に付与されます。
属性タイプ
service.namestringdify
host.namestringdify-api-7f8b

トレース (Traces / Spans)

dify.workflow.run

属性タイプ説明
dify.trace_idstring業務トレース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_fromstringapiwebappdebug
dify.conversation.idstring会話ID(オプション)
dify.message.idstringメッセージID(オプション)
dify.invoked_bystring実行をトリガーしたユーザーID
gen_ai.usage.total_tokensint全ノードの総トークン数(オプション)
gen_ai.user.idstringエンドユーザー識別子(オプション)
dify.parent.trace_idstring親ワークフローのトレースID(オプション)
dify.parent.workflow.run_idstring親ワークフローの実行ID(オプション)
dify.parent.node.execution_idstring親ノードの実行ID(オプション)
dify.parent.app.idstring親アプリID(オプション)

dify.node.execution

属性タイプ説明
dify.trace_idstring業務トレース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プロンプトトークン数(LLMノードのみ)
gen_ai.usage.output_tokensint完了トークン数(LLMノードのみ)
gen_ai.usage.total_tokensint総トークン数(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 Counters)

メトリック (Metric)単位説明
dify.tokens.total{token}消費された総トークン数
dify.tokens.input{token}入力(プロンプト)トークン数
dify.tokens.output{token}出力(完了)トークン数
ラベル (Labels): tenant_id, app_id, operation_type, model_provider, model_name, node_type (node_execution の場合)
警告: ワークフローレベルの dify.tokens.total には、すべての node_execution トークンが含まれています。二重計上を避けるため、operation_type でフィルタリングしてください。

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

トークンメトリックは複数のレイヤーで送信されます。階層構造を理解することで、二重計上を防ぐことができます:
App-level total (アプリレベル合計)
├── workflow          ← すべての node_execution トークンの合計(両方を足さないでください)
│   └── node_execution ← ノードごとの内訳
├── message           ← 独立(非ワークフローのチャットアプリのみ)
├── rule_generate     ← 独立したヘルパーLLM呼び出し
├── code_generate     ← 独立したヘルパーLLM呼び出し
├── structured_output ← 独立したヘルパーLLM呼び出し
└── instruction_modify← 独立したヘルパーLLM呼び出し
重要なルール: workflow トークンには、すでにすべての node_execution トークンが含まれています。決して両方を合計しないでください。
  • トークンメトリックで使用可能なラベル: tenant_id, app_id, operation_type, model_provider, model_name, node_type
  • アプリ名 はスパン属性(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"})

# ── ドリルダウン ──────────────────────────────────────────────
# アプリのワークフローレベルのトークン
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>"})

# ── レート ───────────────────────────────────────────────────
# トークン消費率(1時間あたり)
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)

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

メトリック (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

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

メトリック (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

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

メトリック (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 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.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 コンパニオンログ

共通属性: すべてのスパン属性(トレースセクション参照)に加えて: イベント属性:
  • dify.event.name: dify.node.execution または dify.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)

構造化スパンを持たないログ。シグナルタイプ: metric_only

dify.message.run

属性タイプ説明
dify.event.namestringdify.message.run
dify.event.signalstringmetric_only
trace_idstringOTELトレースID(32文字16進数)
span_idstringOTELスパンID(16文字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入力トークン数
gen_ai.usage.output_tokensint出力トークン数
gen_ai.usage.total_tokensint総トークン数
dify.message.statusstringsucceeded(成功)、failed(失敗)
dify.message.errorstringエラーメッセージ(失敗時)
dify.message.durationfloat所要時間(秒)
dify.message.time_to_first_tokenfloatTTFT(秒)
dify.message.inputsstring/JSON入力(コンテンツゲート制御)
dify.message.outputsstring/JSON出力(コンテンツゲート制御)

dify.tool.execution

属性タイプ説明
dify.event.namestringdify.tool.execution
dify.event.signalstringmetric_only
trace_idstringOTELトレースID
span_idstringOTELスパン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トレースID
span_idstringOTELスパン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トレースID
span_idstringOTELスパン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トレースID
span_idstringOTELスパンID
tenant_idstringテナント識別子
dify.app_idstringアプリケーション識別子
dify.message.idstringメッセージ識別子
dify.dataset.idstringデータセット識別子
dify.dataset.namestringデータセット名
dify.dataset.embedding_providersJSON array埋め込みモデルプロバイダー(データセットごとに1つ)
dify.dataset.embedding_modelsJSON array埋め込みモデル(データセットごとに1つ)
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トレースID
span_idstringOTELスパン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トレースID
span_idstringOTELスパンID
tenant_idstringテナント識別子
dify.app_idstringアプリケーション識別子
dify.prompt_generation.operation_typestring操作タイプ(付録参照)
gen_ai.provider.namestringLLMプロバイダー
gen_ai.request.modelstringLLMモデル
gen_ai.usage.input_tokensint入力トークン数
gen_ai.usage.output_tokensint出力トークン数
gen_ai.usage.total_tokensint総トークン数
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トレースID
span_idstringOTELスパン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値の動作 (Null Value Behavior)

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