로그

로그 (Logs)

앱의 대화·실행 로그를 둘러보고, 로그 보존 정책을 이해하며, 보관된 워크플로우 로그를 다운로드하는 방법을 알아봐요.

모든 앱의 Logs(로그) 탭에서 앱이 실제로 어떻게 사용되는지 확인할 수 있어요. 사람들이 무엇을 질문하거나 제출했는지, 앱이 어떻게 응답했는지, 어떤 피드백이 돌아왔는지 말이죠.

챗 기반 앱(Chatbot, Chatflow, Agent)과 Text Generator 앱은 대화를 로깅하고, Workflow 앱은 실행(run)을 로깅해요.

무엇이 로깅되나

로그는 모든 채널의 실제 사용을 담아요: 웹 앱, API, 그리고 **Home(홈)**의 WEB APPS 목록에서 열린 앱. Workflow 앱의 경우, 트리거로 시작된 실행도 로깅돼요.

최종 사용자 피드백(좋아요/싫어요 및 댓글)은 그것이 참조하는 메시지와 함께 저장돼요.

앱 편집기의 테스트 세션은 Chatflow·Workflow 앱에서 제외돼요(Preview(미리보기) 및 Test Run(테스트 실행)). 다른 앱 유형에서는 팀원 계정 아래에 나열돼요.

로그 둘러보기

각 행은 대화 하나 또는 실행 하나를 나타내요. 대부분의 열은 자명하지만, 몇 가지는 맥락이 필요해요.

• **Title(제목)**은 대화의 첫 번째 메시지에서 생성돼요.
• **End User or Account(최종 사용자 또는 계정)**는 웹 앱·API 사용을 위한 세션 ID를, Dify 내부 사용을 위한 팀원 계정을 보여줘요.
• **User Rate(사용자 평가)**는 최종 사용자의 좋아요·싫어요를, **Op. Rate(운영자 평가)**는 팀의 평가를 셉니다. 둘 다 대화 전체에 걸쳐 집계돼요.
• Trigger By(트리거 기준)(Workflow 앱)는 각 실행을 무엇이 시작했는지 보여줘요:
  • WebApp: 게시된 웹 앱 또는 API를 통한 호출
  • Webhook: 요청을 받은 웹훅 트리거
  • Schedule: 예약된 시간에 도달한 스케줄 트리거
  • Integration: 연결된 통합의 이벤트

대화를 찾으려면 메시지의 단어나 최종 사용자의 세션 ID로 검색하세요. 워크플로우 실행을 찾으려면 입력·출력으로 검색하거나 실행 ID를 붙여넣으세요.

대화 검사하기

행을 클릭하면 전체 메시지 스레드가 열려요. 답변 위에 마우스를 올리면 다음을 할 수 있어요.

• 토큰 소비와 지연 시간을 확인
• 그 뒤에 있는 로그 열기: 원시 프롬프트, Agent 앱의 도구 반복, 또는 Chatflow 메시지의 노드별 추적
• 팀 피드백으로 답변 평가. 싫어요에는 무엇이 잘못됐는지 설명하는 댓글이 달릴 수 있어요. 팀 평가는 최종 사용자 피드백과 구분되어 Op. Rate 열을 채워요.
• 질문과 개선된 응답을 짝지은 어노테이션 추가. 어노테이션 응답이 어떻게 적용되는지는 어노테이션 시스템을 참고하세요.

로그 항목을 팀원과 공유하려면 브라우저 주소 표시줄의 링크를 복사하세요.

실행 검사하기

Workflow 앱에서 실행을 클릭하면 결과, 상태와 토큰 총량이 있는 입력·출력, 그리고 실행이 실패하거나 느려진 지점을 정확히 짚어주는 노드별 추적이 열려요.

문제를 재현하려면 **Test With Params(파라미터로 테스트)**를 클릭하세요. 이 실행의 입력으로 워크플로우가 편집기에서 다시 실행돼요.

로그 보존

로그는 완전한 사용자 대화를 포함하며 민감한 정보를 담을 수 있어요. 애플리케이션이 현지 데이터 개인정보 규정을 준수하는지 확인하세요: 개인정보 처리방침을 게시하고 필요한 곳에서 사용자 동의를 받으세요.

대화를 삭제하거나 오래된 로그를 정리해도 로그에 업로드된 파일은 삭제되지 않아요.

Sandbox 요금제에서는 모든 유형의 로그가 30일간 보존돼요. 더 오래된 항목은 영구 삭제되며, 나중에 업그레이드해도 복구되지 않아요.

Professional과 Team에서는 로그 유형에 따라 보존 정책이 달라요.

• 대화 로그(Chatbot, Chatflow, Agent, Text Generator 앱): 활성 구독 기간 동안 보존
• 워크플로우 실행 로그(Workflow 앱): 최근 실행은 Logs(로그) 페이지에 남고, 3개월쯤 지난 실행은 월별 아카이브로 옮겨져 CSV 파일로 다운로드할 수 있어요.

보관 로그 다운로드 (Professional / Team)

보관된 실행은 손실되지 않아요. 한 달에 한 번, 약 3개월이 지난 워크플로우 실행 로그가 워크스페이스 전체의 월별 아카이브로 묶이고, 보관된 모든 달을 다운로드할 수 있어요.

**Settings(설정) > Archived logs(보관 로그)**에서 Owner와 Admin만 아카이브를 다운로드할 수 있어요.

1. 필요한 달의 **Prepare download(다운로드 준비)**를 클릭하세요. 준비는 백그라운드에서 진행되므로 페이지를 떠났다가 와도 돼요.
2. 버튼이 **Download(다운로드)**로 바뀌면 클릭해 파일을 저장하세요. 준비된 다운로드는 24시간 동안 유효하며, 이후에는 다시 준비해야 해요.

각 다운로드는 그 달의 워크스페이스 모든 워크플로우 실행을 담은 CSV 파일을 포함한 ZIP이에요.

특정 앱의 이력만 뽑아내려면 실행 및 앱 로그 CSV에 있는 app_id 열로 필터링하세요. 앱 ID는 Studio의 URL에 있는 긴 식별자예요.