要点OTel PostgreSQL レシーバーを使用して、ClickStack で PostgreSQL のパフォーマンスメトリクスを監視します。デモデータセットと、あらかじめ用意されたダッシュボードが含まれています。
既存の PostgreSQL とのインテグレーション
前提条件
- ClickStack インスタンスが稼働していること
- PostgreSQL がインストール済みであること (バージョン 9.6 以降)
- ClickStack から PostgreSQL へネットワーク接続できること (デフォルトポート 5432)
- 適切な権限を持つ PostgreSQL の監視ユーザー
監視ユーザーに必要な権限があることを確認する
PostgreSQL レシーバーでは、統計ビューへの読み取り権限を持つユーザーが必要です。監視ユーザーにpg_monitor ロールを付与してください。カスタム OTel collector 設定を作成する
ClickStack では、カスタム設定ファイルをマウントし、環境変数を設定することで、ベースの OpenTelemetry collector 設定を拡張できます。postgres-metrics.yaml を作成します。tls: insecure: true の設定は、開発/テスト用途では SSL 検証を無効にします。本番環境の PostgreSQL で SSL を有効にしている場合は、この行を削除するか、適切な証明書を設定してください。メトリクス収集を確認する
設定後、HyperDX にログインして、メトリクスが取り込まれていることを確認します。- Metrics explorer に移動します
postgresql.で始まるメトリクスを検索します (例:postgresql.backends、postgresql.commits)- 設定した収集間隔でメトリクスのデータポイントが表示されるはずです
デモデータセット
データベースレベルのメトリクスのみこのデモデータセットには、サンプルデータを軽量に保つため、データベースレベルのメトリクスのみが含まれています。実際の PostgreSQL データベースを監視する場合は、テーブルおよび索引のメトリクスも自動的に収集されます。
サンプルのメトリクスデータセットをダウンロードする
事前生成済みのメトリクスファイルをダウンロードします (実際の傾向を再現した 24 時間分の PostgreSQL メトリクス) :- 朝の接続急増 (08:00) - ログイン集中
- cache パフォーマンスの問題 (11:00) - Blocks_read が急増
- アプリケーションのバグ (14:00-14:30) - rollback 率が 15% まで急上昇
- deadlock の発生 (14:15、16:30) - まれに発生する deadlock
HyperDX でメトリクスを確認する
読み込み後、メトリクスをすばやく確認するには、あらかじめ用意されたダッシュボードを使うのが最も簡単です。ダッシュボードと可視化 セクションに進み、ダッシュボードをインポートして、多くの PostgreSQL メトリクスを一度に確認してください。タイムゾーン表示HyperDX は、タイムスタンプをブラウザーのローカルタイムゾーンで表示します。デモデータの期間は 2025-11-10 00:00:00 - 2025-11-11 00:00:00 (UTC) です。どの地域からでもデモメトリクスを確実に表示できるよう、時間範囲を 2025-11-09 00:00:00 - 2025-11-12 00:00:00 に設定してください。メトリクスが表示されたら、可視化を見やすくするために、24 時間の範囲に絞り込めます。
ダッシュボードと可視化
ダッシュボード設定をする
あらかじめ用意されたダッシュボードをインポートする
- HyperDX を開き、Dashboards セクションに移動します
- 右上の三点メニュー内にある Import Dashboard をクリックします
postgres-metrics-dashboard.jsonファイルをアップロードし、Finish Import をクリックします
ダッシュボードを表示する
ダッシュボードは、すべての可視化が事前設定された状態で作成されます。デモデータセットでは、時間範囲を 2025-11-10 00:00:00 - 2025-11-11 00:00:00 (UTC) に設定してください (ローカルのタイムゾーンに合わせて調整してください) 。インポートしたダッシュボードには、デフォルトでは時間範囲が設定されていません。
トラブルシューティング
カスタム設定が読み込まれない
HyperDX にメトリクスが表示されない
認証エラー
次のステップ
- 重要な閾値 (接続数の上限、ロールバック率の高さ、キャッシュヒット率の低さ) に対するアラートを設定します
pg_stat_statements拡張機能でクエリレベルの監視を有効にします- 異なる endpoint と service name を使用して receiver の設定を複製し、複数の PostgreSQL インスタンスを監視します