이 문서에서는 Personalized Service Health에 중단이 발생한 경우 취해야 할 조치를 설명합니다.
Personalized Service Health가 이슈의 영향을 부분적으로 또는 완전히 받을 수 있습니다. Status API 리소스와 Google CloudService Health 대시보드를 통해 서비스 상태의 인시던트, 처리 문제, 성능 문제를 확인할 수 있습니다.
Status API 사용
Service Health API의 상태 API 리소스는 특정 Service Health 기능에 문제가 있는지 알려줍니다.
시작하기 전에
Status API를 사용하려면 다음 단계를 따르세요.
- 이 상태에 액세스하는 데 사용할 프로젝트 또는 조직에 Service Health API를 사용 설정합니다.
-
Verify that billing is enabled for your Google Cloud project.
- Service Health API에 액세스할 수 있는 권한을 설정합니다.
상태 API를 사용하려면 프로젝트 또는 조직에서 ID 및 액세스 관리 (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.viewerORGANIZATION_ID를 가져오려면 조직 리소스 ID 가져오기를 참고하세요.
조직에 부여된 IAM 정책은 조직의 모든 프로젝트에 상속됩니다. 이러한 정책을 사용하면 조직 전체에서 조직 및 프로젝트 이벤트 API에 액세스할 수 있습니다.
참조
사용할 수 있는 메서드와 응답의 필드 의미는 상태 API 참조를 참고하세요.
제품 또는 위치를 설정할 때는 Google Cloud 제품 및 위치에 있는 값을 사용하세요.
프로젝트 ID를 사용하여 서비스 상태 가져오기
프로젝트 ID를 사용하여 서비스 상태를 가져오려면 다음 요청을 사용하세요.
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를 사용하여 서비스 상태 가져오기
상태를 가져오려면 다음 요청을 사용하세요.
GET https://servicehealth.googleapis.com/v1beta/organizations/ORGANIZATION_ID/locations/global/status
서비스 상태가 문제없이 작동하는 경우 상태에서 다음 응답이 생성됩니다.
{
"state": "OK",
}
서비스 상태의 정확성이나 기능에 영향을 미칠 수 있는 문제가 있는 경우 상태는 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 서비스 상태 확인
Google Cloud Service Health는 Personalized Service Health에 문제가 있는지 알려줍니다. RSS 피드를 사용하여 데이터를 사용할 수도 있습니다.
Google Cloud Service Health에 대한 자세한 내용은 이슈 및 Google Cloud Service Health를 참고하세요.