メインコンテンツまでスキップ
に最終更新

Tines

備考

プレビュー

Lakewatchは プライベート プレビュー段階です。アクセスをリクエストするには、Databricksアカウントチームに連絡してください。

LakewatchのアラートをTinesストーリーにエクスポートします。アラートが作成されると、LakewatchはJSONイベントをTines Webhookに投稿し、Tinesストーリーがその処理を決定します。送信先全体でのエクスポートの動作については、「 アラート通知先」を参照してください。

Tinesへのエクスポートは、LakewatchからTinesへの一方通行です。Lakewatchは、Unity Catalogシークレットとして保存するWebhookシークレットを使用して認証を行い、TinesのWebhookアクションを通じてイベントを送信します。

イベントの配信方法​

  • アラート作成時 : Lakewatchはevent_type lakewatch.alert.createdを含むJSONイベントをPOSTします。ペイロードはジェネリックな Webhook の宛先と同じスキーマおよびフィールド名を使用するため、Tines ストーリーは同じフィールドを読み取ることができます。
  • アラートの更新： 送信先で更新配信が有効になっている場合、Lakewatchは、すでにエクスポートされているアラートの状態、タイトル、重大度、説明、分類、または担当者が変更されたときにもlakewatch.alert.updatedイベントを投稿します。アラートが終了すると、updatedイベントを受け取り、alert_stateはRESOLVEDまたはDUPLICATEに設定されます。個別の終了イベントはありません。更新配信を有効にするには、設定で アラートの更新も送信する を選択します。設定の構成を参照してください。
  • ストーリーが結果を決定します ：エクスポートが成功したということは、Tinesがイベントを受信したことを意味するものであり、ストーリーがそれに基づいて実行されたことを意味するものではありません。
警告

Lakewatchは、各イベントを1回送信します。Tinesへの配信が失敗した場合、Lakewatchは失敗を記録し、イベントを再送信しません。アラートは依然としてLakewatchに表示されます。

data.alert_id を使用して、イベントを同じアラートに一致させます。更新配信が有効になっている場合、1 つのアラートは created イベントと後の updated イベントを生成するため、event_type をチェックしてそれらを区別してください。delivery_attempt_id は配信ごとに変更されるため、2 つのイベントが同じアラートに関するものかどうかを判断することはできません。

前提条件​

Tines Webhookの設定​

Tinesストーリーで、インバウンドWebhookアクションを追加し、シークレットで認証するように構成します：

  1. ストーリーに Webhook アクションを追加します。
  2. ヘッダーとして送信されるシークレットを要求するようにアクションを設定します（シークレットアクセスモード）。Webhook URLとシークレットをメモします。

詳細については、「Tines Webhookアクションのドキュメント」を参照してください。

Webhook URLは、https://<tenant>.tines.com/webhook/<path> の形式のWebhookアクションURLであり、パブリックインターネットからアクセスできる必要があります。Lakewatchは、Private Service Connectの背後にあるEndpointのようなプライベートネットワークには配信できません。

WebhookシークレットをUnity Catalogシークレットとして保存する​

Tines webhook__lakewatchシークレットを、Lakewatch環境 のカタログの スキーマの Unity Catalog シークレット に保存します。 シークレットの選択 はスキーマのシークレットを一覧表示し、 シークレットの作成 はそこに作成します。Lakewatch はシークレット名のみを保存し、シークレット値は保存しません。

このシークレットは事前に <catalog>.__lakewatch で作成しておくか、Tinesのエクスポートを構成する際に 「シークレットの作成」 ボタンを使用して作成することができます。いずれの場合も、シークレットを作成するにはカタログに対する USE CATALOG と、__lakewatch スキーマの所有権、あるいはスキーマに対する CREATE SECRET と USE SCHEMA の両方が必要です。ステップについては、「シークレットの作成」を参照してください。

必要な権限​

Tinesエクスポートを構成するには、以下のものが必要です。

  • READ SECRET Webhookシークレットを保持するUnity Catalogシークレット、またはその親スキーマまたはカタログ。Lakewatchは、構成を保存する際にシークレットを読み取れることを確認します。付与するには、 「シークレットの権限を管理する」を参照してください。
  • Lakewatch環境のカタログに対するMANAGE権限。設定の構成を参照してください。

Webhookシークレットを変更するには、同じUnity Catalogシークレットの値を更新します。Lakewatchは次のエクスポート時に新しい値を使用します。設定に変更はありません。別のシークレットを使用するには、設定の シークレットの選択 または シークレットの作成 をクリックして保存します。

Tines をアラート通知先として設定する​

アラート 設定セクションで、アラートのTines宛先を構成します。

  1. Lakewatchサイドバーで 設定 に移動し、 アラート を開きます。
  2. 配信 で、 アラート通知先 を Tines に設定します。
  3. Webhook URL に、Tines WebhookアクションURL（https://<tenant>.tines.com/webhook/<path>）を入力します。
  4. Webhook シークレット で、 シークレットの選択 をクリックして Webhook シークレットを保持するシークレットを選択するか、 シークレットの作成 をクリックしてページを離れずに Webhook シークレットから作成します。このフィールドにはシークレットの名前が表示され、値は表示されません。
  5. 変更を保存します。

アラート設定の完全なリファレンスについては、「 設定の構成」を参照してください。

トラブルシューティング​

  • イベントがストーリーに届きません： Webhook URLがTines WebhookアクションURLではないか、ストーリーが無効になっています。URLがhttps://<tenant>.tines.com/webhook/<path>の形式であること、およびストーリーが有効であることを確認してください。
  • 構成が保存されません ：Unity Catalog シークレットを読み取る権限がない、シークレットが Lakewatch 環境とは別のカタログにある、または Webhook URL が HTTPS を使用していないかプライベートネットワークを指している可能性があります。シークレット、そのカタログ、および Webhook URL へのアクセスを確認してください。
  • シークレットが「シークレットの選択」にリストされていません : シークレットの選択 には、環境のカタログの __lakewatch スキーマでアクセスできるシークレットのみがリストされます。シークレットをそこに保存するか、それに対する READ SECRET を要求してください。
  • Lakewatchはエクスポートが成功したと報告するが、Tinesでは何も起こらない : 2xxレスポンスは、Tinesがイベントを受け入れたことを意味し、ストーリーがイベントに対してアクションを実行したことを意味するわけではありません。Tines ストーリーのロジックを確認してください。
  • Webhookシークレットをローテーションしました ：新しい値でUnity Catalogシークレットを更新してください。エクスポート構成を変更する必要はありません。
このページの見出し