Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Mengirim pesan dengan Firebase console

Anda dapat mengirim pesan notifikasi menggunakan Notifications Composer di Firebase console. Meskipun tanpa fleksibilitas atau skalabilitas yang sama seperti pengiriman pesan dengan Admin SDK atau protokol HTTP dan XMPP, Notifications Composer bisa sangat berguna untuk pengujian atau pemasaran dan interaksi pengguna yang ditargetkan secara khusus. Firebase console menyediakan pengujian A/B berbasis analisis untuk membantu menyaring dan menyempurnakan pesan pemasaran.

Setelah mengembangkan logika penerimaan pesan di aplikasi, Anda dapat memungkinkan pengguna non-teknis untuk mengirim pesan sesuai petunjuk di halaman Notifications pada Pusat Bantuan Firebase.

Tentang

Saat Anda mengirim pesan notifikasi dari Notifications Composer, Google menggunakan nilai yang dimasukkan dalam kolom formulir dengan cara berikut:

  • Kolom seperti Segmen pengguna dan Masa berlaku menentukan opsi target dan pengiriman pesan.
  • Kolom seperti Teks notifikasi dan Data kustom dikirim ke klien dalam payload yang terdiri dari key-value pair.

Kolom ini dipetakan ke kunci yang tersedia melalui protokol server FCM. Misalnya, key-value pair yang dimasukkan ke dalam Data kustom akan ditangani sebagai payload data untuk notifikasi tersebut. Kolom lain langsung dipetakan ke kunci di payload notifikasi FCM.

Perlu diperhatikan bahwa beberapa kolom di Notifications Composer tidak tersedia melalui protokol server FCM. Misalnya, Anda dapat menargetkan segmen pengguna berdasarkan versi aplikasi, bahasa, jenis dan versi browser, atau properti pengguna dengan cara yang tidak tersedia menggunakan kolom to di API server.

Kunci yang dikirim Firebase console ke klien adalah:

Kunci Label kolom console Deskripsi
notification.title Judul notifikasi Menunjukkan judul notifikasi.
notification.body Teks notifikasi Menunjukkan teks isi notifikasi.
data Data kustom Key-value pair yang Anda tetapkan. Key-value pair disampaikan sebagai payload data untuk ditangani aplikasi.

Kunci yang menentukan pengiriman pesan meliputi:

Kunci Label kolom console Deskripsi
sound Suara

Menunjukkan suara yang akan diputar ketika perangkat menerima notifikasi.

time_to_live Tanggal berakhir

Parameter ini menetapkan berapa lama (dalam detik) pesan harus disimpan dalam penyimpanan FCM jika perangkat sedang offline. Untuk informasi lebih lanjut, lihat Menetapkan masa aktif pesan.

Log audit

Halaman ini menjelaskan log audit yang dibuat oleh Firebase sebagai bagian dari Cloud Audit Logs.

Ringkasan

Layanan Firebase menulis log audit untuk membantu Anda menjawab pertanyaan, "Siapa yang melakukan apa, di mana, dan kapan?" Log tersebut adalah Cloud Audit Logs, yang disediakan sebagai bagian dari project Google Cloud yang terhubung ke project Firebase Anda. Setiap project Firebase Anda hanya berisi log audit untuk resource yang berada dalam project secara langsung.

Untuk ringkasan umum tentang Log Audit Cloud, buka Log Audit Cloud. Agar dapat lebih memahami Cloud Audit Logs, baca Memahami log audit.

Cloud Audit Logs menyimpan tiga log audit untuk setiap project, folder, dan organisasi Google Cloud:

  • Log audit Aktivitas Admin
  • Log audit Akses Data
  • Log audit Peristiwa Sistem

Jika diaktifkan secara eksplisit, Firebase Notifications Console akan menulis log audit Akses Data. Log audit Akses Data berisi panggilan API yang membaca konfigurasi atau metadata resource, serta panggilan API yang dilakukan pengguna untuk membuat, mengubah, atau membaca data resource yang diberikan pengguna. Log audit Akses Data tidak merekam operasi akses data di resource yang digunakan bersama secara publik (tersedia untuk Semua Pengguna atau Semua Pengguna Terautentikasi) atau yang dapat diakses tanpa login ke Google Cloud.

Firebase Notifications Console tidak menulis log audit Aktivitas Admin.

Firebase Notifications Console tidak menulis log audit Peristiwa Sistem.

Operasi yang diaudit

Ringkasan berikut menunjukkan operasi API yang sesuai dengan setiap jenis log audit di Firebase Notifications Console:

Kategori log audit Tindakan Firebase Notifications Console Nama jenis (digunakan untuk penelusuran di UI untuk log)
Log Akses Data (DATA_READ) Mendapatkan campaign GetCampaign
Log Akses Data (DATA_READ) Membuat daftar campaign ListCampaign
Log Akses Data (DATA_READ) Mendapatkan informasi dari notifikasi uji coba ABT LegacyGetRollout
Log Akses Data (DATA_READ) Mendapatkan peluang penargetan GetAudiences
Log Akses Data (DATA_READ) Mendapatkan statistik fcm (jumlah Dikirim/Dibuka/Ditayangkan/Dikonversi) GetFcmStats
Log Akses Data (DATA_READ) Mendapatkan daftar label analisis untuk rentang tanggal dan project. GetAnalyticsLabelList
Log Akses Data (DATA_WRITE) Membuat campaign CreateCampaign
Log Akses Data (DATA_WRITE) Menghapus campaign DeleteCampaign
Log Akses Data (DATA_WRITE) Mengupdate campaign UpdateCampaign
Log Akses Data (DATA_WRITE) Membuat Peluncuran dari ABT LegacyCreateRollout

Format log audit

Entri log audit, yang dapat dilihat di Stackdriver Logging menggunakan Logs Viewer, Stackdriver Logging API, atau Cloud SDK, mencakup objek berikut:

  • Entri log itu sendiri, yang merupakan objek dengan jenis LogEntry. Kolom berguna yang meliputi hal berikut ini:

    • logName berisi identifikasi project dan jenis log audit
    • resource berisi target operasi yang diaudit
    • timeStamp berisi waktu operasi yang diaudit
    • protoPayload berisi informasi yang diaudit
  • Data logging audit, yang merupakan objek AuditLog yang disimpan di kolom protoPayload entri log.

  • Informasi audit khusus layanan opsional, yang merupakan objek khusus layanan yang disimpan di kolom serviceData dari objek AuditLog. Untuk mengetahui detailnya, buka Data audit khusus layanan.

Untuk kolom lain dalam objek ini, serta cara menafsirkannya, pelajari Memahami log audit.

Nama log

Nama resource Cloud Audit Logs menunjukkan project atau entity lain yang memiliki log audit, dan apakah log berisi data log audit Aktivitas Admin, Akses Data, atau Peristiwa Sistem. Misalnya, string berikut menunjukkan nama log untuk log audit Aktivitas Admin di project dan log audit Akses Data suatu organisasi:

projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity
organizations/[ORGANIZATION_ID]/logs/cloudaudit.googleapis.com%2Fdata_access

Nama layanan

Log audit Firebase Notifications Console menggunakan nama layanan gcmcontextualcampaign-pa.googleapis.com.

Untuk detail lebih lanjut mengenai layanan logging, buka Memetakan layanan ke resource.

Jenis resource

Log audit Firebase Notifications Console menggunakan jenis resource audited_resource untuk semua log audit.

Untuk melihat daftar lengkapnya, buka Jenis resource yang dimonitor.

Mengaktifkan logging audit

Log audit Akses Data dinonaktifkan secara default dan tidak ditulis kecuali diaktifkan secara eksplisit (dengan pengecualian log audit Akses Data untuk BigQuery, yang tidak dapat dinonaktifkan).

Untuk melihat petunjuk cara mengaktifkan sebagian atau semua log audit Akses Data Anda, buka Mengonfigurasi Log akses data.

Log audit Akses Data yang Anda aktifkan dapat memengaruhi harga log di Stackdriver. Pelajari bagian Harga di halaman ini.

Firebase Notifications Console tidak menulis log audit Aktivitas Admin.

Izin log audit

Izin dan peran pada Cloud Identity and Access Management menentukan log audit mana yang dapat Anda lihat atau ekspor. Log berada di dalam project dan dalam beberapa entity lain termasuk organisasi, folder, dan akun penagihan. Untuk informasi lebih lanjut, buka Memahami peran.

Untuk melihat log audit Akses Data, Anda harus memiliki salah satu peran berikut dalam project yang berisi log audit Anda:

Jika Anda menggunakan log audit dari entity non-project, seperti organisasi, ubah peran Project ke peran organisasi yang sesuai.

Lihat log

Anda memiliki beberapa opsi untuk melihat entri log audit Anda:

Viewer Dasar

Anda dapat menggunakan antarmuka dasar Logs Viewer di GCP Console untuk mengambil entri log audit Anda. Lakukan hal berikut:

  1. Buka halaman Stackdriver Logging > Log (Logs Viewer) di GCP Console:

    Buka halaman Logs Viewer

  2. Pilih project Google Cloud yang ada di bagian atas halaman, atau buat project baru.

  3. Di menu drop-down pertama, pilih jenis resource yang ingin Anda lihat log auditnya. Anda dapat memilih resource tertentu atau Global untuk semua resource.

  4. Di menu drop-down kedua, pilih jenis log yang ingin dilihat: activity untuk log audit Aktivitas Admin, data_access untuk log audit Akses Data, dan system_events untuk log audit Peristiwa Sistem.

    Jika opsi tersebut tidak ditampilkan, tidak ada log audit dengan jenis tersebut yang tersedia dalam project.

Viewer Lanjutan

Anda dapat menggunakan antarmuka lanjutan Logs Viewer di GCP Console untuk mengambil entri log audit Anda. Lakukan hal berikut:

  1. Buka halaman Stackdriver Logging > Log (Logs Viewer) di GCP Console:

    Buka halaman Logs Viewer

  2. Pilih project Google Cloud yang ada di bagian atas halaman, atau buat project baru.

  3. Di menu drop-down pertama, pilih jenis resource yang ingin Anda lihat log auditnya. Anda dapat memilih resource tertentu atau Global untuk semua resource.

  4. Klik panah drop-down (▾) di bagian paling kanan kotak filter penelusuran, lalu pilih Konversikan ke filter lanjutan.

  5. Buat filter yang lebih lanjut menentukan entri log yang ingin Anda lihat. Untuk mengambil semua log audit di project Anda, tambahkan filter berikut. Berikan [PROJECT_ID] yang valid di tiap nama log.

      logName = ("projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity" OR
          OR "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events"
          OR "projects/[PROJECT_ID]logs/cloudaudit.googleapis.com%2Fdata_access")
    

    Untuk detail lebih lanjut tentang filter, buka Filter log lanjutan.

API

Untuk melihat entri log audit Anda menggunakan Stackdriver Logging API:

  1. Buka bagian Coba API ini dalam dokumentasi untuk metode entries.list.

  2. Masukkan string berikut ke dalam bagian Isi permintaan di formulir Coba API ini. Mengklik formulir yang telah diisi sebelumnya ini akan otomatis mengisi bagian permintaan, tetapi Anda harus memberikan [PROJECT_ID] yang valid di setiap nama log.

      {
        "resourceNames": [
          "projects/[PROJECT_ID]"
        ],
        "pageSize": 5,
        "filter": "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"
      }
    
  3. Klik Jalankan.

Untuk detail lebih lanjut tentang kueri, buka Kueri log lanjutan.

SDK

Untuk membaca entri log Anda menggunakan Cloud SDK, jalankan perintah berikut. Berikan [PROJECT_ID] yang valid di tiap nama log.

gcloud logging read "logName=(projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fsystem_events OR projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Fdata_access)"

Buka Membaca entri log untuk mendapatkan informasi lebih lanjut cara menggunakan Cloud SDK.

Untuk sampel entri log audit dan cara mencari informasi yang paling penting di dalamnya, buka Memahami log audit.

Mengekspor log audit

Anda dapat mengekspor log audit dengan cara yang sama seperti saat mengekspor jenis log lainnya. Untuk mengetahui cara mengekspor log Anda, buka Mengekspor log. Berikut adalah beberapa penerapan dari ekspor log audit:

  • Untuk menyimpan log audit dalam jangka waktu yang lebih lama atau menggunakan kemampuan penelusuran yang lebih andal, Anda dapat mengekspor salinan log audit Anda ke Google Cloud Storage, BigQuery, atau Google Cloud Pub/Sub. Dengan Cloud Pub/Sub, Anda dapat mengekspor ke aplikasi lain, repositori lain, dan ke pihak ketiga.

  • Untuk mengelola log audit di seluruh organisasi, Anda dapat membuat sink ekspor gabungan yang dapat mengekspor log dari satu atau semua project di organisasi.

  • Jika log audit Akses Data yang diaktifkan membuat project Anda melebihi alokasi log-nya, Anda dapat mengekspor dan mengecualikan log audit Akses Data dari Logging. Untuk mengetahui detailnya, buka Mengecualikan log.

Harga

Stackdriver Logging mengenakan biaya kepada Anda untuk log audit Akses Data yang secara eksplisit Anda minta. Firebase Notifications Console tidak menulis log audit Aktivitas Admin atau log audit Peristiwa Sistem.

Untuk informasi selengkapnya mengenai harga log audit, pelajari harga Stackdriver.