Personalized Service Health のコンセプト

このドキュメントでは、Personalized Service Health（PSH）で使用される主なコンセプトと用語について説明します。これらのコンセプトを理解すると、イベントを効果的に解釈し、アラートを構成できます。

Service Health イベント

Service Health イベント （v1、v1beta）は、プロジェクトやリソースに関連する Google Cloud プロダクトに影響を与える中断イベントです。たとえば、ネットワーク停止、構成エラー、パフォーマンスの問題などがあります。

各イベントには、イベントの全体的な影響、 Google からの最新情報、 プロジェクトに固有の情報が含まれています。 Google Cloud

インシデント

インシデント は、プロジェクトに関連する、発生中のアクティブな Google Cloud サービス停止または サービス低下です。Service Health イベントのカテゴリです。

インシデントには次の情報が含まれます。

  • インシデントの影響: 影響を受ける Google Cloud プロダクトやロケーションなど、イベントの範囲の詳細。
  • からの最新情報 Google Cloud: サポートGoogle Cloud からの定期的な最新情報。
  • パーソナライズされた関連性: プロジェクトに対するインシデントの関連性。 Google Cloud
  • 症状、回避策、ETA: 影響の評価、 回避策の適用、根本原因の詳細の把握に役立つ情報。

インシデントには、インシデントの原因となった要因と、同様のインシデントの再発を防ぐために が講じる対策を含むインシデントレポートが含まれる場合があります。 Google Cloud インシデント レポートは、次の条件を満たすインシデントで利用できます。

  • インシデントがグローバルに影響を与えている、または 1 つ以上のリージョンでお客様のプロジェクトの相当な割合に影響を与えている。
  • 1 つ以上のプロダクトが利用できないか、大幅に低下している。

イベントの状態と詳細な状態

イベントには、状態を示す 2 つのフィールドがあります。これらのフィールドの値は、イベントの進行に伴って変化します。

  • イベントの状態: イベントの全体的な状態を示します。次のいずれかになります。

    • アクティブ: イベントが Google Cloud に影響を与えており、引き続き 最新情報が届きます。
    • クローズ: イベントが Google Cloud に影響を与えなくなったか、別のイベントと統合されました。

  • 詳細な状態: イベントの状態に関する詳細情報を提供します。 インシデントにのみ適用され、イベントの状態に応じて次のいずれかの値になります。

    • 発生中: Google のエンジニアがインシデントを積極的に調査して影響を特定しています。発生中のインシデントは、影響評価が完了すると、確認済みインシデントまたは解決済みインシデントになります。 アクティブなインシデントは、発生中のインシデントになる可能性があります。

      発生中のインシデントのサポートは、 Google Cloud ネットワーク プロダクトでのみ利用できます。

    • 確認済み: インシデントが Google のエンジニアによって確認され、 少なくとも 1 つの Google Cloud プロダクトに影響を与えています。解決されるまで、ステータスの最新情報が随時提供されます。

      アクティブなインシデントは、確認済みインシデントになる可能性があります。

    • 統合済み: インシデントが上位のインシデントに統合されました。以降の最新情報は、上位のインシデントにのみ公開されます。

    • 解決済み: 対策が講じられた後、インシデントが Google Cloud に影響を与えなくなりました。以降の最新情報はありません。

      クローズされたインシデントは通常、解決済みのインシデントです。

    • 誤検出: 調査の結果、Google のエンジニアは インシデントが Google Cloud に影響を与えていないと判断しました。インシデントが再度確認されると、この状態が変わる可能性があります。

    • 自動クローズ: 次の理由により、インシデントが自動的にクローズされました。

      • インシデントの影響を確認できませんでした。
      • インシデントが断続的であったか、自動的に解決されました。

      アクションや調査が行われなかったため、インシデントは解決されていません。断続的な場合、インシデントが再度発生する可能性があります。

関連性

Personalized Service Health は、すべてのインシデントがプロジェクトに与える影響を評価します。プロジェクトに対するインシデントの影響が確認された場合、または確認される可能性がある場合は、Service Health ダッシュボードと API で利用できます。

関連性 は、インシデントがプロジェクトに与える影響を示します。インシデントの進行に伴って関連性が変化する場合があります。

関連性には次のいずれかの値を指定できます。

  • 影響あり: このインシデントがプロジェクトに影響していることが確認されています。 一部の プロダクトでのみ利用できます。 Google Cloud
  • 関連あり: このインシデントはユーザーのプロジェクトに直接関係しています。 プロジェクトで使用しているロケーションにある Google Cloud プロダクトに影響を与えます。
  • 一部関連あり: このインシデントは、プロジェクトで使用する Google Cloud プロダクトに関連付けられていますが、プロジェクトには影響しない場合があります。 たとえば、プロジェクトで使用している Google Cloud プロダクトに影響する可能性があっても、インシデントがプロジェクトで使用されていないロケーションで発生していることがあります。
  • 影響なし: このインシデントはプロジェクトに影響を与えていません。
  • 不明: 現時点でプロジェクトに与える影響は不明です。

プロダクトの ID 名と表示名（アルファ版とベータ版のみ）

管理者がプロダクト ID のローカル マッピングを必要とせずにオペレーションをすばやく特定できるように、v1alpha リリースと v1beta リリースのイベント エントリでは、参照されるリソース内に表示文字列が用意されています。

具体的には、標準ペイロードで指定された Product オブジェクト（Event と OrganizationEvent の両方のimpact コレクション内）に、識別に役立つ 2 つの新しいプロパティがあります。

  • display_name（文字列）: OUTPUT_ONLY タグ。お客様が読みやすい プロダクト タイトル（"Google Cloud SQL" など）を表示します。
  • previous_display_names （文字列の繰り返し）: OUTPUT_ONLY 配列。この特定のリソースが以前サポートしていたすべてのタイトルを詳しく説明します。これにより、アクティブなリブランディングを通じてイベントを追跡する際の継続性が維持されます。

プロダクト表示フィールドは、システムの安定性を最大限に高めるため、vGA (v1) サーフェスで遅延されます。

フィルタとアラートで使用する正しい不変の ID を特定するには:

  1. サポートされているプロダクトとロケーションのガイドを開きます。
  2. 表で対象の Google Cloud プロダクトを見つけます。
  3. [プロダクト ID] に表示されている値をコピーします。

または、API ペイロードから正しい不変の ID を直接特定します。

  1. イベント リソースを返す API 呼び出し（projects.locations.events.list など）を行います。
  2. 結果の JSON 配列で impact ブロックのマッピングを調べます。
  3. product プロパティに存在する文字列を抽出します。この値は、表示名に関係なく、安定したプロダクト ID を示します。