애플리케이션 토폴로지 보기

이 문서에서는 애플리케이션 모니터링이 App Hub 애플리케이션, 서비스, 워크로드에 대해 만드는 토폴로지 맵을 보는 방법을 설명합니다. 애플리케이션 토폴로지 맵은 알림과 트래픽을 모니터링하고 문제를 해결하는 데 도움이 되는 애플리케이션 관계의 동적 뷰를 제공합니다.

토폴로지 맵 이해하기

애플리케이션 토폴로지 맵은 애플리케이션 성능에 대한 동적이고 실행 가능한 뷰를 제공하여 모니터링 및 문제 해결을 간소화합니다. 토폴로지 맵은 다음과 같이 노드와 에지를 사용하여 애플리케이션을 나타냅니다.

  • 노드는 애플리케이션의 서비스와 워크로드를 나타냅니다.

    예시 애플리케이션의 토폴로지

  • 에지는 서비스와 워크로드 간의 애플리케이션 트래픽을 나타냅니다.

    에지는 지연 시간과 오류율을 표시합니다.

토폴로지 맵은 완전히 대화형입니다. 노드를 확대 및 축소하고 이동하여 서비스와 워크로드 간의 관계를 시각화할 수 있습니다. 특정 노드 또는 에지의 상태에 관한 추가 세부정보를 제공하는 패널을 열려면 노드 또는 에지를 클릭합니다.

시작하기 전에

애플리케이션 토폴로지 맵을 생성하려면 추적 데이터에 애플리케이션별 라벨이 포함되어야 합니다. 이러한 라벨은 OpenTelemetry로 앱을 계측하고, trace 데이터를 Telemetry API로 전송하고, App Hub에 애플리케이션을 등록한 경우에만 사용할 수 있습니다.

시작하려면 다음 안내를 따르세요.

  1. 애플리케이션 모니터링 설정에 설명된 대로 애플리케이션 모니터링을 구성합니다. 애플리케이션 모니터링 설정에는 trace 데이터를 저장하는 모든 프로젝트를 나열하도록 기본 trace 범위를 구성하는 작업이 포함됩니다.
  2. 앱 지원 폴더를 사용하는 경우 앱 토폴로지 API를 사용하지 못하도록 하는 기본 서비스 사용량 제한 정책이 프로젝트에 적용됩니다. 이 문제를 해결하려면 조직 정책 관리자 역할이 있는 사용자가 앱 지원 폴더 관리 프로젝트의 정책 허용 목록에 apptopology.googleapis.com을 추가해야 합니다. 조직 수준에서도 정책이 적용될 수 있습니다. 자세한 내용은 리소스 사용량 제한을 참조하세요.

  3. Enable the Observability, App Topology, and Telemetry APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    trace 범위에 다른 프로젝트를 추가한 경우 해당 프로젝트에 Observability API도 사용 설정하는 것이 좋습니다. 애플리케이션 토폴로지 맵에는 App Hub 프로젝트와 동일한 조직에 있는 trace 범위 프로젝트의 trace 에지만 표시됩니다.

  4. 애플리케이션 토폴로지를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 앱 토폴로지 뷰어(roles/apptopology.viewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

    이 사전 정의된 역할에는 애플리케이션 토폴로지를 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

    필수 권한

    애플리케이션 토폴로지를 보려면 다음 권한이 필요합니다.

    • 토폴로지를 생성하려면: apptopology.applicationTopologies.generate

    커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

  5. OpenTelemetry를 사용하도록 애플리케이션을 계측하고 trace 데이터를 OTLP 엔드포인트로 전송합니다.

토폴로지 맵 보기

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

    애플리케이션 모니터링으로 이동

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

  2. Google Cloud 콘솔의 프로젝트 선택기에서 App Hub 호스트 프로젝트 또는 관리 프로젝트를 선택합니다.

  3. 목록에서 애플리케이션을 선택합니다.

  4. 토폴로지 탭을 클릭합니다. 애플리케이션의 토폴로지 맵이 표시됩니다.

토폴로지 맵은 완전히 대화형입니다. 노드를 확대 및 축소하고 이동하여 서비스와 워크로드 간의 관계를 시각화할 수 있습니다. 노드 또는 에지에 대한 세부정보를 볼 수도 있습니다.

  • 서비스 또는 워크로드의 미해결 알림 또는 속성을 보려면 노드를 선택합니다.
  • 두 노드 간의 지연 시간과 오류율을 보려면 에지를 선택합니다.

문제 해결

애플리케이션 토폴로지 맵에 데이터가 표시되지 않는 이유를 파악하는 데 도움이 되는 정보는 애플리케이션 모니터링 문제 해결을 참조하세요.