使用日志流服务查看实时应用程序日志记录

已完成

此单元将介绍如何查看实时应用日志流,以及实时日志流如何在 Web 应用开发过程中提供帮助。

什么是实时日志流式处理?

实时日志流式处理是查看实时日志以进行故障排除的简便有效方式。 实时日志流式处理可实现快速查看发送到文件系统中的应用日志的所有消息,而无需完成查找和打开这些日志的过程。 要使用实时日志记录,可从命令行连接到实时日志服务,然后即可实时查看正在写入应用日志的文本。

可以流式传输哪些日志?

日志流式处理服务从文件系统日志中添加重定向,因此你看到的信息与保存到这些日志文件中信息相同。 因此,如果为 ASP.NET Windows 应用启用详细日志记录,则实时日志流会显示所有已记录的消息。

Screenshot of Azure portal live log stream pane showing output from the asp logs container.

使用实时日志记录的典型方案

实时日志记录是进行初始调试的有用工具。 实时日志消息为你提供有关代码或服务器问题的即时反馈。 然后即可进行更改、重新部署应用,并立即查看结果。

实时日志流连接到一个应用实例,因此不适用于有多个实例应用的情况。 在扩展应用时,实时日志记录的用途也很有限。 在这些情况下,最好确保将消息保存到可以离线打开和研究的日志文件中。

如何使用实时日志流式处理

可直接从 Azure 门户在 Cloud Shell 会话中通过命令行启用实时日志流。 有两个选项:Azure CLI 或 curl 命令。

Azure CLI

若要打开日志流,请运行以下命令。

az webapp log tail --name <app name> --resource-group <resource group name>

若要停止查看实时日志,请按 Ctrl+C

Curl

若要使用 Curl,你需要 FTPS 凭据。 有两种类型的 FTPS 凭据:

  • 应用程序作用域。 Azure 会在部署 Web 应用时自动创建用户名/密码对,并且每个应用都有独立的凭据集。

  • 用户作用域。 可以创建自己的凭据以用于任何 Web 应用。 只要至少已有一个 Web 应用,就可以在 Azure 门户中管理这些凭据,也可以使用 Azure CLI 命令来管理。

Azure 门户 UI

若要查看和复制这些详细信息,请在 Azure 门户的“应用服务”菜单中,在“部署”下选择“部署中心”,然后选择“FTPS 凭据”选项卡。 选项卡。

Screenshot of the App Service Deployment Center pane showing FTPS credentials tab.

重置用户级凭据

若要创建一组新的用户级凭据,请在 Cloud Shell 中运行以下命令。

az webapp deployment user set --user-name <name-of-user-to create> --password <new-password>

备注

用户名必须在整个 Azure 中全局唯一,而不仅仅是在你自己的订阅或目录中。

创建一组凭据后,可运行以下命令打开日志流。 然后系统会提示输入密码。

curl -u {username} https://{sitename}.scm.azurewebsites.net/api/logstream

若要关闭活动日志流会话,请按 Ctrl+C