Bagikan melalui

Ekspor

Penting

Visual Studio App Center dihentikan pada 31 Maret 2025, kecuali untuk fitur Analitik dan Diagnostik, yang akan terus didukung hingga 30 Juni 2026. Pelajari lebih lanjut.

App Center memungkinkan Anda untuk terus mengekspor semua data mentah Analitik Anda ke Azure. Anda dapat mengekspor data Analytics ke Blob Storage dan Application Insights (Azure Monitor). Dengan mengekspor data, Anda mendapat manfaat dari:

  • Retensi data tak terbatas
  • Analisis Penggunaan Terperinci
  • Dasbor terpadu
  • Fitur tambahan yang kaya dari Application Insights seperti jalur konversi, retensi

App Center terus mengekspor data Analytics ke Application Insights sejak Anda mengonfigurasi ekspor bersama dengan dua hari data yang diisi ulang. Dengan dasbor baru yang diperbarui di Application Insights, pengguna App Center bisa mendapatkan tampilan terpadu dari Analitik Aplikasi dan Backend di satu dasbor.

App Center terus mengekspor data Analytics ke Blob Storage sejak Anda mengonfigurasi ekspor bersama dengan 28 hari data yang diisi ulang. Pelajari selengkapnya tentang Blob Storage

Anda juga dapat mengekspor data ke Azure General Purpose v2 Storage Blob. Akun penyimpanan v2 tujuan umum mendukung fitur Azure Storage terbaru dan menggabungkan semua fungsionalitas akun penyimpanan v1 dan Blob tujuan umum.

Pelajari selengkapnya tentang Penyimpanan Tujuan Umum v2Pelajari selengkapnya tentang Application Insights

Azure Blob Storage

Azure Blob Storage adalah layanan untuk menyimpan sejumlah besar data objek yang tidak terstruktur, seperti teks atau data biner, yang tersedia di seluruh dunia melalui HTTP atau HTTPS. Anda dapat menggunakan Blob Storage untuk mengekspos data secara publik, atau untuk menyimpan data secara privat.

Data diekspor setiap menit dan subfolder baru dibuat setiap kali. Data disimpan dalam format tahun/bulan/hari/jam/menit (misalnya, https://<blob-storage-account>.blob.core.windows.net/archive/2017/12/09/04/03/logs.v1.data) secara default saat blob_path_format_kind diatur ke WithoutAppId. config Saat properti disetel ke WithAppId, data disimpan dalam format appId/year/month/day/hour/minute, yang menambahkan appID di awal jalur default. Data akan memakan waktu hingga 5 menit untuk ditampilkan di Azure Blob Storage.

Data dibagi dalam data "Analitik" (sesi, kejadian), "Kecelakaan", "Kesalahan" dan "Lampiran". Pelajari selengkapnya tentang mengekspor data diagnostik

Visualisasi data di Azure Blob Storage

Konten file blob adalah array JSON dari log perangkat klien, yang terlihat seperti ini untuk data Analytics:

[
    {
        "AppId": "00001111-aaaa-2222-bbbb-3333cccc4444",
        "Timestamp": "2017-12-09T04:02:53.618Z",
        "InstallId": "e589a371-ea0c-4479-9a7b-9f834adec040",
        "MessageType": "EventLog",
        "IngressTimestamp": "2017-12-09T04:02:57.987Z",
        "MessageId": "980e21a0-0cbb-48ac-8820-28acf4beb00d",
        "EventId": "ad980536-e743-48a9-ab7e-cb043602d2c9",
        "EventName": "log_out",
        "CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
        "IsTestMessage": "False",
        "SdkVersion": "1.0",
        "Model": "PC",
        "OemName": "Samsung",
        "OsName": "Android",
        "OsVersion": "8.1.0",
        "OsApiLevel": "2",
        "Locale": "EN",
        "TimeZoneOffset": "PT2M",
        "ScreenSize": "320x240",
        "AppVersion": "1.1.0",
        "AppBuild": "1",
        "AppNamespace": "com.microsoft.test",
        "CarrierName": "AT&T",
        "CarrierCountry": "US",
        "CountryCode": "US",
        "WrapperSdkVersion": "1.0",
        "WrapperSdkName": "mobilecenter.xamarin","Properties": "{\"extra_00\":\"5bcacf3598ca44ebbbc99e4488cfc854\",\"extra_01\":\"2673e48867c74d51af8dc24c762a8b28\",\"extra_02\":\"5b76c801e5074cd3a13ea37253b94484\",\"extra_03\":\"c1e76aa252c947d4b4bcd4d1d96a7be6\",\"extra_04\":\"caea50034c4f441a963700fa3cf70d03\"}",
        "SessionId": "10df497a-4261-4995-b466-3fd77ac47395",
        "SdkName": "mobilecenter.android",
        "OsBuild": "2",
        "WrapperRuntimeVersion": "None",
        "LiveUpdateDeploymentKey": "stage",
        "LiveUpdatePackageHash": "dsadsdasd3211321233",
        "LiveUpdateReleaseLabel": "2.0"
    }
]

Azure Application Insights

Application Insights adalah layanan manajemen performa aplikasi (APM) yang menawarkan kemampuan kueri, segmentasi, pemfilteran, dan analitik penggunaan melalui data peristiwa App Center Anda. Dengan menambahkan App Center SDK ke aplikasi Anda dan mengekspor data ke sumber daya Application Insights jenis aplikasi App Center, Anda akan mendapatkan akses ke fitur berikut:

  • Analytics Application Insights Gunakan bahasa kueri yang kuat untuk menganalisis data peristiwa mentah Anda dan membuat visualisasi. Anda bisa mengekspor hasil kueri Anda ke Power BI atau Excel.
  • Pengguna, Sesi, dan Peristiwa. Pelajari berapa banyak orang yang menggunakan setiap halaman dan fitur aplikasi Anda, lalu segmentasikan menurut negara, browser, atau properti lainnya untuk memahami alasannya.
  • Corong dan Alur pengguna. Pahami cara pengguna menavigasi melalui aplikasi Anda. Identifikasi kemacetan. Temukan cara untuk meningkatkan tingkat konversi dan menghilangkan titik nyeri.
  • Retensi. Temukan berapa banyak pengguna yang kembali menggunakan aplikasi Anda. Cari tahu di mana dan mengapa mereka berhenti sekolah.
  • Buku Kerja. Buat buku kerja interaktif yang menggabungkan visualisasi analisis penggunaan, kueri Application Insights Analytics, dan teks untuk berbagi wawasan di tim Anda.

Bidang App Center dipetakan ke dalam format Application Insights. Berikut adalah kesetaraan antara bidang yang dipetakan:

Application Insights App Center
stempel waktu Waktu kejadian
Nama Nama peristiwa kustom atau jenis data
customDimensions Ini termasuk beberapa bidang yang diperlihatkan dalam tabel di bawah ini
session_Id Pengidentifikasi sesi unik
user_Id Pengidentifikasi penginstalan
application_Version Versi aplikasi
tipe_klien, model_klien Model Perangkat
sistem operasi klien Jenis dan versi OS
Versi SDK Versi App Center SDK

Tabel di bawah ini memperlihatkan pemetaan bidang untuk bidang "customDimensions".

Application Insights App Center
AppBuild Nomor build aplikasi
AppId Pusat Aplikasi App ID
AppNamespace Namespace layanan aplikasi
NegaraOperator Negara penyedia layanan
Nama Operator Jenis operator
EventId ID Peristiwa App Center
IngressTimestamp Tanda waktu penyerapan log
Lokasi Bahasa perangkat
JenisPesan Jenis peristiwa (sesi, peristiwa, ...)
OsApiLevel Tingkat OS API
OsBuild Nomor build OS
OsName Nama OS
OsVersion Versi OS
Karakteristik Properti yang dilampirkan ke peristiwa kustom
Ukuran Layar Ukuran layar perangkat
SdkName Nama SDK App Center
Versi SDK Versi App Center SDK
Offset Zona Waktu Offset zona waktu
UserId Pengidentifikasi pengguna kustom (ditetapkan oleh pengembang)
WrapperRuntimeVersion Versi runtime pembungkus App Center SDK
WrapperSdkName Nama pembungkus SDK App Center
WrapperSdkVersion Versi pembungkus App Center SDK

Contoh kueri AI untuk mengambil peristiwa kustom:

customEvents
    | where name == "YourEventName"
    | extend Properties = todynamic(tostring(customDimensions.Properties))
    | extend YourPropertyName = Properties.YourPropertyName

Informasi selengkapnya tentang Application Insights dan App Center:

Prasyarat

Anda harus memiliki Langganan Azure untuk menggunakan Ekspor; Jika Anda tidak memiliki langganan Azure, buat akun Azure gratis sebelum memulai.

Penautan Langganan Azure

Nota

Langkah ini hanya diperlukan untuk Ekspor Standar; Ekspor Kustom tidak memerlukan langganan Azure.

Ekspor standar data aplikasi App Center ke Azure memerlukan langganan Azure yang ditautkan ke aplikasi App Center. Menambahkan langganan dan menautkannya ke aplikasi harus dilakukan oleh pemilik aplikasi (jika aplikasi bukan milik organisasi), atau oleh admin organisasi.

Menambahkan Langganan Azure

  • Aplikasi milik organisasi: Jika Anda adalah admin organisasi, buka bagian Kelola di bawah organisasi tempat aplikasi berada.
  • Aplikasi milik pengguna: Jika Anda adalah pemilik aplikasi, ikuti langkah-langkah ini.
  1. Masuk ke portal App Center.
  2. Buka pengaturan pengguna.
  3. Di bawah Azure, klik Tambahkan langganan
  4. Pilih langganan Azure yang sudah ada atau buat langganan baru.

Menautkan aplikasi ke Langganan Azure

Setelah menambahkan langganan Azure ke akun pengguna atau organisasi, Anda perlu menyediakan akses kepada aplikasi sehingga langganan dapat digunakan dalam aplikasi tersebut. Dengan melakukan ini, Anda mengizinkan manajer/pengembang apa pun di aplikasi tersebut untuk menggunakan langganan untuk tujuan ekspor. Ini memiliki biaya terkait yang dikenakan terhadap Langganan Azure Anda.

Menyiapkan Ekspor

  1. Di portal App Center, pilih Aplikasi.
  2. Buka Pengaturan Aplikasi.
  3. Klik Ekspor dan pilih opsi Ekspor Baru .
  4. Pilih penyimpanan blob atau Application Insights berdasarkan kebutuhan aplikasi Anda.
  5. Pilih jenis konfigurasi yang Anda inginkan (standar vs kustom).

App Center menawarkan dua cara untuk mengekspor data Anda: ekspor standar dan ekspor kustom. Ekspor standar memungkinkan Anda mengekspor data dengan pengalaman satu klik, menggunakan langganan Azure yang ditautkan ke aplikasi. Ekspor kustom akan memberi Anda lebih banyak fleksibilitas dan konfigurasi akan disesuaikan di Azure.

Standar Ekspor

Ekspor Standar memberikan pengalaman satu klik untuk mengekspor data Anda. Dengan opsi ini, semua sumber daya yang diperlukan secara otomatis dibuat di Azure.

Ekspor Kustom

Ekspor Kustom memungkinkan pengguna menyesuaikan konfigurasi ekspor mereka di Azure.

Untuk Penyimpanan Blob

  1. Masuk ke portal Azure.
  2. Klik Buat sumber daya baru
  3. Cari akun Penyimpanan di pencarian Marketplace.
  4. Klik Buat. Ini membuka halaman Buat akun penyimpanan.
  5. Pilih Langganan Azure.
  6. Pilih grup sumber daya yang sudah ada atau buat baru. (Grup sumber daya adalah kontainer yang menyimpan sumber daya terkait untuk solusi Azure)
  7. Untuk Jenis akun, Anda akan melihat menu drop-down berikut. Ada tiga opsi yang didukung. Pilih apa yang tepat untuk Anda. Akun Blob Storage yang didukung
  8. Klik pada Tinjau + buat
  9. Setelah Validasi berhasil
  10. Klik buat
  11. Setelah penyebaran berhasil, buka sumber daya
  12. Temukan Kunci Akses di tab Pengaturan
  13. Salin string koneksi dan tambahkan ke konfigurasi kustom App Center Anda.

Menambahkan string koneksi di App Center

Untuk Application Insights

  1. Masuk ke portal Azure.
  2. Pilih Buat sumber daya> Alat Manajemen > Application Insights.
  3. Kotak konfigurasi akan muncul
  4. Atur Jenis Aplikasi ke aplikasi App Center.
  5. Salin kunci instrumentasi dari portal Microsoft Azure dan tambahkan ke konfigurasi kustom App Center Anda. Anda akan menemukan kunci instrumentasi di halaman Gambaran Umum di sumber daya Application Insights.

Menambahkan kunci instrumentasi di App Center

Untuk informasi selengkapnya tentang ekspor, lihat panduan mulai cepat Application Insights.

Mengekspor beberapa aplikasi ke akun penyimpanan yang sama

Saat mengonfigurasi ekspor untuk beberapa aplikasi, Anda harus membuat atau memperbarui konfigurasi dengan blob_path_format_kind (bagian dari model ExportBlobConfiguration) yang diatur ke WithAppId, yang mengawali jalur ekspor dengan appID masing-masing.

Jalur ke blob diformat sebagai berikut:

  • ketika enum disetel ke WithoutAppId=false menjadi year/month/day/hour/minute
  • ketika enum disetel ke WithAppId=true menjadi appId/year/month/day/hour/minute

API pembuatan konfigurasi ekspor diuraikan di atas. Untuk konfigurasi yang ada, berikut adalah API pembaruan parsial:

PATCH /v0.1/apps/{owner_name}/{app_name}/export_configurations/{export_configuration_id}

Perubahan akan butuh waktu 5-10 menit untuk tersebar, dan entitas mulai dari saat itu akan ditulis menggunakan format jalur baru.

Opsi keluar dari pengisian ulang

Secara default, konfigurasi ekspor baru akan mengisi kembali dua hari terakhir data untuk sumber daya AI dan 30 hari untuk penyimpanan blob. Ada skenario ketika pengisian kembali tidak diperlukan; misalnya, jika melakukannya akan mengakibatkan penimpaan atau duplikat data. Dalam hal ini, atur backfill properti ke false saat membuat konfigurasi baru.

Memilih jenis data apa yang akan diekspor

Secara default, konfigurasi ekspor baru hanya mengekspor data Analitik (peristiwa, sesi, dan sebagainya) Data terkait diagnostik dapat diekspor dengan mengatur Entities properti (export_entity model) ke kombinasi errors, , crashesdan attachments. Properti ini juga memungkinkan mengecualikan data Analytics agar tidak diekspor dengan menambahkan no_logs nilai ke Entities array.

Mekanisme nonaktifkan otomatis

App Center dapat secara otomatis menonaktifkan konfigurasi ekspor buruk untuk mencegah kemungkinan penundaan di seluruh alur ekspor. Misalnya, App Center menangani kegagalan di bawah ini dari Azure.

  • Kunci instrumentasi Application Insights tidak valid.
  • Sumber daya blob tidak dapat diautentikasi atau nama jarak jauh tidak dapat diselesaikan.

Nota

Jika ekspor diaktifkan kembali, aliran data akan berlanjut dari saat itu tanpa mengisi kembali untuk menghindari kemungkinan penimpaan data atau duplikasi. Jika Anda perlu mengisi kembali data yang hilang, Maka Anda perlu membuat ulang konfigurasi ekspor Anda. Data yang masuk ke Application Insights tetap 48 jam dan 30 hari untuk Blob Storage.

Anda dapat menggunakan salah satu API berikut untuk memeriksa status untuk mengambil tindakan pemulihan.

GET  /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations
GET  /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations​/{export_configuration_id}

Anda dapat menggunakan API berikut untuk mengaktifkan konfigurasi ekspor Anda

POST /v0.1​/apps​/{owner_name}​/{app_name}​/export_configurations​/{export_configuration_id}/enable

Penetapan Harga

Untuk menyiapkan Ekspor, Anda harus membuat langganan Azure. Mengekspor data memiliki biaya terkait yang akan bergantung pada layanan Azure yang Anda ekspor. Temukan detail tentang harga untuk setiap layanan di:

Harga untuk Application Insights

Harga Blob Storage

  • Last updated on