管理者設定 - アラート

Looker 管理者は、アラート管理の管理ページ([Admin] パネルの [Alerts & Schedules] セクションからアクセスできます)で、すべてのユーザーが作成したアラートを管理できます。アラート管理の管理ページには、アクティブと非アクティブのアラートすべての情報が一覧表示されます。

管理者は、作成またはフォローしたアラートや、受信者として登録されているアラートをアラートの管理ユーザーページでも確認できます。他のアラート権限を持つユーザーは、作成されて、[アラートの管理] ユーザーページでフォローされているアラートを管理できます。

アラート情報

[Manage Alerts] 管理ページには、Looker インスタンス上のすべてのアラートに関する情報が表示されます。see_alerts 権限が付与されている管理者とユーザーは、[アラートの管理] の管理ページの表でこれらの設定を表示できます。

定義
Alert Name アラートの作成または編集時に設定されるアラートのタイトル。デフォルトのアラートのタイトルは、アラートをトリガーするために満たす必要がある、または超過する必要がある条件を示します。アラート名をクリックすると、そのアラートの [Alert Details] ページが開きます。
Dashboard アラートがあるタイルを含むダッシュボードの名前。リンクをクリックすると、ダッシュボードに移動します。[なし] は、アラートがダッシュボードから同期されていないことを示します。同期されていないアラートを解決するには、ダッシュボードの編集によるアラートへの影響のドキュメント ページをご覧ください。
Owner アラートを作成したユーザーの名前。
Avg Run Time アラート クエリの期間(秒単位)。
Condition Met [Yes] または [No] で、アラートクエリが最後に実行されたときにアラートの条件が満たされたかどうかを示します。-- 記号は、アラートクエリがまだ実行されていない場合か、アラートクエリが実行されたがアラート条件を満たしたかどうかを判断できない場合に表示されます。この列には、アラートクエリの実行またはアラート通知の配信時に表示される警告またはエラーに関連する警告アイコンまたはエラーアイコンが表示されます。警告アイコンまたはエラーアイコンにカーソルを合わせると、関連するエラー メッセージが表示されます(該当する場合)。

最新でないアラート警告の警告アイコンは、ダッシュボード タイルのデータが直近の 2 つのアラートクエリ間で変更されなかったことを示します。このメッセージの詳細については、このページのアラートエラーと警告メッセージ セクションをご覧ください。
Frequency アラートをチェックして、条件が満たされたかどうか、条件が超過されたかどうかを確認する頻度。
ステータス この列は、アラートが現在有効か無効かを示します。

  • アラート作成ポップアップまたはアラート管理ユーザーページでユーザーが自分のアラートを無効にした場合(またはその他メニューを使用すると)、または Looker 管理者がアラートを無効にした場合、アラートは「無効」とマークされます。[無効] ステータスにカーソルを合わせると、アラートが無効になった理由についてのアラートのオーナーまたは Looker 管理者の説明が表示されます。アラートを無効にすると、アラートの受信者への通知は一時停止されますが、アラートはアラート表示ウィンドウに引き続き表示されます。アラート所有者には、アラート クエリが次回実行されるまで、アラート ステータスが [Active] と表示されることがあります。
  • 管理者がアラートを無効にすると、フォロワーはアラート通知を受信しなくなります。
Following アラートのフォロー中ステータスを示すボタン。詳しくは、このページのフォロー中のアラートをご覧ください。
Activity [Alert Details] ページにあるアラートの [Activity] タブに移動するリンク。
その他メニュー アラートに対して追加の操作を実行できるメニュー。詳しくは、このページのアラート管理のオプションをご覧ください。

アラートが有効になっているダッシュボードまたはダッシュボード タイルをユーザーが削除すると、アラートは無効になります。この場合、フォロワーや受信者には、アラート条件が満たされたときに通知が届かなくなります。このページでは、アラートの対象となるダッシュボードの名前が直ちに削除されます。アラートクエリが次回実行されると、ステータスに [Disabled] と表示され、ダッシュボードまたはダッシュボード要素(タイル)が削除されたことを示すツールチップ メッセージが表示されます。管理者は、アラートの右側にあるその他メニューでアラートを完全に削除できます。

アラートのフィルタリング

アラートのリストをフィルタするには、ページの上部にある [フィルタリスト] 検索バーを使用します。

アラートは、次の属性でフィルタできます。

  • Frequency - アラートをチェックして、条件が満たされたかどうか、条件が超過されたかどうかを確認する頻度
    • Minutes - 15 分または 30 分の頻度のすべてのアラートを返します
    • Hourly - 1 時間2 時間3 時間4 時間6 時間8 時間、または12 時間の頻度のすべてのアラートを返します
    • Daily - 毎日の頻度で時間が設定されたすべてのアラートを返します
    • Weekly - 毎週の頻度で、または時間が設定されたすべてのアラートを返します
    • Monthly - 毎月の頻度で、または時間が設定されたすべてのアラートを返します
  • Condition Met - アラートクエリが最後に実行されたときにアラートの条件が満たされたかどうかを示します
    • Yes - アラートの条件が満たされたか、超過しています
    • No - アラートの条件が満たされていないか、超過していません
  • Status - 条件に対してアラートがまだチェックされているかどうかを示します
    • Active - 条件に対してアラートがまだチェックされています
    • Disabled - 条件に対してアラートがチェックされていません

結果には複数のフィルタを適用できます。フィルタを削除するには、フィルタ名の横にある x をクリックします。ブラウザを更新すると、選択したすべてのフィルタも削除されます。

アラートのグループ化

グループ アラート アイコンをクリックして [グループ条件] メニューを開きます。

アラートは次の方法でグループ化できます。

  • デフォルト: グループ化されません。
  • ダッシュボード名: アラートが設定されているダッシュボード名のアルファベット順
  • オーナー: アラートのオーナーのアルファベット順

アラートのエラーと警告のメッセージ

[アラートの管理] 管理ページには、アラートクエリの実行またはアラート通知の配信時に表示されるエラーまたは警告が表示されます。[Condition Met] 列の警告アイコンまたはエラーアイコンにカーソルを合わせると、エラー メッセージが表示されます(該当する場合)。

Slack または Slack のアタッチメント(API トークン)統合に通知を配信するように設定されているアラートの場合、アラートの条件は満たされたものの通知を配信できなかったとアラート クエリで判断されると、エラー メッセージ Notification delivery failed with existing configuration が表示されます。この障害は、アラートの作成後に Slack 構成に関する変更が加えられた場合に発生することがあります。たとえば、アラートの配信先の Slack ワークスペースが Looker インスタンスから切断された場合、アラートの配信先の Slack チャンネルが削除された場合、Looker が統合に接続できない場合などです。

警告: 最新データのクエリ

[Condition Met] 列の警告アイコンは、アラートのベースとなっているダッシュボード タイルのデータが、最新の 2 つのアラートクエリ間で変更されなかったことを示します。このアイコンにカーソルを合わせると、[Stale Alert Warning] というメッセージと次のテキストが表示されます。

The data for this tile did not change between the two most recent alert queries. Verify that the caching policies defined for this dashboard tile are aligned with the alert frequency.

クエリ間でデータが変更されなかった理由には、いくつかの説明が考えられます。この警告が続く場合は、Looker の管理者または開発者に相談して、このダッシュボード タイルに定義されているキャッシュ ポリシーアラート頻度の設定と一致しているかどうか確認してください。

フォロー中のアラート

[Following] 列には、クリック可能な [Unfollow] ボタンと [Follow] ボタン、クリックできない [Follow] ボタンが表示されます。

アラートをフォローしている場合、アラートの横に [Unfollow] ボタンが表示されます。[Unfollow] をクリックすると、このアラートがトリガーされたときに通知を受信しなくなります。[Unfollow] をクリックすると、次のようになります。

  • アラートを所有している場合は、この列に [Follow] ボタンが表示されます。
  • アラートを所有していない場合は、ブラウザを更新するとこのページからアラートが削除されます。
  • アラート通知の受信者として登録されているが、アラート表示ウィンドウからアラートをフォローしなかった場合は、クリックできない [Follow] ボタンが表示されます。アラートのフォローを解除するには、アラート通知から直接登録解除する必要があります。

次のいずれかの条件に該当する場合は、クリックできない [Follow] ボタンがアラートの横に表示されます。

アラート管理のオプション

各アラートの右側には、次のオプションを含むその他メニューがあります。

  • View Alert
  • Edit Alert
  • Disable Alert(アラートが現在有効になっている場合)
  • Enable Alert(アラートが現在無効の場合)

[View Alert] をクリックすると、[Alert Details] ページが開きます。

[Edit Alert] をクリックすると、アラート ウィンドウが開きます。ここではアラートの設定を変更できます。変更を保存するには [Save Alert] をクリックし、保存せずにアラート ウィンドウを閉じるには [Cancel] をクリックします。

アラートが有効になっているダッシュボードまたはダッシュボード タイルをユーザーが削除すると、アラートは無効になります。この場合、フォロワーや受信者には、アラート条件が満たされたときに通知が届かなくなります。アラートの所有者は、アラートのダッシュボード名が削除されたことをこのページですぐに確認できます。アラートクエリが次回実行されると、アラートの [Status] は [Disabled] になります。

アラートの詳細ページ

[Alert Details] ページは、アラートの所有者が構成したアラート情報の概要を示すポップアップです。アラートの所有者とフォロワーには、それぞれ異なる内容がこのページに表示されます。

[Alert Details] ページは、次のいずれかの方法で開くことができます。

  1. アラートの右側にあるその他メニューをクリックし、[View Alert] を選択する
  2. アラートのタイトルをクリックする

アラートの詳細ページを構成する

アラートを作成すると、[Manage Alerts] 管理ページにそのアラートのエントリが表示されます。[Alert Details] ページを開いて、フォロワーと受信者が表示できるアラートに関する情報を構成します。

ダッシュボードをアラートにリンクするには、次の手順を行います。

  1. テキスト ボックスをクリックして、アラートをトリガーする条件やアラートがトリガーされる状況に関する説明を追加します。[Save] をクリックして説明を保存します。
  2. [+ Link Investigative Dashboard] ボタンをクリックします。
  3. [Link Dashboard to Alert] ウィンドウで、ダッシュボードを含むフォルダを選択し、ダッシュボードの名前をクリックします。

    [+ Link Investigative Dashboard] ボタンの代わりに、リンクされたダッシュボードの名前が表示されます。このボタンをクリックして、リンクされたダッシュボードに移動します。ダッシュボード名の [x] をクリックすると、リンクされたダッシュボードを削除できます。ダッシュボードへのリンクを削除することを確認するメッセージが表示されます。

以下のアラートの詳細は [Alert Details] ページに自動的に表示され、構成できません。

  • アラートの履歴に関する情報(このページの [Activity] タブに表示されます)
  • アラートのビジュアリゼーション
  • ダッシュボードの同期ステータスと、アラートが関連付けられているダッシュボードの名前

所有しているアラートを操作するには、他にも次のような方法があります。

  • アラートのビジュアリゼーションでその他メニューをクリックし、[Explore from here] をクリックして、アラートが設定されているダッシュボード タイルのクエリが事前に設定された Explore を開きます。
  • [Test Now] ボタンをクリックして、即時アラート クエリを実行します。アラートがトリガーされると、その所有者、受信者、フォロワーに通知が送信されます。

[Done] をクリックし、[Alert Details] ページを閉じます。

アラートの詳細ページを表示する

所有していないアラートでも、受信者として登録されている場合や、そのアラートをフォローするように選択した場合は、[Alert Details] を確認できます。[Alerts Detail] ページで [Details] タブを開くと、所有者が構成したアラートに関する情報が表示されます。

[Alerts Detail] ページの [Details] タブでは、次の操作を行えます。

  1. アラートをトリガーする条件や、アラートがトリガーされる状況についての説明を表示します。
  2. リンクされたダッシュボードをクリックすると、アラート クエリにコンテキストを追加する別のダッシュボードに移動します。
  3. アラートのビジュアリゼーションを表示します。
  4. アラートの同期ステータスを表示します。
  5. アラートのビジュアリゼーションでその他メニューをクリックし、[Explore from here] をクリックして、アラートが設定されているダッシュボード タイルのクエリが事前に設定された Explore を開きます。
  6. [Test Now] ボタンをクリックして、即時アラート クエリを実行します。アラートがトリガーされると、その所有者、受信者、フォロワーに通知が送信されます。
  7. [Done] をクリックし、[Alert Details] ページを閉じます。

アラート アクティビティの表示

Looker は指定された頻度でアラートクエリを実行して、データがアラート条件を満たしたかどうか、あるいは超過したかどうかをチェックします。こうしたチェックの結果はアラートの履歴になります。[Alert Details] ページの上部にある [Activity] タブをクリックすると、アラートの履歴と追加情報が表示されます。

[Alert Details] ページの [Activity] タブでは、次の操作を行えます。

  1. 条件に対してアラートがチェックされる頻度を表示します。
  2. アラートのメタデータを表示します
  3. アラートの同期ステータスを表示します。
  4. [Test Now] ボタンをクリックして、即時アラート クエリを実行します。アラートがトリガーされると、その所有者、受信者、フォロワーに通知が送信されます。
  5. [Done] をクリックし、[Alert Details] ページを閉じます。

アラート メタデータの表示

[Alert Details] ページの [Activity] タブにあるテーブルには、各アラート実行に関するメタデータが含まれています。

見出し 定義 設定可能な値
Ran At アラートクエリが開始された時刻のタイムスタンプ DD/MM HH:MM形式の任意のタイムスタンプ

例: 05/30 18:25
Run Time アラートクエリの実行にかかった時間 0.81s 形式の任意の時間
Fresh 最新の 2 つのアラート クエリの間で変更されたデータがアラート クエリによってチェックされたかどうかを示すブール値。データが変更された場合と、データが変更されなかった場合が示されます。
  • Yes(データが変更された場合)
  • No(データが変更されなかった場合)
Source アラート クエリによって条件値がチェックされたデータの生成元
  • query
  • cache
  • stale cache
  • querycachestale cache が適用されない場合、[Source] の値は空白になります。
Source Time アラート クエリによって条件値がチェックされたデータベース行のタイムスタンプ DD/MM HH:MM 形式の任意のタイムスタンプ

例: 05/25 16:01
Condition Met アラート条件が満たされたかどうかを示すブール値
  • Yes(条件が満たされました)
  • No(条件が満たされていません)
Trigger 満たされたか、超過した場合にアラートをトリガーする条件値 任意の数値
Observed アラート条件を満たしたか超過し、アラートをトリガーした観測値 任意の数値
Status アラート クエリのステータス
  • Complete
  • Running
  • Not Started

アラートの同期ステータスの表示

[Alert Details] ページの 2 つのタブに、アラートの同期ステータスと、アラートが関連付けられているダッシュボードの名前が表示されます。

  • 緑色の丸で囲まれたチェックマークは、アラートがダッシュボードに同期されていることを示します。
  • 黄色の三角形の警告記号は、アラートがダッシュボードから同期されていないことを示します。ステータスには、同期が解除された時点のタイムスタンプが含まれます。同期されていないアラートの場合、[Dashboard] 列に [None] の値が表示されます。未同期アラートの解決については、ダッシュボードの編集がアラートに与える影響のドキュメントをご覧ください。