Mengonfigurasi cakupan metrik menggunakan API

Dokumen ini menjelaskan cara menggunakan Google Cloud CLI atau Cloud Monitoring API untuk mengonfigurasi cakupan metrik project Google Cloud. Halaman ini ditujukan untuk developer dan administrator sistem.

Perintah di halaman ini merujuk ke penampung resource, yang selalu berupa project Google Cloud.

Sebelum memulai

• Jika Anda tidak memahami istilah cakupan metrik dan cakupan project, lihat Cakupan metrik.

• Pastikan peran Identity and Access Management (IAM) Anda di project cakupan dan di setiap project yang ingin Anda tambahkan sebagai project yang dipantau menyertakan semua izin dalam peran Monitoring Admin (roles/monitoring.admin). Untuk mengetahui informasi selengkapnya, lihat Konfigurasi cakupan metrik.

• Metode cakupan metrik Cloud Monitoring API yang mengambil informasi bersifat sinkron; tetapi, API yang mengubah status bersifat asinkron. Perintah Google Cloud CLI akan diblokir hingga operasi asinkron selesai. Untuk informasi tentang cara menentukan saat metode API asinkron selesai dan cara menentukan statusnya, lihat Metode API asinkron.

• Jika Anda berencana memanggil Cloud Monitoring API menggunakan curl atau jika Anda ingin menggunakan contoh di halaman ini, selesaikan langkah-langkah penyiapan perintah curl.

Mencantumkan semua cakupan metrik yang menyertakan project

gcloud

Pratinjau

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

Untuk mendapatkan daftar cakupan metrik yang dapat melihat metrik untuk penampung resource, seperti project Google Cloud, jalankan perintah gcloud beta monitoring metrics-scopes list:

gcloud beta monitoring metrics-scopes list MONITORED_RESOURCE_CONTAINER_NAME

Sebelum menjalankan perintah, masukkan ID penampung resource ke dalam variabel MONITORED_RESOURCE_CONTAINER_NAME. Jika penampung resource adalah project Google Cloud, masukkan projects/PROJECT_ID_OR_NUMBER.

Misalnya, untuk mencantumkan cakupan metrik yang menyertakan project my-project, jalankan perintah berikut:

gcloud beta monitoring metrics-scopes list projects/my-project

Respons berikut menunjukkan bahwa project my-project disertakan dalam dua cakupan metrik:

metricsScopes:
- createTime: '2018-08-06T17:13:42Z'
  name: locations/global/metricsScopes/012345012345
  updateTime: '2018-08-18T16:20:37.032928Z'
- createTime: '2021-04-13T15:37:26.869Z'
  name: locations/global/metricsScopes/9876543210
  updateTime: '2021-04-13T15:37:27.284239Z'

Untuk mendapatkan informasi mendetail tentang cakupan metrik, jalankan perintah gcloud beta monitoring metrics-scopes describe.

curl

Untuk mendapatkan daftar cakupan metrik yang dapat melihat metrik untuk suatu project, kirim permintaan GET ke endpoint locations.global.metricsScopes.listMetricsScopesByMonitoredProject dan sertakan parameter kueri yang menentukan project.

curl -H "Authorization: Bearer ${TOKEN}" \
https://monitoring.googleapis.com/v1/locations/global/metricsScopes:listMetricsScopesByMonitoredProject?monitored_resource_container=projects/${PROJECT_ID_OR_NUMBER}

Jika berhasil, responsnya adalah array objek MetricsScope.

Metode ini tidak menghasilkan entri yang ditulis ke log audit project cakupan. Agar tindakan ini dicatat dalam log audit, aktifkan Pembacaan Data untuk Cloud Resource Manager API. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi log audit Akses Data.

Mendapatkan detail tentang cakupan metrik

gcloud

Pratinjau

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

Untuk mendapatkan informasi mendetail tentang cakupan metrik, jalankan perintah gcloud beta monitoring metrics-scopes describe:

gcloud beta monitoring metrics-scopes describe METRICS_SCOPE_ID

Sebelum menjalankan perintah, masukkan nama nama yang sepenuhnya memenuhi syarat dari cakupan metrik ke dalam variabel METRICS_SCOPE_ID. Berikut adalah contoh nama yang sepenuhnya memenuhi syarat:

locations/global/metricsScopes/012345012345

Berikut adalah contoh respons. Dalam contoh ini, cakupan metrik berisi satu project, dan ID cakupan metrik dan project sama:

createTime: '2018-08-06T17:13:42Z'
monitoredProjects:
- createTime: '2018-08-06T17:13:42Z'
  name: locations/global/metricsScopes/012345012345/projects/012345012345
name: locations/global/metricsScopes/012345012345
updateTime: '2018-08-18T16:20:37.032928Z'

Untuk mengidentifikasi project Google Cloud dari ID-nya, jalankan perintah gcloud projects list dan filter menurut project ID. Misalnya, untuk mendapatkan nama project 012345012345, jalankan perintah berikut:

gcloud projects list --filter="012345012345" --format="value(NAME)"

curl

Untuk mendapatkan informasi tentang cakupan metrik, kirim permintaan GET ke endpoint locations.global.metricsScopes.get:

curl -H "Authorization: Bearer ${TOKEN}" \
https://monitoring.googleapis.com/v1/locations/global/metricsScopes/${SCOPING_PROJECT_ID_OR_NUMBER}

Jika berhasil, responsnya adalah objek MetricsScope.

Metode ini tidak menghasilkan entri yang ditulis ke log audit project cakupan. Agar tindakan ini dicatat dalam log audit, aktifkan Pembacaan Data untuk Cloud Resource Manager API. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi log audit Akses Data.

Menambahkan project ke cakupan metrik

Jika menggunakan App Hub, untuk melihat metrik sistem dari App Hub, Anda harus mengonfigurasi project host App Hub dan cakupan metrik. Menambahkan project layanan App Hub ke project host App Hub tidak akan mengubah cakupan metrik project. Demikian pula, menambahkan project ke cakupan metrik tidak akan mengubah daftar project layanan App Hub yang dilampirkan ke project host App Hub. Untuk informasi tentang cara mengonfigurasi project host App Hub, lihat Menambahkan atau menghapus project layanan.

gcloud

Pratinjau

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

Untuk menambahkan penampung resource, seperti project Google Cloud, ke cakupan metrik, jalankan perintah gcloud beta monitoring metrics-scopes create:

gcloud beta monitoring metrics-scopes create MONITORED_RESOURCE_CONTAINER_NAME --project=SCOPING_PROJECT_ID_OR_NUMBER

Sebelum menjalankan perintah sebelumnya, lakukan hal berikut:

• Masukkan nama atau ID project Google Cloud yang cakupan metrikanya akan diubah menjadi variabel SCOPING_PROJECT_ID_OR_NUMBER.

• Masukkan ID penampung resource Anda ke dalam variabel MONITORED_RESOURCE_CONTAINER_NAME. Jika penampung resource adalah project Google Cloud, masukkan projects/PROJECT_ID_OR_NUMBER.

Misalnya, perintah berikut menambahkan project my-monitored-project ke cakupan metrik project bernama my-staging-projects:

gcloud beta monitoring metrics-scopes create projects/my-monitored-project --project=my-staging-projects

Respons terhadap perintah sebelumnya memberikan konfirmasi bahwa perintah berhasil diselesaikan:

Created monitored project [locations/global/metricsScopes/my-staging-projects/projects/my-monitored-project].

curl

Untuk menambahkan project Google Cloud ke cakupan metrik, kirim permintaan POST ke endpoint locations.global.metricsScopes.projects.create. Dalam contoh berikut, project yang diidentifikasi oleh variabel lingkungan MONITORED_PROJECT_ID_OR_NUMBER ditambahkan sebagai project yang dipantau:

curl -H "Authorization: Bearer ${TOKEN}" \
-H "Content-Type: application/json" -X POST \
-d "{'name': 'locations/global/metricsScopes/${SCOPING_PROJECT_ID_OR_NUMBER}/projects/${MONITORED_PROJECT_ID_OR_NUMBER}'}" \
https://monitoring.googleapis.com/v1/locations/global/metricsScopes/${SCOPING_PROJECT_ID_OR_NUMBER}/projects

Respons metode asinkron ini adalah objek Operation.

Aplikasi yang memanggil metode ini harus melakukan polling pada endpoint operation.get hingga nilai kolom Operation.done adalah true. Jika kolom Operation.done ditetapkan ke false, hal ini menunjukkan bahwa operasi sedang berlangsung. Untuk informasi selengkapnya, lihat Perintah API asinkron.

Berikut adalah contoh respons saat menambahkan project yang dipantau berhasil:

{
  "name": "operations/6915efde-1915-400a-ad49-7b62041d9bd2",
  "metadata": {
    "@type": "type.googleapis.com/google.monitoring.metricsscope.v1.OperationMetadata",
    "state": "DONE",
    ...
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.monitoring.metricsscope.v1.MonitoredProject",
    "name": "locations/global/metricsScopes/012012012012/projects/678678678678",
    "provider": "G​C​P",
    "providerAccountId": "...",
    ...
  }
}

Dalam respons sebelumnya, kolom Operation.done ditetapkan ke true. Nilai ini menunjukkan bahwa perintah telah selesai. Karena perintah berhasil diselesaikan, kolom Operation.response ditetapkan dan nilainya adalah objek MonitoredProject. Kolom response.name menyertakan ID project cakupan dan project yang dipantau. Kolom providerAccountId mencantumkan nama project yang dipantau.

Memanggil metode ini akan menghasilkan entri dalam log audit project cakupan. Konsol Google Cloud tidak memanggil metode API ini. Oleh karena itu, perubahan yang dilakukan pada cakupan metrik saat menggunakan konsol Google Cloud tidak dicatat dalam log audit.

Menghapus project dari cakupan metrik

Jika Anda menggunakan App Hub, sebelum menghapus project dari cakupan metrik, pastikan project tersebut tidak digunakan oleh aplikasi App Hub. Menghapus project dari cakupan metrik tidak akan memengaruhi aplikasi. Namun, Anda tidak akan dapat melihat metrik sistem untuk aplikasi tersebut dari konteks project host App Hub. Untuk informasi tentang cara mengonfigurasi project host App Hub, lihat Menambahkan atau menghapus project layanan.

gcloud

Pratinjau

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

Untuk menghapus penampung resource, seperti project Google Cloud, dari cakupan metrik, jalankan perintah gcloud beta monitoring metrics-scopes delete:

gcloud beta monitoring metrics-scopes delete MONITORED_RESOURCE_CONTAINER_NAME --project=SCOPING_PROJECT_ID_OR_NUMBER

Sebelum menjalankan perintah sebelumnya, lakukan hal berikut:

• Masukkan nama atau ID project Google Cloud yang cakupan metrikanya akan diubah menjadi variabel SCOPING_PROJECT_ID_OR_NUMBER.

• Masukkan ID penampung resource Anda ke dalam variabel MONITORED_RESOURCE_CONTAINER_NAME. Jika penampung resource adalah project Google Cloud, masukkan projects/PROJECT_ID_OR_NUMBER.

Misalnya, perintah berikut menghapus project my-monitored-project dari cakupan metrik project bernama my-staging-projects:

gcloud beta monitoring metrics-scopes delete projects/my-monitored-project --project=my-staging-projects

Respons terhadap perintah sebelumnya memberikan konfirmasi bahwa perintah berhasil diselesaikan:

Deleted monitored project [locations/global/metricsScopes/my-staging-projects/projects/my-monitored-project].

Error berikut dilaporkan saat project cakupan tidak memantau project yang ditentukan oleh variabel MONITORED_RESOURCE_CONTAINER_NAME:

NOT_FOUND: Requested entity was not found.

curl

Untuk menghapus project Google Cloud dari cakupan metrik, kirim permintaan DELETE ke endpoint locations.global.metricsScopes.projects.delete:

curl -H "Authorization: Bearer ${TOKEN}" -X DELETE \
https://monitoring.googleapis.com/v1/locations/global/metricsScopes/${SCOPING_PROJECT_ID_OR_NUMBER}/projects/${MONITORED_PROJECT_ID_OR_NUMBER}

Respons terhadap metode asinkron ini adalah objek Operation.

Aplikasi yang memanggil metode ini harus melakukan polling pada endpoint operation.get hingga nilai kolom Operation.done adalah true. Jika kolom Operation.done ditetapkan ke false, hal ini menunjukkan bahwa operasi sedang berlangsung. Untuk informasi selengkapnya, lihat Perintah API asinkron.

Berikut adalah contoh respons saat penghapusan project yang dipantau berhasil:

{
  "name": "operations/4367ff34-0ff0-4767-b8d3-0638e30f077c",
  "metadata": {
    "@type": "type.googleapis.com/google.monitoring.metricsscope.v1.OperationMetadata",
    "state": "DONE",
    ...
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}

Dalam respons sebelumnya, kolom Operation.done ditetapkan ke true. Nilai ini menunjukkan bahwa perintah telah selesai. Karena perintah berhasil selesai, kolom Operation.response ditetapkan dan berisi kolom @type.

Memanggil metode ini akan menghasilkan entri dalam log audit project cakupan. Konsol Google Cloud tidak memanggil metode API ini. Oleh karena itu, perubahan yang dilakukan pada cakupan metrik saat menggunakan konsol Google Cloud tidak dicatat dalam log audit.

Metode API asinkron

Catatan: Perintah Google Cloud CLI akan diblokir hingga metode API asinkron yang dipanggil selesai.

Semua metode cakupan metrik Cloud Monitoring API yang mengubah status sistem, misalnya, perintah untuk menambahkan project yang dipantau ke cakupan metrik, bersifat asinkron. Untuk perintah ini, respons perintah adalah objek Operation.

Aplikasi yang memanggil metode API asinkron harus melakukan polling endpoint operation.get hingga nilai kolom Operation.done adalah true:

• Jika done adalah false, operasi sedang berlangsung.

  Untuk memuat ulang informasi status, kirim permintaan GET ke endpoint operation.get:

  curl -H "Authorization: Bearer ${TOKEN}" \
  https://monitoring.googleapis.com/v1/${OPERATION_NAME}

  Pada perintah sebelumnya, OPERATION_NAME adalah variabel lingkungan yang menyimpan nilai kolom Operation.name.

• Jika done adalah true, operasi akan selesai dan kolom error atau response ditetapkan:

  • error: Jika ditetapkan, operasi asinkron akan gagal. Nilai kolom ini adalah objek Status yang berisi kode error gRPC dan pesan error.
  • response: Jika ditetapkan, operasi asinkron berhasil diselesaikan, dan nilainya mencerminkan hasilnya.

Penyiapan perintah curl

Bagian ini menjelaskan penyiapan yang digunakan untuk membuat perintah curl dalam dokumen ini. Setiap perintah curl di halaman ini menyertakan kumpulan argumen yang diikuti dengan URL resource API:

curl -H "Authorization: Bearer ${TOKEN}" <other_args> \
https://monitoring.googleapis.com/v1/locations/global/metricsScopes/<resource>

Tetapkan variabel lingkungan ini untuk menyederhanakan pembuatan perintah curl:

1. Buat variabel lingkungan untuk menyimpan ID atau nomor project cakupan:

   SCOPING_PROJECT_ID_OR_NUMBER=SCOPING_PROJECT_ID_OR_NUMBER
   

2. Opsional. Jika Anda berencana menambahkan atau menghapus project yang dipantau, konfigurasikan variabel lingkungan dengan ID atau nomor project yang dipantau:

   MONITORED_PROJECT_ID_OR_NUMBER=MONITORED_PROJECT_ID_OR_NUMBER
   

3. Lakukan autentikasi ke Google Cloud CLI:

   gcloud auth login
   

4. Opsional. Agar tidak perlu menentukan project ID dengan setiap perintah gcloud, tetapkan project ID sebagai default menggunakan gcloud CLI:

   gcloud config set project ${SCOPING_PROJECT_ID_OR_NUMBER}
   

5. Buat token otorisasi dan ambil dalam variabel lingkungan:

   TOKEN=`gcloud auth print-access-token`
   

   Token berlaku untuk waktu terbatas. Jika perintah yang berfungsi tiba-tiba melaporkan bahwa Anda tidak diautentikasi, terbitkan ulang perintah ini.

6. Untuk memverifikasi bahwa Anda mendapatkan token akses, tampilkan variabel TOKEN:

   echo ${TOKEN}
   ya29.GluiBj8o....
   

Anda mungkin juga harus menentukan argumen lain, misalnya, untuk menentukan jenis permintaan HTTP (misalnya, -X DELETE). Permintaan default adalah GET, sehingga contoh tidak menentukannya.

Langkah selanjutnya

Untuk informasi tentang cara menggunakan Google Cloud dengan Terraform, lihat resource berikut:

• Terraform dengan Google Cloud
• Registry Terraform untuk google_monitoring_monitored_project