管理者設定 - ワークフローの実行

[管理者] メニューの [アラートとスケジュール] セクションにある [ワークフローの実行] ページに、ワークフロー アクティビティの最近の履歴が表示されます。[ワークフローの実行] ページを表示するには、see_schedules 権限と chat_with_agent 権限を含むロールが割り当てられている必要があります。

ワークフローは、管理者設定 - ワークフロー ページで確認できます。ワークフローでは、コンテンツを特定のアドレスに送信するタイミングを指定します。

新しいワークフローは、コンテンツが送信されるたびに作成されます。たとえば、毎週月曜日に特定のコンテンツを送信するようにワークフローを指定した場合、Looker は毎週月曜日に新しいワークフローを作成して、指定されたアドレスにコンテンツを送信します。

ワークフローを実行ステータスでフィルタする

[ワークフローの実行] ページの上部で、ジョブのステータス別にワークフローをフィルタできます。

  • すべて: すべての最近のワークフロー
  • 実行中: 実行中のワークフローのみ
  • 成功: 正常に完了したワークフローのみ
  • 失敗: 正常に完了できなかったワークフローのみ

含まれる情報

各ワークフロー実行またはジョブには、次の情報が含まれます。

列 定義
時間 ワークフローの実行が開始された日時
ステータス ワークフロー実行が完了したか（緑色のチェックマーク）、エラーが返されたか（赤色の警告アラートアイコン）
ステージ 実行中のワークフロー実行の現在のステージ
ユーザー ワークフローを作成したユーザー
ソース コンテンツのタイプ（Workflow として表示）
名前 ワークフローの名前。ワークフロー コンテンツへのリンクとしても機能します。
タイプ 配信先（Email、Slack など）
メッセージ 実行に失敗した場合のエラー メッセージ。実行が成功した場合、success
ランタイム ワークフロー実行の実行時間または実行中ワークフローの現在までの実行時間

ワークフロー実行のエラー メッセージのトラブルシューティング

[メッセージ] 列に表示されるエラー メッセージを使用して、ワークフロー実行の失敗を診断して解決できます。一般的なエラー メッセージには次のようなものがあります。

受信者と許可リストに関するエラー

  • Unauthorized emails in plan: ["<email_address>"]:
    • 原因: 1 つ以上の受信者のメールアドレスが、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）を使用して、失敗した実行をプログラムで再試行することもできます。