- Static threshold: 値が指定した数値を超えたときに発報します。デフォルトのモードであり、本ページではこのモードについて説明します。
- Anomaly detection(Managed ClickStack のみ): 直近の履歴から学習した想定範囲を値が外れたときに発報します。詳しくは 異常検知アラート を参照してください。
- 検索アラート
検索アラートでは、保存済みの検索結果に基づいて通知をトリガーできます。これにより、特定のイベントやパターンの発生頻度が想定より高い場合や低い場合を検知できます。
定義した時間枠内で一致した結果の件数が、指定したしきい値を上回るか下回ると、アラートがトリガーされます。
検索アラートを作成するには:
検索に対してアラートを作成するには、その検索が保存されている必要があります。既存の保存済み検索に対してアラートを作成することも、アラートの作成中に検索を保存することもできます。以下の例では、検索はまだ保存されていないものとします。
1
アラート作成ダイアログを開く
まず検索を実行し、
Searchページ右上のAlertsボタンをクリックします。
2
アラートを作成する
アラート作成パネルでは、次の操作を行えます。
- アラートに関連付ける保存済み検索に名前を付ける。
- しきい値を設定し、指定した期間内に何回到達したらアラートとするかを指定する。しきい値は上限または下限として使用することもできます。ここで設定する期間は、アラートがトリガーされる頻度も決定します。
grouped byの値を指定する。これにより、検索をServiceNameなどで集計できるようになり、同じ検索から複数のアラートをトリガーできます。- 通知先の webhook 宛先を選択する。この画面から直接新しい webhook を追加することもできます。詳しくはwebhook の追加を参照してください。


- ダッシュボードチャートアラート
ダッシュボードアラートは、チャートに対しても設定できます。
完全なSQL集計とClickHouse関数による高度な計算を活用し、保存済みのダッシュボードからチャートベースのアラートを直接作成できます。
メトリクスが設定したしきい値を超えると、アラートが自動的にトリガーされるため、KPI、レイテンシ、その他の主要なメトリクスを継続的に監視できます。
ダッシュボード上の可視化に対してアラートを作成するには、ダッシュボードが保存済みである必要があります。
1
チャート編集ダイアログを開く
チャートの設定メニューを開き、アラートボタンを選択します。チャート編集ダイアログが表示されます。

2
アラートを追加する
Add Alert を選択します。

3
アラート条件を定義する
条件 (
この画面から新しい webhook を直接追加することもできます。詳しくは webhook の追加 を参照してください。
>=, >, <=, <, =, !=, <= x >=, > or <)、しきい値、期間、webhook を定義します。ここで設定する期間は、アラートがトリガーされる頻度も決定します。
webhook の追加
アラート の作成時には、既存の webhook を使用することも、新しく作成することもできます。作成した webhook は、ほかの アラート でも再利用できます。 webhook は、Slack や PagerDuty などのさまざまなサービス種別に対して作成できるほか、汎用的なターゲット向けにも作成できます。 たとえば、以下の chart に対する アラート の作成を考えてみましょう。webhook を指定する前に、ユーザーはAdd New Webhook を選択できます。


- Slack: webhook または API を使用して、チャンネルに直接通知を送信します。
- PagerDuty: PagerDuty API を介して、オンコールチーム向けにインシデントをルーティングします。
- Webhook: 汎用 webhook を介して、alerts を任意のカスタムシステムやワークフローに接続します。
ClickHouse Cloud only integrationsSlack API および PagerDuty インテグレーションは、ClickHouse Cloud でのみサポートされています。
- Webhook URL。例:
https://hooks.slack.com/services/<unique_path>。詳細については、Slack documentation を参照してください。
- Slack bot token。詳細については、Slack documentation を参照してください。
- PagerDuty integration key。詳細については、PagerDuty documentation を参照してください。
- Webhook URL
- Webhook headers (任意)
- Webhook ボディ (任意) 。現在、ボディではテンプレート変数
{{title}}、{{body}}、{{link}}をサポートしています。
アラートの管理
アラートは、HyperDX の左側にあるアラートパネルから一元管理できます。

- 赤いバー: この評価でしきい値条件が満たされ、アラートが発報されました (通知送信あり)
- 緑のバー: アラートは評価されましたが、しきい値条件は満たされませんでした (通知送信なし)
アラートの削除
アラートを削除するには、関連する Search またはチャートの編集ダイアログを開き、Remove Alert を選択します。 以下の例では、Remove Alert ボタンをクリックすると、チャートからアラートが削除されます。

その他の SQL ベースのチャートタイプ (テーブル、円グラフ、ヒートマップなど) はアラートをサポートしていません。
SQLアラートを作成する
SQLベースのチャートにアラートを作成するには、次の手順を行います。1
ダッシュボードでSQLベースのチャートを作成または開く
保存済みのダッシュボードで、SQL チャートモードの新しいチャートを作成するか、既存のSQLベースのチャートを開いて編集します。表示タイプとして Line、Stacked Bar、または Number を選択します。

2
アラートを追加する
チャートエディタのアラートセクションで Add Alert を選択します。次の項目を設定します。
- しきい値タイプ:
>=(以上),>(より大きい),<=(以下),<(より小さい),=(等しい),!=(等しくない),<= x >=(範囲内), または> or <(範囲外) - しきい値: 比較対象となる数値
- インターバル: アラートを評価する頻度 (1m, 5m, 15m, 30m, 1h, 6h, 12h, または 1d)。これは各評価の time window も定義します。
- Webhook: アラート発報時に使用する通知チャネルです。Webhook の追加を参照してください。

3
ダッシュボードを保存する
アラートを有効にするには、ダッシュボードを保存します。アラートは設定したインターバルで評価を開始します。
- 値カラム:
SELECT句の最後の数値カラムがアラートの値として使用されます。クエリが複数の数値カラム (例:count, avg_latency, p99_latency) を返す場合、しきい値と比較されるのは最後のカラム (p99_latency) のみです。 - タイムスタンプカラム: 時系列チャート (Line と Stacked Bar) では、システムは結果内の Date/DateTime カラムを時間バケット (つまり時系列チャートの x 軸) として識別します。各時間バケットの値カラムは、それぞれ独立してしきい値に対して評価され、いずれかの時間バケットの値が設定されたしきい値を超えた場合、アラートがトリガーされます。
- グループカラム: 数値カラムでもタイムスタンプカラムでもないカラム (例:
ServiceName,Environment) は、グループ化の次元として扱われます。グループが存在する場合、グループ値の一意な組み合わせごとに個別に追跡され、それぞれに対してアラートが生成されます。ClickStack は、設定されたしきい値を超えた値を持つ各グループごとにアラートを送信します。グループは時系列チャートでのみ利用できます。
{intervalSeconds:Int64}、{intervalMilliseconds:Int64}、$__timeInterval(col)、または $__timeInterval_ms(col)) を含める必要があります。アラートの実行時には、これらはアラートに設定された期間に置き換えられます。
アラートに使用するクエリには、時間範囲フィルター ({startDateMilliseconds:Int64} と {endDateMilliseconds:Int64}、または $__timeFilter(col) など) を含めることを推奨します。クエリ内に時間範囲フィルターが含まれているかどうかにかかわらず、アラートクエリはアラートに設定された期間で実行されます。時間範囲フィルターがない場合、クエリは実行のたびにソーステーブルで利用可能な全期間を読み取ります。
いずれかのサービスのエラー率が 5% を超えた場合にアラートを発報します。また、トラフィックの少ないサービスでノイズの多いアラートが発生するのを避けるため、アラート期間内のリクエスト数が少なくとも 10 件あることを条件とします。
>= 5 (エラー率が 5% に達すると発報)
このクエリでは、ServiceName は数値カラムでもタイムスタンプのカラムでもないため、各サービスは個別のアラートグループとして扱われます。アラートはサービスごとに個別に発報されます。
ラグ付き平均による異常検知 (時系列)
エラー数が移動平均を2標準偏差超えて上回った場合にアラートを発します。これにより、固定のしきい値ではなく、直近のベースライン動作に対するスパイクを検出できます。> 0 (ローリングベースラインを上回る過剰なエラーが検出されると発報します)
このクエリは、ローリングウィンドウ計算を初期化するために、日付範囲の開始前の30インターバルを取得し、その後、最終出力を評価ウィンドウのみに絞り込みます。
HyperDX で活用できる、一般的なアラートのシナリオをいくつか紹介します。
エラー: デフォルトの
All Error Events と HTTP Status >= 400 の保存済み検索に対してアラートを設定し、
エラーが過剰に発生したときに通知を受け取ることを推奨します。
低速な操作: 低速な操作を対象とする検索 (例:
duration:>5000) を設定し、そのような操作の発生件数が多すぎる場合に
アラートを出すことができます。
ユーザーイベント: 新規ユーザーの登録時や重要なユーザー操作が実行された際に、
顧客対応チームへ通知されるようアラートを設定することもできます。
異常な変化: サービスごとにエラー件数が異なる場合や、トラフィックが時間帯によって変動する場合など、明確なしきい値を決められないときは、
ServiceName でグループ化した
異常検知アラートを使用してください。