メインコンテンツまでスキップ

システムテーブルのLakebaseテレメトリ

備考

ベータ版

This feature is in Beta.To use it, a ワークスペース管理者 must turn on Lakebase Observability in システムテーブル from the Previews page.See Manage Databricks previews.

Lakebase captures its observability telemetry into the system.lakebase schema, starting with advanced Postgres signals.Capture is automatic.With that preview enabled, telemetry lands in these tables while a project's コンピュート runs.There is no configuration to create, no destination to choose, and no credentials to provide.知見 and Genie read the same tables, and you can クエリー them with any Databricks tool.

注記

Table and column names might change before general availability.

Requirements​

  • ワークスペースで有効にされた Lakebase Observability in システムテーブル プレビュー。
  • AWS または Azure の Lakebase プロジェクト。「Postgres データベースの取得」を参照してください。

キャプチャされる内容​

Lakebase records the signals you need to explain a slow or failing database, across the following tables:

キャプチャされる内容

テーブル名

アクティブセッションと待機イベント

system.lakebase.active_session_history, system.lakebase.wait_event_counters

クエリープランおよびクエリーごとの実行統計

system.lakebase.plan_history, system.lakebase.pg_stat_statements_counters

スキーマの変更:変更内容、変更日時、変更者

system.lakebase.ddl_history

データベース統計:サイズ、読み取りおよび変更された行数、セッション数

system.lakebase.database_counters, system.lakebase.database_gauges

コンピュートリソースの使用状況: CPU、メモリ、キャッシュ、接続

system.lakebase.compute_counters, system.lakebase.compute_gauges

失敗の背後にあるエラーを含む、生の Postgres Logs メッセージ

system.lakebase.postgres_logs

キャプチャされる内容

テーブル名

アクティブセッションと待機イベント

system.lakebase.active_session_history, system.lakebase.wait_event_counters

クエリープランおよびクエリーごとの実行統計

system.lakebase.plan_history, system.lakebase.pg_stat_statements_counters

スキーマの変更:変更内容、変更日時、変更者

system.lakebase.ddl_history

データベース統計:サイズ、読み取りおよび変更された行数、セッション数

system.lakebase.database_counters, system.lakebase.database_gauges

コンピュートリソースの使用状況: CPU、メモリ、キャッシュ、接続

system.lakebase.compute_counters, system.lakebase.compute_gauges

失敗の背後にあるエラーを含む、生の Postgres Logs メッセージ

system.lakebase.postgres_logs

レコードは 7 日間保持されます。このページの残りの部分では、各テーブルのすべての列について説明します。これらのテーブルが他のシステムテーブルの中でどのような位置づけにあるかについては、Lakebase システムテーブルリファレンスを参照してください。

アクセス​

The system.lakebase tables are governed by Unity Catalog.Users with both the アカウント admin and metastore admin roles can read the telemetry and manage access to it.See Manage privileges in Unity Catalog.

アクセスはスキーマレベルで適用されるため、system.lakebaseを読み取ることができるユーザーはアカウント内のすべてのプロジェクトのテレメトリを確認できます。

マスクされたステートメントテキスト​

Columns that hold statement text return <REDACTED> unless you are an アカウント admin or a member of the databricks_pii_access アカウント-level グループ.An アカウント admin creates and manages that グループ.See Create and manage the databricks_pii_access グループ and Access masked statement text.

すべてのテーブルに共通の列​

以下の各テーブルには、行の取得元を識別する列が含まれています。

列

Type

説明

project_id

STRING

行が取得されたLakebaseプロジェクトです。

branch_id

STRING

行が生成されたBranch。

endpoint_id

STRING

行の発生元のコンピュート Endpoint。

compute_id

STRING

特定のコンピュートインスタンス。コンピュートがゼロにスケールされ、再開すると、これが変更されます。

ts

TIMESTAMP

行が記録されたとき。

compute_mode

STRING

当時のコンピュートのモード。たとえば、読み取り/書き込みまたは読み取り専用です。

列

Type

説明

project_id

STRING

行が取得されたLakebaseプロジェクトです。

branch_id

STRING

行が生成されたBranch。

endpoint_id

STRING

行の発生元のコンピュート Endpoint。

compute_id

STRING

特定のコンピュートインスタンス。コンピュートがゼロにスケールされ、再開すると、これが変更されます。

ts

TIMESTAMP

行が記録されたとき。

compute_mode

STRING

当時のコンピュートのモード。たとえば、読み取り/書き込みまたは読み取り専用です。

_countersで終わる名前のテーブルには、行の値が累積された間隔の起動を示すprevious_ts列も含まれています。これらは、その間隔の累積値であり、ポイントインタイムの読み取り値ではありません。_gaugesで終わるテーブルは代わりにポイントインタイムの読み取りであり、previous_tsはありません。

以下のテーブルには、これらの共通列を除く列のみが一覧表示されます。

セッションアクティビティ​

すべてのアクティブなバックエンドの継続的にサンプリングされたスナップショットです。これは、AWS Performance Insights や Oracle の Active Session History (ASH) と同じパターンです。セッションが待機中を含め、何らかの処理を行っている場合、ここに表示されます。

active_session_history​

列

Type

説明

sample_seq

LONG

このサンプルのバッチ内での順序。

pid

LONG

バックエンドのプロセス ID です。

datid

LONG

データベースのオブジェクトID。

userid

LONG

接続しているロールのオブジェクトIDです。

queryid

LONG

実行中のクエリーを識別します。pg_stat_statements_counters内のqueryidと一致します。

wait_event_info

LONG

待機イベントの内部エンコーディング。

wait_event_type

STRING

待機イベントのカテゴリ。たとえば Timeout または Lock です。

wait_event

STRING

特定の待機イベント。例えば、PgSleepです。

backend_state

LONG

バックエンドの状態。例えば、アクティブまたはアイドル。

backend_type

LONG

バックエンドプロセスのタイプ。

xact_age_ms

LONG

現在のトランザクションがオープンしている期間です。

query_age_ms

LONG

現在のクエリーの実行時間。

blocking_pid

LONG

このセッションをブロックしているセッションの PID です (存在する場合)。

leader_pid

LONG

このバックエンドが並列ワーカーである場合、並列クエリーリーダーのPID。

flags

LONG

内部ステータスフラグ

plan_fingerprint

LONG

plan_history内の特定のプランシェイプにLinkします。

appname_hash

LONG

接続中のアプリケーション名のハッシュです。

列

Type

説明

sample_seq

LONG

このサンプルのバッチ内での順序。

pid

LONG

バックエンドのプロセス ID です。

datid

LONG

データベースのオブジェクトID。

userid

LONG

接続しているロールのオブジェクトIDです。

queryid

LONG

実行中のクエリーを識別します。pg_stat_statements_counters内のqueryidと一致します。

wait_event_info

LONG

待機イベントの内部エンコーディング。

wait_event_type

STRING

待機イベントのカテゴリ。たとえば Timeout または Lock です。

wait_event

STRING

特定の待機イベント。例えば、PgSleepです。

backend_state

LONG

バックエンドの状態。例えば、アクティブまたはアイドル。

backend_type

LONG

バックエンドプロセスのタイプ。

xact_age_ms

LONG

現在のトランザクションがオープンしている期間です。

query_age_ms

LONG

現在のクエリーの実行時間。

blocking_pid

LONG

このセッションをブロックしているセッションの PID です (存在する場合)。

leader_pid

LONG

このバックエンドが並列ワーカーである場合、並列クエリーリーダーのPID。

flags

LONG

内部ステータスフラグ

plan_fingerprint

LONG

plan_history内の特定のプランシェイプにLinkします。

appname_hash

LONG

接続中のアプリケーション名のハッシュです。

待機イベント​

集計された待機イベントのカウントと時間(active_session_historyのサンプルごとのビューを補完)。

ウェイト イベント カウンター​

列

Type

説明

wait_event_id

LONG

待機イベントの内部エンコーディング。

wait_class_name

STRING

待機イベントのカテゴリー。

wait_event_name

STRING

特定の待機イベント。

wait_event_count

LONG

この待機イベントがその間隔で何回発生しましたか。

wait_event_time

DOUBLE

この間隔における、この待機イベントに費やされた合計時間です。

列

Type

説明

wait_event_id

LONG

待機イベントの内部エンコーディング。

wait_class_name

STRING

待機イベントのカテゴリー。

wait_event_name

STRING

特定の待機イベント。

wait_event_count

LONG

この待機イベントがその間隔で何回発生しましたか。

wait_event_time

DOUBLE

この間隔における、この待機イベントに費やされた合計時間です。

クエリープラン​

各実行のクエリープランの記録であり、完全なプランと Neon 固有のストレージ統計が含まれます。これが最も詳細なテーブルであり、通常は低速クエリーの調査の最後にたどり着く場所です。

plan_history​

列

Type

説明

row_position

LONG

この行のバッチ内での序数位置。

analyze_enabled

BOOLEAN

プランに実際の実行統計 (EXPLAIN ANALYZE) が含まれるかどうか、単なる推定値ではなく。

buffers_enabled

BOOLEAN

プランにバッファの使用状況統計が含まれるかどうか。

query_hash

STRING

クエリーテキストを識別するハッシュ。

queryid

LONG

クエリーを特定します。pg_stat_statements_countersとactive_session_historyにおいてqueryidに一致します。

duration_ms

DOUBLE

クエリーの実行にかかった時間です。

total_cost

DOUBLE

プランナーが推定したクエリーのコストです。

plan_rows

LONG

プランナーの見積もり行数です。

actual_rows

LONG

返された実際の行数です。

plan_fingerprint

LONG

この特定のプランの形状を識別します。active_session_history内のplan_fingerprintと一致します。

lock_wait_time_ms

DOUBLE

ロックの待機に費やされた時間。

planning_time_ms

DOUBLE

クエリー計画の所要時間(実行とは別)。

shared_blks_hit / shared_blks_read / shared_blks_dirtied / shared_blks_written

LONG

この実行における共有バッファーキャッシュのアクティビティです。

local_blks_hit / local_blks_read / local_blks_dirtied / local_blks_written

LONG

仮テーブルのローカルバッファアクティビティ。

temp_blks_read / temp_blks_written

LONG

一時ファイルのアクティビティ(例えば、大規模なソートやハッシュによるものなど)。

neon_getpage_count

LONG

pageserverに送信されたページリクエスト数。

neon_file_cache_hits

LONG

ページサーバーの代わりにローカルファイルキャッシュから提供されるページ数。

neon_getpage_wait_us

LONG

ページサーバーのページリクエストの待機に費やされた時間 (マイクロ秒単位)。

backend_pid

LONG

このクエリーを実行したバックエンドプロセスID。

lock_wait_count

LONG

この実行がロックを待機した回数。

userid / dbid

LONG

接続ロールとデータベースのオブジェクトID。

query_text

STRING

クエリーテキスト。マスキング済み。マスクされたステートメントテキストを参照してください。

plan_json

STRING

The full クエリー plan, as JSON.Masked.See Masked statement text.

usename / datname

STRING

接続ロールとデータベースの名前。

application_name / client_addr

STRING

接続しているアプリケーション名とクライアントアドレス。

wait_events

STRING

この実行中に観測された待機イベント。

parameters

STRING

クエリーで使用されているパラメーター (存在する場合) をバインドします。マスキング済み。マスクされたステートメント テキストを参照してください。

blocking_pids

STRING

この実行をブロックしたセッションのPID (存在する場合)。

neon_branch_id / neon_endpoint_id / neon_timeline_id

STRING

Branch、Endpoint、およびタイムラインの内部 Neon 識別子。

cpu_user_time_ms / cpu_sys_time_ms

DOUBLE

この実行によって消費されたCPU時間をユーザー時間とシステム時間に分割したもの。

voluntary_csw / involuntary_csw

LONG

この実行中のコンテキストスイッチ

trace_id / span_id / trace_flags / service_name

STRING / STRING / LONG / STRING

クエリーがトレースされたリクエストの一部であった場合の、OpenTelemetry形式のトレース識別子。

timeline_id

LONG

内部タイムライン識別子。

truncated

BOOLEAN

この行のデータ(たとえば、大規模なプラン)が書き込まれる前に切り捨てられたかどうか。

列

Type

説明

row_position

LONG

この行のバッチ内での序数位置。

analyze_enabled

BOOLEAN

プランに実際の実行統計 (EXPLAIN ANALYZE) が含まれるかどうか、単なる推定値ではなく。

buffers_enabled

BOOLEAN

プランにバッファの使用状況統計が含まれるかどうか。

query_hash

STRING

クエリーテキストを識別するハッシュ。

queryid

LONG

クエリーを特定します。pg_stat_statements_countersとactive_session_historyにおいてqueryidに一致します。

duration_ms

DOUBLE

クエリーの実行にかかった時間です。

total_cost

DOUBLE

プランナーが推定したクエリーのコストです。

plan_rows

LONG

プランナーの見積もり行数です。

actual_rows

LONG

返された実際の行数です。

plan_fingerprint

LONG

この特定のプランの形状を識別します。active_session_history内のplan_fingerprintと一致します。

lock_wait_time_ms

DOUBLE

ロックの待機に費やされた時間。

planning_time_ms

DOUBLE

クエリー計画の所要時間(実行とは別)。

shared_blks_hit / shared_blks_read / shared_blks_dirtied / shared_blks_written

LONG

この実行における共有バッファーキャッシュのアクティビティです。

local_blks_hit / local_blks_read / local_blks_dirtied / local_blks_written

LONG

仮テーブルのローカルバッファアクティビティ。

temp_blks_read / temp_blks_written

LONG

一時ファイルのアクティビティ(例えば、大規模なソートやハッシュによるものなど)。

neon_getpage_count

LONG

pageserverに送信されたページリクエスト数。

neon_file_cache_hits

LONG

ページサーバーの代わりにローカルファイルキャッシュから提供されるページ数。

neon_getpage_wait_us

LONG

ページサーバーのページリクエストの待機に費やされた時間 (マイクロ秒単位)。

backend_pid

LONG

このクエリーを実行したバックエンドプロセスID。

lock_wait_count

LONG

この実行がロックを待機した回数。

userid / dbid

LONG

接続ロールとデータベースのオブジェクトID。

query_text

STRING

クエリーテキスト。マスキング済み。マスクされたステートメントテキストを参照してください。

plan_json

STRING

The full クエリー plan, as JSON.Masked.See Masked statement text.

usename / datname

STRING

接続ロールとデータベースの名前。

application_name / client_addr

STRING

接続しているアプリケーション名とクライアントアドレス。

wait_events

STRING

この実行中に観測された待機イベント。

parameters

STRING

クエリーで使用されているパラメーター (存在する場合) をバインドします。マスキング済み。マスクされたステートメント テキストを参照してください。

blocking_pids

STRING

この実行をブロックしたセッションのPID (存在する場合)。

neon_branch_id / neon_endpoint_id / neon_timeline_id

STRING

Branch、Endpoint、およびタイムラインの内部 Neon 識別子。

cpu_user_time_ms / cpu_sys_time_ms

DOUBLE

この実行によって消費されたCPU時間をユーザー時間とシステム時間に分割したもの。

voluntary_csw / involuntary_csw

LONG

この実行中のコンテキストスイッチ

trace_id / span_id / trace_flags / service_name

STRING / STRING / LONG / STRING

クエリーがトレースされたリクエストの一部であった場合の、OpenTelemetry形式のトレース識別子。

timeline_id

LONG

内部タイムライン識別子。

truncated

BOOLEAN

この行のデータ(たとえば、大規模なプラン)が書き込まれる前に切り捨てられたかどうか。

クエリーの統計情報​

標準のpg_stat_statements拡張機能から取得される、クエリーごとの集計統計情報。

pg_stat_statements_counters​

列

Type

説明

userid / dbid

LONG

接続ロールとデータベースのオブジェクトID。

queryid

LONG

クエリーを特定します。plan_historyとactive_session_historyにおいてqueryidに一致します。

toplevel

BOOLEAN

この行が、PL/pgSQL関数またはプロシージャ内にネストされたものではなく、トップレベルのステートメントであるかどうか。PL/pgSQLの制限事項を参照してください。

query

STRING

クエリーテキスト。マスキング済み。マスクされたステートメントテキストを参照してください。

calls

LONG

このクエリーが指定された間隔で実行された回数です。

plans

LONG

このクエリーが間隔内で計画された回数。

rows

LONG

返された、または影響を受けた合計行数。

total_exec_time / total_plan_time

DOUBLE

このクエリーの、間隔内での実行および計画に費やされた合計時間。

shared_blks_hit / shared_blks_read / shared_blks_dirtied / shared_blks_written

LONG

共有バッファキャッシュのアクティビティ。

local_blks_hit / local_blks_read / local_blks_dirtied / local_blks_written

LONG

仮テーブルのローカルバッファアクティビティ。

temp_blks_read / temp_blks_written

LONG

一時ファイルのアクティビティ。

wal_bytes / wal_fpi / wal_records

LONG

このクエリーによって生成されたライトアヘッドlogのボリューム。

jit_emission_count / jit_emission_time / jit_functions / jit_generation_time / jit_inlining_count / jit_inlining_time / jit_optimization_count / jit_optimization_time

混合

このクエリーでJITが使用された場合のJIT (Just-in-Time) コンパイル統計です。

列

Type

説明

userid / dbid

LONG

接続ロールとデータベースのオブジェクトID。

queryid

LONG

クエリーを特定します。plan_historyとactive_session_historyにおいてqueryidに一致します。

toplevel

BOOLEAN

この行が、PL/pgSQL関数またはプロシージャ内にネストされたものではなく、トップレベルのステートメントであるかどうか。PL/pgSQLの制限事項を参照してください。

query

STRING

クエリーテキスト。マスキング済み。マスクされたステートメントテキストを参照してください。

calls

LONG

このクエリーが指定された間隔で実行された回数です。

plans

LONG

このクエリーが間隔内で計画された回数。

rows

LONG

返された、または影響を受けた合計行数。

total_exec_time / total_plan_time

DOUBLE

このクエリーの、間隔内での実行および計画に費やされた合計時間。

shared_blks_hit / shared_blks_read / shared_blks_dirtied / shared_blks_written

LONG

共有バッファキャッシュのアクティビティ。

local_blks_hit / local_blks_read / local_blks_dirtied / local_blks_written

LONG

仮テーブルのローカルバッファアクティビティ。

temp_blks_read / temp_blks_written

LONG

一時ファイルのアクティビティ。

wal_bytes / wal_fpi / wal_records

LONG

このクエリーによって生成されたライトアヘッドlogのボリューム。

jit_emission_count / jit_emission_time / jit_functions / jit_generation_time / jit_inlining_count / jit_inlining_time / jit_optimization_count / jit_optimization_time

混合

このクエリーでJITが使用された場合のJIT (Just-in-Time) コンパイル統計です。

スキーマの変更​

スキーマの変更:何が、いつ、誰によって変更されたか。これは、デプロイからでも手動編集からでも、Genie がインシデントをスキーマ変更にまで遡って追跡するために読み取るものです。

ddl_history​

列

Type

説明

row_position

LONG

この行のバッチ内での序数位置。

command_tag

STRING

たとえば ALTER TABLE のような DDL コマンドの種類。

object_type / object_name

STRING

変更されたオブジェクトの種類と名前。

schema_name

STRING

オブジェクトが属するPostgresスキーマです。

query_text

STRING

完全な DDL ステートメントです。マスキング済み。See Masked statement text.

duration_ms

DOUBLE

DDLステートメントの実行にかかった時間。

userid / usename

LONG / STRING

接続ロールのオブジェクトIDと名前。

application_name

STRING

接続アプリケーションの名前。

backend_pid

LONG

ステートメントを実行したバックエンドプロセスID。

dbid

LONG

データベースのオブジェクトID。

search_path

STRING

当時のセッションの検索パス。

ddl_json

STRING

DDL ステートメントの構造化および解析された表現。マスキング済み。マスクされたステートメント テキストをご覧ください。

列

Type

説明

row_position

LONG

この行のバッチ内での序数位置。

command_tag

STRING

たとえば ALTER TABLE のような DDL コマンドの種類。

object_type / object_name

STRING

変更されたオブジェクトの種類と名前。

schema_name

STRING

オブジェクトが属するPostgresスキーマです。

query_text

STRING

完全な DDL ステートメントです。マスキング済み。See Masked statement text.

duration_ms

DOUBLE

DDLステートメントの実行にかかった時間。

userid / usename

LONG / STRING

接続ロールのオブジェクトIDと名前。

application_name

STRING

接続アプリケーションの名前。

backend_pid

LONG

ステートメントを実行したバックエンドプロセスID。

dbid

LONG

データベースのオブジェクトID。

search_path

STRING

当時のセッションの検索パス。

ddl_json

STRING

DDL ステートメントの構造化および解析された表現。マスキング済み。マスクされたステートメント テキストをご覧ください。

注記

DDLキャプチャには実際のギャップがあります: コンピュートがゼロへのスケールから再開する直前に行われた変更が見逃される可能性があります。スキーマの変更が発生したことがわかっているにもかかわらずここに表示されない場合は、それが最も可能性の高い理由です。制限事項を参照してください。

Postgres Logs​

障害の原因となる特定のエラーを含む、生のPostgres Logsメッセージ。

postgres_Logs​

列

Type

説明

sample_seq

LONG

この行のバッチ内での序数位置。

elevel

LONG

内部ログレベルのエンコーディング。

severity

STRING

The Logs severity, for example ERROR or LOG.

sqlstate

STRING

未定義の列を示す42703などのPostgres SQLSTATEエラーコード。

backend_pid / leader_backend_pid

LONG

バックエンドプロセスID、および該当する場合は並列クエリーリーダーのPID。

userid / usename

LONG / STRING

接続ロールのオブジェクトIDと名前。

datid / datname

LONG / STRING

データベースのオブジェクトIDと名前。

application_name / client_addr

STRING

接続しているアプリケーション名とクライアントアドレス。

schema_name / table_name / column_name / constraint_name / datatype_name

STRING

エラーによって参照されるスキーマ、テーブル、列、制約、またはデータ型 (Postgresに存在する場合)。

funcname

STRING

該当する場合、エラーが発生した関数。

filename / lineno

文字列 / ロング

エラーの発生元であるPostgresソースファイルと行。

message

STRING

ログメッセージのテキスト。

detail / hint / context

STRING

Postgresで利用可能な場合は、追加の詳細、推奨される修正、およびエラーのコンテキスト。

internalquery

STRING

該当する場合、エラーに関連する内部生成クエリーです。

statement

STRING

このログエントリの作成を Trigger したステートメント。マスキング済み。マスキングされたステートメントテキストを参照してください。

truncated_mask

LONG

書き込み前に切り捨てられたフィールドがあるかどうかを示します。

列

Type

説明

sample_seq

LONG

この行のバッチ内での序数位置。

elevel

LONG

内部ログレベルのエンコーディング。

severity

STRING

The Logs severity, for example ERROR or LOG.

sqlstate

STRING

未定義の列を示す42703などのPostgres SQLSTATEエラーコード。

backend_pid / leader_backend_pid

LONG

バックエンドプロセスID、および該当する場合は並列クエリーリーダーのPID。

userid / usename

LONG / STRING

接続ロールのオブジェクトIDと名前。

datid / datname

LONG / STRING

データベースのオブジェクトIDと名前。

application_name / client_addr

STRING

接続しているアプリケーション名とクライアントアドレス。

schema_name / table_name / column_name / constraint_name / datatype_name

STRING

エラーによって参照されるスキーマ、テーブル、列、制約、またはデータ型 (Postgresに存在する場合)。

funcname

STRING

該当する場合、エラーが発生した関数。

filename / lineno

文字列 / ロング

エラーの発生元であるPostgresソースファイルと行。

message

STRING

ログメッセージのテキスト。

detail / hint / context

STRING

Postgresで利用可能な場合は、追加の詳細、推奨される修正、およびエラーのコンテキスト。

internalquery

STRING

該当する場合、エラーに関連する内部生成クエリーです。

statement

STRING

このログエントリの作成を Trigger したステートメント。マスキング済み。マスキングされたステートメントテキストを参照してください。

truncated_mask

LONG

書き込み前に切り捨てられたフィールドがあるかどうかを示します。

注記

すべてのエラータイプに対して、構造化された schema_name、table_name、column_name フィールドは入力されていません。たとえば、「列が存在しません」という解析エラー(SQLSTATE 42703)の場合、message が直接列を指定しているにもかかわらず、それらを空のままにします。これらのフィールドが入力されていることを当てにしないでください。まず message を確認してください。

コンピュートメトリクス​

コンピュートレベルのリソース使用量: CPU、メモリ、ディスクおよびネットワークI/O、ローカルファイルキャッシュ (LFC)、そしてページサーバーの前に配置されるLakebaseのコンピュート側キャッシュ。

compute_counters​

列

Type

説明

backpressure_throttling_seconds

DOUBLE

この間隔で、ストレージ層が書き込みの抑制に費やした時間。非ゼロ値は、書き込み量がストレージが吸収できる許容量を超過したことを意味します。

host_busiest_cpu_seconds / host_cpu_seconds

DOUBLE

最もビジーなコアおよび合計で消費されたCPU時間。

host_disk_read_bytes / host_disk_written_bytes

DOUBLE

ディスクI/Oボリューム。

host_network_receive_bytes / host_network_transmit_bytes

DOUBLE

ネットワーク IO ボリューム。

lfc_evictions / lfc_hits / lfc_misses / lfc_writes

LONG

この期間のローカルファイルキャッシュのアクティビティ。

replica_lfc_redo_evictions

LONG

このコンピュートが読み取りレプリカである場合、レプリカの再実行によってローカルファイルのキャッシュが強制排除されます。

列

Type

説明

backpressure_throttling_seconds

DOUBLE

この間隔で、ストレージ層が書き込みの抑制に費やした時間。非ゼロ値は、書き込み量がストレージが吸収できる許容量を超過したことを意味します。

host_busiest_cpu_seconds / host_cpu_seconds

DOUBLE

最もビジーなコアおよび合計で消費されたCPU時間。

host_disk_read_bytes / host_disk_written_bytes

DOUBLE

ディスクI/Oボリューム。

host_network_receive_bytes / host_network_transmit_bytes

DOUBLE

ネットワーク IO ボリューム。

lfc_evictions / lfc_hits / lfc_misses / lfc_writes

LONG

この期間のローカルファイルキャッシュのアクティビティ。

replica_lfc_redo_evictions

LONG

このコンピュートが読み取りレプリカである場合、レプリカの再実行によってローカルファイルのキャッシュが強制排除されます。

compute_gauges​

列

Type

説明

current_lsn

LONG

現在の先行書き込み log の位置。

replica_wal_replay_lsn / replica_wal_receive_lsn

LONG

このコンピュートが読み取りレプリカである場合の、WALのリプレイおよび受信位置。

max_connections

LONG

設定された接続制限。

lfc_working_set_size_5m / lfc_working_set_size_15m / lfc_working_set_size_60m

LONG

過去5分、15分、60分間の推定ワーキングセットサイズ。

lfc_size_limit / lfc_allocated / lfc_used

LONG

ローカルファイルキャッシュの容量と現在の使用量。

total_size_limit / total_size

LONG

全体のストレージ容量および現在の使用量。

replication_lag_bytes / replication_lag_time_ms

LONG / DOUBLE

このコンピュートがリードレプリカである場合、レプリケーションラグが発生します。

host_logical_cpus / host_memory_total_bytes

DOUBLE

コンピュートのプロビジョニングされた CPU とメモリ。

列

Type

説明

current_lsn

LONG

現在の先行書き込み log の位置。

replica_wal_replay_lsn / replica_wal_receive_lsn

LONG

このコンピュートが読み取りレプリカである場合の、WALのリプレイおよび受信位置。

max_connections

LONG

設定された接続制限。

lfc_working_set_size_5m / lfc_working_set_size_15m / lfc_working_set_size_60m

LONG

過去5分、15分、60分間の推定ワーキングセットサイズ。

lfc_size_limit / lfc_allocated / lfc_used

LONG

ローカルファイルキャッシュの容量と現在の使用量。

total_size_limit / total_size

LONG

全体のストレージ容量および現在の使用量。

replication_lag_bytes / replication_lag_time_ms

LONG / DOUBLE

このコンピュートがリードレプリカである場合、レプリケーションラグが発生します。

host_logical_cpus / host_memory_total_bytes

DOUBLE

コンピュートのプロビジョニングされた CPU とメモリ。

データベースメトリクス​

データベースごとのアクティビティ:変更された行、トランザクション、セッション、およびvacuumの状態。テーブルの肥大化と自動バキュームシグナルはここで確認できます。

データベースカウンター​

列

Type

説明

datid / datname

LONG / STRING

データベースのオブジェクトIDと名前。

active_time_ms / idle_in_transaction_time_ms / session_time_ms

DOUBLE

アクティブ状態、オープンなトランザクションでのアイドル状態、および全体的な接続に費やされた時間。

deadlocks

LONG

検出されたデッドロック数。

rows_deleted / rows_fetched / rows_inserted / rows_returned / rows_updated

LONG

その期間の行レベルのアクティビティ。

sessions_abandoned / sessions_established / sessions_fatal / sessions_killed

LONG

セッションライフサイクル数。

shared_blks_hit / shared_blks_read

LONG

共有バッファキャッシュのアクティビティ。

xact_commit / xact_rollback

LONG

コミット済みおよびロールバック済みのトランザクション。

列

Type

説明

datid / datname

LONG / STRING

データベースのオブジェクトIDと名前。

active_time_ms / idle_in_transaction_time_ms / session_time_ms

DOUBLE

アクティブ状態、オープンなトランザクションでのアイドル状態、および全体的な接続に費やされた時間。

deadlocks

LONG

検出されたデッドロック数。

rows_deleted / rows_fetched / rows_inserted / rows_returned / rows_updated

LONG

その期間の行レベルのアクティビティ。

sessions_abandoned / sessions_established / sessions_fatal / sessions_killed

LONG

セッションライフサイクル数。

shared_blks_hit / shared_blks_read

LONG

共有バッファキャッシュのアクティビティ。

xact_commit / xact_rollback

LONG

コミット済みおよびロールバック済みのトランザクション。

database_gauges​

列

Type

説明

datid / datname

LONG / STRING

データベースのオブジェクトIDと名前。

numbackends

LONG

このデータベースへの現在の接続数です。

size

LONG

データベースのディスク上のサイズ。

oldest_frozen_xid_age / oldest_mxid_age

LONG

最も古い凍結されていない行のトランザクションIDとマルチザクトIDの経過時間。上昇する値は、テーブルサイズで肥大化が視認できるようになるはるか前に、vacuumが遅れていることの最も初期の兆候です。

列

Type

説明

datid / datname

LONG / STRING

データベースのオブジェクトIDと名前。

numbackends

LONG

このデータベースへの現在の接続数です。

size

LONG

データベースのディスク上のサイズ。

oldest_frozen_xid_age / oldest_mxid_age

LONG

最も古い凍結されていない行のトランザクションIDとマルチザクトIDの経過時間。上昇する値は、テーブルサイズで肥大化が視認できるようになるはるか前に、vacuumが遅れていることの最も初期の兆候です。

制限事項​

注記

ステートメントのキャプチャ時にパスワードがマスキングされるため、キャプチャされた CREATE ROLE には PASSWORD '***' が表示されます。マスキングはステートメント内のパスワードの検出に依存しているため、不正な形式のステートメントでは検出をすり抜ける可能性があります。

Databricksでは、OAuthロールの使用を推奨しています。これにより、Databricks IDがトークンで認証され、パスワードを入力する必要がなくなります。

次の制限が適用されます:

  • COPY 操作はクエリープラン履歴にキャプチャされません。

  • PL/pgSQL関数またはプロシージャ内で実行されたクエリーは、トップレベルのステートメントとしても実行されない限り、クエリーレベルのテレメトリにはキャプチャされません。Postgres独自のステートメント追跡では、defaultでトップレベルのステートメントのみがカウントされます。

  • BranchやEndpointは、表示名(「本番運用」など)ではなく、内部ID(例:br-odd-mud-y2icrn1h)でテレメトリや知見に表示されます。知見またはテーブルの行がどのBranchまたはEndpointを参照しているかを確認する必要がある場合は、Lakebase UIでIDをクロスリファレンスしてください。

  • テレメトリの取得を有効にするGUCは、既存のコンピュートに自動的に伝播されない場合があります。プレビューを有効にした後でテレメトリが表示されない場合は、プロジェクトに接続して次を確認してください。

    SQL
    SHOW neon_monitor.log_capture_enabled;
    SHOW databricks.o11y_exporter_enabled;

    両方とも on を返す必要があります。いずれかが off を返す場合は、コンピュート Endpoint を再起動してください。

Legacy observability configurations​

テレメトリがシステムテーブルに移行する前は、独自の Unity Catalog 内のカタログおよびスキーマにテレメトリを取り込み、事前構築済みダッシュボードを提供するオブザーバビリティ設定を作成できました。既存の設定は引き続き機能し、そのダッシュボードも利用可能なままになります。新しいオブザーバビリティ設定を作成することはできなくなり、システムテーブルへの取り込みではダッシュボードが作成されません。

次のステップ​