Pelabelan resource App Engine

Label adalah cara mudah untuk mengelompokkan resource yang berhubungan atau terkait satu sama lain. Anda dapat menggunakan label untuk mendapatkan tampilan yang lebih terperinci tentang cara penagihan resource untuk layanan App Engine Anda. Anda juga dapat memanfaatkan fitur seperti pemfilteran bertingkat untuk melakukan penelusuran resource yang lebih akurat.

Berikut adalah beberapa cara untuk menggunakan label:

Beri label pada jenis layanan yang Anda buat. Misalnya, jika Anda menambahkan label seperti service:default, service:backend, dan service:frontend ke layanan App Engine, Anda dapat membandingkan bagaimana layanan yang berbeda ini menggunakan bandwidth keluar, jam kerja instance, dan resource lainnya.
Memberi label berdasarkan tim atau pusat biaya untuk membedakan project yang dimiliki oleh tim yang berbeda. Hal ini dapat digunakan dalam penghitungan atau penganggaran biaya. Misalnya, team:marketing dan team:research.
Memberi label pada lingkungan tempat layanan dijalankan. Misalnya, environment:prod dan environment:test.
Beri label berdasarkan pemilik atau kontak utama jika ada individu yang bertanggung jawab atas resource.
Memberi label status layanan. Misalnya, state:inuse dan state:readyfordeletion.

Label hanya dapat digunakan untuk data penagihan, bukan untuk alat lainnya, seperti Metrics Explorer.

Pembatasan

Anda dapat menetapkan hingga 64 label untuk setiap resource.
Anda hanya dapat memberi label layanan secara eksplisit. Versi dan instance mewarisi label dari layanan induknya.
Lingkungan fleksibel App Engine tidak mendukung label penagihan untuk Firestore dalam penggunaan mode Datastore (Datastore).

Menambahkan atau mengubah label

Untuk menambahkan label ke layanan App Engine:

Konsol

Buka halaman Layanan App Engine.

Buka Layanan
Pilih kotak centang di samping layanan yang ingin diberi label.
Klik Show info panel dan pilih tab Labels untuk meluaskan kolom label.
Klik Tambahkan label untuk menambahkan pasangan nilai kunci ke layanan yang Anda pilih. Misalnya, untuk menambahkan label env:prod, masukkan env untuk Kunci dan prod untuk Nilai.
Simpan perubahan Anda.

Admin API

Anda dapat menambahkan dan menetapkan label melalui resource Service. Lihat dokumentasi referensi Admin API:

Melihat data penagihan yang terkait dengan layanan yang diberi label

Anda dapat menambahkan perincian ke data penagihan untuk aplikasi Anda yang menggunakan label. Misalnya, Anda dapat melihat biaya untuk resource tertentu, seperti bandwidth keluar, yang dikelompokkan berdasarkan hari dan layanan. Hal ini dapat memberi Anda data tentang biaya aplikasi harian dan memungkinkan Anda mengoptimalkan penggunaan resource aplikasi Anda.

Untuk melihat label penagihan, ekspor data Anda ke BigQuery, lalu buat kueri data tersebut:

Ekspor data penagihan ke BigQuery.

Setelah Anda mengaktifkan BigQuery Export, mungkin perlu waktu beberapa jam untuk melihat data Anda.
Dari halaman BigQuery di Konsol Google Cloud, pilih project dan set data penagihan Anda.
Jalankan kueri terhadap tabel yang dibuat dari BigQuery Export.

Label ditambahkan ke set data Anda sebagai kolom berulang, yang berarti beberapa label dapat dipasangkan ke satu baris dalam set data biaya Anda. Untuk membuat kueri berdasarkan label dengan mudah, Anda dapat menerapkan FLATTEN tabel pada kolom label.

Misalnya, kueri berikut mengambil data biaya, kunci label, dan nilai label untuk bandwidth keluar tempat label berada:

SELECT
  product,
  resource_type,
  start_time,
  end_time,
  labels.key,
  labels.value,
  cost
FROM (FLATTEN([YOUR_DATASET.TABLEID], labels))
WHERE
  cost > 0.0
  and labels.key is not null
  and resource_type = 'Out Bandwidth'
LIMIT 100

BigQuery menampilkan data Anda dengan output yang diratakan:

produk	resource_type	start_time	end_time	labels_key	labels_value	cost
App Engine	Bandwidth Keluar	07-10-2017 22:00:00	07-10-2017 23:00:00	pelanggan	default	0,020033
App Engine	Bandwidth Keluar	07-10-2017 13:00:00	07-10-2017 14:00:00	pelanggan	frontend	0,016042
App Engine	Bandwidth Keluar	07-10-2017 06:00:00	07-10-2017 07:00:00	pelanggan	backend_task	0,013125
App Engine	Bandwidth Keluar	07-10-2017 21:00:00	07-10-2017 22:00:00	pelanggan	default	0,020722
App Engine	Bandwidth Keluar	07-10-2017 19:00:00	07-10-2017 20:00:00	pelanggan	frontend	0,020725
App Engine	Bandwidth Keluar	08-10-2017 04:00:00	08-10-2017 05:00:00	pelanggan	backend_task	0,02072
App Engine	Bandwidth Keluar	08-10-2017 02:00:00	08-10-2017 03:00:00	pelanggan	default	0,020723
App Engine	Bandwidth Keluar	07-10-2017 14:00:00	07-10-2017 15:00:00	pelanggan	frontend	0,020724
App Engine	Bandwidth Keluar	07-10-2017 23:00:00	08-10-2017 00:00:00	pelanggan	backend_task	0,021417

Jangka waktu dalam laporan penagihan

Untuk memastikan bahwa setiap hari dalam laporan mencakup periode 24 jam penuh, data penagihan yang Anda ekspor hanya berisi data hingga tengah malam terakhir, Waktu Pasifik. Misalnya, jika Anda mengekspor data penagihan pada siang hari pada 3 Desember, ekspor tersebut akan menyertakan data hingga 2 Desember, pukul 23.59.

Untuk setiap hari dalam laporan, data penagihan diatribusikan ke label yang ada di awal hari. Misalnya, jika Anda membuat label pada siang hari Waktu Pasifik pada tanggal 3 Desember, laporan untuk tanggal 3 Desember tidak akan mengatribusikan data ke label karena label tersebut tidak ada di awal hari. Data akan diatribusikan ke label mulai 4 Desember.

Label yang dibuat pada siang hari dan dihapus dalam periode 24 jam yang sama tidak akan memiliki data yang diatribusikan ke label tersebut.

Melihat label di konsol Google Cloud

Setelah memberi label pada resource, Anda dapat melihat label di konsol Google Cloud.

Buka halaman Layanan App Engine.

Buka Layanan
Untuk setiap layanan, Anda dapat melihat semua label di kolom Label.

Menghapus label

Untuk menghapus label dari layanan:

Buka halaman Layanan App Engine.

Buka Layanan App Engine
Pilih kotak centang di samping layanan yang ingin Anda hapus labelnya.
Klik Tampilkan panel info dan pilih tab Label untuk meluaskan kolom label.
Klik X di samping semua label yang ingin dihapus.
Simpan perubahan Anda.