Personalized Service Health でサービス中断を確認する

このドキュメントでは、Personalized Service Health で中断が発生した場合の対処方法について説明します。

Personalized Service Health は、インシデントの影響を部分的にまたは完全に受ける可能性があります。Service Health のインシデント、処理の問題、パフォーマンスの問題は、Status API リソースと Google CloudService Health ダッシュボードで確認できます。

Status API を使用する

Service Health API の Status API リソースは、特定の Service Health 機能で問題が発生しているかどうかを示します。

始める前に

Status API の使用を開始するには:

  1. このステータスへのアクセスに使用するプロジェクトまたは組織で Service Health API を有効にします。

  2. Make sure that billing is enabled for your Google Cloud project.

  3. Service Health API にアクセスする権限を設定します。

  4. Status API を使用するには、プロジェクトまたは組織で Identity and Access Management（IAM）の権限を構成します。

    プロジェクトの権限を構成するには、次のコマンドを実行します。

    gcloud projects add-iam-policy-binding PROJECT_ID \
--member {USER|GROUP|SERVICE_ACCOUNT} \
--role roles/servicehealth.viewer

    組織の権限を構成するには、次のコマンドを実行します。

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
--member {USER|GROUP|SERVICE_ACCOUNT} \
--role roles/servicehealth.viewer

    ORGANIZATION_ID を取得するには、組織リソース ID の取得をご覧ください。

組織に付与された IAM ポリシーは、組織内のすべてのプロジェクトに継承されます。これらのポリシーを使用すると、組織全体で組織とプロジェクトのイベント API にアクセスできます。

参照

使用できるメソッドとレスポンスのフィールドの意味については、ステータス API リファレンスをご覧ください。

プロダクトまたはロケーションを設定するときは、Google Cloud プロダクトとロケーションにある値を使用します。

プロジェクト ID を使用して Service Health のステータスを取得する

プロジェクト ID を使用して Service Health のステータスを取得するには、次のリクエストを使用します。

GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/status

ステータス値が OK の場合、リクエストは次のレスポンスを返します。

{
  "state": "OK",
}

このステータスは、プロジェクト ID を使用してアクセスされた機能（イベントや影響など）に内部的な問題が発生していないことを示します。

ステータス値が ISSUES_DETECTED の場合、リクエストは次のレスポンスを生成します。

{
  "state": "ISSUES_DETECTED",
  "issues": [
    {
      "message": "We are experiencing problems creating new events",
      "details": {
        "API": "events"
      }
    },
    {
      "message": "We are experiencing problems creating new impacts",
      "details": {
        "API": "impacts"
      }
    }
  ]
}

ISSUES_DETECTED 状態では、一連の問題も返されます。これは、プロジェクト ID を使用してアクセスした機能が正確でない可能性があることを示しています。

ステータスを取得する権限がない場合は、PERMISSION_DENIED エラーが発生します。

{
  "error": {
    "code": 403,
    "message": "Permission 'servicehealth.statuses.get' denied on resource '//servicehealth.googleapis.com/projects/PROJECT_ID/locations/global/status' (or it may not exist).",
    "status": "PERMISSION_DENIED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "IAM_PERMISSION_DENIED",
        "domain": "servicehealth.googleapis.com",
        "metadata": {
          "resource": "projects/PROJECT_ID/locations/global/status",
          "permission": "servicehealth.statuses.get"
        }
      }
    ]
  }
}

組織 ID を使用して Service Health のステータスを取得する

ステータスを取得するには、次のリクエストを使用します。

GET https://servicehealth.googleapis.com/v1beta/organizations/ORGANIZATION_ID/locations/global/status

Service Health が問題なく動作している場合、ステータスは次のレスポンスを返します。

{
  "state": "OK",
}

Service Health で精度や機能に影響する可能性のある問題が発生している場合、ステータスは ISSUES_DETECTED 状態のレスポンスを返します。

{
  "state": "ISSUES_DETECTED",
  "issues": [
    {
      "message": "We are experiencing problems creating new organization level events",
      "details": {
        "API": "organizationEvents"
      }
    },
    {
      "message": "We are experiencing problems creating new organization level impacts",
      "details": {
        "API": "organizationImpacts"
      }
    }
  ]
}

ステータスを取得する権限がない場合は、PERMISSION_DENIED エラーが返されます。

{
  "error": {
    "code": 403,
    "message": "Permission 'servicehealth.statuses.get denied on resource '//servicehealth.googleapis.com/organizations/ORGANIZATION_ID/locations/global/status' (or it may not exist).",
    "status": "PERMISSION_DENIED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "IAM_PERMISSION_DENIED",
        "domain": "servicehealth.googleapis.com",
        "metadata": {
          "resource": "organizations/ORGANIZATION_ID/locations/global/status",
          "permission": "servicehealth.statuses.get"
        }
      }
    ]
  }
}

Google Cloud Service Health を確認する

Google Cloud Service Health は、Personalized Service Health で問題が発生しているかどうかを示します。RSS フィードを使用してデータを取得することもできます。

Google Cloud Service Health の詳細については、インシデントと Google Cloud Service Health をご覧ください。