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

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

알려진 문제

이 섹션에는 애플리케이션 모니터링과 관련된 알려진 문제가 나와 있습니다.

  • 애플리케이션 모니터링에서는 트레이스 지연 시간을 사용할 수 없습니다. Trace 탐색기 페이지를 사용하여 trace 데이터를 확인해야 합니다. 자세한 내용은 trace 찾기 및 탐색을 참고하세요.

문제 해결

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

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

Google Cloud 콘솔에서 애플리케이션 모니터링 페이지를 열면 '애플리케이션을 만들어 시작'이라는 메시지가 표시됩니다. App Hub 애플리케이션을 등록했으므로 이 메시지가 표시되지 않을 것으로 예상됩니다.

이 실패를 해결하려면 리소스 선택 도구가 App Hub 호스트 프로젝트 또는 앱 사용 설정 폴더의 관리 프로젝트로 설정되어 있는지 확인하세요.

애플리케이션에서 일부 골드 신호의 데이터를 표시하지 않음

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

  • 인프라에서 측정항목 유형을 지원하지 않습니다. 예를 들어 네트워크 부하 분산기는 시스템 측정항목을 지원하지 않습니다. 자세한 내용은 App Hub 지원 리소스를 참고하세요.

  • 측정항목 유형은 지원되지만 사용 가능한 데이터가 없습니다. 예를 들어 측정항목 데이터가 수집되지 않은 간격으로 기간이 설정된 경우 골드 신호에 표시할 데이터가 없습니다.

App Hub 라벨을 생성하는 리소스 목록은 App Hub 지원 리소스를 참고하세요.

애플리케이션의 측정항목 데이터가 누락되었거나 불완전함

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

별도의 조치를 취하지 않아도 될 수도 있습니다. 서비스 또는 워크로드의 사전 정의된 대시보드에 추가된 차트는 해당 서비스 또는 워크로드에서 사용하는 리소스를 기반으로 선택됩니다. 그러나 일부 리소스는 특정 측정항목 유형의 데이터를 생성하지 않을 수 있습니다. App Hub 라벨을 생성하는 리소스 목록은 App Hub 지원 리소스를 참고하세요.

측정항목 데이터가 불완전한 경우 다음을 수행합니다.

  1. 프로젝트 선택 도구가 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트로 설정되어 있는지 확인합니다.

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

애플리케이션의 로그 데이터가 누락되었거나 불완전함

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

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

  1. 로그 데이터를 보는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

    • App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트 및 기본 로그 범위가 나열된 다른 모든 프로젝트의 로그 뷰어 (roles/logging.viewer). 이 역할은 _Default 로그 버킷의 대부분의 로그 항목에 대한 액세스 권한을 부여합니다. 자세한 내용은 Logging 역할을 참고하세요.
    • App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트의 기본 로그 범위에 나열된 로그 뷰에 대한 로그 뷰 접근자 (roles/logging.viewAccessor). 로그 뷰에 대한 액세스 권한 부여에 대해 자세히 알아보려면 로그 뷰에 대한 액세스 제어를 참고하세요.

  2. 조직 관리자가 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트의 기본 로그 범위를 구성하여 애플리케이션의 로그 데이터를 저장하는 리소스를 나열했는지 확인합니다. 자세한 내용은 애플리케이션 모니터링 설정을 참고하세요.

알림 정책이 누락됨

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

Google Cloud 콘솔을 사용하여 알림 정책을 워크로드 또는 서비스와 연결하려면 다음 단계를 따르세요.

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

    알림으로 이동

    검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

  2. Google Cloud 콘솔의 툴바에서 App Hub 호스트 프로젝트 또는 앱 사용 설정 폴더의 관리 프로젝트를 선택합니다.
  3. 알림 정책을 찾아 더보기를 클릭하고 수정을 선택한 다음 알림 및 이름 섹션으로 이동합니다.
  4. 애플리케이션 라벨 섹션에서 애플리케이션을 선택한 다음 워크로드 또는 서비스를 선택합니다.
  5. 정책 저장을 클릭합니다.

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

  • 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 호스트 프로젝트 또는 앱 사용 설정 폴더의 관리 프로젝트에 대한 Monitoring 편집자 (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 페이지에 액세스하면 선택한 리소스가 폴더의 관리 프로젝트로 재설정됩니다. 일반적으로 애플리케이션의 원격 분석 데이터를 보려면 프로젝트를 선택해야 합니다.

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