SQLアラート
このセクションのトピック
自分のクエリーが返す値を監視し、定義したしきい値を超えると「アラート」を示します。
場所: ワークスペース › ツール › SQLアラート
ワークスペースのナビゲーションバーから「SQLアラート 」を開きます。表には設定済みのすべてのルールが、現在の値と「アラート 」/「OK 」の表示とともに並びます。クエリーが失敗したルールは「エラー 」と表示されます(サーバの応答は「設定 」で開いて読めます)。クエリーが行を返さない、またはNULLを返すルールは「値なし 」、まだ測定していないルールはダッシュを表示します。どれもOKとは数えません。環境タグで保護された接続(書き込みの確認、または読み出し専用)では、書き込むクエリーのルールは実行されず、「拒否:書き込み 」とタグの名前が表示されます。アラートは自動で実行されるので、確認を求めることができないからです。
各ルールは自分のクエリーです。Calíopeは定義した間隔でそれを実行し、指定した列の値を取り、選んだ演算子(>、<、=、<>)でしきい値と比較します。定義済みのメトリクスはありません。何を監視するかは、SQLで自分で決めます。
「更新 」は、すべてのルールを1回評価します。
自動更新 :再生ボタンを押して間隔を秒で入力すると、ルールが自動で評価し直されます。ルールが条件を満たすと、その行に「アラート 」の印が付き、ビューのフッタにアクティブなアラートの数が表示されます。最短の間隔は1秒です。一時停止を押すか、ツールを離れると、再評価は止まります。
「サンプルを読み込む 」は、動作するところから始められるよう、出来上がったルールを追加します。
MySQL MariaDB Aurora PostgreSQL
サンプルは1つで、アクティブな接続が100を超えたときです。
SQL Server
サンプルは5つあり、押すたびにまだ持っていない次のものが追加されます:ブロックされたセッション、最大値の80%を超えるユーザセッション、1分以上開いたままのトランザクション、データベースのトランザクションログの使用率80%超、そしてサーバの起動以降にロック待ちに費やした秒数です。5つすべてそろうと、ボタンはオフになります。
ClickHouse
サンプルは5つあり、押すたびにまだ持っていない次のものが追加されます:サーバの上限に対する使用中のメモリーの割合、いま実行中のクエリー、1分以上遅れているレプリカ、すでに失敗した未完了のミューテーション、そしてパーツがもっとも多いパーティションの、サーバがINSERTを拒否する上限に対する割合です。5つすべてそろうと、ボタンはオフになります。
Oracle
サンプルは5つあり、押すたびにまだ持っていない次のものが追加されます:いま何かを実行中のユーザセッションが20を超えたとき、ブロックされたセッション、もっとも使用率の高い表領域が最大サイズの85%を超えたとき、無効なオブジェクト、そして同じ呼び出しを1分以上続けているセッションです。V$SESSIONや表領域の使用量を読むものには「サーバ情報 」と同じ権限が必要で、なければルールは「エラー 」と表示されます。5つすべてが一覧にそろうと、ボタンはオフになります。
TiDB
サンプルは3つあり、押すたびにまだ持っていない次のものが追加されます:クラスタ内のセッションが100を超えたとき、直近1時間のスローなSQL文が100を超えたとき、そして10分以上実行中のスキーマ変更です。3つすべてが一覧にそろうと、ボタンはオフになります。
「書き出す 」は、表(ルール、値、状態)をタブ区切り(TSV)のファイルに保存します。
ルールが発火すると、Calíopeが知らせます 。システムメッセージを残し、前面にいないときは通知も送ります。いつ、どこに届き、どうオフにするかは、トピック「アラートが発火したとき:メッセージと通知」で説明しています。
キーワード: SQLアラート、アラート、しきい値、ルール、メトリクス、監視、自動更新、間隔、ポーリング、モニタ
監視するクエリーと、アラートを発生させる条件を定義します。
場所: SQLアラート › 設定
ツールバーの「設定 」を押します。シートで「追加 」を押してルールを追加し、次の項目を入力します:
- 「名前 」 — 表の中でルールを見分けるための名前。
- 「SQL 」 — 監視する値を返すクエリー。1行を返すようにします。読まれるのは最初の行です。
- 「列 」 — 値を持つ結果の列。名前がどれにも一致しなければ、最初の列が使われます。
- 「演算子 」と「しきい値 」 — アラートを発生させる条件。
MySQL MariaDB Aurora
例:SQL = SHOW STATUS WHERE Variable_name = 'Threads_connected'、列 = Value、演算子 = >、しきい値 = 100。
TiDB
TiDBのSHOW STATUSにはThreads_connectedがありません。同じアラートには、SQL = SELECT COUNT(*) AS n FROM information_schema.CLUSTER_PROCESSLIST、列 = n、演算子 = >、しきい値 = 100。
PostgreSQL
例:SQL = SELECT COUNT(*) AS "Value" FROM pg_stat_activity WHERE pid <> pg_backend_pid()、列 = Value、演算子 = >、しきい値 = 100。
SQL Server
例:SQL = SELECT COUNT(*) AS Value FROM sys.dm_exec_requests WHERE blocking_session_id <> 0、列 = Value、演算子 = >、しきい値 = 0。
ClickHouse
例:SQL = SELECT count() AS Value FROM system.processes WHERE query_id != queryID()、列 = Value、演算子 = >、しきい値 = 0。ルール自身のクエリーを数えずに、実行中のクエリーを数えます。64ビット整数はテキストで届き、桁を失わずに正確な数として比較されます。
Oracle
例:SQL = SELECT COUNT(*) AS "Value" FROM v$session WHERE blocking_session IS NOT NULL、列 = Value、演算子 = >、しきい値 = 0。ほかのセッションを待っているセッションを数えます。NUMBERはすべての桁付きで届き、正確な数として比較されます。
値が数値でなければ、テキストとして1文字ずつ比較されます。>と<はアルファベット順に従うので、YYYY-MM-DDの形で書いた日付には使えます。
ルールを変更するには、一覧で選択して編集し、「保存 」を押します。「削除 」か、横のゴミ箱でルールを削除します。「完了 」はルールを保存して、もう一度評価します。
ルールはこのデバイスに保存され、開いているすべてのセッションに適用され、iCloud同期を有効にしていればほかのデバイスと同期されます。
キーワード: アラートを設定、ルール、SQL、列、演算子、しきい値、threads_connected
ルールが「アラート」に変わると、Calíopeはシステムメッセージを残し、前面にいないときは通知も送ります。
場所: ワークスペース › ツール › SQLアラート
知らせるタイミング 。ルールが「アラート 」に変わったときです。アラートのまま続く各サイクルでは知らせません。発火し、「OK 」に戻り、再び発火したルールは、そのたびに知らせます。アラートとエラー、または行を返さないクエリーの間を行き来するルールが知らせるのは、最大で5分に1回です。この間隔はルールごとなので、同時に発火した2つのルールはどちらも知らせます。
残すもの
• システムメッセージ :ルール名、その値、しきい値、プロファイルのエイリアスを含みます。Calíopeが前面にあっても記録されます。システムメッセージがiCloudで同期されていれば、ほかのデバイスとApple WatchのCalíopeでも読めます。Apple Watchではサーバのグループに入ります。
• ローカル通知 :ルール名と、その下に値としきい値を表示します。Calíopeが前面になく、「設定」›「通知」の「SQLアラートの発生 」がオンのときだけです。Calíopeが前面にあれば、行が赤くなっているのがすでに見えるからです。
値としきい値は、書かれたときの小数の桁数のまま表示されます。0.15が0.2として届くことはありません。
ルールが評価されるのは、タブが開いている間だけです 。Macでは、ほかのアプリが前面にあっても評価が続き、そのとき通知が届きます。iPhoneとiPadでは、Calíopeを離れると数秒でシステムがCalíopeを止めます。その間に発火したルールは戻ったときに評価され、その知らせは通知なしでメッセージに残ります。
オフにする方法 。通知は「SQLアラートの発生 」でオフにします。メッセージは、「設定」›「一般」›「システムメッセージ」の「システムメッセージを記録 」でオフにします。これはすべての種類をオフにします。Apple Watchでは、サーバのグループのスイッチで鳴るかどうかが決まります。
キーワード: アラート、知らせる、通知、システムメッセージ、間隔、5分、Apple Watch、しきい値、ルール