애플리케이션 모니터링 문제 해결

이 문서에서는 애플리케이션 모니터링 페이지에 표시되는 데이터를 이해하는 데 도움이 되는 정보를 제공합니다. 또한 애플리케이션 데이터를 볼 수 있도록 Google Cloud 프로젝트를 구성하는 데 도움이 되는 정보도 포함되어 있습니다.

알려진 문제

이 섹션에서는 애플리케이션 모니터링과 관련된 알려진 문제를 보여줍니다.

애플리케이션 모니터링에서는 Trace 지연 시간이 제공되지 않습니다. trace 데이터를 보려면 Trace 탐색기 페이지를 사용해야 합니다. 자세한 내용은 trace 찾기 및 탐색을 참조하세요.

문제 해결

이 섹션에서는 애플리케이션 모니터링과 관련된 문제를 해결하는 방법을 설명합니다.

애플리케이션을 만들라는 메시지가 표시됨

Google Cloud 콘솔에서 애플리케이션 모니터링 페이지를 열 때 "시작하려면 애플리케이션을 만드세요" 메시지가 표시됩니다. 하지만 App Hub 애플리케이션을 등록했으므로 이 메시지가 표시되지 않아야 합니다.

이 오류를 해결하려면 리소스 선택 도구가 App Hub 호스트 프로젝트 또는 앱 지원 폴더를 위한 관리 프로젝트로 설정되었는지 확인합니다.

애플리케이션에 일부 골든 신호의 데이터가 표시되지 않음

골든 신호 값이 표시되지 않는 데는 여러 가지 이유가 있습니다.

인프라에서 측정항목 유형이 지원되지 않습니다. 예를 들어 네트워크 부하 분산기는 시스템 측정항목을 지원하지 않습니다. 자세한 내용은 애플리케이션 모니터링 지원 서비스 및 워크로드를 참조하세요.
측정항목 유형은 지원되지만 사용 가능한 데이터가 없습니다. 예를 들어 측정항목 데이터가 수집되지 않는 시기로 기간이 설정된 경우에는 골든 신호에 대해 표시할 데이터가 없습니다.

App Hub 라벨을 생성하는 리소스 목록은 애플리케이션 모니터링 지원 서비스 및 워크로드를 참조하세요.

애플리케이션의 측정항목 데이터가 누락되었거나 완전하지 않음

서비스 또는 워크로드의 차트를 볼 때 측정 항목 데이터가 차트에 표시되지 않거나 일부 데이터가 누락되었을 수 있습니다.

별도의 작업을 수행할 필요가 없습니다. 서비스 또는 워크로드에 대해 사전 정의된 대시보드에 추가되는 차트는 해당 서비스 또는 워크로드에 사용되는 리소스를 기준으로 선택됩니다. 하지만 일부 리소스는 특정 측정항목 유형에 대해 데이터를 생성하지 않을 수 있습니다. App Hub 라벨을 생성하는 리소스 목록은 애플리케이션 모니터링 지원 서비스 및 워크로드를 참조하세요.

측정항목 데이터가 완전하지 않으면 다음을 수행합니다.

프로젝트 선택 도구가 App Hub 호스트 프로젝트 또는 앱 지원 폴더를 위한 관리 프로젝트로 설정되었는지 확인합니다.
조직 관리자가 애플리케이션의 측정항목 데이터를 저장하는 프로젝트를 나열하도록 App Hub 호스트 프로젝트 또는 앱 지원 폴더를 위한 관리 프로젝트에 대해 측정항목 범위를 구성했는지 확인합니다. 자세한 내용은 애플리케이션 모니터링 설정을 참조하세요.

애플리케이션의 로그 데이터가 누락되었거나 완전하지 않음

대시보드의 로그 패널에 로그 항목이 표시되지 않거나 애플리케이션에서 생성된 모든 로그 항목이 표시되지 않습니다.

이 문제를 해결하려면 다음을 수행합니다.

로그 데이터를 보는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.
- App Hub 호스트 프로젝트 또는 앱 지원 폴더를 위한 관리 프로젝트 그리고 기본 로그 범위가 나열된 다른 모든 프로젝트에 대한 로그 뷰어(roles/logging.viewer) 역할. 이 역할은 _Default 로그 버킷에서 대부분의 로그 항목에 대한 액세스를 부여합니다. 자세한 내용은 Logging 역할을 참조하세요.
- App Hub 호스트 프로젝트 또는 앱 지원 폴더를 위한 관리 프로젝트의 기본 로그 범위에 나열된 로그 뷰에 대한 로그 뷰 접근자(roles/logging.viewAccessor) 역할. 로그 뷰에 대한 액세스 권한 부여에 대해 자세히 알아보려면 로그 뷰에 대한 액세스 제어를 참조하세요.
조직 관리자가 애플리케이션의 로그 데이터를 저장하는 리소스를 나열하도록 Ap Hub 호스트 프로젝트 또는 앱 지원 폴더를 위한 관리 프로젝트에 대해 기본 로그 범위를 구성했는지 확인합니다. 자세한 내용은 애플리케이션 모니터링 설정을 참조하세요.

알림 정책이 누락됨

애플리케이션 모니터링 대시보드에 알림 정책을 표시하려면 정책에 특정 라벨을 추가하여 알림 정책을 서비스 또는 워크로드와 연결해야 합니다.

Google Cloud 콘솔을 사용하여 알림 정책을 워크로드 또는 서비스와 연결하려면 다음을 수행합니다.

Google Cloud 콘솔에서 알림 페이지로 이동합니다.
알림으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
Google Cloud 콘솔의 툴바에서 App Hub 호스트 프로젝트 또는 앱 지원 폴더를 위한 관리 프로젝트를 선택합니다.
알림 정책을 찾아서 더보기를 클릭하고, 수정을 선택한 후 알림 및 이름 섹션으로 이동합니다.
애플리케이션 라벨 섹션에서 애플리케이션을 선택한 후 워크로드 또는 서비스를 선택합니다.
정책 저장을 클릭합니다.

이 단계를 완료하면 다음 키가 포함된 라벨이 알림 정책에 연결됩니다. 이러한 라벨을 통해 애플리케이션 및 서비스 또는 워크로드를 식별할 수 있습니다.

apphub_application_location
apphub_application_id
apphub_service_id 또는 apphub_workload_id

또한 Google Cloud CLI, Terraform, Cloud Monitoring API를 사용하여 알림 정책에 사용자 라벨을 추가할 수 있습니다. 하지만 이전 예시에 표시된 라벨 키를 사용해야 합니다. 자세한 내용은 다음을 참조하세요.

알림 정책에 애플리케이션 라벨을 추가했지만 정책이 나열되지 않음

이 문제를 해결하려면 정책에 다음 라벨이 포함되는지 확인합니다.

apphub_application_location
apphub_application_id
apphub_service_id 또는 apphub_workload_id

서비스 및 워크로드의 대시보드가 서로 다름

수행할 작업이 없습니다.

서비스 또는 워크로드에 사용되는 리소스에 따라 서비스 또는 워크로드에 표시되는 데이터가 결정됩니다.

현재 표시 중인 대시보드에 변경사항을 저장할 수 없음

서비스 또는 워크로드 대시보드에 표시된 데이터를 내보내는 동안 변경사항을 저장하려고 합니다. 툴바에는 대시보드에 저장 버튼이 표시됩니다. 하지만 이 버튼을 선택해도 변경사항을 현재 대시보드에 저장할 수 없습니다.

대시보드에 저장 버튼은 표시 중인 대시보드가 읽기 전용일 때만 표시됩니다. 하지만 이 버튼을 사용하면 변경사항을 커스텀 대시보드에 저장할 수 있습니다. 자세한 내용은 대시보드 개요를 참조하세요.

차트를 저장할 수 없음

원격 분석 데이터를 내보낼 때 툴바에서 대시보드에 저장 버튼이 사용 중지됩니다.

이 문제를 해결하려면 충분한 권한이 있는지 확인합니다.

커스텀 대시보드에 변경사항을 저장하는 데 필요한 권한을 얻으려면 관리자에게 App Hub 호스트 프로젝트 또는 앱 지원 폴더를 위한 관리 프로젝트에 대해 모니터링 편집자(roles/monitoring.editor) IAM 역할을 부여해 달라고 요청하세요.

예상치 못한 이슈가 발생함

애플리케이션 모니터링이 출시되면서 metadata.system_labels.apphub_host_project_id 라벨 이름이 metadata.system_labels.apphub_application_container로 변경되었습니다. 이러한 변경사항에 따라 일부 새로운 이슈가 생성되거나, 기존에 열려 있던 이슈가 종료되지 않을 수 있습니다. 예를 들어 측정항목 부재 정책의 경우 변경된 라벨로 인해 모니터링 중인 시계열의 샘플 보고가 중단되어 알림을 받을 수 있습니다.

수행할 작업이 없습니다. 데이터 수신이 중지되고 자동 종료 기간이 만료되면 이슈가 자동으로 종료됩니다. 자세한 내용은 부분적인 측정항목 데이터를 참조하세요.

앱 지원 폴더의 로그에 액세스할 수 없음

Google Cloud 콘솔에서 리소스 선택 도구로 앱 지원 폴더를 선택했습니다. 그런 후 로그 탐색기 페이지와 같은 Google Cloud Observability 페이지를 열면 리소스 선택 도구가 프로젝트로 재설정됩니다.

이 동작은 의도된 것입니다. 앱 지원 폴더를 선택한 후 Google Cloud Observability 페이지에 액세스하면 선택한 리소스가 폴더의 관리 프로젝트로 재설정됩니다. 일반적으로 애플리케이션의 원격 분석 데이터를 보려고 할 때 프로젝트를 선택합니다.

앱 지원 폴더의 로그에 액세스하려면 리소스 선택 도구를 사용하여 폴더를 수동으로 선택합니다.