連携の概要
独自のスケジュールで動くツールについては、TaskBeacon が ping を待つ代わりに、結果を自分で読み取ることができます。 数分ごとにツールの API に何が実行されたかを問い合わせ、監視対象はそれぞれ通常のジョブになります。ステータス (OK、Failed、Late、Missed)、履歴、アラート、レポート、ステータスページは、スクリプトと同じように使えます。 連携は Pro に含まれる予定ですが、現在は誰でも利用できます。
利用できる連携
- Power BI: セマンティックモデル(データセット)の更新。
- SharePoint / OneDrive: 期限までに届く、または更新される必要のあるファイル。
- dbt Cloud: ジョブの実行。
- Fivetran: 接続の同期。
- Azure Data Factory: パイプラインの実行(パイプラインごとに 1 ジョブ)。
連携を追加する
- Jobs(ジョブ)で + New job(新規ジョブ)の横の ▾ を開き、Add integration…(連携を追加…)を選びます(または Settings → Integrations(設定 → 連携))。
- ツールを選び、アクセス情報を入力します。Test connection and continue(接続をテストして続行)で、まずアクセスを確認します。失敗した場合は何も保存されません。
- 監視する対象を選びます。それぞれが、選んだプロジェクト内のジョブになります。ジョブはプランのジョブ数の上限に含まれます。
- 各ジョブの Edit(編集)を開いてスケジュールを設定し、Missed(未実行)が機能するようにします(Power BI と Fivetran では、ツールから自動で入力されます)。
結果は初期設定では 10 分ごとに読み取ります(連携のページで 5 分〜1 時間に変更できます)。そのため、アラートは実行から最大でその時間だけ遅れて届くことがあります。 ツールからリクエストを減らすよう求められた場合や、アクセスが使えなくなった場合は、連携にエラーが表示され、後で再試行します。
保存するデータ
- 入力されたアクセス情報(クライアントシークレット、トークン、API キー)。暗号化して保存します。復号する鍵はデータベースとそのバックアップの外に保管しています。一度保存した情報は、あなたにも二度と表示されません。
- 監視対象の名前と ID(ワークスペースとモデル、フォルダーとファイル名、ジョブ、パイプライン)。
- 各実行について: 開始・終了時刻、ステータス、所要時間、ツールが報告するエラーメッセージ、ファイルの場合はサイズと更新日時。
データの行やファイルの中身を読むことはなく、データベースに接続することも、データベースのパスワードを求めることもありません。 アクセス権は必要最小限にしてください(各ページに必要な権限を記載しています)。連携のページで Disconnect and delete credentials(接続を解除して認証情報を削除)を押すと、保存されたアクセス情報がすぐに削除されます。 その連携のジョブは、履歴付きで一時停止の状態で残るか、チェックを入れた場合は一緒に削除されます。プライバシー(英語)もご覧ください。
ユースケース: チーム全員への Power BI 更新失敗の通知 · SharePoint にファイルが 8:00 までに届かないときにアラートを受け取る · dbt Cloud ジョブの失敗アラートと、開始されなかった実行。その他のご質問: FAQ