个性化服务健康概念

本文档介绍了 Personalized Service Health (PSH) 中使用的关键概念和术语。了解这些概念有助于您有效解读事件和配置提醒。

Personalized Service Health 事件

Service Health 事件（v1、v1beta）是指影响与您的项目或资源相关的 Google Cloud 产品的任何中断事件。示例包括网络中断、配置错误和性能问题。

每个事件都包含有关事件的总体影响、Google 的更新以及特定于您的 Google Cloud 项目的详细信息。

突发事件

突发事件是指与您的项目相关的、新出现的和正在发生的服务中断或降级。 Google Cloud 突发事件也是 Service Health 事件的一种类别。

突发事件包括以下内容：

  • 突发事件影响：事件范围的详细信息，例如受影响的Google Cloud 产品和位置。
  • Google Cloud的动态：Google Cloud 支持团队的定期动态。
  • 个性化相关性：突发事件与您的 Google Cloud项目的相关性。
  • 症状、解决方法和预计解决时间：有助于评估影响、应用解决方法或详细了解根本原因的信息。

突发事件可能具有突发事件报告，其中包含导致突发事件的因素，以及 Google Cloud 计划采取的措施，以防止类似突发事件再次发生。对于满足以下条件的突发事件，系统会提供突发事件报告：

  • 突发事件对全球产生影响，或对一个或多个区域的大量客户项目产生影响。
  • 一个或多个产品无法使用或严重降级。

事件状态和详细状态

事件有两个字段用于指示其状态。这些字段的值会随着事件的发展而变化。

  • 事件状态：表示事件的整体状态。可以是下列选项之一：

    • 活跃：事件正在影响 Google Cloud ，并将继续收到更新。
    • 已关闭：事件不再影响任何 Google Cloud 产品，或已与其他事件合并。

  • 详细状态：提供有关事件状态的更多信息。它仅适用于突发事件，并且可以是以下值之一，具体取决于事件状态：

    • 新出现：Google 工程师正在积极调查突发事件，以确定影响。影响评估完成后，新出现的突发事件将成为已确认或已解决的突发事件。活跃突发事件可能是新出现的突发事件。

      仅 Google Cloud网络产品支持新出现的突发事件。

    • 已确认：Google 工程师已确认突发事件，并且该事件至少影响一个 Google Cloud 产品。在问题解决之前，我们会持续提供状态更新。

      有效的突发事件可以是已确认的突发事件。

    • 已合并：突发事件已合并到父级突发事件中。所有后续更新都将仅发布到父级。

    • 已解决：采取措施后，突发事件不再影响任何 Google Cloud 产品。后续不会再有更新。

      已关闭的突发事件通常是已解决的突发事件。

    • 假正例：经过调查，Google 工程师得出结论，该突发事件不会影响 Google Cloud 产品。如果再次审核突发事件，则此状态可能会发生变化。

    • 自动关闭：突发事件因以下原因自动关闭：

      • 无法确认突发事件的影响。
      • 突发事件是间歇性的，或已自行解决。

      由于未采取任何措施或进行调查，因此该突发事件没有解决方案。如果问题是间歇性的，突发事件可能会重新开启。

精细中断状态

在多产品或多位置突发事件期间，个别产品或位置可能会在整体突发事件解决之前恢复。Personalized Service Health 在每个产品和每个位置级别提供精细的中断状态，以反映突发事件处于活动状态时的部分恢复情况。 项目级事件和组织级事件均提供精细的中断状态。

产品或位置可能具有以下精细中断状态之一：

  • 受影响：产品或位置因突发事件而中断。
  • 已解决：指定商品或位置不再发生中断，并且已恢复。

事件状态与精细状态之间的区别

请务必区分整体事件状态、详细状态以及各个产品或位置的精细中断状态：

  • 总体事件状态和详细状态：适用于整个突发事件。只要至少有一个产品或位置仍处于受影响状态，突发事件就会保持有效状态（具有已确认等详细状态）。只有在所有关联的产品和位置都达到已解决状态后，突发事件才会转换为已关闭（详细状态为已解决）。
  • 精细的中断状态：独立应用于每个受影响的产品或位置。单个产品或位置可以转换为已解决，而整体事件状态仍为有效。

当突发事件合并到父级突发事件中时，子级突发事件的精细中断状态会被清除，并且子级突发事件会将精细状态委托给父级突发事件，作为单一事实来源。

相关性

Personalized Service Health 会评估所有突发事件对您项目的影响。如果突发事件可能或已确认对您的项目产生影响，则该突发事件会显示在 Service Health 信息中心和 API 中。

相关性表示您的项目是否受到事件的影响、与事件相关或与事件部分相关。对于预览版中支持的产品，相关性还会识别项目中受影响的特定资源。

相关性可以具有以下值：

  • 受影响：已确认突发事件正在影响您的项目。对于受支持的产品（预览版），您还可以查看项目中哪些特定资源受到影响。
  • 相关：突发事件与您的项目直接相关，并影响您的项目所用位置的 Google Cloud 产品。
  • 部分相关：此突发事件与您的项目使用的 Google Cloud产品相关联，但可能不会影响您的项目。例如，此突发事件可能影响到您的项目所使用的 Google Cloud产品，但您的项目并未使用受影响的位置。
  • 未受影响：突发事件没有影响您的项目。
  • 未知：目前无法了解对您的项目的影响。

受影响的资源

当事件与您的项目的相关性为 IMPACTED 时，Personalized Service Health 可以识别项目中受中断影响的具体 Google Cloud 资源（例如，特定的 Cloud SQL 实例或 Google Kubernetes Engine 集群）。

在 Service Health v1beta API 中，每个受影响的资源都由一个 Impact 资源 (projects/{PROJECT_ID}/locations/global/impacts/{IMPACT_ID}) 表示。Impact 资源包含：

  • 关联的事件 (events)：与资源影响相关联的一个或多个项目级 Service Health Event 资源名称 (projects/{PROJECT_ID}/locations/global/events/{EVENT_ID})。
  • 受影响的资产 (asset)：
    • assetName：受影响的Google Cloud 资源的完整资源名称（例如 //cloudsql.googleapis.com/projects/123456789/instances/my-db-instance）。
    • assetType：受影响资源的 Cloud Asset Inventory 资源类型（例如 sqladmin.googleapis.com/Instance 或 container.googleapis.com/Cluster）。
  • 说明 (description)：有关对资源的影响的其他上下文（如有）。
  • 时间戳（createTime、updateTime）：首次创建和上次更新资源影响记录的时间。

在预览版中使用受影响的资源时，请注意以下行为：

  • 项目影响与组织影响：
    • 影响 (projects.locations.impacts) 范围限定为单个项目，并且仅在事件已确认与该项目具有 IMPACTED 相关性且产品支持可用时，才会返回非容器资源。
    • 组织影响 (organizations.locations.organizationImpacts) 会在整个组织中汇总，以返回具有任何非零相关性（PARTIALLY_RELATED、RELATED 或 IMPACTED）的容器资产（项目），其中非零相关性是指可能受 OrganizationEvent 影响的任何项目。
  • API 启用前提条件：如需接收 Impact 记录，必须在事件开始前至少 24 小时在项目中启用 Service Health API (servicehealth.googleapis.com)。在事件开始后启用 API 会回填过去 90 天的项目级事件，但不会回填资源级影响。
  • 事件持续时间生命周期：一旦资源被确定为受事件影响，其 Impact 记录就会在突发事件的生命周期内保持与事件关联。使用关联的 Event 资源跟踪总体突发事件状态（ACTIVE 或 COMPLETED）和通信更新。
  • 支持的产品和突发事件范围：资源级影响适用于受支持的 Google Cloud 产品和资源类型。如果事件影响的产品不支持资源级影响，或者中断发生在控制平面或区域级，而与单个资源实例无关，则项目 Event 仍会显示 relevance: IMPACTED，而 impacts.list 会返回一个空列表。

如需查询受影响的资源，请参阅管理影响项目的事件。

产品身份名称和显示名称（仅限 Alpha 版和 Beta 版）

为了让管理员能够快速查明操作，而无需在本地映射商品标识码，v1alpha 和 v1beta 版本中的事件条目在引用的资源中提供了显示字符串。

具体而言，在标准载荷上指定的 Product 对象（位于 Event 和 OrganizationEvent 上的 impact 集合中）中，有两个新属性有助于识别：

  • display_name（字符串）：一个 OUTPUT_ONLY 标记，用于公开适合客户朗读的人类可读商品名称（例如 "Google Cloud SQL"）。
  • previous_display_names（重复字符串）：一个 OUTPUT_ONLY 数组，详细说明此特定资源以前支持的所有标题。这样可以保持事件跟踪的连续性，即使品牌名称发生变化也不受影响。

为实现最高的系统稳定性，商品展示字段在 vGA (v1) 平台上会延迟显示。

如需确定要在过滤条件和提醒中使用的正确不可变标识符，请执行以下操作：

  1. 打开支持的产品和位置指南。
  2. 在表格中找到目标 Google Cloud 商品。
  3. 复制产品 ID 下列出的值。

或者，直接从 API 载荷中确定正确的不可变标识符：

  1. 进行 API 调用，返回事件资源（例如 projects.locations.events.list）。
  2. 检查生成的 JSON 数组中的 impact 块映射。
  3. 提取 product 属性中的字符串。此值表示稳定的产品 ID，与不同的显示名称无关。