PGBouncer

Supported OS Linux Mac OS

インテグレーションバージョン8.1.0

概要

PgBouncer チェックは、接続プールメトリクスを追跡し、アプリケーションに出入りするトラフィックの監視を可能にします。

セットアップ

インストール

PgBouncer チェックは Datadog Agent パッケージに含まれています。PgBouncer ノードに追加でインストールする必要はありません。

このチェックには、PgBouncer インスタンスを照会するための関連ユーザーが必要です。

  1. PgBouncer の pgbouncer.ini ファイルに Datadog ユーザーを作成します。

    stats_users = datadog

  2. PgBouncer の userlist.txt ファイルに datadog ユーザーの関連パスワードを追加します。

    "datadog" "<PASSWORD>"

  3. 認証情報を確認するには、次のコマンドを実行します。

    psql -h localhost -U datadog -p 6432 pgbouncer -c \
"SHOW VERSION;" \
&& echo -e "\e[0;32mpgBouncer connection - OK\e[0m" \
|| echo -e "\e[0;31mCannot connect to pgBouncer\e[0m"

    パスワードの入力を要求されたら、userlist.txt に追加したパスワードを入力します。

構成

    ホスト

    ホストで実行中の Agent に対してこのチェックを構成するには

    メトリクスの収集

    1. Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの pgbouncer.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル pgbouncer.d/conf.yaml を参照してください。

      init_config:

instances:
  ## @param database_url - string - required
  ## `database_url` parameter should point to PgBouncer stats database url (ie. "pgbouncer")
  #
  - database_url: "postgresql://datadog:<PASSWORD>@<HOSTNAME>:<PORT>/<DATABASE_URL>?sslmode=require"

      注: PgBouncer のインスタンスに SSL サポートがない場合は、sslmode=require を sslmode=allow と置換してサーバーエラーを防ぎます。詳細は、SSL サポートの Postgres ドキュメントを参照してください。

    2. Agent を再起動します。

    ログ収集

    Agent バージョン 6.0 以降で利用可能

    1. Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml ファイルでこれを有効にします。

      logs_enabled: true

    2. Pgbouncer のログの収集を開始するには、次の構成ブロックを pgbouncer.d/conf.yaml ファイルに追加します。

      logs:
  - type: file
    path: /var/log/postgresql/pgbouncer.log
    source: pgbouncer
    service: "<SERVICE_NAME>"

      path パラメーターと service パラメーターの値を変更し、環境に合わせて構成してください。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル pgbouncer.d/conf.yaml を参照してください。

    3. Agent を再起動します。

    コンテナ化

    コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。

    メトリクスの収集
    パラメーター値
    <INTEGRATION_NAME>pgbouncer
    <INIT_CONFIG>空白または {}
    <INSTANCE_CONFIG>{"database_url": "postgresql://datadog:<パスワード>@%%host%%:%%port%%/<データベース_URL>?sslmode=require"}
    ログ収集

    Agent バージョン 6.0 以降で利用可能

    Datadog Agent で、ログの収集はデフォルトで無効になっています。有効にする方法については、Kubernetes ログ収集を参照してください。

    パラメーター値
    <LOG_CONFIG>{“source”: “pgbouncer”, “service”: “pgbouncer”}

    検証

    Agent の status サブコマンドを実行し、Checks セクションで pgbouncer を探します。

    収集データ

    メトリクス

    注: PgBouncer のバージョンによっては、すべてのメトリクスを使用できないことがあります。

    イベント

    PgBouncer チェックには、イベントは含まれません。

    サービスチェック

    pgbouncer.can_connect
    Agent が監視対象の PGBouncer インスタンスに接続できない場合は、CRITICAL を返します。それ以外の場合は、OK を返します。
    Statuses: ok, クリティカル

    トラブルシューティング

    ご不明な点は、Datadog のサポートチームまでお問合せください。

    PREVIEWING: may/embedded-workflows