本記事では、OceanBase Cloud Exporterが提供するネイティブ監視メトリクス、一般的なラベル、元の単位、数値の意味について説明します。
メトリクスリストは現在提供可能なセットを示しており、毎回のリクエストで全てのメトリクスが含まれるわけではありません。OBのバージョン、デプロイメント形態、テナントまたはクラスタの存在、収集の成否などによって、実際に返される内容は異なります。
本記事の単位と集計基準は、Exporterが返すネイティブメトリクスに適用されます。ネイティブメトリクスとコンソール内で計算または単位換算された論理メトリクスは同名である場合がありますので、両者の単位やアラートしきい値を直接混同しないでください。接続方法については、Prometheusを使用したOceanBaseデータの監視を参照してください。
読み方のルール
- 数値の意味:
counterは累積量を表し、通常はrate()またはincrease()を使用します。gaugeは現在値を表し、通常は直接読み取ります。プロセスの再起動や統計のリセットにより、累積量がゼロに戻る可能性があります。 - 単位:Byteはバイトです。KiB、MiB、GiBは1024進法です。s、ms、μs、nsはそれぞれ秒、ミリ秒、マイクロ秒、ナノ秒です。Gbit/sは10⁹ bit/sとして計算されます。
一般的なラベル
一般的なラベルとその意味は以下のとおりです。
ラベル |
意味 |
|---|---|
app |
アプリケーションタイプ(HOST:ホスト;OB:OceanBase) |
svr_ip、host_name |
ノードIPアドレス、クラウドホスト識別子 |
ob_cluster_name |
クラスタID/識別子 |
obregion、obzone |
OBクラスタ名、OBゾーン名 |
ob_tenant_id、tenant_name |
テナントID、テナント名 |
uid |
クラウドアカウント識別子 |
obproxy_cluster |
OBProxyクラスタID |
ob_cluster_name_alias、tenant_name_alias |
クラスタ表示エイリアス、テナント表示エイリアス |
device、dev |
デバイス名 |
mountpoint、fstype |
ファイルシステムのマウントポイント、ファイルシステムタイプ |
mount_label、ob_device、is_ob_disk、is_ob_volume |
ディスク用途識別子。インストールディスク、データディスク、ログディスクなどを区別するために使用されます |
name |
プロセス名 |
stat_id |
ob_sysstat統計項目番号 |
ホストとOBのメトリクス
ホスト基本メトリクス
メトリクス名 |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
node_cpu_seconds_total |
modeで集計した累積CPU時間 |
s | counter |
node_filesystem_avail_bytes |
ファイルシステムで特権を持たないユーザーが使用可能な残り容量 | Byte | gauge |
node_filesystem_size_bytes |
ファイルシステムの総容量 | Byte | gauge |
node_disk_reads_completed_total |
ディスクで累積して完了した読み取り操作数 | 回 | counter |
node_disk_read_bytes_total |
ディスクで累積して読み取ったバイト数 | Byte | counter |
node_disk_read_time_seconds_total |
ディスク読み取り操作の累積時間 | s | counter |
node_disk_writes_completed_total |
ディスクで累積して完了した書き込み操作数 | 回 | counter |
node_disk_written_bytes_total |
ディスクに累積して書き込んだバイト数 | Byte | counter |
node_disk_write_time_seconds_total |
ディスク書き込み操作の累積時間 | s | counter |
node_load1 |
システムの直近1分間の平均負荷 | 無次元 | gauge |
node_load5 |
システムの直近5分間の平均負荷 | 無次元 | gauge |
node_load15 |
システムの直近15分間の平均負荷 | 無次元 | gauge |
node_memory_Buffers_bytes |
カーネルバッファのメモリサイズ | Byte | gauge |
node_memory_MemFree_bytes |
空きメモリサイズ | Byte | gauge |
node_memory_Cached_bytes |
ページキャッシュのメモリサイズ | Byte | gauge |
node_memory_MemTotal_bytes |
総メモリサイズ | Byte | gauge |
node_network_receive_bytes_total |
NICで累積して受信したバイト数 | Byte | counter |
node_network_transmit_bytes_total |
NICで累積して送信したバイト数 | Byte | counter |
node_boot_time_seconds |
システム起動時刻のUnixタイムスタンプ | s | gauge |
node_time_seconds |
取得時のシステムのUnixタイムスタンプ | s | gauge |
カスタムホストメトリクス
メトリクス名 |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
io_util |
サンプリング期間中にディスクがIO処理に費やした時間の割合 | % | gauge |
io_await |
サンプリング期間中の各ディスク読み書きIOの平均処理時間 | ms | gauge |
node_ntp_offset_seconds |
NTPまたはChronyが報告する時刻のずれ | s | gauge |
node_ntp_system_time_offset_seconds |
Chronyが報告するシステム時刻とNTP時刻のずれ | s | gauge |
ntp_service_available |
NTPずれの取得に成功したかどうか。1は成功、0はコマンドの実行または解析失敗を表す | 無次元 | gauge |
ntp_suitable_source_available |
chronyd -Qが適切な時刻源を検出できない場合に0を報告する(現在は異常のみを報告する)。 |
無次元 | gauge |
プロセスメトリクス
メトリクス名 |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
process_exists |
指定されたプロセスが存在するかどうか。1は存在、0は存在しないことを表す | 無次元 | gauge |
process_count |
同名のobserverプロセスの数 | 個 | gauge |
process_uptime_seconds |
observerプロセスの生存時間 | s | gauge |
process_boot_time_seconds |
observerプロセス起動時のUnixタイムスタンプ | s | gauge |
process_memory_rss_bytes |
observerプロセスの常駐メモリRSS | Byte | gauge |
process_cpu_percent |
observerプロセスのCPU利用率 | % | gauge |
process_fd_count |
observerプロセスのファイルディスクリプタ数 | 個 | gauge |
process_thread_count |
observerプロセスのスレッド数 | 個 | gauge |
OB SQLメトリクス
メトリクス名 |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
ob_role_is_rootserver |
現在のOBServerがRootServiceを担っているかどうか:1ははい、0はいいえ | 無次元 | gauge |
ob_sysstat |
v$sysstatの統計値。意味と単位はstat_idによって決まります |
stat_id表を参照 |
混合 |
ob_cache_size_bytes |
テナントの各種KVCacheの現在の使用量 | Byte | gauge |
ob_disk_total_bytes |
現在のOBServerデータディスク容量 | Byte | gauge |
ob_disk_free_bytes |
現在のOBServerデータディスクの空き容量 | Byte | gauge |
ob_plan_cache_memory_bytes |
テナントプランキャッシュの使用メモリ | Byte | gauge |
ob_plan_cache_access_total |
テナントプランキャッシュの累計アクセス回数 | 回 | counter |
ob_plan_cache_hit_total |
テナントプランキャッシュの累計ヒット回数 | 回 | counter |
ob_active_session_num |
テナントの現在のACTIVEセッション数 | 件 | gauge |
ob_all_session_num |
テナントの現在の全セッション数 | 件 | gauge |
ob_server_uptime_seconds |
現在ノードのstart_service_timeから収集時刻までの稼働時間 |
s | gauge |
ob_query_rt_cumulative_count |
SQL応答時間がle以下の累計リクエスト数 |
回;leの単位はμs |
累計バケットカウント |
ob_system_event_total_waits |
待機カテゴリ別に集計した非IDLE待機の累計回数 | 回 | counter |
ob_system_event_time_waited |
待機カテゴリ別に集計した非IDLE待機の累計時間 | s | counter |
ob_tenant_available_disk_total |
テナントが配置されている各ゾーンのOBデータディスク総容量のうち最大のもの | Byte | gauge |
ob_tenant_log_disk_total_bytes |
現在ノードがテナントに割り当てたログディスク容量 | Byte | gauge |
ob_tenant_log_disk_used_bytes |
現在ノードのテナントが使用しているログディスク容量 | Byte | gauge |
ob_tenant_server_required_size |
ノード上のテナントデータファイルが実際に占有するディスク容量 | Byte | gauge |
ob_tenant_server_data_size |
ノード上のテナントデータ量 | Byte | gauge |
ob_waitevent_wait_total |
テナントの全非IDLE待機の累計回数 | 回 | counter |
ob_waitevent_wait_seconds_total |
テナントの全非IDLE待機の累計時間 | s | counter |
ob_foreground_waitevent_cnt |
最近1秒間のASHにおけるフォアグラウンド非IDLE待機またはON_CPUサンプル数 | 件 | gauge |
ob_background_waitevent_cnt |
最近1秒間のASHにおけるバックグラウンド非IDLE待機またはON_CPUサンプル数 | 件 | gauge |
ob_sql_event_in_parse |
最近1秒間のASHサンプルのうちSQL解析段階にあるサンプル数 | 件 | gauge |
ob_sql_event_in_pl_parse |
最近1秒間のASHサンプルのうちPL解析段階にあるサンプル数 | 件 | gauge |
ob_sql_event_in_plan_cache |
最近1秒間のASHサンプルのうちプランキャッシュアクセス段階にあるサンプル数 | 件 | gauge |
ob_sql_event_in_sql_optimize |
最近1秒間のASHサンプルのうちSQL最適化段階にあるサンプル数 | 件 | gauge |
ob_sql_event_in_sql_execution |
最近1秒間のASHサンプルのうちSQL実行段階にあるサンプル数 | 件 | gauge |
ob_sql_event_in_px_execution |
最近1秒間のASHサンプルのうちPXパラレル実行段階にあるサンプル数 | 件 | gauge |
ob_sql_event_in_sequence_load |
最近1秒間のASHサンプルのうち自動インクリメント列またはSEQUENCE値取得段階にあるサンプル数 | 件 | gauge |
ob_ss_cache_total_hit_cnt |
共有ストレージローカルキャッシュの累計ヒット回数 | 回 | counter |
ob_ss_cache_total_miss_cnt |
共有ストレージローカルキャッシュの累計ミス回数 | 回 | counter |
ob_tenant_space_usage_bytes |
テナントのSPACE_TYPE分類による容量使用量 |
Byte | gauge |
ob_tenant_vector_mem_hold_bytes |
ベクトルインデックス保持メモリ量 | Byte | gauge |
ob_tenant_vector_mem_used_bytes |
ベクトルインデックス使用済みメモリ量 | Byte | gauge |
ob_tenant_vector_mem_limit_bytes |
ベクトルインデックスメモリ使用上限 | Byte | gauge |
ob_clog_ls_end_scn |
ログストリーム連続ログの終了SCN | SCN、ナノ秒単位 | gauge |
ob_clog_ls_max_replayed_scn |
ログストリームでリプレイ済みの最大SCN | SCN、ナノ秒単位 | gauge |
ob_m_disk_tenant_base_data_size |
テナントMajor SSTableベースラインデータ量、上流ルールによりレプリカ重複除去後 | Byte | gauge |
ob_user_disk_total_bytes |
お客様が設定したノードのデータディスク容量。メトリクス名は_bytesで終わるが、実際の単位はGiB |
GiB | gauge |
ob_m_ssd_threshold_iops |
SSDまたはクラウドディスク1台あたりのIOPS能力上限 | 回/秒 | gauge |
ob_m_ssd_threshold_throughput |
SSDまたはクラウドディスク1台あたりのスループット能力上限 | MiB/秒 | gauge |
ob_m_ecs_threshold_iops |
ECSインスタンスレベルディスクIOPS能力上限 | 回/秒 | gauge |
ob_m_ecs_threshold_throughput |
ECSインスタンスレベルディスクスループット能力上限 | Gbit/秒 | gauge |
ob_sysstat統計項目
メトリクスおよびラベルの例(一部のラベルは省略):ob_sysstat{stat_id="40000",ob_tenant_id="…",tenant_name="…",…}
ネットワークとリクエストキュー
stat_id |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
| 10000 | 累計受信RPCパケット数 | 回 | counter |
| 10001 | 累計受信RPCパケットサイズ | Byte | counter |
| 10002 | 累計送信RPCパケット数 | 回 | counter |
| 10003 | 累計送信RPCパケットサイズ | Byte | counter |
| 10005 | 累計RPCネットワーク遅延 | μs | counter |
| 10006 | 累計RPCフレームワーク遅延 | μs | counter |
| 20000 | 累計リクエストキュー投入回数 | 回 | counter |
| 20001 | 累計リクエストキューからの取り出し回数 | 回 | counter |
| 20002 | キュー内でのリクエストの累計待機時間 | μs | counter |
トランザクションとclogの同期
stat_id |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
| 30000 | 累計clog同期時間 | μs | counter |
| 30001 | 累計clog同期回数 | 回 | counter |
| 30002 | 累計clogコミット回数 | 回 | counter |
| 30006 | トランザクション総時間 | μs | counter |
| 30007 | 累計トランザクションコミット回数 | 回 | counter |
| 30008 | 累計トランザクションコミット時間 | μs | counter |
| 30009 | 累計トランザクションロールバック回数 | 回 | counter |
| 30010 | 累計トランザクションロールバック時間 | μs | counter |
| 30011 | 累計トランザクションタイムアウト回数 | 回 | counter |
| 30012 | 累計ローカルトランザクション回数 | 回 | counter |
| 30013 | 累計分散トランザクション回数 | 回 | counter |
SQLとカーソル
stat_id |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
| 40000 | 累計実行SELECT文数 | 回 | counter |
| 40001 | SELECT文の累計実行時間 | μs | counter |
| 40002 | 累計実行INSERT文数 | 回 | counter |
| 40003 | INSERT文の累計実行時間 | μs | counter |
| 40004 | 累計実行REPLACE文数 | 回 | counter |
| 40005 | REPLACE文の累計実行時間 | μs | counter |
| 40006 | 累計実行UPDATE文数 | 回 | counter |
| 40007 | UPDATE文の累計実行時間 | μs | counter |
| 40008 | 累計実行DELETE文数 | 回 | counter |
| 40009 | DELETE文の累計実行時間 | μs | counter |
| 40010 | 累計ローカルSQL実行回数 | 回 | counter |
| 40011 | 累計リモートSQL実行回数 | 回 | counter |
| 40012 | 分散SQL実行回数の合計 | 回 | counter |
| 40018 | その他のSQLステートメントの実行回数の合計 | 回 | counter |
| 40019 | その他のSQLステートメントの実行時間の合計 | μs | counter |
| 40030 | 現在開いているカーソルの数 (opened cursors current) | 個 | gauge |
キャッシュヒットとI/O
stat_id |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
| 50000 | row cacheヒット回数の合計 | 回 | counter |
| 50001 | row cacheミス回数の合計 | 回 | counter |
| 50004 | bloomfilterキャッシュヒット回数の合計 | 回 | counter |
| 50005 | bloomfilterキャッシュミス回数の合計 | 回 | counter |
| 50008 | block cacheヒット回数の合計 | 回 | counter |
| 50009 | block cacheミス回数の合計 | 回 | counter |
| 50010 | locationキャッシュヒット回数の合計 | 回 | counter |
| 50011 | locationキャッシュミス回数の合計 | 回 | counter |
| 50037 | clogキャッシュヒット回数の合計 | 回 | counter |
| 50038 | clogキャッシュミス回数の合計 | 回 | counter |
| 60000 | I/O読み取り回数の合計 | 回 | counter |
| 60001 | I/O読み取り遅延の累計 | μs | counter |
| 60002 | I/O読み取りバイト数の累計 | Byte | counter |
| 60003 | I/O書き込み回数の合計 | 回 | counter |
| 60004 | I/O書き込み遅延の累計 | μs | counter |
| 60005 | I/O書き込みバイト数の累計 | Byte | counter |
| 60021 | MemStore書き込みロック成功回数の合計 | 回 | counter |
| 60022 | MemStore書き込みロック失敗回数の合計 | 回 | counter |
| 60023 | MemStore書き込みロック待機時間の合計 | μs | counter |
| 80057 | トランザクションログ累積バイト数 | Byte | counter |
キャッシュ、MemStoreとリソース
stat_id |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
| 120000 | locationキャッシュの現在の使用量 | Byte | gauge |
| 120001 | clogキャッシュの現在の使用量 | Byte | gauge |
| 120008 | row cacheサイズ | Byte | gauge |
| 120009 | bloomfilterキャッシュサイズ | Byte | gauge |
| 130000 | アクティブMemStoreサイズ | Byte | gauge |
| 130001 | MemStoreの総サイズ | Byte | gauge |
| 130002 | major freezeをトリガーするしきい値 | Byte | gauge |
| 130004 | MemStoreサイズ制限 | Byte | gauge |
| 140002 | 利用可能な最大メモリ | Byte | gauge |
| 140003 | 使用済みメモリ | Byte | gauge |
| 140005 | テナントが使用できる最大CPUコア数 × 100 | 0.01 core | gauge |
| 140006 | テナントが実際に使用しているCPUコア数 × 100 | 0.01 core | gauge |
| 140013 | cgroup統計によるテナントスレッドの累積CPU時間 | μs | counter |
データベースの時間モデル
stat_id |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
| 200002 | データベースのフォアグラウンド活動の累積CPU時間(DB CPU) | μs | counter |
| 200006 | バックグラウンドプロセスの累積CPU時間 | μs | counter |
| 200010 | フォアグラウンドの累積非アイドル待機時間 | μs | counter |
| 200013 | バックグラウンドの累積非アイドル待機時間 | μs | counter |
共有ストレージマイクロブロックキャッシュIO
以下のメトリクスはIOPSまたはスループットで表されているため、rate()で計算する必要はありません。
stat_id |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
| 245012 | 共有ストレージマイクロブロックキャッシュ common_io の現在の読み取りIOPS |
回/秒 | gauge |
| 245013 | 共有ストレージマイクロブロックキャッシュ common_io の現在の読み取りスループット |
バイト/秒 | gauge |
| 245014 | 共有ストレージマイクロブロックキャッシュ common_io の現在の書き込みIOPS |
回/秒 | gauge |
| 245015 | 共有ストレージマイクロブロックキャッシュ common_io の現在の書き込みスループット |
バイト/秒 | gauge |
SQL Audit監視メトリクス
メトリクス名 |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
sql_audit_slow_sql_total_count |
agent SQL Audit収集でスロークエリと判断されたレコードの累計数 | 件 | counter |
sql_audit_failed_sql_total_count |
agent SQL Audit収集で FailCount が0より大きいレコードの累計数 |
件 | counter |
ODPとBinlogのメトリクス
ODPコンテナとKubernetesリソースメトリクス
一般的なラベルはobproxy_cluster、namespace、pod、containerであり、メトリクス特有のデバイス、NIC、リソースラベルも含まれます。具体的なラベルはクラウドプラットフォームの上流での収集および再ラベリングの結果に準じます。以下のセマンティクスはcAdvisorメトリクス定義およびkube-state-metrics Podメトリクスに基づいています。CPUクォータのマイクロ秒単位についてはcAdvisor quota説明を参照してください。
メトリクス名 |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
container_cpu_load_average_10s |
コンテナの直近10秒間のCPU平均負荷の1000倍です。使用時は返された値を1000で割って実際の平均負荷を得ます | 無次元 | gauge |
container_cpu_usage_seconds_total |
コンテナが累計で消費したCPU時間 | s | counter |
container_fs_reads_bytes_total |
コンテナファイルシステムの累計読み取りバイト数 | Byte | counter |
container_fs_reads_total |
コンテナファイルシステムの累計完了読み取り操作数 | 回 | counter |
container_fs_writes_bytes_total |
コンテナファイルシステムの累計書き込みバイト数 | Byte | counter |
container_fs_writes_total |
コンテナファイルシステムの累計完了書き込み操作数 | 回 | counter |
container_memory_cache |
コンテナページキャッシュのメモリ量 | Byte | gauge |
container_memory_usage_bytes |
コンテナの現在のメモリ使用量 | Byte | gauge |
container_network_receive_bytes_total |
コンテナネットワークの累計受信バイト数 | Byte | counter |
container_network_transmit_bytes_total |
コンテナネットワークの累計送信バイト数 | Byte | counter |
container_spec_cpu_quota |
各CFSサイクルで使用可能なCPU時間クォータ | μs/サイクル | gauge |
container_spec_memory_limit_bytes |
コンテナに設定されたメモリ制限 | Byte | gauge |
kube_pod_container_resource_limits |
Pod内のコンテナに設定されたリソース制限 | unitによる:CPUはcore、メモリはByte | gauge |
ODPパフォーマンスメトリクス
メトリクス名 |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
odp_transaction_total |
OBProxyの累計処理トランザクション数 | 回 | counter |
odp_sql_request_total |
OBProxyの累計処理SQLリクエスト数 | 回 | counter |
odp_sql_cost_total |
OBProxyがSQLリクエストを処理する累計時間 | ms | counter |
odp_current_session |
OBProxyの現在接続数 | 件 | gauge |
odp_used_connections |
OBProxyの現在クライアント接続数 | 件 | gauge |
odp_new_client_connections |
OBProxyの累計ログインクライアント接続数 | 回 | counter |
ODPプロセスメトリクス
agentのobserverメトリクスと同名ですが、異なるプロセスや収集元を表します。クエリ時にはクラスタ、ノード、プロセスの次元を保持し、両方のプロセスタイプを直接合計して混同することを避けます。
メトリクス名 |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
process_cpu_percent |
OBProxyプロセスのCPU利用率 | % | gauge |
process_memory_rss_bytes |
OBProxyプロセスの常駐メモリRSS | Byte | gauge |
Binlogメトリクス
メトリクス名 |
意味 |
元の単位 |
数値の意味 |
|---|---|---|---|
binlog_instance_disk_total_size_mb |
Binlogインスタンスが使用中のログディスク容量 | MiB(名称はmbと表記) | gauge |