Konfigurasikan sakelar pelaporan log - Mobile Platform as a Service

Anda dapat menggunakan konfigurasi sakelar untuk mengontrol pelaporan log secara dinamis. Server mengirimkan nilai sakelar guna memodifikasi kondisi pelaporan log secara otomatis.

Mobile Analysis Service (MAS) mengandalkan SDK client untuk tagging. SDK tersebut mengumpulkan data mengenai perilaku pengguna dan performa aplikasi, lalu mengubahnya menjadi log yang dilaporkan ke server. Log ini kemudian diproses secara real-time atau offline menjadi metrik dan dashboard.

mPaaS mengenakan biaya berdasarkan traffic dari log tagging yang dilaporkan. Untuk menghindari biaya yang tidak perlu, Anda dapat mengelola pelaporan log melalui konfigurasi sakelar. Informasi lebih lanjut mengenai biaya traffic pelaporan log tersedia di Postpaid.

Topik ini menjelaskan cara menambahkan dan mengelola konfigurasi tagging.

Tambahkan konfigurasi tagging

Masuk ke konsol mPaaS. Pada panel navigasi di sebelah kiri, pilih Mobile Analysis Service > Log management > Configure upload switch. Di pojok kiri atas, klik Tagging Configuration untuk membuka halaman daftar sakelar log.
Klik New Business dan konfigurasikan informasi tagging.
- Business Code: Kode bisnis. Untuk tag perilaku kustom, konfigurasi kode bisnis berbeda tergantung platformnya.
  - Android: bizType yang ditetapkan oleh client menggunakan metode MPLogger.event(String logId, String bizType, Map<String, String> params). Nilai bizType tidak boleh mengandung garis bawah (_).
  - iOS: Nilai default-nya adalah behavior. Client dapat menyesuaikannya menggunakan parameter bizType pada antarmuka writeLogWithActionId. Informasi lebih lanjut tersedia di Kode bisnis Android atau Kode bisnis iOS.
- Business Name: Deskripsi operasi tagging. Anda dapat menyesuaikan nama bisnis ini.
- Log Header: Field 01 dalam model log, digunakan untuk membedakan tipe log yang berbeda. Log header untuk tag perilaku kustom adalah D-VM. Informasi lebih lanjut tersedia di Model log.
Klik Add untuk menambahkan konfigurasi tagging. Informasi lebih lanjut tentang memodifikasi konfigurasi tersedia di bagian Memodifikasi konfigurasi tagging di bawah.

Memodifikasi konfigurasi tagging

Konfigurasi tagging baru akan ditampilkan di daftar sakelar log. Anda dapat mengatur sakelar pelaporan log, mengonfigurasi pengaturan jaringan, memodifikasi tag, serta menghapus konfigurasi tersebut.

Atur sakelar pelaporan log

Anda dapat mengaktifkan atau menonaktifkan pelaporan log. Saat sakelar pelaporan diaktifkan, log tagging untuk operasi tersebut akan dilaporkan secara otomatis.

Atur jaringan pelaporan

Anda dapat memilih untuk melaporkan log tagging di Semua lingkungan jaringan (seperti 2G, 3G, 4G, dan Wi-Fi) atau hanya di lingkungan Wi-Fi.

Modifikasi informasi tagging

Pada kolom Actions, klik Modify untuk membuka halaman modifikasi konfigurasi tagging. Anda dapat melakukan perubahan lebih lanjut pada konfigurasi:

Business Code: Sesuai dengan kode bisnis yang Anda masukkan saat menambahkan konfigurasi tagging.
Description: Sesuai dengan nama bisnis yang Anda masukkan saat menambahkan konfigurasi tagging.
Log Header: Sesuai dengan log header yang Anda masukkan saat menambahkan konfigurasi tagging.
Minimum upload level: Setiap log memiliki tingkat kepentingan 1, 2, atau 3. Tingkat 1 paling penting, diikuti tingkat 2, lalu tingkat 3. Jika Anda mengatur tingkat pelaporan minimum ke 2, log dengan tingkat 1 dan 2 akan dilaporkan, tetapi log tingkat 3 tidak. Tingkat default untuk tag perilaku kustom adalah 2. Untuk aplikasi iOS, Anda dapat memodifikasi tingkat log saat melakukan tagging di sisi client. Informasi lebih lanjut tersedia di Tagging perilaku kustom iOS.
Uploaded logs: Log tagging dari sisi client pertama kali ditulis ke file lokal. Ketika jumlah log untuk tipe kode bisnis ini dalam file lokal mencapai jumlah tertentu, log tersebut akan dilaporkan secara otomatis ke sisi server Mobile Analysis Service. Informasi lebih lanjut tersedia di Pelaporan log otomatis Android atau Pelaporan log otomatis iOS.
Log upload rate: Laju pelaporan log, dihitung per pengguna. Nilai ini dalam satuan permil. Misalnya, nilai 1000 berarti log dilaporkan untuk semua pengguna.
Strategy: Jika Anda mencentang kebijakan Upload in background, waktu pelaporan berbeda tergantung platformnya.
- Android: Pelaporan log otomatis dipicu ketika aplikasi masuk ke latar belakang selama lebih dari setengah jam.
- iOS: Pelaporan log otomatis dipicu segera ketika aplikasi masuk ke latar belakang. Informasi lebih lanjut tersedia di Pelaporan log Android atau Pelaporan log iOS.

Inisialisasi bisnis

Log yang ditulis secara lokal oleh client akan dilaporkan secara otomatis ke sisi server Mobile Analysis Service ketika kondisi tertentu terpenuhi. Konfigurasi tagging default menentukan kondisi pemicu untuk pelaporan otomatis tersebut. Setelah membuat aplikasi baru, Anda dapat menggunakan fitur Initialize Business untuk menyinkronkan konfigurasi tagging default ke daftar konfigurasi tagging aplikasi baru tersebut.

Untuk menginisialisasi konfigurasi bisnis, klik tombol Initialize Business pada halaman dan konfirmasi aksi tersebut. Setelah inisialisasi berhasil, daftar konfigurasi tagging default akan ditampilkan.

Penting

Meskipun Anda tidak menggunakan fitur Initialize Business untuk menyinkronkan konfigurasi tagging default ke daftar aplikasi baru, konfigurasi default tersebut tetap berlaku. Namun, konfigurasi tersebut tidak akan ditampilkan di daftar konfigurasi tagging.

Mock

Seperti dijelaskan sebelumnya, Anda dapat menambahkan dan memodifikasi konfigurasi tagging pada halaman konsol untuk mengontrol kebijakan pelaporan log. Konsol juga memungkinkan Anda mengonfigurasi tagging secara langsung menggunakan JSON. Namun, kami tidak merekomendasikan penggunaan fitur ini karena alasan berikut:

Fitur mock hanyalah cara praktis untuk mengonfigurasi tagging dan tidak menyediakan fungsi tambahan.
Jika Anda mengonfigurasi tag bisnis yang sama baik melalui halaman konsol maupun fitur mock, konfigurasi mock akan diutamakan.
Jika Anda tidak terbiasa dengan format konfigurasi tagging, Anda mungkin kesulitan menggunakan fitur mock dengan benar. Penggunaan yang salah dapat memengaruhi perilaku pelaporan log otomatis default.

Tambahkan konfigurasi mock

Ikuti langkah-langkah berikut untuk menambahkan konfigurasi mock:

Pada halaman Configure Upload Switch, klik Add Mock Configuration.
Isi informasi konfigurasi.
- Version: Pilih versi aplikasi Anda.
- Platform: Pilih tipe aplikasi.
- Value: Informasi konfigurasi dalam format JSON. Informasi lebih lanjut tersedia di bagian Format konfigurasi mock di bawah.
Setelah memastikan informasi sudah benar, klik OK untuk menambahkan konfigurasi mock.

Format konfigurasi mock

Format konfigurasi mock adalah sebagai berikut:

{
                        "LogHeader1": {
                        "BusinessCode1": {
                        "write": "yes",
                        "send": [
                        "wifi"
                        ],
                        "maxLogCount": 50,
                        "level": 3,
                        "uploadRate": 1000,
                        "event": [
                        "gotoBackground"
                        ]
                        },
                        "BusinessCode2": {
                        ...
                        },
                        ...
                        },
                        "LogHeader2": {
                        ...
                        },
                        ...
                        }

LogHeader: Sesuai dengan log header dalam konfigurasi tagging.
BusinessCode: Sesuai dengan kode bisnis dalam konfigurasi tagging.
write: Sesuai dengan sakelar pelaporan dalam konfigurasi tagging. Nilainya adalah "yes" jika sakelar diaktifkan, dan "no" jika tidak.
send: Sesuai dengan jaringan dalam konfigurasi tagging. Nilainya adalah ["2g", "3g", "4g", "wifi"] untuk Semua jaringan dan ["wifi"] untuk Wi-Fi saja.
maxLogCount: Sesuai dengan jumlah pelaporan log dalam konfigurasi tagging.
level: Sesuai dengan tingkat pelaporan minimum dalam konfigurasi tagging.
uploadRate: Sesuai dengan laju pelaporan log dalam konfigurasi tagging.
event: Sesuai dengan kebijakan dalam konfigurasi tagging. Nilainya adalah ["gotoBackground"] jika kebijakan Report in Background dipilih, dan [] jika tidak.