Menyiapkan Google Cloud Observability untuk Pemantauan Aplikasi

Dengan mengonfigurasi Google Cloud Observability untuk Pemantauan Aplikasi, Anda dapat melihat dan menganalisis log, metrik, dan trace dari aplikasi App Hub dalam satu antarmuka, meskipun telemetri Anda disimpan di beberapa project Google Cloud . Untuk menyiapkan Google Cloud Observability, Anda harus mengonfigurasi cakupan kemampuan observasi—yang mencakup cakupan log default, cakupan metrik, dan cakupan trace default—serta memberikan peran IAM. Penyiapan ini berlaku baik saat Anda mendaftarkan aplikasi yang ada dengan App Hub atau men-deploy aplikasi menggunakan Application Design Center.

Untuk menampilkan pemberitahuan terkait aplikasi di dasbor Pemantauan Aplikasi, Anda juga dapat mengaitkan kebijakan pemberitahuan dengan aplikasi App Hub. Jika Anda menjalankan workload di Google Kubernetes Engine dan ingin dasbor Pemantauan Aplikasi menampilkan sinyal utama traffic HTTP, latensi, dan tingkat error, lihat Melakukan instrumentasi aplikasi untuk Pemantauan Aplikasi.

Sebelum memulai

  • Identifikasi project yang cakupan observabilitasnya akan Anda konfigurasi. Project ini adalah salah satu dari berikut:

    • Project host App Hub.
    • Project pengelolaan App Hub untuk batas project tunggal Anda.
    • Project pengelolaan App Hub untuk folder khusus aplikasi Anda.

    Dalam dokumen ini, jika jenis project pengelolaan tidak ditentukan, tugas konfigurasi akan berlaku untuk semua project pengelolaan.

  • Pastikan Anda memiliki peran Identity and Access Management (IAM) yang diperlukan untuk mengonfigurasi cakupan kemampuan observasi. Peran IAM yang diperlukan bergantung pada apakah Anda berencana membuat sink gabungan, yang memungkinkan Anda memusatkan penyimpanan data log.

    Mengonfigurasi sink dan cakupan

    Untuk mendapatkan izin yang diperlukan untuk mengonfigurasi cakupan kemampuan observasi dan membuat sink log gabungan, minta administrator untuk memberi Anda peran IAM Organization Administrator (roles/resourcemanager.organizationAdmin) di organisasi 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.

    Hanya mengonfigurasi cakupan

    Untuk mendapatkan izin yang Anda perlukan untuk mengonfigurasi cakupan kemampuan observasi, minta administrator untuk memberi Anda peran IAM berikut:

    Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

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

Mengonfigurasi cakupan kemampuan observasi

Cakupan kemampuan observasi mengontrol cara halaman penjelajah dan dasbor menelusuri data yang akan ditampilkan. Setiap project Google Cloud berisi satu cakupan kemampuan observasi. Anda tidak mengonfigurasi cakupan kemampuan observasi project secara langsung. Sebagai gantinya, untuk project Anda, konfigurasikan hal berikut:

  • Cakupan log default

    Konfigurasikan cakupan ini sehingga saat Anda membuka halaman Logs Explorer atau melihat dasbor, data log aplikasi Anda akan ditampilkan. Pastikan cakupan ini mencantumkan project dan tampilan log yang menyimpan data log aplikasi Anda.

  • Cakupan metrik

    Konfigurasikan cakupan ini agar diagram Anda, misalnya, yang Anda buat menggunakan halaman Metrics Explorer, dan kebijakan pemberitahuan dapat menampilkan atau memantau data metrik aplikasi Anda. Pastikan cakupan ini mencantumkan project yang menyimpan data metrik aplikasi Anda.

  • Cakupan trace default

    Konfigurasikan cakupan ini sehingga saat Anda membuka halaman Trace Explorer, data trace aplikasi Anda akan ditampilkan. Pastikan cakupan ini mencantumkan project yang menyimpan data trace aplikasi Anda.

Bagian selanjutnya memberikan panduan tentang cara mengonfigurasi cakupan ini.

Mengonfigurasi dan menetapkan cakupan log default

Lakukan salah satu hal berikut:

  • Jika Anda memiliki sink gabungan tingkat organisasi yang merutekan semua data log di organisasi Anda ke bucket log terpusat, sebaiknya lakukan hal berikut:

    1. Buat tampilan log di bucket log terpusat untuk log aplikasi Anda.

    2. Di project host atau project pengelolaan App Hub, buat cakupan log dan tambahkan tampilan log, lalu tetapkan cakupan ini sebagai cakupan log default.

  • Jika Anda menggunakan folder khusus aplikasi dan jika Anda tidak memiliki sink gabungan level organisasi atau folder bertingkat, sebaiknya lakukan hal berikut:

    1. Buat sink gabungan intersepsi untuk folder khusus aplikasi Anda, dan rutekan log tersebut ke bucket log _Default dari project pengelolaan untuk folder khusus aplikasi Anda.

    2. Dalam project pengelolaan untuk folder khusus aplikasi, pastikan cakupan log bernama _Default ditetapkan sebagai cakupan log default. Cakupan bernama _Default mencantumkan tampilan _AllLogs di bucket log _Default project, yang merupakan lokasi penyimpanan terpusat untuk aplikasi Anda.

  • Jika Anda tidak menggunakan sink gabungan, maka untuk project host atau project pengelolaan App Hub, konfigurasikan cakupan log default untuk mencantumkan lokasi penyimpanan data log aplikasi Anda. Sebaiknya tambahkan tampilan log pada bucket log yang menyimpan data log Anda.

Misalnya, Anda telah mengonfigurasi folder khusus aplikasi dan tidak menggunakan sink gabungan. Kemudian, Anda dapat melakukan hal berikut:

  1. Di project pengelolaan untuk folder khusus aplikasi, buat cakupan log.

  2. Anda menambahkan satu tampilan log ke cakupan log untuk setiap project di folder Anda, termasuk project pengelolaan.

    Tampilan yang Anda tambahkan adalah tampilan _AllLogs di bucket log _Default project. Tampilan ini mencakup semua log di bucket log _Default, dan bucket log _Default menyimpan data log aplikasi Anda.

    Setelah Anda menyelesaikan langkah ini, cakupan log mungkin memiliki entri seperti berikut:

    _Default/_AllLogs     my-folder-mp
_Default/_AllLogs     project-in-my-folder
_Default/_AllLogs     another-project-in-my-folder

  3. Anda menyimpan cakupan log dan menetapkannya sebagai cakupan log default.

Mengonfigurasi cakupan metrik

Pastikan cakupan metrik untuk project host atau project pengelolaan App Hub Anda mencantumkan semua project yang menyimpan data metrik aplikasi Anda:

  • Untuk folder khusus aplikasi, Google Cloud Observability mencoba menyinkronkan daftar project di folder khusus aplikasi Anda dengan daftar project dalam cakupan metrik. Misalnya, jika Anda menambahkan project ke folder khusus aplikasi, perintah akan dikeluarkan untuk menambahkan project tersebut ke cakupan metrik.

    Jika jumlah project di folder khusus aplikasi tidak melebihi kuota cakupan metrik, yang secara default adalah 375 project per cakupan metrik, Google Cloud Observability dapat menjaga daftar project dalam cakupan metrik tetap sinkron dengan daftar project di folder khusus aplikasi. Misalnya, anggap kuotanya adalah 375 project per cakupan metrik. Jika folder khusus aplikasi Anda berisi 100 project, cakupan metrik akan mencantumkan semua project dalam folder khusus aplikasi Anda. Jika Anda menambahkan project ke folder khusus aplikasi, project tersebut juga akan ditambahkan ke cakupan metrik.

    Jika jumlah project di folder khusus aplikasi melebihi kuota cakupan metrik, daftar project dalam cakupan metrik tidak akan menyertakan semua project di folder khusus aplikasi. Misalnya, kuota adalah 375 project per cakupan metrik dan folder khusus aplikasi Anda berisi 380 project. Setelah 375 project ditambahkan ke cakupan metrik, kuota akan habis dan upaya untuk menambahkan 5 project yang tersisa akan gagal. Akibatnya, beberapa data aplikasi tidak tersedia untuk project pengelolaan untuk folder khusus aplikasi Anda.

    Sebaiknya tinjau penggunaan kuota cakupan metrik Anda dan tentukan apakah Anda perlu meminta pembaruan kuota atau mengubah cakupan metrik secara manual. Untuk mengetahui informasi tentang langkah-langkah ini, lihat Cakupan metrik untuk folder khusus aplikasi.

  • Untuk project host App Hub dan untuk project pengelolaan untuk batas project tunggal, Anda harus mengonfigurasi cakupan metrik.

    Jika Anda mengubah kumpulan project yang menyimpan data metrik, Anda juga harus memperbarui cakupan metrik project host.

Mengonfigurasi dan menetapkan cakupan trace default

Lakukan tindakan berikut:

  1. Untuk setiap project yang akan menyimpan data trace aplikasi Anda, sebaiknya aktifkan Observability API:

    Peran yang diperlukan untuk mengaktifkan API

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

    Mengaktifkan API

  2. Di project host atau project pengelolaan App Hub Anda, buat cakupan trace dan tambahkan project yang menyimpan data trace aplikasi Anda. Jika Anda menggunakan folder khusus aplikasi, tambahkan project di folder tersebut.

  3. Tetapkan cakupan trace kustom Anda sebagai cakupan trace default.

    Grafik topologi hanya dapat menampilkan data trace dari project di organisasi yang sama dengan project host atau project pengelolaan Anda.

Mengaitkan kebijakan pemberitahuan dengan aplikasi App Hub

Untuk melihat kebijakan pemberitahuan dari konteks Pemantauan Aplikasi, Anda harus mengaitkannya dengan layanan atau workload dengan menambahkan label khusus aplikasi ke kebijakan pemberitahuan. Label yang ditentukan pengguna ini juga disertakan dalam pemberitahuan apa pun yang dibuat untuk kebijakan. Untuk mempelajari label lebih lanjut, lihat Memberikan anotasi pemberitahuan menggunakan label. Untuk mengetahui daftar label App Hub, lihat Melihat telemetri aplikasi.

Untuk mengaitkan kebijakan pemberitahuan dengan workload atau layanan menggunakan konsol Google Cloud , lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman  Pemberitahuan:

    Buka Pemberitahuan

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

  2. Di toolbar konsolGoogle Cloud , pilih project host atau project pengelolaan App Hub Anda.
  3. Temukan kebijakan pemberitahuan, klik View more, pilih Edit, lalu buka bagian Notifications and name.

  4. Di bagian Application labels, pilih aplikasi Anda, lalu pilih layanan atau workload Anda:

    Halaman kebijakan pemberitahuan yang menampilkan cara mengaitkan kebijakan pemberitahuan dengan label App Hub.

  5. Klik Save policy.

Setelah Anda menyelesaikan langkah-langkah ini, label dengan kunci berikut akan dilampirkan ke kebijakan pemberitahuan Anda. Label ini mengidentifikasi aplikasi dan layanan atau workload Anda:

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id atau apphub_workload_id

Anda juga dapat menambahkan label pengguna ke kebijakan pemberitahuan menggunakan Google Cloud CLI, Terraform, atau Cloud Monitoring API. Namun, Anda harus menggunakan kunci label yang ditampilkan dalam contoh sebelumnya. Untuk informasi selengkapnya, lihat referensi berikut:

Berikan akses

IAM mengelola akses ke data log, metrik, dan trace Anda. Bagian ini merangkum peran yang mungkin ingin Anda berikan kepada akun utama:

  • Logs View Accessor (roles/logging.viewAccessor) pada tampilan log yang tercantum dalam cakupan log default project host atau project pengelolaan App Hub Anda. Untuk mempelajari lebih lanjut cara memberikan akses ke tampilan log, lihat Mengontrol akses ke tampilan log.

  • Logs Viewer (roles/logging.viewer) di project host atau project pengelolaan App Hub Anda dan di project lain yang tercantum dalam cakupan log default-nya. Peran ini memberikan akses ke sebagian besar entri log di bucket log _Default. Untuk mengetahui informasi selengkapnya, lihat Peran logging.

  • Peran Monitoring Editor (roles/monitoring.editor) di project host atau project pengelolaan App Hub Anda. Untuk akun utama yang tidak perlu membuat kebijakan pemberitahuan, pertimbangkan untuk memberikan peran Monitoring Viewer (roles/monitoring.viewer).

  • Cloud Trace User (roles/cloudtrace.user) di project host atau project pengelolaan App Hub Anda dan di project yang tercantum dalam cakupan trace default-nya.

  • App Hub viewer (roles/apphub.viewer) di project host atau project pengelolaan App Hub Anda.

Langkah berikutnya