你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

配置 PostgreSQL 服务器日志和主要版本升级日志的捕获

适用于: Azure Database for PostgreSQL 灵活服务器

可以使用 PostgreSQL 服务器日志来诊断 Azure Database for PostgreSQL 灵活服务器中遇到的特定问题,以及获取有关服务器上运行的活动的详细见解。 可以使用主要版本升级日志来排查在尝试将服务器升级到 PostgreSQL 更高主要版本期间可能发生的错误。

默认情况下,已禁用在 Azure Database for PostgreSQL 灵活服务器中捕获可供下载的服务器日志的功能。 但是,启用该功能后,Azure Database for PostgreSQL 灵活服务器会开始将服务器日志捕获到文件中,你可以下载这些文件进行详细检查。 可以使用 Azure 门户或 Azure CLI 命令列出和下载这些文件,以帮助进行任何故障排除工作。

本文介绍如何启用和禁用该功能。 其中还介绍了如何列出所有可用的服务器日志,以及如何下载其中的任何日志。

启用可供下载的 PostgreSQL 服务器日志和主要版本升级日志的捕获功能

使用 Azure 门户

  1. 选择你的 Azure Database for PostgreSQL 灵活服务器。

  2. 在资源菜单中的“监视”部分下,选择“服务器日志”

    显示“服务器日志”页的屏幕截图。

  3. 在“下载服务器日志”下,选中“启用”复选框

    显示如何配置服务器以捕获 PostgreSQL 服务器日志和主要版本升级日志的屏幕截图。可以下载捕获的日志文件进行检查。

  4. 默认情况下,日志文件将保留三天,但你可以将保留期从 1 天调整到 7 天。 使用“保留期(天)”滑块调整为所需的配置

    显示如何调整捕获的 PostgreSQL 服务器日志和主要版本升级日志的保留期的屏幕截图。

  5. 选择“保存”按钮。

    显示如何保存对服务器日志页面所做的配置更改的屏幕截图。

  6. 此时会显示一则通知,指出服务正在配置可供下载的日志的捕获。

    显示通知的屏幕截图,通知指出正在应用配置更改。

  7. 操作结束后会显示一条通知,指出服务已完成可供下载的日志的捕获配置。

    显示通知的屏幕截图,通知指出已成功应用配置更改。

注意

  • 启用可供下载的服务器日志捕获功能几分钟后,第一条日志可供下载。

  • 最初,服务器日志会占用数据磁盘空间约一个小时。 然后,它们将移动到备份存储,并按配置的保留期保存在其中。

禁用可供下载的 PostgreSQL 服务器日志和主要版本升级日志的捕获功能

使用 Azure 门户

  1. 选择你的 Azure Database for PostgreSQL 灵活服务器。

  2. 在资源菜单中的“监视”部分下,选择“服务器日志”

    显示“服务器日志”页的屏幕截图。

  3. 在“下载服务器日志”下,取消选中“启用”复选框

    屏幕截图显示了如何配置服务器,以停止捕获可供下载的 PostgreSQL 服务器日志和主要版本升级日志。

  4. 选择“保存”按钮。

    显示如何保存对服务器日志页面所做的配置更改的屏幕截图。

  5. 此时会显示一则通知,指出服务正在配置可供下载的日志的捕获。

    显示通知的屏幕截图,通知指出正在应用配置更改。

  6. 操作结束后会显示一条通知,指出服务已完成可供下载的日志的捕获配置。

    显示通知的屏幕截图,通知指出已成功应用配置更改。

列出可供下载的已捕获日志

使用 Azure 门户

  1. 选择你的 Azure Database for PostgreSQL 灵活服务器。

  2. 在资源菜单中的“监视”部分下,选择“服务器日志”

    屏幕截图显示了“服务器日志”页,其中捕获了一些日志。

  3. 表格显示了所有尚未删除的已捕获日志文件。 在某个时间点捕获的、但由于超出配置的保留期而被删除的文件将不再可见,也不再可供访问。 使用“搜索日志文件”、“日志时间范围”和“日志类型”框,可以定义筛选条件来减少显示的日志。 通过选择列标题,可以根据所选标题代表的属性值按升序或降序对可见日志文件列表进行排序。 在提供的每个列下,你可以看到每个文件的不同属性:

    • 名称:日志文件的名称。 服务为每个日志文件分配一个符合 postgresql_yyyy_mm_dd_hh_00_00.log 模式的名称。
    • 上次更新时间:每个日志文件的上次上传时间戳。 大约每 10 分钟上传一次日志文件。
    • 大小:日志文件占用的字节大小
    • 日志类型:“服务器日志”表示该文件对应于 PostgreSQL 服务器日志。 “升级日志”表示该文件对应于主要版本升级日志

    屏幕截图显示了“服务器日志”页,其中捕获了一些日志并突出显示了列标题。

  4. 表格内容不会自动更新。 若要查看最新信息,可以选择“刷新”

    屏幕截图显示了“服务器日志”页,并突出显示了用于更新页面内容的“刷新”按钮。

下载可供下载的已捕获日志

使用 Azure 门户

  1. 选择你的 Azure Database for PostgreSQL 灵活服务器。

  2. 在资源菜单中的“监视”部分下,选择“服务器日志”

    屏幕截图显示了“服务器日志”页,其中捕获了一些日志。

  3. 表格显示了所有尚未删除的已捕获日志文件。 在某个时间点捕获的、但由于超出配置的保留期而被删除的文件将不再可见,也不再可供访问。 使用“搜索日志文件”、“日志时间范围”和“日志类型”框,可以定义筛选条件来减少显示的日志。 通过选择列标题,可以根据所选标题代表的属性值按升序或降序对可见日志文件列表进行排序。 标识你要下载的日志,然后在“操作”列下选择“下载”

    屏幕截图显示了“服务器日志”页,其中捕获了一些日志并突出显示了如何下载其中的一个日志。

  4. 如果你要一次性下载多个日志文件,请选择你要下载的所有文件,然后在工具栏中选择“下载”

    屏幕截图显示了“服务器日志”页,其中捕获了一些日志并突出显示了如何下载多个文件。

  5. 表格内容不会自动更新。 若要查看最新信息,可以选择“刷新”

    屏幕截图显示了“服务器日志”页,并突出显示了用于更新页面内容的“刷新”按钮。