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

JavaScript 应用程序的源映射支持

Application Insights 支持将源映射上传到你自己的存储帐户 Blob 容器。 源映射可用于取消缩小在端到端事务详细信息页上找到的调用堆栈。 JavaScript SDKNode.js SDK 发送的任何异常都可以通过源映射来取消缩小。

Unminify a Call Stack by linking with a Storage Account

新建存储帐户和 Blob 容器

如果已有存储帐户或 blob 容器,则可以跳过此步骤。

  1. 新建存储帐户
  2. 在存储帐户中创建 Blob 容器。 请务必将“公共访问级别”设置为 Private,以确保你的源映射不可公开访问。

Your container access level must be set to Private

将源映射推送到 Blob 容器

应将持续部署管道配置为自动将源映射上传到已配置的 Blob 容器,从而将持续部署管道集成到你的存储帐户。

可将源映射上传到 Blob 存储容器,其文件夹结构与编译和部署时的文件夹结构相同。 常见的用例是用其版本作为部署文件夹的前缀,例如 1.2.3/static/js/main.js。 当通过名为 sourcemaps 的 Azure Blob 容器取消缩小时,将尝试提取位于 sourcemaps/1.2.3/static/js/main.js.map 处的源映射。

如果使用 Azure Pipelines 持续生成和部署应用程序,请将 Azure 文件复制任务添加到管道,自动上传源映射。

Add an Azure File Copy task to your Pipeline to upload your source maps to Azure Blob Storage

使用源映射存储帐户配置 Application Insights 资源

从“端到端事务详细信息”页

可以在“端到端事务详细信息”选项卡中单击“取消缩小”,在资源未配置的情况下,它会显示配置提示。

  1. 在门户中,查看已缩小异常的详细信息。
  2. 选择“取消缩小”。
  3. 如果资源尚未配置,则会显示一条消息,提示你进行配置。

从“属性”页

如果要配置或更改已链接到 Application Insights 资源的存储帐户或 Blob 容器,可以通过查看 Application Insights 资源的“属性”选项卡来完成此操作。

  1. 导航到 Application Insights 资源的“属性”选项卡。
  2. 选择“更改源映射 blob 容器”。
  3. 选择与源映射容器不同的 Blob 容器。
  4. 选择 Apply

Reconfigure your selected Azure Blob Container by navigating to the Properties Blade

故障排除

Blob 容器中所需的 Azure 基于角色的访问控制 (Azure RBAC) 设置

门户上使用此功能的任何用户都必须至少作为存储 Blob 数据读取者分配给 Blob 容器。 你必须将此角色分配给要通过此功能使用源映射的任何其他人。

注意

此角色可能尚未自动分配给你或你的团队,具体取决于容器的创建方式。

找不到源映射

  1. 验证相应的源映射是否已上传到正确的 blob 容器
  2. 验证源映射文件是否以它映射到的 JavaScript 文件命名,并以 .map 为后缀。
    • 例如,/static/js/main.4e2ca5fa.chunk.js 将搜索名为 main.4e2ca5fa.chunk.js.map 的 Blob。
  3. 检查浏览器的控制台,看是否记录了任何错误。 在任何支持票证中包含此错误信息。

后续步骤