이 페이지는 Cloud Translation API를 통해 번역되었습니다.

애플리케이션 텔레메트리 보기
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 문서에서는 App Hub 애플리케이션, 서비스, 워크로드의 기본 제공 (OOTB) 대시보드를 보는 방법을 설명합니다. 이러한 대시보드를 사용하면 애플리케이션의 리소스 실적을 파악하고 문제를 진단할 수 있습니다.

이러한 OOTB 대시보드에 표시되는 텔레메트리에는 로그 및 측정항목 데이터와 미해결 이슈에 관한 정보가 포함됩니다. 애플리케이션 대시보드는 위치, 중요도, 소유자와 같은 정보를 제공합니다. 서비스 및 워크로드 대시보드에는 App Hub 및 인프라 유형에 관한 정보가 포함됩니다.

애플리케이션별 라벨

App Hub별 라벨을 사용하면 Google Cloud Observability에서 OOTB 대시보드의 계층 구조를 구성하고 표시된 원격 분석을 서비스 또는 워크로드의 원격 분석으로 필터링할 수 있습니다. 이러한 라벨을 사용하여 로그 및 측정항목 데이터를 필터링할 수도 있습니다. 이러한 라벨은 애플리케이션이 App Hub와 통합된 Google Cloud리소스에서 실행될 때 연결됩니다. 이러한 라벨은 Google Cloud Managed Service for Prometheus 측정항목이 처리될 때 연결될 수 있습니다.

로그 라벨

로그 항목에는 애플리케이션 및 서비스 또는 워크로드의 라벨을 나열하는 apphub 필드가 포함됩니다. 다음은 이 데이터의 형식을 보여줍니다.

apphub: {
  application: {
    id: "my-app"
    location: "my-app-location"
  }
  workload: {
    criticalityType: "MEDIUM"
    environmentType: "STAGING"
    id: "my-workload-id"
  }
}

측정항목 라벨

이 섹션에서는 애플리케이션별 라벨을 Google Cloud 리소스에서 생성된 측정항목 데이터와 Google Cloud Managed Service for Prometheus를 사용하여 처리된 Prometheus 측정항목에 연결하는 방법을 설명합니다. 다음에서 a.b.{x,y}를 a.b.x 및 a.b.y로 해석합니다.

다음 App Hub 라벨은 애플리케이션에서 사용하는 Google Cloud 리소스의 측정항목 데이터에 연결됩니다.

metadata.system_labels.apphub_application_{container,id,location}
metadata.system_labels.apphub_{workload,service}_{criticality_type,environment_type,id}

다음 중 하나가 true인 경우 App Hub 애플리케이션 라벨이 Google Cloud Managed Service for Prometheus 측정항목에 연결됩니다.

워크로드가 버전 1.30 이상의 Google Kubernetes Engine 클러스터에서 실행 중이며 워크로드의 컨트롤러 유형이 다음 중 하나입니다.
- apps.k8s.io/{Deployment,StatefulSet,DaemonSet}
- batch.k8s.io/CronJob
Cloud Run에서 OpenTelemetry를 사용하는 경우
Google Kubernetes Engine에서 OpenTelemetry를 사용하고 OTLP Kubernetes 처리 안내를 따르는 경우

Managed Service for Prometheus는 App Hub API를 사용하여 App Hub 애플리케이션이 있는지 확인합니다. 애플리케이션이 발견되면 다음 애플리케이션별 라벨이 트레이스 데이터에 추가됩니다.

metric.labels.apphub_application_{container,id,location}
metric.labels.apphub_workload_{criticality_type,environment_type,id}

알림 정책 라벨

서비스 및 워크로드 라벨은 알림 정책에 자동으로 연결되지 않습니다. 하지만 다음 키와 함께 다음 라벨을 모두 알림 정책에 연결하여 특정 워크로드 또는 서비스와 알림 정책을 연결할 수 있습니다.

apphub_application_location
apphub_application_id
apphub_service_id 또는 apphub_workload_id

알림 정책에 이전 키가 포함된 경우 정책의 이슈가 OOTB 대시보드에 표시됩니다.

자세한 내용은 알림 정책을 서비스 또는 워크로드와 연결을 참고하세요.

Google Cloud 콘솔 탐색

Google Cloud Observability 페이지가 열리면 Google Cloud 콘솔에서 리소스 선택 도구를 앱 지원 폴더에서 폴더의 관리 프로젝트로 자동 재설정합니다.

Cloud Logging은 폴더를 리소스로 지원합니다. 예를 들어 폴더 리소스에서 로그 수신기와 로그 버킷을 만들 수 있습니다. 마찬가지로 폴더에는 _Default 및 _Required 로그 버킷이 포함되어 있으며, 이러한 버킷의 콘텐츠를 확인할 수 있습니다. 폴더 리소스에 액세스하려면 리소스 선택 도구를 사용하여 앱 지원 폴더를 수동으로 선택합니다.

시작하기 전에

애플리케이션 모니터링을 사용하려면 먼저 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 구성해야 합니다. 애플리케이션의 원격 분석 데이터를 보려면 다음 프로젝트를 사용하세요.

로그 및 측정항목 데이터를 보고 알림 정책을 만들고 대시보드를 맞춤설정하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.
- App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트 및 기본 로그 범위가 나열된 다른 모든 프로젝트의 로그 뷰어 (roles/logging.viewer). 이 역할은 _Default 로그 버킷의 대부분의 로그 항목에 대한 액세스 권한을 부여합니다. 자세한 내용은 Logging 역할을 참고하세요.
- App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트의 기본 로그 범위에 나열된 로그 뷰에 대한 로그 뷰 접근자 (roles/logging.viewAccessor). 로그 뷰에 대한 액세스 권한 부여에 대해 자세히 알아보려면 로그 뷰에 대한 액세스 제어를 참고하세요.
- App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트에 대한 모니터링 편집자 (roles/monitoring.editor) 알림 정책 또는 대시보드를 만들거나 수정할 필요가 없는 사용자에게는 Monitoring 뷰어 역할 (roles/monitoring.viewer)을 부여하는 것이 좋습니다.
- App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트에 있는 App Hub 뷰어 자세한 내용은 App Hub 역할 및 권한을 참고하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트의 관측 가능성 범위를 구성했는지 확인합니다. 자세한 내용은 애플리케이션 모니터링 설정을 참고하세요.

관측 가능성 범위는 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트에서 사용할 수 있는 데이터를 제어합니다. 이러한 범위의 기본 설정으로 인해 일부 로그 또는 측정항목 데이터를 볼 수 없을 수 있습니다.
애플리케이션 데이터를 모니터링하는 알림 정책을 업데이트하여 애플리케이션별 라벨을 포함합니다. 자세한 내용은 알림 정책을 서비스 또는 워크로드와 연결을 참고하세요.

모든 애플리케이션 요약 보기

최상위 OOTB 대시보드에는 등록된 애플리케이션의 상태가 간단하게 요약되어 표시됩니다. 이 페이지에는 애플리케이션별로 미해결 이슈의 수와 위치, 심각도, 환경에 관한 정보가 표시됩니다.

App Hub에 등록된 애플리케이션의 요약 정보가 표시되는 최상위 OOTB 대시보드를 열려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 애플리케이션 모니터링 페이지로 이동합니다.
Application monitoring으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
Google Cloud 콘솔의 툴바에서 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 선택합니다.
선택사항: App Hub에서 애플리케이션을 열려면 더보기를 클릭하고 AppHub에서 관리를 선택합니다.
애플리케이션의 OOTB 대시보드를 열려면 애플리케이션을 선택합니다. 다음 섹션에서는 원격 분석을 탐색하거나 해석하는 방법을 안내합니다.

애플리케이션 원격 분석 및 이슈 살펴보기

애플리케이션 모니터링 페이지에 나열된 애플리케이션을 선택하면 애플리케이션의 최상위 OOTB 대시보드가 열립니다. 이 대시보드는 미해결 이슈 수를 요약하고 여러 골드 신호의 값을 나열하여 애플리케이션의 상태를 파악하는 데 도움이 됩니다. 예를 들어 이 페이지에 광범위한 실패가 표시되면 실패의 원인이 애플리케이션이 아닌 인프라일 수 있습니다.

애플리케이션의 OOTB 대시보드를 열려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 애플리케이션 모니터링 페이지로 이동합니다.
Application monitoring으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
Google Cloud 콘솔의 툴바에서 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 선택합니다.
애플리케이션 모니터링 페이지에서 애플리케이션의 이름을 선택합니다.

애플리케이션의 OOTB 대시보드가 개요 탭이 선택된 상태로 열립니다. 이 탭에는 각 서비스 및 워크로드와 함께 미해결 문제 수 및 골드 신호 값이 표시됩니다.
- 트래픽: 선택한 기간 동안 리소스의 수신 요청 비율입니다.
- 서버 오류율: 선택한 기간 동안 5xx 계열 HTTP 오류 코드를 생성하거나 이에 매핑하는 수신 요청의 평균 비율입니다.
- P95 지연 시간: 선택한 기간 동안 집계된 서비스 요청 지연 시간의 95번째 백분위수(밀리초)입니다.
- 포화도: 서비스 또는 워크로드의 '가득참' 정도를 측정합니다. 관리형 인스턴스 그룹 (MIG), Cloud Run, Google Kubernetes Engine 배포와 같은 컴퓨팅 기반 리소스를 사용하는 서비스 및 워크로드의 경우 이 필드에 CPU 사용률이 표시됩니다.
개요 탭에서는 다음 작업을 모두 할 수 있습니다.
- 기간을 재설정합니다. 대시보드를 열면 시간 범위가 가장 최근 1시간으로 설정됩니다.
- 운영자, 개발자, 비즈니스 소유자와 같은 애플리케이션에 관한 정보를 확인합니다.
- App Hub에서 애플리케이션, 서비스 또는 워크로드를 엽니다.
- 서비스 또는 워크로드의 대시보드를 엽니다.
애플리케이션 원격 분석 및 미해결 이슈에 관한 정보를 보려면 대시보드 탭을 선택합니다.

대시보드 탭에는 로그, 측정항목, 이슈 정보가 표시됩니다. 이 탭에는 탭에 표시되는 데이터를 제한하는 데 사용할 수 있는 필터도 포함되어 있습니다. 이 탭을 탐색하는 방법에 대한 자세한 내용은 이 문서의 다음 섹션을 참고하세요.

대시보드 필터링

대시보드 탭에는 애플리케이션의 서비스 및 워크로드에 관한 데이터가 표시됩니다. 하지만 이 대시보드를 특정 서비스 또는 서비스 집합으로 필터링할 수 있습니다.

예를 들어 대시보드 탭의 툴바에는 apphub_service_id: *과 같은 필터가 포함되어 있습니다. 특정 서비스의 데이터를 보려면 메뉴를 클릭한 다음 목록에서 해당 서비스를 선택합니다.

로그 데이터 살펴보기

애플리케이션 대시보드의 대시보드 탭을 보는 경우 로그 데이터가 애플리케이션 로그 섹션에 표시됩니다. 그렇지 않으면 데이터 데이터가 로그 섹션에 표시됩니다.

대시보드의 애플리케이션 로그 및 로그 섹션에는 필터와 일치하고 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트의 기본 로그 범위에 나열된 리소스에 의해 저장된 로그 항목이 표시됩니다. 애플리케이션의 경우 필터는 다음과 비슷합니다.

-- Application logs
(apphub_application_location=global)
(apphub_application_id=my-app)

서비스 및 워크로드의 경우 필터에 추가 절이 포함됩니다. 로그 데이터에 적용된 필터를 보려면 쿼리 표시를 클릭합니다.

쿼리를 작성하려면 플라이아웃을 열거나 로그 탐색기 페이지를 열면 됩니다. 두 옵션 모두 쿼리를 작성하고 실행하며 범위를 변경할 수 있습니다. 하지만 플라이아웃을 사용하면 현재 컨텍스트가 유지되며 탐색 분석 결과를 맞춤 대시보드에 저장할 수 있습니다.

플라이아웃을 열려면 데이터 탐색을 클릭합니다.

탐색 분석이 완료되면 취소를 클릭하여 플라이아웃을 닫고 변경사항을 삭제합니다. 커스텀 대시보드에 변경사항을 저장하려면 대시보드에 저장을 클릭하고 대화상자를 완료합니다. 플라이아웃을 열 때 보고 있던 대시보드에는 변경사항을 저장할 수 없습니다.

플라이아웃에 쿼리 표시 버튼에 표시된 필터가 표시되지 않습니다. 이러한 필터는 대시보드 수준에서 적용되며 삭제할 수 없습니다.
새 브라우저 탭에서 로그 탐색기 페이지를 열려면 로그 탐색기에서 보기를 클릭합니다.

쿼리는 특정 애플리케이션 라벨과 일치하고 대시보드에서 지정한 기간에 해당하는 로그 항목을 표시하도록 사전 구성됩니다. 브라우저 탭을 닫으면 변경사항이 삭제됩니다.

로그를 탐색하는 방법에 관한 자세한 내용은 다음 문서를 참고하세요.

측정항목 데이터 살펴보기

대시보드의 차트와 표에는 애플리케이션, 서비스 또는 워크로드에서 사용하는 리소스와 관련된 골든 신호 및 기타 측정항목 데이터가 표시됩니다. 표시된 데이터는 App Hub 호스트 프로젝트의 측정항목 범위 또는 앱 지원 폴더의 관리 프로젝트에 나열된 모든 프로젝트에 저장할 수 있습니다.

측정항목 데이터를 표시하는 차트 또는 표에서 측정항목 유형 및 집계 옵션과 같은 세부정보를 볼 수 있습니다. 이 정보를 보려면 차트 또는 표의 툴바로 이동한 다음 정보를 클릭합니다.

차트 또는 표를 자세히 살펴보려면 플라이아웃을 열거나 측정항목 탐색기 페이지를 열면 됩니다. 두 옵션 모두 다양한 차트 설정을 시도하고 결과를 맞춤 대시보드에 저장할 수 있습니다. 하지만 플라이아웃은 현재 컨텍스트를 유지합니다.

플라이아웃을 열려면 데이터 탐색을 클릭합니다.

탐색 분석이 완료되면 취소를 클릭하여 플라이아웃을 닫고 변경사항을 삭제합니다. 커스텀 대시보드에 변경사항을 저장하려면 대시보드에 저장을 클릭하고 대화상자를 완료합니다. 플라이아웃을 열 때 보고 있던 대시보드에는 변경사항을 저장할 수 없습니다.
측정항목 탐색기에서 차트 또는 표를 보려면 툴바로 이동하여 더보기를 클릭한 다음 측정항목 탐색기에서 보기를 선택합니다.

이제 수정하고 살펴볼 수 있는 임시 차트가 생성되었습니다. 예를 들어 집계 옵션을 변경하거나 표시 스타일을 변경할 수 있습니다. 차트를 커스텀 대시보드에 저장하려면 대시보드에 저장을 클릭하고

이슈 살펴보기

대시보드의 알림 섹션에는 서비스 또는 워크로드와 연결된 알림 정책의 최근 이슈가 나열됩니다. 이러한 알림 정책은 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트에 저장되어야 합니다.

알림 섹션에 항목이 표시되지 않으면 서비스 또는 워크로드와 연결된 알림 정책이 없는 것입니다. 이 연결을 만들려면 정책에 라벨을 추가합니다. 자세한 내용은 알림 정책을 서비스 또는 워크로드와 연결을 참고하세요.

이슈 및 알림 정책에 대한 자세한 내용을 확인하려면 다음 단계를 따르세요.

이슈의 원인이 된 알림 정책에 대한 세부정보를 확인하려면 정책 이름을 클릭합니다. 열리는 대시보드에는 모니터링된 데이터와 라벨을 표시하는 차트를 비롯하여 알림 정책에 관한 자세한 정보가 표시됩니다.
애플리케이션과 연결된 모든 알림 정책을 보려면 툴바로 이동하여 탐색기 데이터를 클릭합니다. 모든 정책이 나열된 플라이아웃이 열립니다. 대시보드로 돌아가려면 취소를 클릭합니다.

서비스 또는 워크로드 원격 분석 및 이슈 살펴보기

각 서비스 및 워크로드에 대해 OOTB 대시보드가 제공됩니다. 이러한 대시보드는 로그, 측정항목, 이슈 정보를 표시하며 특정 서비스 또는 워크로드의 상태를 파악하는 데 도움이 됩니다. 이러한 사전 정의된 대시보드의 데이터는 애플리케이션의 대시보드 탭에 표시된 데이터를 탐색하는 것과 비슷하게 탐색할 수 있습니다.

서비스 또는 워크로드의 OOTB 대시보드를 열려면 다음 단계를 따르세요.

Google Cloud 콘솔에서 애플리케이션 모니터링 페이지로 이동합니다.
Application monitoring으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
Google Cloud 콘솔의 툴바에서 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 선택합니다.
애플리케이션 모니터링 페이지에서 애플리케이션 이름을 선택한 다음 서비스 또는 워크로드를 선택합니다.

대시보드에는 선택한 서비스 또는 워크로드의 로그, 측정항목, 이슈 정보가 표시됩니다. 이 데이터를 탐색하는 방법에 대한 자세한 내용은 이 문서의 다음 섹션을 참고하세요.

커스텀 대시보드 만들기

Google Cloud Observability는 커스텀 대시보드 생성을 지원하므로 대시보드 콘텐츠를 완전히 제어할 수 있습니다. 맞춤 대시보드는 Google Cloud 콘솔의 대시보드 페이지에 표시되며 복사, 수정, 삭제할 수 있습니다. 구성한 대시보드 위젯을 저장하는 대상일 수도 있습니다. 예를 들어 애플리케이션 대시보드에서 차트를 살펴보고 있다면 툴바로 이동하여 대시보드에 저장을 선택하여 해당 차트를 커스텀 대시보드에 저장할 수 있습니다.

애플리케이션, 서비스 또는 워크로드의 맞춤 대시보드를 만들 계획이라면 다음이 도움이 될 수 있습니다.

대시보드 개요 문서에서는 위젯 유형을 요약하고 작업 기반 안내 링크를 제공합니다.
맞춤 대시보드에 대시보드 수준 필터를 추가할 수 있습니다. 이러한 필터를 사용하면 개별 위젯에 필터를 추가하는 것보다 더 효율적이고 유연할 수 있습니다. 필터는 라벨을 기반으로 합니다. 라벨 목록은 이 문서의 애플리케이션별 라벨 섹션을 참고하세요.
기존 템플릿에 원하는 콘텐츠가 대부분 포함되어 있는지 고려합니다. 템플릿을 저장하는 GitHub 저장소 링크를 비롯한 자세한 내용은 대시보드 템플릿 설치를 참고하세요.

알림 정책을 App 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를 사용하여 알림 정책에 사용자 라벨을 추가할 수도 있습니다. 하지만 이전 예에 표시된 라벨 키를 사용해야 합니다. 자세한 내용은 다음을 참조하세요.

문제 해결

조회 중인 데이터 또는 대시보드에 데이터가 표시되지 않는 이유를 파악하는 데 도움이 되는 정보는 애플리케이션 모니터링 문제 해결을 참고하세요.