排查应用监控问题

本文档包含的信息可能会帮助您了解应用监控页面上显示的数据。其中还包含可能有助于您配置 Google Cloud 项目的信息，以便您查看应用的数据。

已知问题

本部分列出了与应用监控相关的已知问题：

  • 应用监控不提供轨迹延迟时间。您必须使用 Trace 探索器页面查看跟踪记录数据。如需了解详情，请参阅查找和探索跟踪记录。

问题排查

本部分介绍了如何解决与应用监控相关的问题。

系统提示您创建应用

您在 Google Cloud 控制台中打开应用监控页面，然后看到“创建应用以开始使用”消息。您应该不会看到此消息，因为您已注册 App Hub 应用。

如需解决此失败问题，请确保资源选择器已设置为您的 App Hub 宿主项目或启用了应用的文件夹的管理项目。

您的应用未显示某些黄金信号的数据

导致您看不到黄金信号值的原因有多种：

  • 基础架构不支持该指标类型。例如，网络负载平衡器不支持系统指标。如需了解详情，请参阅 App Hub 支持的资源。

  • 指标类型受支持，但没有任何数据可用。例如，如果时间范围设置为未收集指标数据的时间间隔，则系统不会显示黄金信号的数据。

如需查看生成 App Hub 标签的资源列表，请参阅 App Hub 支持的资源。

应用的指标数据缺失或不完整

您查看服务或工作负载的图表，但该图表不显示任何指标数据，或者缺少部分数据。

您可能无需执行任何操作。系统会根据服务或工作负载使用的资源，为其预定义的信息中心添加图表。不过，某些资源可能不会为特定指标类型生成数据。如需查看可生成 App Hub 标签的资源列表，请参阅 App Hub 支持的资源

如果指标数据不完整，请执行以下操作：

  1. 确保将项目选择器设置为您的 App Hub 宿主项目或已启用应用的文件夹的管理项目。

  2. 让组织管理员为您的 App Hub 宿主项目配置指标范围，或为启用应用的文件夹配置管理项目，以列出存储应用指标数据的项目。如需了解详情，请参阅设置应用监控。

应用的日志数据缺失或不完整

信息中心的日志面板不显示任何日志条目，或者不显示应用生成的所有日志条目。

如需解决此失败问题，请执行以下操作：

  1. 如需获得查看日志数据所需的权限，请让您的管理员为您授予以下 IAM 角色：

    • 您可以使用 App Hub 托管项目或启用了应用的文件夹的管理项目以及列出了其默认日志范围的任何其他项目中的 Logs Viewer (roles/logging.viewer) 查看日志。此角色会授予对 _Default 日志分桶中大多数日志条目的访问权限。如需了解详情，请参阅日志记录角色。
    • 针对 App Hub 宿主项目的默认日志范围或启用了应用的文件夹的管理项目中列出的日志视图的 Logs View Accessor (roles/logging.viewAccessor)。如需详细了解如何授予对日志视图的访问权限，请参阅控制对日志视图的访问权限。

  2. 确保组织管理员已为启用了应用的文件夹配置了 App Hub 宿主项目或管理项目的默认日志范围，以列出存储应用日志数据的资源。如需了解详情，请参阅设置应用监控。

您的提醒政策缺失

如需在应用监控信息中心上显示提醒政策，您必须向提醒政策添加特定标签，以便将提醒政策与服务或工作负载相关联。

如需使用 Google Cloud 控制台将提醒政策与工作负载或服务相关联，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 提醒页面：

    进入提醒

    如果您使用搜索栏查找此页面，请选择子标题为监控的结果。

  2. 在 Google Cloud 控制台的工具栏中，选择您的 App Hub 宿主项目或启用了应用的文件夹的管理项目。
  3. 找到相应提醒政策，点击 View more（查看更多），选择 Edit（修改），然后前往Notifications and name（通知和名称）部分。
  4. 在应用标签部分，选择您的应用，然后选择您的工作负载或服务。
  5. 点击保存政策。

完成这些步骤后，系统会将具有以下键的标签附加到您的提醒政策。这些标签用于标识您的应用以及您的服务或工作负载：

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id 或 apphub_workload_id

您还可以使用 Google Cloud CLI、Terraform 或 Cloud Monitoring API 向提醒政策添加用户标签。不过，您必须使用上例中显示的标签键。详情请参阅以下内容：

您已向提醒政策添加应用标签，但该政策未列出

如需解决此失败问题，请验证该政策是否包含以下标签：

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id 或 apphub_workload_id

服务和工作负载的信息中心有所不同

您无需采取任何行动。

服务或工作负载使用的资源决定了系统会显示哪些数据。

您无法保存对所查看信息中心所做的更改

您正在探索服务或工作负载信息中心中显示的数据，并希望保存所做的更改。工具栏会显示保存到信息中心按钮。 不过，选择该按钮后，您将无法将更改保存到当前信息中心。

只有当您查看的信息中心是只读信息中心时，系统才会显示保存到信息中心按钮。不过，您可以使用此按钮将更改保存到自定义信息中心。如需了解详情，请参阅信息中心概览。

您无法保存图表

在您探索遥测数据时，工具栏中的 Save to dashboard 按钮会处于停用状态。

如需解决此失败问题，请确保您拥有足够的权限。

如需获得保存对自定义信息中心所做的更改所需的权限，请让您的管理员为您授予 App Hub 托管项目或启用了应用的文件夹的管理项目的 Monitoring Editor (roles/monitoring.editor) IAM 角色。

系统会打开意外突发事件

随着应用监控功能的发布，metadata.system_labels.apphub_host_project_id 标签已重命名为 metadata.system_labels.apphub_application_container。此更改可能会导致系统生成一些新突发事件，并且一些未结突发事件无法关闭。例如，对于指标缺失政策，您可能会收到通知，因为标签的更改可能会导致受监控的时间序列停止报告样本。

您无需采取任何行动。当数据停止传入且自动关闭期限到期后，突发事件会自动关闭。如需了解详情，请参阅部分指标数据。

您无法访问启用了应用的文件夹中的日志

您已在 Google Cloud 控制台中使用资源选择器选择了启用了应用的文件夹。然后，您打开 Google Cloud 可观测性页面（例如 Logs Explorer 页面），资源选择器会重置为项目。

这是预期行为。选择启用了应用的文件夹后，如果您访问 Google Cloud Observability 页面，所选资源会重置为该文件夹的管理项目。通常，当您要查看应用的遥测数据时，需要选择该项目。

如需访问已启用应用的文件夹中的日志，请使用资源选择器手动选择该文件夹。