큐와 검토

큐는 URL이나 레코드를 순서대로 또는 여러 워커에서 병렬로 처리하기 위한 작업 목록입니다. Guida에서는 큐를 스크립트에서 다룰 수 있을 뿐 아니라 Queue Console에서 운영 상태를 직접 확인할 수 있습니다.

Queue Console이 다루는 것

• 큐별 pending, in-flight, completed, failed 수
• 보류 항목과 페이로드 세부 정보
• 데드 레터 항목 확인
• 워커 시작, 중지, 상태 확인
• 재시도, 폐기, 복구를 위한 작업
• Workflow Ledger와의 관련성

기본 흐름

1. 스크립트 또는 MCP 도구로 항목을 큐에 넣음
2. 워커 또는 수동 스크립트가 항목을 꺼냄
3. 처리가 성공하면 완료로 기록
4. 실패하면 재시도하거나 데드 레터로 보냄
5. Queue Console과 Workflow Ledger Console에서 상태 확인

g.queue.enqueue("urls", { url: "https://example.com" });

const item = g.queue.dequeue("urls");
if (item) {
  await g.nav.navigateToUrl(item.data.url);
  await g.dom.waitForDomStable();
  g.queue.commit(item.id);
}

검토와 복구

큐 처리가 항상 완전 자동으로 끝나지는 않습니다. 사이트 변경, 시간 초과, 인증, 데이터 누락 등으로 실패한 항목은 Queue Console에서 페이로드를 확인하고 재시도나 폐기를 판단할 수 있습니다.

관련 페이지:

• 큐 워커
• Workflow Ledger Console
• URL을 큐에 넣고 처리하기