Google Maps Platform 이슈 관리

이슈의 수명 주기

Google Maps Platform은 Google Cloud Platform 이슈 관리 프레임워크를 따릅니다.

서비스 중단 또는 서비스 성능 저하가 발생하면 제품 엔지니어링팀과 Google Maps Platform 지원팀이 협력하여 이슈를 해결하고 관련 내용을 사용자에게 전달합니다.

수명 주기

감지

Google은 내부 및 블랙박스 모니터링을 통해 이슈를 감지하며 조사를 위해 엔지니어에게 알림을 트리거합니다. 자세한 내용은 사이트 안정성 엔지니어링 교재의 6장을 참고하세요.

Issue Tracker에 아직 보고되지 않은 이슈를 발견한 경우 Google Cloud 콘솔의 Google Maps Platform 지원 케이스 만들기 페이지로 이동하여 새로운 지원 케이스를 작성하세요.

초기 대응

Google에서 이슈를 감지하면 지원팀이 사용자와의 커뮤니케이션을 주도합니다. 이슈의 초기 알림에 포함된 정보는 부족한 경우가 많으며 주요 증상과 함께 문제의 제품만 언급하는 경우가 종종 있습니다. 이는 Google이 세부정보보다 신속한 알림에 우선순위를 두기 때문이며 더 자세한 내용은 이후 업데이트에서 제공될 예정입니다.

대응

이슈 커뮤니케이션 채널

적절한 양의 정보를 제공하기 위해 Google Maps Platform 지원팀은 문제의 범위와 심각도에 따라 여러 가지 이슈 커뮤니케이션 채널을 제공합니다.

사용자에게 영향을 미치는 문제가 발견되는 경우 지도 공개 상태 대시보드를 확인하세요. 대시보드에는 다수의 고객에게 영향을 미치는 이슈가 표시되므로 여기에 표시된 이슈는 사용자의 문제와 관련이 있을 가능성이 높습니다. 심각도를 나타내기 위해 상태 대시보드에는 서비스 중단, 장애 또는 정보 중 하나로 이슈가 표시됩니다.

Google Maps Platform 알림 그룹은 Google Maps Platform API에 관한 기타 기술적인 업데이트뿐만 아니라 광범위한 서비스 중단이 보고되는 공개 Google 그룹입니다. 이후 업데이트에서 서비스 중단이 감지되면 문제가 해결될 때까지 모든 그룹 구성원에게 이메일 알림이 전송됩니다.

Maps Platform 상태 카드는 Maps Platform API와 서비스의 현재 상태를 보여주는 Cloud 콘솔의 지도 지원 섹션에 항상 표시되는 정보 메시지입니다. 활성 이슈가 있으면 영향을 받는 제품을 식별하는 메시지와 활성 이슈를 확인할 수 있는 지도 공개 상태 대시보드 링크가 포함됩니다.

서비스 중단

Issue Tracker에는 알려진 모든 이슈의 참조 목록이 포함됩니다. 미해결 이슈를 구독하여 확인하고 진행 상태를 추적할 수 있으며 Google팀의 조사에 도움이 되는 의견을 제공할 수 있습니다. 또한 Issue Tracker의 링크는 Google Maps Platform 지원 문서에 포함되어 있습니다.

문제가 내 프로젝트에서만 발생하거나 제한된 수의 고객에게 영향을 주는 경우 지원 케이스가 사용됩니다. 신고된 이슈가 없는데도 문제가 해결되지 않으면 Cloud 콘솔의 Google Maps Platform 지원 케이스 만들기 페이지로 이동하여 새로운 지원 케이스를 작성합니다.

조사

제품 엔지니어링팀은 이슈의 근본 원인을 조사할 책임이 있습니다. 이슈 관리는 사이트 안정성 엔지니어가 실행하는 경우가 많지만 상황이나 제품에 따라 소프트웨어 엔지니어 또는 다른 엔지니어가 실행할 수도 있습니다. 자세한 내용은 사이트 안정성 엔지니어링 교재의 12장을 참고하세요.

문제 완화/해결

변경사항을 통해 이슈의 영향이 없어졌다고 Google이 확신하는 경우에만 문제가 해결된 것으로 간주됩니다. 예를 들어 이슈를 트리거한 변경사항을 롤백하는 것도 해결로 간주될 수 있습니다.

이슈가 진행 중인 동안 지원팀과 제품팀이 문제를 완화하려고 시도합니다. 예를 들어 과부하가 발생한 서비스에 일시적으로 추가 리소스를 제공하여 문제의 영향 또는 범위를 줄일 수 있으면 문제가 완화됩니다.

완화 현상이 보이지 않으면 지원팀에서 임시 해결 방법을 찾아 전달합니다. 임시 해결 방법이란 이슈에도 불구하고 기본적인 요구사항을 해결하기 위해 취할 수 있는 조치입니다. 예를 들어 문제가 있는 코드 경로를 회피하기 위해 API 호출에 다른 설정을 사용하는 것이 임시 해결 방법이 될 수 있습니다.

후속 활동

이슈가 계속되는 동안 지원팀은 정기적인 업데이트를 제공합니다. 업데이트에는 일반적으로 다음 내용이 포함됩니다.

  • 오류 메시지, 영향을 받는 기능, 문제의 범위 등 이슈에 대한 자세한 내용
  • 임시 해결 방법을 포함한 문제 완화 진행 상태
  • 이슈에 맞춤화된 커뮤니케이션의 타임라인
  • 이슈 해결 시점 등 상태 변경

사후 조사

모든 이슈는 이슈를 완전히 이해하고 Google이 취할 수 있는 안정성 개선 조치를 파악하기 위해 사후(이슈 발생 후) 내부 분석으로 이어집니다. 그런 다음 이러한 개선 작업을 구현하고 추적합니다. Google의 사후 조사에 대한 자세한 내용은 사이트 안정성 엔지니어링 교재의 15장을 참고하세요.

이슈 보고서

이슈가 매우 광범위하고 심각한 영향을 미치는 경우 Google은 증상, 영향, 근본 원인, 해결 조치, 향후 이슈 방지 대책을 개략적으로 설명하는 이슈 보고서를 제공합니다. 사후 조사와 마찬가지로 Google은 문제로부터 배울 수 있는 부분과 안정성을 개선하는 데 필요한 조치에 각별히 주의를 기울입니다. 사후 조사에 따른 보고서 작성 및 배포에 대한 Google의 목표는 고객을 위해 안정적인 서비스를 구축하려는 Google의 노력을 투명하게 보여주는 것입니다.

FAQ

서비스 중단이 발생하면 알림을 받고 싶습니다. 어떻게 해야 하나요?

  • 진행 중인 문제에 대한 알림을 받고 실시간으로 이슈 진행 상태를 추적하려면 Google Maps Platform 알림 그룹에 가입하세요. 이 그룹을 통해 제품 및 플랫폼 공지사항에 대한 최신 정보를 확인할 수도 있습니다.
  • RSS 피드지도 공개 상태 대시보드 하단의 JSON 기록 링크를 사용하여 현재 및 과거 이슈의 피드를 확인하세요. 대시보드의 모든 게시물은 피드의 게시물을 트리거합니다. 계속해서 최신 정보를 확인할 수 있도록 피드의 모든 게시물에는 대시보드 이벤트와 관련된 모든 메시지 및 최신 소식이 포함됩니다. 따라서 진행 상황을 종합적으로 파악하기 위해 피드 기록을 자세히 살펴보지 않아도 됩니다. RSS 피드는 XML 형식으로 게시됩니다. Google에서 제공하는 RSS 구독 확장 프로그램과 같은 브라우저 확장 프로그램을 사용하면 피드 콘텐츠를 미리 보고 즐겨 사용하는 RSS 리더를 통해 구독할 수 있습니다. JSON 기록은 과거 이슈의 JSON 웹 피드입니다. 다양한 소프트웨어 라이브러리 및 웹 프레임워크는 JSON 피드를 통한 콘텐츠 신디케이션을 지원합니다.

대시보드 홈페이지에서 어떤 유형의 상태 정보를 확인할 수 있나요?

Google 지도 공개 상태 대시보드에서는 Google Maps Platform에 속하는 API 및 서비스에 대한 정보를 제공합니다. 활성 이슈가 있는 경우 Google Maps Platform 내에 각 API 및 서비스에 대한 정보가 게시됩니다. 상태 표시기는 항상 표시되며 다음 중 하나에서 각 API 및 서비스의 전반적인 상태를 나타냅니다.

  • 서비스 중단: 프로덕션 시스템 또는 서비스가 중단되었습니다. 임시 해결 방법을 사용할 수 없거나 쉽게 구현되지 않습니다.
  • 서비스 장애: 프로덕션 시스템 또는 서비스가 부분적으로 손상되었거나 예상대로 작동하지 않습니다. 임시 해결 방법이 존재합니다.
  • 서비스 정보: 프로덕션 시스템 또는 서비스가 부분적으로 손상되었거나 예상대로 작동하지 않습니다. 일반적으로 서비스를 계속 사용할 수 있고 영향이 미미하며 소수의 사용자에게만 영향을 미칩니다.
  • 사용 가능: 서비스가 완전히 기능하고 예상대로 작동합니다.

대시보드는 실시간인가요?

지도 공개 상태 대시보드는 Google Maps Platform SLA의 적용을 받는 정식 버전 제품의 상태를 거의 실시간으로 제공하기 위한 것입니다. 모든 이슈는 게시 전에 먼저 확인되므로 처음 감지된 시간으로부터 약간 지연될 수 있습니다. 따라서 대시보드를 가동시간 추적 목적으로 사용해서는 안 됩니다.

대시보드를 사용하여 Google Maps Platform의 업타임을 모니터링할 수 있나요?

지도 공개 상태 대시보드는 GMP SLA를 기반으로 하는 GMP 서비스 상태를 모니터링하기 위한 것이 아닙니다. 특히 심각도가 낮은 이슈의 경우 대시보드에 표시되는 서비스 중단 기간이 SLA에 정의된 실제 '다운타임'을 반영하지 않을 수 있습니다. 또한 문제가 완전히 해결된 것을 확인하기 위해 문제가 완화된 후의 추가 시간이 포함되어 표시될 수도 있습니다.

API 사용량을 모니터링하거나 대시보드를 만들고 알림을 만들려면 Google Maps Platform 모니터링 페이지를 참고하세요.

대시보드에 이슈가 표시되지 않으면 어떻게 해야 하나요?

모든 이슈가 항상 모든 고객과 프로젝트에 영향을 미치는 것은 아닙니다. 광범위하고 심각한 이슈만 대시보드에 반영됩니다. 대시보드에 표시되지 않은 문제가 발생할 경우 지원팀에 문의 하시기 바랍니다.

과거 서비스 장애 및 서비스 중단에 대한 정보는 어디에서 확인할 수 있나요?

지도 공개 상태 대시보드의 기록 페이지에는 지난 365일 동안에 발생한 서비스 장애 및 서비스 중단 기록이 저장됩니다. 이슈가 진행되는 동안 지원팀에서 게시하는 이슈 보고서와 이슈에 관한 게시글을 검토하려면 이슈를 클릭하세요.

대시보드는 누가 업데이트하나요?

Google Maps Platform 지원팀은 다양한 유형의 신호를 사용하여 서비스 상태를 모니터링하고 광범위한 이슈 발생 시 대시보드를 업데이트합니다. 또한 이슈가 해결된 후에는 필요한 경우 자세한 분석 보고서도 게시합니다.

'이슈'와 '서비스 중단'은 어떻게 다른가요?

이 두 용어는 서로 바꿔 사용할 수 있지만 지도 공개 상태 대시보드 및 Google의 외부 커뮤니케이션에서 '이슈'는 서비스의 성능이 저하된 기간을 나타내고 '서비스 중단'은 Google 고객의 경험을 무용지물로 만들 정도로 서비스가 작동하지 않는 가장 심각한 장애를 나타냅니다.