配置 PostgreSQL 监视

您必须配置 Monitoring Agent for PostgreSQL，以便代理程序可从正受监视的 PostgreSQL 数据库收集数据。

开始之前

必须先安装 PostgreSQL JDBC 驱动程序，然后再安装此代理程序。代理程序配置时需要此驱动程序的路径。

JDBC 第 4 类驱动程序是新版本，因此最好使用此版本。用户可以根据代理程序所使用的 JDK 版本来安装 JDBC 4 版本的子类型。要了解 JDBC 版本到 JDK 版本的映射，请从 https://jdbc.postgresql.org/download.html 获取更多信息。

代理程序收集的一些属性依赖于 pg_stat_statements 扩展。要添加 pg_stat_statements，请先安装 postgresql-contrib 程序包。必须修改 postgresql.conf 配置文件以使 PostgreSQL 服务器装入 pg_stat_statements 扩展。
  1. 在文本编辑器中打开 postgresql.conf 文件，并更新 shared_preload_libraries 行：
    shared_preload_libraries = 'pg_stat_statements'
pg_stat_statements.track_utility = false
    除实用程序命令以外，监视 SQL 语句需要这些更改。
    注： pg_stat_statements.track_utility 的状态仅由超级用户设置或修改。
  2. 在更新并保存 postgresql.conf 后，重新启动 PostgreSQL 服务器。
  3. 使用 psql 运行以下 SQL 命令，它应该与稍后将在用于 JDBC 连接的代理程序配置中提供的数据库相连接：
    create extension pg_stat_statements; 
select pg_stat_statements_reset();
    注： 命令 create extension 和函数 pg_stat_statements_reset() 仅由超级用户运行。
    视图 pg_stat_statements 需要对特定数据库启用，有关更多详细信息，请参阅 https://www.postgresql.org/docs/9.6/static/pgstatstatements.html。

pg_hba.conf 文件是包含认证设置的 PostgreSQL 数据库文件。在 pg_hba.conf 文件中将 auth-method 参数值设置为 ident 时，PostgreSQL 代理程序 无法连接到 PostgreSQL 数据库。确保 auth-method 参数的认证设置正确。例如，可以将 auth-method 参数的这些值设置为：md5、trust 或 password。

查看必备硬件和软件。有关最新系统需求信息，请参阅 PostgreSQL 代理程序 的软件产品兼容性报告 (SPCR)。

关于此任务

PostgreSQL 代理程序是一个多实例代理程序；您必须手动创建第一个实例并启动代理程序。“受管系统名称”包含指定的实例名称，例如，instance_name:host_name:pc，其中，pc 是两字符产品代码。“受管系统名称”限制为 32 个字符。指定的实例名称限制为 28 个字符（减去主机名长度后）。例如，如果指定 PostgreSQL2 作为实例名称，那么受管系统名称为 PostgreSQL2:hostname:PN。
要点： 如果指定长实例名称，那么会截断受管系统名称，并且也不会完全显示代理程序代码。

产品版本和代理程序版本通常不同。此处的方向针对的是此代理程序的最新发行版。有关如何检查环境中代理程序版本的信息，请参阅 代理程序版本命令。有关代理程序版本列表以及每个版本的新增功能的详细信息，请参阅 变更历史记录。

下一步做什么

登录 Cloud APM 控制台可在仪表板中查看代理程序所收集的数据。有关使用 Cloud APM 控制台的信息，请参阅启动 Cloud APM 控制台。