TTL 指標とモニタリング

このページでは、Spanner の有効期間（TTL）の指標について説明します。詳しくは、TTL についてをご覧ください。

指標

Spanner は、SQL クエリで読み取り可能なシステムテーブル内の TTL アクティビティに関する情報を、Cloud Monitoring を介してアクセスされる指標として提供します。

システムテーブルはデータベースのテーブルにつき TTL 情報を報告しますが、Cloud Monitoring はデータベースレベルで指標を報告します。

SQL クエリを使用する

Spanner には、TTL に関連する情報を追跡する組み込みテーブルが用意されています。テーブルの名前は SPANNER_SYS.ROW_DELETION_POLICIES で、次のスキーマがあります。

列名	型	説明
TABLE_NAME	STRING	この TTL ポリシーを含むテーブルの名前。
PROCESSED_WATERMARK	TIMESTAMP	現時点で、このポリシーはテーブル内のすべての行に対して実行されています。一部のテーブルパーティションが最近処理された可能性があるため、このタイムスタンプは最も長く処理されていないパーティションを表します。通常、これは 72 時間以内です。
UNDELETABLE_ROWS	INT64	TTL ポリシーで削除できない行の数。詳細については、削除できない行をご覧ください。
MIN_UNDELETABLE_TIMESTAMP	TIMESTAMP	最後の処理サイクルで観測された削除できない行のもっとも古いタイムスタンプ。

削除ポリシーの情報は、データベースのテーブルごとに返されます。

このデータのクエリは、次のような SQL クエリを使用して実行できます。

SELECT TABLE_NAME, UNDELETABLE_ROWS
FROM SPANNER_SYS.ROW_DELETION_POLICIES
WHERE UNDELETABLE_ROWS > 0

SPANNER_SYS テーブルには SQL インターフェースを介してのみアクセスできます。次に例を示します。

Google Cloud コンソールの Spanner Studio ページ
gcloud spanner databases execute-sql コマンド
executeQueryAPI

Spanner が提供する他の単一読み取りメソッドは、SPANNER_SYS をサポートしていません。

Cloud Monitoring を使用する

Spanner には、データベースレベルで TTL アクティビティをモニタリングするために、次の指標が用意されています。

row_deletion_policy/deleted_rows は、TTL ポリシーによって削除された行の数です。
row_deletion_policy/undeletable_rows は、行削除（GoogleSQL）または TTL INTERVAL（PostgreSQL）のステートメントに一致するものの、削除できない行の数です。これは通常、行に子行が多すぎるためにアクションが Spanner のトランザクション制限を超過したことが理由です。
row_deletion_policy/processed_watermark_age は、現在から最後に成功したサイクルで使用された読み取りタイムスタンプまでの時間（削除できない行の有無は問わない）です。

これらの指標は、Cloud Monitoring と Google Cloud コンソールの両方で利用できます。

モニタリング

他の TTL アクティビティをモニタリングすることもできます。

最後に成功したスキャンを確認する

Spanner が期限切れ行を検索するためにテーブルをスキャンした、最後のスナップショット時間を確認できます。SQL クエリとして行うには:

SELECT PROCESSED_WATERMARK
FROM SPANNER_SYS.ROW_DELETION_POLICIES
WHERE TABLE_NAME = $name

row_deletion_policy/process_watermark_age 指標によっても同様の情報が表示されますが、現在の時刻と前回のスキャン時刻の差として表されます。この指標はテーブルごとに分類されませんが、データベース内の TTL が有効になっているテーブルの最も古いスキャン時間を表します。

通常、TTL ポリシーに一致する行は、有効期限から 72 時間以内に削除されます。72 時間を超えたときに通知されるように、processed_watermark_age にアラートを設定できます。

processed_watermark_age が 72 時間を超える場合は、優先度の高いタスクが TTL の実行を妨げる可能性があります。この場合は、CPU 使用率を確認し、必要に応じてコンピューティング容量を追加することをおすすめします。CPU 使用率が推奨範囲内にある場合は、Key Visualizer を使用してホットスポット化を確認します。

削除された行をモニタリングする

テーブルの TTL アクティビティをモニタリングするには、row_deletion_policy/deleted_rows 指標をグラフに表示します。この指標によって、削除された行の数の経時的な推移が表示されます。

期限切れのデータがない場合、この指標は空になります。

削除できない行をモニタリングする

TTL が行を削除できない場合、Spanner は自動的に再試行します。再試行しても TTL アクションを処理できない場合、Spanner は行をスキップし、row_deletion_policy/undeletable_rows_count 指標で報告します。

ゼロ以外のカウントについて通知されるように、row_deletion_policy/undeletable_rows_count でアラートを設定できます。

ゼロ以外のカウントが見つかった場合は、カウントをテーブル別に分類するクエリを作成できます。

SELECT TABLE_NAME, UNDELETABLE_ROWS, MIN_UNDELETABLE_TIMESTAMP
FROM SPANNER_SYS.ROW_DELETION_POLICIES
WHERE UNDELETABLE_ROWS > 0

削除できない行の内容を検索するには、次の手順を行います。

SELECT *
FROM $TABLE_NAME
WHERE $EXPIRE_COL >= $MIN_UNDELETABLE_TIMESTAMP

行の削除に失敗する一般的な原因は、インターリーブされたテーブルとインデックスの更新がカスケードされ、その結果としてトランザクションサイズが Spanner のミューテーションの上限を超過することです。この問題を解決するには、スキーマを更新してインターリーブされたテーブルの TTL ポリシーを個別に追加します。