AlloyDB Omni Kubernetes オペレーターのカスタム リソース指標

このページでは、AlloyDB Omni Kubernetes オペレーターのカスタム リソース（CR）指標について説明します。AlloyDB Omni Kubernetes オペレーターは、kube-state-metrics を使用して、カスタム リソース マニフェストから構築された指標を Prometheus 形式で公開します。

指標タイプは Prometheus 指標タイプの定義に従います。Prometheus Info 指標は、Prometheus ゲージ指標の特別な種類です。値は常に 1 で、対応する AlloyDB Omni Kubernetes オペレーター カスタム リソースに関する重要な情報を提供する複数のラベルがあります。

カスタム リソース指標を有効にする方法については、AlloyDB Omni Kubernetes オペレーター カスタム リソースをモニタリングするをご覧ください。

カスタム リソース定義（CRD）のメタデータ ラベル

すべてのカスタム リソース指標には、CRD のグループ、バージョン、種類を示す次のラベルがあります。詳細については、Kubernetes API のコンセプトをご覧ください。ラベルの定義と命名は次の表に示します。

Key（キー） 説明 値の例

customresource_group

CRD のグループ。

alloydbomni.dbadmin.goog

customresource_version

CRD のバージョン。

v1

customresource_kind

CRD の種類。

DBCluster

DBCluster の指標

DBCluster 指標は、DBCluster リソース マニフェストから公開されます。DBCluster の指標名はすべて alloydb_omni_dbcluster_ で始まります。すべての DBCluster 指標には次のラベルがあります。

Key（キー） 値

namespace

DBCluster が属する Namespace。

dbcluster

DBCluster カスタム リソースの名前。

次の表のラベルの値は空になります。DBCluster マニフェストに関連するフィールドが存在しない場合、これらのラベルは Prometheus 指標名とラベルに従って存在しないラベルと同等と見なされます。

指標名 説明 ラベル 単位 タイプ

alloydb_omni_dbcluster_ha_ready

DBCluster の高可用性（HA）の準備状況: ha-ready の場合は 1、それ以外の場合は 0. reason: この DBCluster が HA の準備ができている（またはできていない）理由。 1 ゲージ

alloydb_omni_dbcluster_primary_ready

DBCluster プライマリ ノードの準備状況: 準備ができている場合は 1、そうでない場合は 0. reason: この DBCluster のプライマリ ノードの準備が整っている（いない）理由。 1 ゲージ

alloydb_omni_dbcluster_status_info

DBCluster. の現在のステータス
  • phase: DBCluster の位相。
  • database_version: AlloyDB Omni イメージの現在の実行バージョン（15.7.0 など）。
  • controlplane_agents_version: コントロール プレーン エージェント イメージの現在の実行バージョン（1.3.0 など）。
  • read_write_endpoint: DBCluster の読み取り / 書き込みエンドポイント.
  • read_only_endpoint: DBCluster の読み取り専用エンドポイント。
  • primary_phase: DBCluster プライマリ ノードのフェーズ。
  • haready_status: HAReady の状態ステータス（True または False.）
  • haready_reason: HAReady 状態の理由。
 1 情報

alloydb_omni_dbcluster_spec_info

DBCluster マニフェストの spec フィールドの DBCluster 構成。
  • num_standbys:構成されたスタンバイ ノードの数。
  • database_version: 構成された AlloyDB Omni イメージのバージョン（15.7.0 など）。
  • controlplane_agents_version: 構成されたコントロール プレーン エージェント イメージのバージョン（1.3.0 など）。
  • is_deleted: この DBCluster が削除対象かどうかを示します。true または false. に設定します。
  • allow_external_incoming_traffic: この DBCluster が Kubernetes クラスタ外からのトラフィックを許可するように構成されているかどうかを示す（true または false）。
 1 情報

alloydb_omni_dbcluster_spec_num_standbys

DBCluster 仕様で定義されたスタンバイの数。 なし 1 ゲージ

alloydb_omni_dbcluster_critical_incident_info

DBCluster マニフェスト status.criticalIncidents セクションの重大なインシデント エントリ。
  • create_time: 重大なインシデントが発生した時刻。
  • message: 重大なインシデントのエラー メッセージ。
  • code: 重大なインシデントのエラーコード。
 1 情報

alloydb_omni_dbcluster_critical_incident_create_time

重大なインシデントが発生した時刻。Unix エポック時刻形式で表します。
  • message: 重大なインシデントのエラー メッセージ。
  • code: 重大なインシデントのエラーコード。
 秒 ゲージ

フェイルオーバー指標

フェイルオーバー指標は、Failover リソース マニフェストから公開される指標です。すべてのフェイルオーバー指標名は alloydb_omni_failover_ で始まります。すべてのフェイルオーバー指標には、次のラベルがあります。

Key（キー） 値

namespace

Failover が属する名前空間。

failover

Failover カスタム リソースの名前。

dbcluster

フェイルオーバーのターゲットとなる DBCluster カスタム リソースの名前。この値は、Failover の spec.dbclusterRef フィールドと同じです。

次の表のラベルの値は空になります。また、関連するフィールドが Failover マニフェストに存在しない場合、Prometheus 指標名とラベルに基づいて存在しないラベルと同等と見なされます。

指標名 説明 ラベル 単位 タイプ

alloydb_omni_failover_start_time

この Failover の開始時刻。Unix エポック時間形式で表されます。
  • state: Failover の状態。
  • phase: Failover の位相。
 秒 ゲージ

alloydb_omni_failover_end_time

Failover が終了した時刻（Unix エポック時間形式）
  • state: Failover の状態
  • phase: Failover の位相
 秒 ゲージ

alloydb_omni_failover_status_info

Failover の現在のステータス。
  • start_time: Failover が開始された時刻。
  • end_time: Failover が終了した時刻。
  • new_primary: Failover の完了後のプライマリ ノードの名前。
  • old_primary: Failover の開始前の名前
  • phase: Failover の位相。
  • state: Failover の状態。
 1 情報

PgBouncer の指標

PgBouncer 指標は、PgBouncer リソース マニフェストから公開される指標です。PgBouncer の指標名はすべて alloydb_omni_pgbouncer_ で始まります。すべての PgBouncer 指標には次のラベルがあります。

Key（キー） 値

namespace

PgBouncer が属する名前空間。

pgbouncer

PgBouncer カスタム リソースの名前。

dbcluster

この PgBouncer がターゲットとする DBCluster カスタム リソースの名前。この値は、PgBouncer の spec.dbclusterRef フィールドと同じです。

次の表のラベルには空の値が設定されます。また、PgBouncer マニフェストに関連するフィールドが存在しない場合、Prometheus 指標名とラベルに基づいて存在しないラベルと同等と見なされます。

指標名 説明 ラベル ユニット タイプ

alloydb_omni_pgbouncer_status_info

PgBouncer の現在のステータス。
  • endpoint: この PgBouncer によって公開されるエンドポイント。このエンドポイントに接続して、この PgBouncer のターゲットである DBCluster に対してクエリを実行します。
  • phase: PgBouncer のフェーズ
 1 情報

次のステップ