관리자 설정 – 워크플로 실행

관리 메뉴의 알림 및 일정 섹션에 있는 워크플로 실행 페이지에는 워크플로 활동의 최근 기록이 표시됩니다. 워크플로 실행 페이지를 보려면 see_schedules 및 chat_with_agent 권한이 포함된 역할이 할당되어 있어야 합니다.

관리 설정 – 워크플로 페이지에서 워크플로를 확인할 수 있습니다. 워크플로에서는 콘텐츠를 특정 주소로 전송해야 하는 시점을 지정합니다.

콘텐츠가 전송될 때마다 새 워크플로가 생성됩니다. 예를 들어 워크플로에서 매주 월요일 특정 주소를 특정 주소로 보내는 것으로 지정하면 Looker는 매주 월요일 새로운 워크플로를 만들어 해당 콘텐츠를 지정된 주소로 전송합니다.

실행 상태별 워크플로 필터링

워크플로 실행 페이지 상단에서 작업 상태별로 워크플로를 필터링할 수 있습니다.

  • 모두: 최근의 모든 워크플로
  • 실행 중: 실행 중인 워크플로만
  • 성공: 성공적으로 완료된 워크플로만
  • 실패: 성공적으로 완료되지 않은 워크플로만

포함된 정보

각 워크플로 실행 또는 작업에는 다음 정보가 포함됩니다.

열 정의
시간 워크플로 실행이 시작된 시간
상태 워크플로 실행이 완료되었는지 (녹색 체크표시) 또는 오류가 반환되었는지 (빨간색 알림 아이콘)
단계 실행 중인 워크플로 실행의 현재 단계
사용자 워크플로를 만든 사용자
소스 콘텐츠 유형(Workflow로 표시됨)
이름 워크플로 콘텐츠 링크 역할을 하는 워크플로의 이름
유형 전송 대상입니다(예: Email 또는 Slack).
메시지 실패한 실행의 경우 오류 메시지입니다. 성공적인 실행을 위해서는 success
런타임 워크플로 실행이 실행된 기간

워크플로 실행 오류 메시지 문제 해결

메시지 열에 표시된 오류 메시지를 사용하여 워크플로 실행 실패를 진단하고 해결할 수 있습니다. 일반적인 오류 메시지는 다음과 같습니다.

수신자 및 허용 목록 오류

  • Unauthorized emails in plan: ["<email_address>"]:
    • 원인: 하나 이상의 수신자 이메일 주소가 Looker 인스턴스의 이메일 도메인 허용 목록에 포함되지 않은 도메인에 속합니다.
    • 해결 방법: 수신자의 도메인을 관리 이메일 허용 목록에 추가하거나 워크플로를 수정하여 승인되지 않은 이메일 주소를 삭제합니다.

상담사 및 항목 오류

  • Agent execution failed: unexpected message received:
    • 원인: Gemini 데이터 에이전트가 지시사항을 해석하거나 자연어 인사이트 요약을 생성하는 동안 런타임 오류 또는 예상치 못한 응답이 발생했습니다.
    • 해결 방법: 워크플로 구성에서 자연어 지시어를 검토하고 수정하여 안내가 명확하고 구체적인지 확인합니다.
  • entity WorkflowAgent missing:
    • 원인: 워크플로와 연결된 기본 데이터 에이전트, 대시보드 또는 Explore가 삭제, 이름 변경 또는 수정되었습니다.
    • 해결 방법: 활성 데이터 에이전트 또는 액세스 가능한 Explore를 사용하여 워크플로를 다시 만들거나 업데이트합니다.

사용자 권한 및 계정 오류

  • 사용자 권한 또는 모델 액세스 실패:
    • 원인: 워크플로를 만든 사용자에게 Explore 또는 대시보드의 기본 모델에 대한 액세스 권한이 없습니다.
    • 해결 방법: 워크플로 소유자에게 관리 > 사용자 / 역할에 필요한 권한이 있는지 확인하거나 활성 상태의 승인된 사용자로 워크플로를 다시 만듭니다.
  • 사용 중지된 사용자 계정:
    • 원인: 워크플로 소유자의 Looker 사용자 계정이 사용 중지되었거나 비활성화되었습니다.
    • 해결 방법: 사용자 계정을 다시 사용 설정하거나 활성 사용자 아래에 워크플로를 다시 만듭니다.

스케줄러 대기열 및 시간 초과 오류

  • Job is no longer processing @<state> (여기서 <state>은 execute 또는 deliver) 또는 Job was expected to dequeue by @<time>:
    • 원인: 워크플로가 완료되지 않고 1시간 이상 스케줄러 대기열에 남아 있습니다. 이는 일반적으로 임시 데이터베이스 연결 시간 초과 또는 시스템 리소스 제약 때문입니다.
    • 해결 방법: 워크플로는 다음 예약된 간격으로 다시 실행됩니다. Looker API (run_scheduled_plan_once)를 사용하여 실패한 실행을 프로그래매틱 방식으로 재시도할 수도 있습니다.