Dify 1.19.0: 중첩된 워크플로우 트레이싱과 세 가지 변경 사항이 기업 운영에 가져올 것

기존에는 Dify에서 워크플로우가 호출하는 Workflow Tool 내부에서 무슨 일이 벌어지고 있는지, 오직 “Tool 스팬이 통과함” 또는 “Tool 스팬이 실패함”만 확인할 수 있었습니다. 내부의 LLM Call이나 단계(step)를 추적할 수 없었습니다. v1.19.0에서 이것이 변경되었습니다.

この記事で分かること：

Dify 1.19.0 (2026-11-04 출시)의 세 가지 주요 변경 사항
중첩된 워크플로우 트레이싱 메커니즘과 실무 활용처
업그레이드 전에 확인해야 할 Docker Compose 2.35.0 이상의 요구사항

Dify 1.19.0은 2026-11-04에 출시되었습니다. 변경의 전반적인 내용은 공식 릴리스 페이지(https://github.com/langgenius/dify/releases/tag/1.19.0)에서 확인할 수 있습니다. 대기업 내에서 Dify Enterprise를 사용하는 입장에서, 실무와 직결되는 세 가지 포인트를 정리합니다.

변경 내용: 워크플로우 내에서 Workflow Tool을 호출할 때, 그 내부의 단계(step)나 LLM Call이 외부 트레이스(Langfuse 등)에 계층 구조로 출력되도록 변경되었습니다.

기존에는:

외부 워크플로우 → Workflow Tool의 스팬 (통과/실패)만 보임
Workflow Tool 내부에서 무슨 일이 일어났는지, 어떤 LLM Call이 느렸는지, 어느 단계에서 막혔는지는 추적할 수 없음

v1.19.0 이후에는:

Workflow Tool 호출 스팬 아래에 내부 단계가 계층적으로 나열됨
LLM Call의 프롬프트(prompt), 응답(response), 토큰 수를 확인할 수 있음
중첩된 Tool이 여러 번 호출된 경우에도, 각 호출이 별도의 스팬으로 남음

주의사항:

새로운 트레이스 계층은 “향후 실행”에 적용됩니다. 기존 기록은 백필(backfill)되지 않습니다.
Workflow Tool의 내부 단계가 영속화되어 있어야 합니다 (1.18.0 이후의 Console 드릴다운 기능을 전제로 함)
로링 디플로이(rolling deploy) 중에는 트레이스 큐의 마이그레이션 절차(
ops_trace
→ops_trace_v2
)가 필요합니다.

대기업 내에서 Dify를 사용하면, 워크플로우가 여러 Workflow Tool을 호출하는 복잡한 구성이 되는 경우가 있습니다. 이전에는 “어떤 Tool에서 막히고 있는지”를 구분하기 위해 로그를 하나하나 확인해야 했습니다. 중첩 트레이싱이 가능해지면서 이 조사 시간이 크게 단축됩니다.

변경 내용: App을 내보내기(export) 할 때, 해당 앱이 사용하고 있는 Workflow Tools도 함께 .ifpkg 패키지에 포함되도록 변경되었습니다.

기존에는:

App을 내보내도 Workflow Tools의 정의는 포함되지 않았음
다른 환경에 임포트(import) 할 때, Workflow Tools를 별도로 생성/등록해야 했음

v1.19.0 이후에는:

.ifpkg (format v2)에 Workflow Tools의 정의가 포함됨 - 임포트 대상에서 기존 Tool과 중복되면 재사용하고, 그렇지 않으면 생성·공개·등록까지 자동 수행함
추이적 의존성(Tool이 호출하는 Tool)도 포함됨

중요 주의사항: 모든 Dify App 내보내기가 format v2로 변경되었습니다. 구 버전의 임포터는 수용하지 못할 가능성이 있습니다. 임포트 대상 환경도 1.19.0 이상으로 맞춘 후에 패키지를 임포트해야 합니다.

여러 Dify 환경(개발/스테이징/운영)을 사용하는 경우, 이 변경 사항의 영향을 받을 수 있습니다. 마이그레이션 순서는 “임포트 대상을 먼저 1.19.0으로 업그레이드한 후, 내보내기 및 임포트를 수행”하는 절차를 따르게 됩니다.

변경 내용: difyctl에 Skills를 관리하는 6가지 명령어가 추가되었습니다.