適切なユーザー権限があれば、ユーザー定義のダッシュボード、または新しいダッシュボードや従来のダッシュボードを使用する LookML ダッシュボードにアラートを作成できます。
アラートの作成
アラートを設定できるのは、タイルのビジュアリゼーションで 1 つ以上の数値メジャーまたは表計算を持つタイルのみです。ビジュアリゼーションの種類とダッシュボード タイルのビジュアリゼーション内に存在するフィールドにより、単一のフィールドまたは表計算の値に基づくアラート条件を設定できるかどうか、またはフィールドまたは表計算の値に基づくアラート条件を設定できるかどうかが決まります。
Looker は、ダッシュボード タイルのビジュアリゼーションのタイプと、ビジュアリゼーションに含まれているフィールドの種類に応じて、異なる方法でデータを確認します。作成したアラートの種類は次のいずれかになります。
- 単一値アラート(単一値ビジュアリゼーションでのみ使用)- Looker は、ビジュアリゼーション(結果テーブルの最初の行)で使用されている値に基づいてデータを確認します。
- 時系列アラート(クエリ結果に日付または時間のディメンションがある場合に使用)- Looker は以前に見たことのないすべての新しい行をチェックします(クエリの日付または時間のディメンションに基づく)。
- カテゴリ アラート(単一値、時系列のいずれでもない) - アラートの作成時に特定の行またはピボット値が選択されていない限り、Looker はすべての行とピボット値を確認します。
行の合計を含む表計算に基づくアラートはサポートされていません。
アラートを作成するには、ダッシュボードの編集モードを終了し、開発モードを終了する必要があります。
ダッシュボード タイルにアラートを作成するには、タイルのベルのアイコンをクリックし、表示を許可する既存のアラートのリストの下部にある [新規] ボタンをクリックします(リスト全体を表示するにはスクロールが必要な場合があります)。そのタイルに現在アラートが構成されていないか、そのタイルの既存のアラートを表示する権限がない場合は、ダッシュボード タイルにカーソルを合わせてベルのアイコンを表示します。ベルのアイコンをクリックして、アラート作成ウィンドウを開きます。
アラート作成ウィンドウで、アラートの複数のコンポーネントを指定できます。
各アラートクエリは、アラート作成時のダッシュボードとタイル設定をキャプチャします。アラートのクエリは、アラートの作成後にダッシュボードまたはタイルに加えた変更(ビジュアリゼーション タイプの変更など)は、ダッシュボード フィルタに対する変更や、ダッシュボード タイルのビジュアリゼーションの外観などには適用されません。アラートおよび通知に適用するには、変更が完了したら、新しいアラートを作成する必要があります。
アラートは、アラートの再作成を必要とせず、自分または他のユーザーが基盤となるダッシュボードまたはタイルに行った一般的な変更の多くと同期されます。詳しくは、ダッシュボードの編集によるアラートへの影響に関するドキュメント ページをご覧ください。
アラートに名前を付ける
デフォルトのアラートのタイトルは、アラートがトリガーされるために必要な条件を示しています。アラートの名前を変更するには:
- その他メニューをクリックしてから、[アラートを編集] をクリックします。
- アラートのタイトルを 1 回クリックします。
- カスタム タイトルを入力し、フィールドの外側から離れるか、Enter キーを押して更新内容を確認します。
- [アラートを保存] をクリックして新しいタイトルを保存します。
カスタム アラートのタイトルは、そのタイルのアラートビュー ウィンドウに一覧表示されるすべてのアラートに表示されます。設定したカスタム タイトルはアラートの通知にも表示されます。
アラート表示ウィンドウのアラートのカスタム タイトルにカーソルを合わせると、そのアラートをトリガーする条件が表示されます。
アラートの条件の設定
アラート作成ウィンドウの [Condition] プルダウンで、タイルデータに変更がないかチェックする方法とアラート通知をトリガーする変更の種類を Looker に指示するコンポーネントを設定できます。
アラートの条件は次のコンポーネントで表されます。
- ダッシュボード タイルのビジュアリゼーションに表示されるフィールドまたは表計算のリスト
- アラート通知をトリガーするために、選択したフィールド、フィールド、表計算、または表計算の変更
- アラート通知のトリガーとなる変化の程度
次のような条件があります。
- 次より大きい
- 次より小さい
- 次と等しい
- 次の値以上
- 以下
クエリに日付または時刻フィールドが含まれている場合は、追加の条件を使用できます。
- Increases by
- Decreases by
- 変化率(増加率と減少率の組み合わせ)
これらの比較条件を時系列データとともに使用するには、他にもいくつかの考慮事項があります。詳細については、時系列データに基づくアラートの設定に関するヘルプセンター記事をご覧ください。
Looker では、整数値と小数値データの比較に基づくアラートのみが作成されます。ただし、簡単な回避策を使用すると、データ値の変化率に基づくアラートを設定できます。
アラート通知の設定
アラート作成ウィンドウの [送信先] で、アラート通知の送信先を指定できます。
アラートをメールで送信する
アラート通知をメールで送信するには、[送信先] プルダウンから [メール] を選択します。アラートメール通知の受信者を指定できます。メールアドレスはデフォルトで表示されますが、必要に応じて受信者リストを変更できます。権限により、アラート通知をどのメールドメインに送信できるかが決まります。
各受信者に、アラートに関する情報とアラートのフォローを解除するためのオプションが記載されたメールが届きます。アラートのフォローを解除すると、その受信者のメールアドレスが受信者のリストから削除されます。
Slack アタッチメント(API トークン)統合へのアラートの送信
Slack Attachment(API Token)アクションは、Looker アクション ハブから取得できます。このアクションが [管理] パネルの [アクション] ページで有効になっている場合、アラート作成ウィンドウの [送信先] プルダウンにオプションとして [Slack Attachment (API Token)] が表示されます。
セルフホストのアクション ハブ サーバーを使用する、お客様がホストするインスタンスの管理者は、Looker インスタンスを更新する際、アクション ハブ サーバーを再起動する必要があります。
Looker 管理者が Slack 添付ファイル(API トークン)アクションを有効にして、Slack で Looker アプリ bot ユーザーを設定したら、Slack 添付ファイル(API トークン)の統合を使用して、Slack にアラート通知を送信できます。
[Where to send] プルダウンから [Slack Attachment (API Token)] を選択します。
[チャンネル タイプ] フィールドと [共有] フィールドが表示されます。
埋め込みユーザーが Slack 添付ファイルの統合にアラート通知を送信する権限を持っていても、Slack アプリの bot ユーザー用に Slack ワークスペースが構成されていない限り、[送信先] プルダウンに [Slack Attachment (API Token)] は表示されません。
[Channel Type] フィールドを使用して、アラートを受け取る Slack の受信者の種類を指定します。
- チャネル: Slack チャネルにアラートを送信する
- ユーザー: Slack ユーザーに、ダイレクト メッセージでアラートを送信する
チャネルタイプを選択すると、[共有] フィールドに、Slack ワークスペースの Looker アプリ bot ユーザーの認証情報に適用されるチャネルまたはダイレクト メッセージ オプションが入力されます。
[共有] 欄で、アラート通知の送信先にするダイレクト メッセージまたはチャネルを選択します。選択したユーザーまたはチャンネルには、アラートが設定されているタイルに関する情報を含む通知が送信されます。
- ダッシュボード タイルの可視化の PNG 画像
- ダッシュボードの名前またはカスタム アラートのタイトルと、アラートをトリガーした条件を含むメッセージ
- タイルのダッシュボードに移動するためのリンク
- アラートの登録解除するためのリンク
単一値ビジュアリゼーションの場合、Slack 通知には、ビジュアリゼーションの PNG ではなく、単一の値がテキストとして表示されます。
Slack 統合へのアラートの送信
Slack のアクションは、Looker アクション ハブから取得できます。このアクションが [管理] パネルの [アクション] ページで有効になっている場合、アラート作成ウィンドウの [送信先] プルダウンにオプションとして [Slack] が表示されます。Looker 管理者は、少なくとも 1 つの Slack ワークスペースを Looker インスタンスに接続する必要があります。
Slack統合は、次の条件を満たすLookerホスト型デプロイメントでご利用いただけます。
- Lookerインスタンスが6.24以降であること。
- Looker インスタンスで IP 許可リスト機能が有効になっていません。
この Slack 統合は、お客様がホストするインスタンスではサポートされていません。
Looker アプリのインストールを有効にするには、Slack ワークスペース オーナーが Slack ワークスペースのアプリのインストール設定の調整が必要になることがあります。
Looker 管理者が Slack アクションを有効にして適切な Slack ワークスペースに接続したら、Slack にアラート通知を送信できます。
[送信先] プルダウンから [Slack] を選択します。
Slack への認証をまだ行っていない場合は、[送信先] プルダウンに [Slack でログイン] ボタンが表示されます。
[Slack でログイン] をクリックします。Looker が Slack ワークスペースへのアクセスをリクエストします。Looker 管理者が複数の Slack ワークスペースを Looker インスタンスに接続している場合、OAuth ページの右上にプルダウン メニューが表示されます。プルダウンから適切な Slack ワークスペースを選択します。[Allow] をクリックします。
また、Looker の個人アカウント ページから Slack に認証することもできます。Looker 管理者が複数の Slack ワークスペースを Looker インスタンスに接続している場合、ワークスペースの一覧が表示され、各ワークスペースに個別にログインできます。
少なくとも 1 つの Slack ワークスペースにログインすると、アラート作成ウィンドウの残りの Slack フィールドが次のように表示されます。
埋め込みユーザーが Slack 統合にアラート通知を送信する権限を持っていても、Slack ワークスペースが Looker インスタンスに接続されていない限り、[送信先] プルダウンに [Slack] オプションは表示されません。
[ワークスペース] プルダウンには、ログインしているワークスペースのリストが表示されます。リストからワークスペースを選択します。アラート通知を送信するワークスペースが表示されない場合は、Looker 管理者が Looker インスタンスに接続しているワークスペースの一覧を確認し、Looker の個人アカウント ページから各ワークスペースに個別にログインできます。
[Share In] フィールドには、選択した Slack ワークスペースに基づくチャネルとダイレクト メッセージ オプションが入力されます。アラート通知のダイレクト メッセージまたはチャネルを選択します。そのチャンネルのユーザーには、アラートが設定されているタイルに関する情報を含む通知が表示されます。
- ダッシュボード タイルの可視化の PNG 画像
- ダッシュボードの名前またはカスタム アラートのタイトルと、アラートをトリガーした条件を含むメッセージ
- タイルのダッシュボードに移動するためのリンク
- アラート通知の登録解除リンク
単一値ビジュアリゼーションの場合、Slack 通知には、ビジュアリゼーションの PNG ではなく、単一の値がテキストとして表示されます。
アラートの頻度を設定する
アラート作成ウィンドウの [頻度] で、Looker がデータを変更することを確認する頻度(およびアラートの条件が満たされた場合はアラート通知を送信する頻度)を設定できます。デフォルトの頻度は [毎日] の [05:00] です。指定できる頻度のオプションは次のとおりです。
- 指定された月の [日](デフォルトは月の第 1)で [毎月](時刻: デフォルトは 05:00)
- 指定した曜日(デフォルトは日曜日)の毎週、指定した時刻(デフォルトは 05:00)
- 毎日、指定された時刻(デフォルトは 05:00)
- 指定した間隔で時間単位(デフォルトではデータを 1 時間おきに確認)と開始時間と終了時間(デフォルトは 05:00 と 17:00)Looker では、1 時間間隔で以下の間隔でデータを確認できます。
- 時間
- 2 時間
- 3 時間
- 4 時間
- 6 時間
- 8 時間
- 12 時間
- 指定した間隔での分数(デフォルトでは 15 分ごとにデータを確認)。指定した開始時間と終了時間(デフォルトは 05:00 と 17:00)が設定されます。分単位の間隔では、次の間隔で Looker がデータを確認できます。
- 15 分
- 30 分
開始時間と終了時間が含まれます。たとえば、チェック間隔を 12 時間に設定し、開始時刻を 05:00、終了時刻を 17:00 に設定すると、Looker では 05:00 と 17:00 にデータがチェックされます。
Looker は、管理の [Settings] ページの [Application Time Zone] 設定で指定されたタイムゾーン、またはアラート作成者のユーザー固有のタイムゾーンで指定されたタイムゾーンに従ってアラートを送信します。
アラートの権限の設定
アラートの作成権限は、アラート作成ウィンドウの [権限] プルダウンから [公開] または [非公開] を選択して設定できます。アラートに従わない場合、デフォルトでは [公開] とマークされます。つまり、ダッシュボード タイルの次の権限を持つ Looker ユーザーは、アラート表示ウィンドウでアラートとその設定を確認できます。また、アラートがトリガーされるとメール通知が届くように、アラートをフォローすることもできます。
Slack と Slack の添付ファイル(API トークン)の統合についてのアラートを追跡することはできません。ただし、これらの送信先のいずれかにアラートを作成し、[公開] に設定すると、他のユーザーはアラート設定を表示、複製できるようになります。
アラートを [非公開] に設定すると、自分と管理者だけが設定を確認できるようになります。それには、アラート作成ウィンドウの [権限] プルダウンから [非公開] オプションを選択します。
セキュリティ上の理由から、一部のアラートは他のユーザーが表示したり、他のユーザーがフォローしたりすることはできません。また、アラートの権限を表示したり設定したりすることはできません。