Menjalankan kueri

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

App Topology memungkinkan Anda menjalankan kueri untuk membantu mengorelasikan data dan menjawab pertanyaan tentang kondisi, performa, dan postur keamanan aplikasi Anda.

Jenis topologi

App Topology mendukung kueri untuk Google Cloud resource dalam Google Cloud project dan kueri untuk aplikasi Pusat Aplikasi dalam project atau folder yang mendukung aplikasi. Saat membuat aplikasi App Hub di folder, Anda dapat melihat hubungan resource di seluruh project dalam folder tersebut saat menjalankan kueri di App Topology.

Catatan: Aplikasi di project host lama tidak didukung.

Di Cloud Hub, App Topology menyediakan beberapa domain untuk jenis pertanyaan tertentu. Setiap domain memungkinkan Anda membuat kueri kumpulan data pokok tertentu.

• Kondisi dan pemecahan masalah - Untuk Site Reliability Engineer (SRE) dan pengguna lain yang berfokus pada kondisi runtime dan keandalan layanan. Anda dapat melihat pemberitahuan terbuka untuk peristiwa deployment, dan menganalisis traffic antara komponen aplikasi atau resource agen.

• Deployment - Untuk engineer DevOps yang mengelola supply chain software dan konfigurasi infrastruktur. Anda dapat memeriksa artefak build untuk mengetahui kerentanan umum sebelum di-deploy, dan melacak asal-usul dari kode sumber ke produksi.

• Keamanan - Untuk engineer dan pengelola keamanan yang mengaudit akses, kerentanan, dan risiko supply chain software. Anda dapat memeriksa jalur akses dan mengidentifikasi layanan dan infrastruktur yang berjalan dan terpengaruh oleh kerentanan.

App Topology juga menyediakan diagram topologi yang berfokus pada penggunaan tertentu di area lain Google Cloud.

Gunakan tabel berikut untuk membantu Anda memutuskan alat topologi mana yang akan digunakan:

Alat topologi	Kapan menggunakannya
App Topology API	Agen dapat menggunakan server MCP App Topology untuk membuat kueri dan mengorelasikan data resource.
App Topology di Cloud Hub	Menganalisis hubungan data di seluruh domain observabilitas, keamanan, dan deployment. Melihat layanan dan workload Pusat Aplikasi yang dikelompokkan berdasarkan aplikasi Menggunakan kueri yang telah ditentukan atau membuat kueri Anda sendiri Melihat data untuk project individual dan folder yang mendukung aplikasi
Topologi aplikasi di Cloud Monitoring	Melihat data observabilitas real-time seperti traffic, latensi, dan dependensi layanan berdasarkan telemetri. Melihat layanan dan workload Pusat Aplikasi yang dikelompokkan berdasarkan aplikasi Mendaftarkan layanan dan workload yang ditemukan Menyediakan tampilan terfokus pada performa dan traffic aplikasi Melihat data untuk project individual dan folder yang mendukung aplikasi
Topologi agen	Melihat infrastruktur dan konektivitas sistem berbasis agen, seperti koneksi antara agen dan alat pengelolaannya. Menggunakan kueri yang disediakan, atau menjalankan kueri yang telah ditentukan dan diubah di Cloud Hub Melihat data untuk project individual saja

Sebelum memulai

1. Identifikasi Google Cloud project yang ingin Anda siapkan.

   • Data keamanan dan kepatuhan yang disediakan oleh Security Command Center hanya tersedia untuk project dan aplikasi di Google Cloud organisasi. Jika ingin memigrasikan project ke organisasi, lihat petunjuk migrasi
   • Jika Anda menyiapkan folder yang mendukung aplikasi untuk aplikasi App Hub, aktifkan API dan berikan izin yang dijelaskan dalam petunjuk ini di project pengelolaan folder.

2. Untuk melihat data supply chain software seperti provenance build, konfigurasi insight Developer Connect.

3. Aktifkan App Topology, Inventaris Aset Cloud, dan Observability API.

   Peran yang diperlukan untuk mengaktifkan API

   Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

   Aktifkan API

4. Opsional: Untuk melihat traffic agen, instrumentasikan aplikasi AI Anda.

5. Opsional: Siapkan Security Command Center untuk data keamanan dan kepatuhan. Aktifkan Security Command Center di tingkat organisasi dan konfigurasi fitur yang ingin Anda gunakan. Membuat kueri data dari Security Command Center hanya tersedia untuk paket Premium dan Enterprise.

6. Berikan izin kepada pengguna Anda untuk membuat kueri data dan melihat topologi diagram.

7. Jika Anda melindungi layanan di perimeter Kontrol Layanan VPC, perbarui perimeter untuk menyertakan App Topology dan layanan yang menyediakan data pokok. Pelajari lebih lanjut.

Peran yang diperlukan

Peran Operator Cloud Hub mencakup izin yang diperlukan untuk melihat data semua domain di Cloud Hub serta data untuk topologi Google Cloud lainnya.

Untuk mendapatkan izin yang diperlukan guna membuat kueri semua domain di App Topology, minta administrator untuk memberi Anda peran IAM Operator Cloud Hub (roles/cloudhub.operator) di project dengan resource Anda atau project pengelolaan untuk aplikasi Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Tentang kueri

Kueri App Topology terdiri dari beberapa komponen:

• Node - Resource yang ditemukan Google Cloud atau resource yang terdaftar di aplikasi Pusat Aplikasi. Contoh node mencakup

  • VM Compute Engine
  • Image container di Artifact Registry
  • Agen
  • Pemberitahuan (insiden di Cloud Monitoring)
  • Aplikasi, layanan, atau workload Pusat Aplikasi
  • Kerentanan

  Pembuat kueri mengelompokkan node berdasarkan layanan.

• Klausa Where: filter yang diterapkan ke node untuk menyaring kueri berdasarkan properti spesifik node.

• Koneksi: Hubungan terarah antara dua node. Koneksi bersifat kontekstual, dan hanya hubungan yang valid yang tersedia untuk jenis node yang dipilih. Contohnya mencakup:

  • contained in
  • sends traffic to
  • owns
  • depends on

Contoh kueri berikut menelusuri deployment yang memiliki kerentanan tertentu:

Contoh kueri menggunakan berbagai komponen

Kueri menetapkan node utama investigasi: - K8s Apps Deployment - Deployment Google Kubernetes Engine (GKE) - Docker Image - Image container yang disimpan di Artifact Registry - Vulnerability

Koneksi contains dan contained in menunjukkan hubungan node:

• K8s Apps Deployment contains Vulnerability
• Vulnerability contained in Docker Image

Klausa Where memfilter hasil kerentanan untuk menampilkan CVE tertentu.

• Where Id = CVE-2026-24061

Batasan

Ketersediaan data:

• Google Cloud Observability tidak mendukung telemetri untuk semua layanan dan beban kerja Pusat Aplikasi. Untuk mengetahui daftar resource infrastruktur yang didukung, lihat Infrastruktur yang didukung Pemantauan Aplikasi.
• Saat melihat topologi untuk aplikasi App Hub, resource yang dapat dibagikan di seluruh aplikasi tidak disertakan dalam visualisasi.
• Saat Anda menghapus peristiwa insight Developer Connect, peristiwa tersebut mungkin masih muncul di hasil kueri App Topology selama beberapa hari.

Lokasi Google Cloud project:

• Data keamanan dan kepatuhan yang disediakan oleh Security Command Center hanya tersedia untuk project dan aplikasi di Google Cloud organisasi.

Menjalankan kueri

Anda dapat menggunakan kueri yang telah ditentukan, mengubah kueri yang telah ditentukan, atau membuat kueri kustom.

Menggunakan atau menyesuaikan kueri yang disarankan

App Topology menyediakan saran kueri yang dapat Anda gunakan tanpa perubahan apa pun, atau Anda dapat menyesuaikan saran tersebut agar sesuai dengan persyaratan spesifik Anda.

1. Di Google Cloud Konsol, buka halaman App Topology.

   Buka App Topology

2. Di panel Create your query, pilih tab untuk domain yang ingin Anda jelajahi.

3. Di bagian Quick Queries, klik kueri untuk melihat pratinjau komponen kueri.

4. Untuk menggunakan kueri, klik Use suggestion. Kueri akan muncul di bagian Show.

5. Ubah detail kueri di editor agar sesuai dengan kebutuhan Anda.

   • Untuk menambahkan komponen ke kueri, klik ikon plus () di samping node.
   • Untuk menghapus komponen, klik ikon tutup .
   • Untuk mengubah nilai klausa Where, klik nilai.

   Anda dapat mengklik Undo untuk mengembalikan perubahan atau Redo untuk menerapkan kembali perubahan yang Anda kembalikan dengan Undo.

   Saat Anda membuat kueri, node, filter, dan koneksi yang tersedia akan diperbarui.

   Misalnya, jika Anda memilih Vulnerabilities in Kubernetes deployments , komponennya adalah:

   Application
     contains Workload
       depends on K8s Apps Deployment
          contains Vulnerability
             Where Id = Empty value
   

   Untuk menggunakan kueri, Anda harus menentukan kerentanan yang akan ditelusuri dengan mengganti Empty value dengan ID CVE seperti CVE-2026-24061.

   Sebagai alternatif, Anda dapat mengubah kueri untuk menelusuri semua workload aplikasi yang berisi image Docker dengan kerentanan tertentu

   Application
     contains Workload
       contains Deployment Event
         contains artifact Docker Image
           contains Vulnerability
             Where Id = CVE-2026-24061
   

6. Setelah selesai mengedit kueri, klik Run query. Jika hasil kueri Anda menyertakan Google Cloud resource yang ditemukan atau resource yang terdaftar di aplikasi App Hub, diagram topologi akan ditampilkan.

   Diagram tidak tersedia untuk hasil kueri yang hanya menyertakan jenis data seperti string atau jumlah.

   Berdasarkan hasilnya, Anda dapat mengedit kueri, lalu mengklik Run query untuk memperbarui diagram topologi.

   Jika tidak ada hasil, coba perbaiki kueri Anda.

7. Berinteraksi dengan topologi untuk mempelajari resource Anda dan hubungannya.

Membuat kueri kustom

Untuk membuat kueri kustom, mulai kueri baru atau sesuaikan kueri saran yang ada menggunakan langkah-langkah berikut:

1. Di Google Cloud Konsol, buka halaman App Topology.

   Buka App Topology

2. Di panel Create your query, pilih tab untuk domain yang ingin Anda jelajahi.

3. Di bagian Show, klik dan pilih resource atau temuan sebagai node utama untuk kueri Anda, lalu klik Continue.

4. Untuk memperbaiki kueri, klik tombol untuk filter atau koneksi apa pun guna mengaktifkannya untuk node yang dipilih. Tentukan nilai untuk setiap filter yang Anda aktifkan.

   Catatan: Semua penyesuaian bersifat kontekstual. Anda hanya akan melihat filter dan koneksi yang valid untuk jenis node yang dipilih.

5. Untuk membuat perubahan tambahan pada kueri, Anda dapat menambahkan, mengedit, atau menghapus komponen.

   • Untuk menambahkan komponen ke kueri, klik ikon plus () di samping node.
   • Untuk menghapus komponen, klik ikon tutup .
   • Untuk mengubah nilai klausa Where, klik nilai.

   Anda dapat mengklik Undo untuk mengembalikan perubahan atau Redo untuk menerapkan kembali perubahan yang Anda kembalikan dengan Undo.

   Saat Anda membuat kueri, node, filter, dan koneksi yang tersedia akan diperbarui.

6. Setelah selesai mengedit kueri, klik Run query. Jika hasil kueri Anda menyertakan Google Cloud resource yang ditemukan atau resource yang terdaftar di aplikasi App Hub, diagram topologi akan ditampilkan.

   Diagram tidak tersedia untuk hasil kueri yang hanya menyertakan jenis data seperti string atau jumlah.

   Berdasarkan hasilnya, Anda dapat mengedit kueri, lalu mengklik Run query untuk memperbarui diagram topologi.

   Jika tidak ada hasil, coba perbaiki kueri Anda.

7. Berinteraksi dengan topologi untuk mempelajari resource Anda dan hubungannya.

Berinteraksi dengan topologi

Diagram topologi di tab Graph menampilkan resource dan hubungannya sebagai node dan koneksi.

• Ikon mewakili node, yang mencakup resource yang ditemukan dan terdaftar.
• Garis mewakili koneksi, hubungan antara node.

Anda dapat berinteraksi dengan topologi dengan cara berikut:

• Mengubah visualisasi dengan memperbesar atau memperkecil atau memposisikan ulang node.
• Melihat label untuk koneksi dengan mengarahkan kursor ke garis koneksi antara dua node.
• Mendapatkan informasi tentang node atau koneksi dengan memilihnya.
• Menyembunyikan atau menampilkan panel kueri dengan mengklik Toggle panel terlebih dahulu.

Untuk melihat hasil kueri dalam tabel, klik tab Table. Anda dapat mengubah cara data ditampilkan dengan cara berikut:

• Untuk memilih kolom yang ditampilkan tabel, klik Column display options .
• Untuk memfilter tabel untuk properti tertentu, pilih properti di kolom Filter.
• Anda juga dapat mengurutkan setiap kolom dalam urutan menaik atau menurun.