플로우 실행 기록 (Flow Runs)
실험적 기능
플로우 러너와 실행 기록은 tapflow의 AI 자동화 축에 속하는 실험적 기능입니다. 정식 경로는 수동 QA 대시보드입니다.
대시보드의 Flow Runs 페이지에서 tapflow flow run이 남긴 실행 기록을 볼 수 있습니다. CI가 빌드마다 플로우를 돌렸다면 어느 빌드에서 어느 플로우가 왜 실패했는지 팀원 누구나 브라우저로 확인할 수 있습니다. 실패가 앱 문제인지, 기기·에이전트·릴레이 같은 환경 문제인지도 나눠서 보여 줍니다.
토큰을 주고 실행하면 실행 기록이 남습니다. 설정은 기록 남기기를 참고하세요.
사용 방법
- 대시보드 왼쪽 사이드바에서 Flow Runs를 엽니다. 처음에는 CI 실행만 보입니다.
- 위쪽의 All / CI / Local로 어디서 실행된 기록을 볼지 고릅니다. 상태(Any status, Running, Passed, Failed, Cancelled)와 플로우 이름으로도 좁힐 수 있습니다. 플로우 이름은 일부만 입력해도 됩니다.
- 행을 누르면 그 실행의 상세 화면이 열립니다. Cmd를 누른 채 클릭하면(Windows·Linux는 Ctrl) 새 탭에서 열립니다.
목록은 한 페이지에 최근 실행부터 25개씩 보여 줍니다. 표 아래의 Newer와 Older로 페이지를 옮깁니다.
App Center의 빌드 행에 있는 Runs 버튼을 누르면 그 빌드의 실행 기록만 모아서 볼 수 있습니다. 필터는 주소에 들어가므로 걸러 낸 목록을 링크로 공유할 수 있습니다.
실행 상세
상세 화면에는 플로우가 실행 순서대로 나옵니다.
- 실패한 플로우는 실패 메시지, 스텝별 결과, 실패 순간의 스크린샷을 보여 줍니다. 스크린샷을 누르면 원본 크기로 열립니다.
- 끝까지 가지 못한 플로우는 Not run으로 표시합니다.
- CI가 실행 링크를 남겼다면 Open the CI run으로 CI 쪽 실행 화면을 열 수 있습니다. 빌드가 있는 실행은 Other runs of this build로 같은 빌드의 다른 실행 기록을 볼 수 있습니다.
진행 중인 실행 지켜보기
실행이 진행 중이면 목록과 상세 화면이 몇 초마다 새로 고침됩니다. 상세 화면의 Watch the device를 누르면 러너가 조작하는 기기를 실시간으로 볼 수 있습니다. 보기 전용이라 화면을 눌러도 기기에는 아무것도 전달되지 않습니다. 세션 하나를 동시에 4명까지 볼 수 있습니다.
상태의 의미
| 상태 | 의미 |
|---|---|
| Running | 실행 중 |
| Passed | 모든 플로우 통과 |
| Failed | 하나 이상의 플로우가 실패. 모든 실패가 환경 문제면 상세 화면에 Environment problem으로 나오고 플로우를 시작하기 전에 실패했다면 그 이유가 나옵니다. |
| Cancelled | 실행이 취소됨(Ctrl+C, CI 잡 취소). 러너가 끝을 알리기 전에 연결이 끊긴 실행도 여기에 들어가고 상세 화면에 그 사실이 나옵니다. |
기록 남기기(운영자)
tapflow flow run에 API 유형 토큰(view, builds:write)을 주면 실행마다 기록이 남습니다. 토큰은--token이나TAPFLOW_TOKEN으로 줍니다. 자세한 내용은 플로우 레퍼런스의 실행 기록을 참고하세요.- 기록하지 않으려면
--no-record를 붙입니다. - 로컬에서 실행하면 러너가 실행이 끝날 때 그 실행 페이지의 링크를 출력합니다. CI에서는 릴레이 주소가 로그에 남지 않도록 실행 ID만 출력합니다.
- 빌드에 딸린 기록은 그 빌드가 지워질 때 함께 지워지고 빌드 없이 실행한 기록은 7일 뒤 지워집니다.
관련 문서
- 플로우 레퍼런스: 플로우 작성법과
tapflow flow run옵션 - CI/CD에서 MCP 활용: CI에서 플로우를 돌리는 예시
- REST API의 실행 기록: 실행 기록을 읽고 쓰는 엔드포인트