Melihat topologi aplikasi

Dokumen ini menjelaskan cara melihat peta topologi yang dibuat oleh Application Monitoring untuk aplikasi, layanan, dan workload App Hub Anda. Peta topologi aplikasi memberikan tampilan dinamis hubungan aplikasi Anda untuk membantu Anda memantau pemberitahuan dan traffic, serta memecahkan masalah.

Memahami peta topologi

Peta topologi aplikasi memberikan tampilan dinamis dan dapat ditindaklanjuti terkait performa aplikasi Anda, sehingga menyederhanakan pemantauan dan pemecahan masalah. Peta topologi merepresentasikan aplikasi Anda menggunakan node dan tepi, sebagai berikut:

  • Node merepresentasikan layanan dan workload aplikasi Anda:

    Topologi aplikasi contoh.

  • Edge merepresentasikan traffic aplikasi Anda antara layanan dan beban kerja Anda:

    Edge menampilkan latensi dan tingkat error.

Peta topologi sepenuhnya interaktif. Anda dapat memperbesar dan memperkecil, serta memindahkan node untuk membantu Anda memvisualisasikan hubungan antara layanan dan beban kerja. Untuk membuka panel yang memberikan detail tambahan tentang status node atau tepi tertentu, klik node atau tepi.

Sebelum memulai

Untuk membuat peta topologi aplikasi, data rekaman aktivitas Anda harus berisi label khusus aplikasi. Label ini hanya tersedia jika Anda menginstrumentasikan aplikasi dengan OpenTelemetry, mengirim data trace ke Telemetry API, dan mendaftarkan aplikasi Anda dengan App Hub.

Untuk memulai, lakukan hal berikut:

  1. Konfigurasi Pemantauan Aplikasi seperti yang dijelaskan dalam Menyiapkan Pemantauan Aplikasi. Penyiapan untuk Pemantauan Aplikasi mencakup konfigurasi cakupan trace default untuk mencantumkan semua project yang menyimpan data aktivitas Anda.
  2. Jika Anda menggunakan Folder yang mendukung Aplikasi, project Anda akan memiliki kebijakan Pembatasan Penggunaan Layanan default yang mencegah Anda menggunakan App Topology API. Untuk mengatasinya, seseorang dengan peran Administrator Kebijakan Organisasi harus menambahkan apptopology.googleapis.com ke daftar yang diizinkan kebijakan untuk project pengelolaan folder yang mendukung aplikasi. Perhatikan bahwa mungkin ada kebijakan yang diterapkan di tingkat organisasi. Untuk mengetahui informasi selengkapnya, lihat Membatasi penggunaan resource.

  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

    Jika Anda telah menambahkan project lain ke cakupan rekaman aktivitas, sebaiknya aktifkan juga Observability API untuk project tersebut. Peta topologi aplikasi hanya menampilkan tepi rekaman aktivitas dari project cakupan rekaman aktivitas yang berada dalam organisasi yang sama dengan project App Hub Anda.

  4. Untuk mendapatkan izin yang diperlukan guna melihat topologi aplikasi, minta administrator untuk memberi Anda peran IAM App Topology viewer (roles/apptopology.viewer) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

    Peran bawaan ini berisi izin yang diperlukan untuk melihat topologi aplikasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

    Izin yang diperlukan

    Izin berikut diperlukan untuk melihat topologi aplikasi:

    • Untuk membuat topologi: apptopology.applicationTopologies.generate

    Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

  5. Lakukan instrumentasi pada aplikasi Anda untuk menggunakan OpenTelemetry dan untuk mengirim data trace Anda ke endpoint OTLP.

Melihat peta topologi

  1. Di konsol Google Cloud , buka halaman Application monitoring:

    Buka Pemantauan aplikasi

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Di pemilih project pada konsol Google Cloud , pilih project host atau project pengelolaan App Hub Anda.

  3. Pilih aplikasi dari daftar.

  4. Klik tab Topology. Peta topologi untuk aplikasi Anda akan muncul.

Peta topologi sepenuhnya interaktif. Anda dapat memperbesar dan memperkecil, serta memindahkan node untuk membantu Anda memvisualisasikan hubungan antara layanan dan beban kerja. Anda juga dapat melihat detail tentang node atau tepi:

  • Untuk melihat pemberitahuan atau atribut yang terbuka untuk layanan atau workload, pilih node.
  • Untuk melihat latensi dan rasio error antara dua node, pilih edge.

Memecahkan masalah

Untuk mengetahui informasi yang dapat membantu Anda memahami alasan peta topologi aplikasi tidak menampilkan data, lihat Memecahkan Masalah Pemantauan Aplikasi.