Menentukan microservice

Dokumen ini menjelaskan cara membuat layanan dan layanan kustom untuk resource berbasis GKE dan Cloud Run.

Dalam Cloud Monitoring, layanan adalah konstruksi yang dapat Anda kaitkan dengan SLO dan kebijakan pemberitahuan. Beberapa resource yang dapat Anda buatkan layanan Monitoring juga disebut sebagai layanan, tetapi dengan arti yang berbeda, seperti layanan GKE atau layanan Cloud Run.

Monitoring dapat mengenali layanan berbasis GKE dan Cloud Run sebagai kandidat untuk pemantauan. Untuk membuat layanan bagi mereka, Anda menentukan kandidat yang ingin diperlakukan sebagai layanan Monitoring. Monitoring akan membuat infrastruktur yang diperlukan untuk Anda.

Anda juga dapat menentukan layanan kustom arbitrer.

Mengidentifikasi atau membuat layanan

Untuk mengidentifikasi layanan kandidat, atau membuat layanan kustom, buka panel Define service:

Pada panel navigasi Konsol Google Cloud, pilih Monitoring, lalu pilih SLO:
Buka SLO
Di halaman Services Overview, lakukan salah satu hal berikut:
- Klik Tentukan layanan.
- Di panel Current status, klik link Define service:

Dari panel Define service, Anda dapat melakukan hal berikut:

Membuat layanan berbasis GKE atau Cloud Run dari daftar layanan kandidat.
Menentukan layanan kustom.

Bagian berikut menjelaskan opsi ini.

Membuat layanan berbasis GKE dan Cloud Run

Cloud Monitoring dapat mengidentifikasi layanan potensial dari jenis berikut:

Namespace GKE
Layanan GKE
Workload GKE
Layanan Cloud Run

Karena mungkin ada banyak layanan potensial ini, Monitoring tidak berasumsi bahwa Anda ingin semuanya diperlakukan sebagai layanan dengan SLO. Untuk menunjukkan layanan potensial mana yang harus diperlakukan sebagai layanan, Anda dapat menggunakan Konsol Google Cloud atau API.

Menggunakan Google Cloud Console untuk membuat layanan GKE dan Cloud Run

Untuk mengidentifikasi layanan Monitoring berbasis GKE atau Cloud Run dengan menggunakan Konsol Google Cloud, lakukan hal berikut:

Pada halaman Services Overview, klik Define service.
Pilih Kandidat Layanan.

Mungkin ada banyak layanan kandidat dalam daftar. Anda dapat memfilter daftar sebagai berikut:
1. Klik Filter tabel. Daftar opsi filter akan ditampilkan.
2. Pilih salah satu opsi di daftar filter. Opsi yang dipilih akan muncul di panel filter.
3. Klik di samping opsi di panel filter dan mulai mengetik. Nilai yang cocok diberikan dalam daftar. Pilih nilai dari daftar.
Klik layanan kandidat dari daftar layanan potensial.

Saat Anda mengklik entri, kolom berikut akan diisi untuk Anda:
- Nama tampilan ditetapkan ke nama entri dalam daftar. Anda dapat mengubah nilai ini.
- Satu blok kode JSON untuk konfigurasi layanan baru dibuat dari kandidat. Jangan ubah nilai ini.
Klik Submit. Saat layanan dibuat, pemberitahuan Berhasil akan ditampilkan.

Menggunakan API untuk membuat layanan GKE dan Cloud Run

Layanan berbasis GKE dan Cloud Run juga dapat ditentukan menggunakan SLO API, bagian dari Cloud Monitoring API.

Untuk membuat layanan secara terprogram, posting objek konfigurasi seperti salah satu dari berikut ini ke metode services.create:

Namespace GKE

Gunakan struktur GkeNamespace, misalnya:

{
  "displayName": "test-kube-namespace",
  "gkeNamespace": {
    "location": "us-central1-c",
    "clusterName": "cluster-1",
    "namespaceName": "test-kube-namespace"
  }
}

Layanan GKE

Gunakan struktur GkeService, misalnya:

{
  "displayName": "test-kube-service",
  "gkeService": {
    "location": "us-central1-c",
    "clusterName": "cluster-1",
    "namespaceName": "kube-system",
    "serviceName": "test-kube-service"
  }
}

Beban kerja GKE

Gunakan struktur GkeWorkload, misalnya:

{
  "displayName": "frontend-a",
  "gkeWorkload": {
    "location": "us-central1-b",
    "clusterName": "cluster-2",
    "namespaceName": "default",
    "topLevelControllerType": "Deployment",
    "topLevelControllerName": "frontend-a"
  }
}

Cloud Run

Gunakan struktur CloudRun, misalnya:

{
  "displayName": "test-cloudrun-service",
  "cloudRun": {
    "serviceName": "test-cloudrun-service",
    "location": "us-central1"
  }
}

Untuk mengetahui informasi selengkapnya tentang cara mengelola layanan secara terprogram, lihat Bekerja dengan API.

Membuat layanan kustom

Saat tidak ada jenis layanan lain yang memenuhi kebutuhan Anda, buat layanan kustom. Dengan layanan kustom, Anda dapat mengelompokkan SLO secara bebas dengan cara yang bermanfaat bagi lingkungan Anda, atau membuat SLO pada metrik bisnis yang tidak sesuai dengan microservice yang ada.

Menggunakan Google Cloud Console untuk membuat layanan kustom

Untuk menentukan layanan kustom menggunakan konsol Google Cloud, lakukan hal berikut:

Klik Define service di halaman Services Overview untuk memunculkan panel Define service.
Pilih Layanan Kustom.
Masukkan nama tampilan untuk layanan kustom Anda.
Klik Submit. Saat layanan dibuat, pemberitahuan Berhasil akan ditampilkan.

Menggunakan API untuk membuat layanan kustom

Untuk menentukan layanan kustom menggunakan SLO API, posting objek konfigurasi Custom seperti berikut ke metode services.create:

{
  "displayName": "hello-world-service",
  "custom": {}
}

Untuk mengetahui informasi selengkapnya tentang cara mengelola layanan secara terprogram, lihat Bekerja dengan API.

Langkah selanjutnya

Setelah mengidentifikasi atau membuat layanan baru, Anda dapat melakukan hal berikut:

Buat SLO untuk layanan baru Anda. Anda harus menentukan setidaknya satu SLO untuk layanan baru agar layanan tersebut dapat berguna. Untuk mengetahui informasi selengkapnya, lihat Membuat SLO.
Buka dasbor untuk layanan baru Anda. Untuk layanan baru, dasbor kosong, tetapi Anda dapat menentukan SLO dari dasbor. Untuk informasi selengkapnya, lihat Menggunakan dasbor microservice.