Heroku Postgres のメトリクスのログ
この記事の英語版に更新があります。ご覧の翻訳には含まれていない変更点があるかもしれません。
最終更新日 2022年12月09日(金)
Table of Contents
Heroku Postgres Standard および Premium 層のデータベースのユーザーには、そのアプリのログストリームにデータベース関連のイベントが表示されます。これらのイベントは、時間の経過に伴う使用状況の記録や分析に役立ちます。
heroku-postgres で表示される Heroku Postgres のメトリクスは、postgres ですべてのアプリケーションに対して表示される Postgres 自体から送出される標準のアラートとは別のものです。
ログ形式
Nov 09 23:56:02 source=HEROKU_POSTGRESQL_SILVER addon=postgresql-devcenter-123456 sample#current_transaction=54017686 sample#db_size=16012956319bytes sample#tables=97 sample#active-connections=7 sample#waiting-connections=0 sample#index-cache-hit-rate=0.9239 sample#table-cache-hit-rate=0.93609 sample#load-avg-1m=0 sample#load-avg-5m=0 sample#load-avg-15m=0 sample#read-iops=0 sample#write-iops=0.13333 sample#tmp-disk-used=33849344 sample#tmp-disk-available=72944943104 sample#memory-total=4044960kB sample#memory-free=46920kB sample#memory-cached=3667532kB sample#memory-postgres=20824kB sample#wal-percentage-used=0.06512959334021144
すべての Standard および Premium 層のデータベースのアプリケーションログには、次の属性が表示されます。
source: 測定に関連するデータベースのアタッチメント名 (HEROKU_POSTGRESQL_VIOLET など)。addon: 測定に関連するデータベースのアドオン名 (Postgres-metric-68904 など)。- ログ行のタイムスタンプは、測定が取得された時刻です。
データベースメトリクス
次の属性は、特定のデータベースに適用されます。これらは、シングルテナントとマルチテナントのデータベースプランで同じです。
sample#db_size: データベースに含まれているバイト数。このメトリクスには、ディスク上のすべてのテーブルおよびインデックスデータが含まれます (データベースの肥大化を含む)。sample#tables: データベース内のテーブルの数。sample#active-connections: データベース上で確立された接続の数。sample#waiting-connections: ロックの取得を待機している接続の数。多数の接続が待機している場合、このメトリクスは不適切に処理されているデータベース並列性の兆候である可能性があります。sample#current_transaction: 現在のトランザクション ID。時間の経過に伴う書き込みを追跡するために使用できます。sample#index-cache-hit-rate: 共有バッファキャッシュから処理されたインデックス参照の比率 (小数点以下 5 桁に四捨五入)。Heroku では、可能であれば 0.99 以上の値をお勧めします。インデックスヒット率が常に 0.99 未満である場合は、高コストのクエリを調査するか、データベースプランの大容量 RAM へのアップグレードを行います。sample#table-cache-hit-rate: 共有バッファキャッシュから処理されたテーブル参照の比率 (小数点以下 5 桁に四捨五入)。Heroku では、可能であれば 0.99 以上の値をお勧めします。テーブルヒット率が常に 0.99 未満である場合は、データベースプランの大容量 RAM へのアップグレードを行います。sample#memory-postgres: データベースの Postgres プロセスによって使用されている概略のメモリ量 (KB 単位)。このメトリクスには、共有バッファキャッシュのほか、各接続のメモリが含まれます。sample#follower-lag-commits: 複製ラグ。このフォロワーがそのリーダーに対して遅れているコミットの数として測定されます。複製は非同期であるため、この数が 0 を超えていても問題ではありませんが、値が増えている場合は調査する必要があります。詳細は、「フォロワーを監視する」を参照してください。このメトリクスは、フォロワーデータベースに対してのみ公開されます。
サーバーメトリクス
これらのメトリクスはサーバーオペレーティングシステムから直接得られます。マルチテナントプランの場合、これらのメトリクスには共有サーバー上で実行されている他のデータベースも含まれるため、データベースパフォーマンスの診断時に誤解を招くことがあります。
sample#load-avg-1m、sample#load-avg-5m、およびsample#load-avg-15m: 1 分、5 分、および 15 分の期間での平均システム負荷を、使用可能な CPU の数で割ったもの。1.0 のload-avg は、平均して、プロセスがタイムスパンの 100% で CPU リソースを要求していたことを示します。この数値には I/O の待機が含まれます。バースト可能なパフォーマンスを備えたデータベースの場合は、ベースラインの負荷平均が保証されます。詳細は、技術的特性に関する記事のバースト可能なパフォーマンスのセクションを参照してください。sample#read-iops およびsample#write-iops: 16 KB ブロックの I/O サイズでの読み取りまたは書き込み操作の数。sample#memory-total: 使用可能なサーバーメモリの合計量。sample#memory-free: 使用可能な空きメモリの量 (KB 単位)。sample#memory-cached: ページキャッシュに OS で使用されているメモリの量 (KB 単位)。sample#memory-postgres: Postgres で使用されているメモリの量 (KB 単位)。sample#tmp-disk-used、sample#tmp-disk-available: tmp マウントで使用中/使用可能なバイトの数。sample#wal-percentage-used: 使用されている WAL ディスクの割合 (0.0 から1.0 で示す)。詳細は、こちらの記事を参照してください。
オペレーティングシステムは、ページキャッシュに使用するメモリ量を最大化するように設計されていますが、アプリケーションが要求した場合はそのメモリを解放することがあります。サーバーで使用できるメモリの合計量を見積もるには、sample#memory-free と sample#memory-cached を一緒に追加してください。
PgBouncer メトリクス
これらのメトリクスは、PgBouncer プーラーアタッチメントがあるすべての Heroku Postgres サーバーに含まれています。これらのメトリクスは、PgBouncer の特殊内部データベースに接続したときに SHOW POOLS; コマンドを実行することによって表示可能なもののサブセットです。
sample#client_active: アクティブなサーバー接続の割り当てがあるプーラーへのクライアント接続の数。sample#client_waiting: サーバー接続の割り当てを待機しているプーラーへのクライアント接続の数。sample#server_active: クライアント接続に現在割り当てられているサーバー接続の数。sample#server_idle: クライアント接続に現在割り当てられていないサーバー接続の数。sample#max_wait: サーバー接続の割り当てを現在待機しているすべてのクライアントで最も長い待機時間。sample#avg_query: プールされている接続経由で実行されるすべてのクエリの平均クエリ時間。sample#avg_recv: クライアントから受け取る秒あたりのバイト数。sample#avg_sent: クライアントに送信する秒あたりのバイト数。