メインコンテンツへスキップ
Managed Postgres は、ClickHouse Cloud API で Prometheus 互換のメトリクス用エンドポイントを 2 つ公開しています。
組織レベルのエンドポイントは、最大 100 個のサービスのメトリクスを返します。組織に 100 個を超える Managed Postgres サービスがある場合は、サポートにお問い合わせください

認証

このエンドポイントでは、OpenAPI の他の部分と同じ [APIキー] を使用します。作成方法や組織 ID、サービス ID の確認方法については、 OpenAPI ガイドを参照してください。

組織内のすべてのサービスをスクレイプする

単一サービスのスクレイピング

レスポンス例

メトリクスの一覧とその意味については、 メトリクス リファレンスを参照してください。

Prometheus の設定

この設定では、組織レベルのエンドポイントを 60 秒ごとにスクレイプします。
このエンドポイントはメトリクスを1分ごとに更新します。60s より短い間隔で スクレイプすると、サンプルが重複し、Gauge パネルでは階段状のパターンになります。 honor_labels: true を設定すると、エンドポイントの postgres_servicepostgres_service_name ラベルは、Prometheus に上書きされずそのまま保持されます。 単一のサービスをスクレイプするには、metrics_path/<PG_ID> を追加します。

あらかじめ用意された Grafana ダッシュボード

あらかじめ用意された Grafana ダッシュボードでは、エンドポイントが公開するあらゆるメトリクスを可視化できます。これには、ソート可能なサービス一覧テーブル、CPU とメモリの使用率、閾値アラート付きのディスク使用量、状態別の接続数、トランザクションとロールバック率、Tuple のアクティビティ、I/O、データベースごとのストレージ使用量、デッドロックが含まれます。

ダッシュボードのインポート

1

ダッシュボード JSON のダウンロード

2

Grafana でインポート画面を開く

Dashboards → New → Import に移動します。JSON ファイルをアップロードするか、その内容を貼り付けます。
3

Prometheus データソースを選択する

DS_PROMETHEUS の入力を求められたら、前のセクションで設定したエンドポイントをスクレイプしている Prometheus データソースを選択します。
Grafana をプロビジョニングで運用している場合は、JSON を ダッシュボードのプロビジョニングパスに配置します。Grafana は ${DS_PROMETHEUS} 参照を、そのインスタンスで利用可能な Prometheus データソースに対応付けます。

テンプレート変数

このダッシュボードでは、3 つの変数を使用します。
  • データソース — このダッシュボードの基になる Prometheus データソース。
  • サービスpostgres_service_name に対する複数選択フィルター。 既定値は All です。1 つ以上のサービスを選択すると、すべてのパネルをその範囲に絞り込めます。
  • スクレイプ間隔 — 非表示の定数で、既定値は 60s です。これは Grafana の $__rate_interval の計算に使われます。スクレイプ間隔が異なる場合は、 JSON 内でこの値を変更してください。

ドリルインするために単一のサービスに絞り込む

いくつかのパネルは、Service 変数で単一の サービスに絞り込むと、さらに詳細を確認できるように設計されています。たとえば CPU by mode パネルでは、 usersystemiowaitsteal、その他の CPU モードを積み上げて表示するため、スパイクの原因がアプリケーションコードなのか、カーネルの処理なのか、 ディスク待ちなのか、あるいはハイパーバイザーの競合なのかを判断できます。

Grafana と Datadog とのインテグレーション

このエンドポイントは ClickHouse Prometheus エンドポイント と同じ形式のため、そこで説明されている Grafana Cloud、Grafana Alloy、Datadog OpenMetrics agent の設定は、ここでもそのまま利用できます。metrics_path は ClickHouse ではなく、Managed Postgres の 組織 または インスタンスのパスを指すようにしてください。
最終更新日 2026年7月2日