メトリクスリファレンス

このページでは、Managed Postgres Prometheus エンドポイントで公開されているすべてのメトリックを一覧で確認できます。セットアップと認証については、Prometheus エンドポイントページを参照してください。

共通ラベル

すべてのメトリクスには、以下のラベルが付きます。

一部のメトリクスには、内訳の次元を表すラベルが追加されます (たとえば、CPU メトリクスの mode、接続の state、データベースサイズの database など) 。これらは各メトリクスの説明とあわせて記載しています。

PostgresServiceInfo は、常に 1 となる Gauge で、ラベルにサービスの現在のステータスとバージョンを保持します。これを使用して、他のメトリクスにステータスを結合したり、サービスが running 状態から外れたときにアラートを出したりできます。

メトリクス	Type	Extra labels	Description
`PostgresServiceInfo`	gauge	`postgres_status`, `postgres_version`	サービスごとに 1 つの series があり、値は常に `1` です。

postgres_status は、サービスの現在のライフサイクル状態を示します (例: running、creating、stopped) 。postgres_version は、Postgres のメジャーバージョン (例: 17、18) を示します。

サービスにプロビジョニングされる静的な上限値です。これらが変わるのは、サービスのサイズを変更した場合のみです。

メトリクス	型	単位	説明
`PostgresServer_CPUCores`	gauge	cores	サービスに割り当てられたCPUコア数。
`PostgresServer_MemoryLimitBytes`	gauge	bytes	サービスに割り当てられたメモリ容量。
`PostgresServer_StorageLimitBytes`	gauge	bytes	サービスに割り当てられたストレージ容量。

メトリクス	Type	Extra labels	Description
`PostgresServer_CPUSeconds_Total`	カウンター	`mode`	消費された CPU 時間。`user`、`system`、`iowait`、`softirq`、`steal`、`irq`、`nice`、`idle` の各モード別に分類されます。
`PostgresServer_MemoryUsedPercent`	Gauge		使用中のメモリ量。`PostgresServer_MemoryLimitBytes` に対する割合です。
`PostgresServer_MemoryCachePercent`	Gauge		キャッシュとバッファで使用されるメモリ量。総メモリに対する割合です。
`PostgresServer_FilesystemUsedPercent`	Gauge		使用中のファイルシステム領域。総ストレージに対する割合です。

CPU 使用率をパーセンテージで計算するには、対象のモードに対する PostgresServer_CPUSeconds_Total の rate を求め、それを PostgresServer_CPUCores で割ります。

メトリクス	型	単位	説明
`PostgresServer_DiskReads_Total`	カウンター	ops	完了したディスク読み取り操作数。
`PostgresServer_DiskWrites_Total`	カウンター	ops	完了したディスク書き込み操作数。
`PostgresServer_NetworkReceiveBytes_Total`	カウンター	bytes	ネットワーク経由で受信したバイト数。
`PostgresServer_NetworkTransmitBytes_Total`	カウンター	bytes	ネットワーク経由で送信したバイト数。

サービス開始以降の累積カウンターです。1 秒あたりの値にするには、rate() または irate() を使用します。

メトリクス	Type	Description
`PostgresServer_TuplesFetched_Total`	カウンター	クエリで取得された行。
`PostgresServer_TuplesInserted_Total`	カウンター	挿入された行。
`PostgresServer_TuplesUpdated_Total`	カウンター	更新された行。
`PostgresServer_TuplesDeleted_Total`	カウンター	削除された行。
`PostgresServer_TransactionsCommitted_Total`	カウンター	コミットされたトランザクション。
`PostgresServer_TransactionsRolledBack_Total`	カウンター	ロールバックされたトランザクション。
`PostgresServer_Deadlocks_Total`	カウンター	検出されたデッドロック。

メトリクス	Type	Extra labels	Description
`PostgresServer_ActiveConnections`	gauge	`state`	状態別の接続数 (例: `active`、`idle`) 。
`PostgresServer_CacheHitRatio`	gauge		バッファキャッシュのヒット率。キャッシュから提供されたブロック数が、アクセスされた総ブロック数に占める割合 (パーセンテージ) です。
`PostgresServer_DatabaseSizeBytes`	gauge	`database`	各データベースのディスクサイズ (バイト単位) 。デフォルトの `postgres` と、ユーザーが作成したすべてのデータベースを含みます。