在Azure Database for PostgreSQL灵活服务器中下载 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. 默认情况下,服务将日志文件保留三天,但你可以将保留期从一天调整为七天。 使用 日志保留期(以天为单位) 切片器设置所需的配置。

    显示如何调整 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. 该表不会自动更新。 若要查看最新信息,请选择“ 刷新”。

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