Ekspor

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

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

• Retensi data tidak terbatas
• Analisis Penggunaan Terperinci
• Dasbor terpadu
• Fitur kaya tambahan dari Application Insights seperti corong, 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 Tujuan umum blob.

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, 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 saat. 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 diatur ke WithAppId, data disimpan dalam format appId/year/month/day/hour/minute, yang mengawali jalur default dengan appID. Data akan memakan waktu hingga 5 menit untuk ditampilkan dalam Azure Blob Storage.

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

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

[
    {
        "AppId": "046d56b8-ea26-4653-97ba-12b8f99c3ef5",
        "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": "83a2daa9-e5b4-4082-ba4a-ce34b95ab859",
        "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:

• Analitik Application Insights. Gunakan bahasa kueri yang canggih 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 lain untuk memahami alasannya.
• Corong dan Alur pengguna. Pahami cara pengguna menavigasi melalui aplikasi Anda. Mengidentifikasi penyempitan. 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 keluar.
• 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	Pusat Aplikasi
rentang waktu	Waktu peristiwa
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
client_Type, client_Model	Model perangkat
client_OS	Jenis dan versi OS
sdkVersion	Versi App Center SDK

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

Application Insights	Pusat Aplikasi
AppBuild	Nomor build aplikasi
AppId	App Center App ID
AppNamespace	Namespace layanan aplikasi
CarrierCountry	Negara operator
CarrierName	Jenis operator
EventId	ID Peristiwa App Center
IngressTimestamp	Tanda waktu penyerapan log
Lokal	Bahasa perangkat
MessageType	Jenis peristiwa (sesi, peristiwa, ...)
OsApiLevel	Tingkat OS API
OsBuild	Nomor build OS
OsName	Nama OS
OsVersion	Versi OS
Properti	Properti yang dilampirkan ke peristiwa kustom
UkuranLayar	Ukuran layar perangkat
SdkName	Nama SDK App Center
SdkVersion	Versi App Center SDK
TimeZoneOffset	Offset zona waktu
UserId	Pengidentifikasi pengguna kustom (set pengembang)
WrapperRuntimeVersion	Versi runtime pembungkus App Center SDK
WrapperSdkName	Nama pembungkus SDK App Center
WrapperSdkVersion	Versi pembungkus SDK App Center

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:

• Pelajari tentang Application Insights secara umum
• Pelajari tentang Integrasi dengan App Center di blog AI
• Pelajari tentang Keputusan yang Lebih Baik Melalui Analitik yang Lebih Baik di blog 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

Catatan

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 berikut.

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 organisasi pengguna, 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 dibebankan 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.

Ekspor Standar

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 untuk menyesuaikan konfigurasi ekspor mereka di Azure.

Untuk Blob Storage

1. Masuk ke portal Microsoft Azure.
2. Klik Buat sumber daya baru
3. Cari akun Penyimpanan di Cari 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.
8. Klik Tinjau + buat
9. Setelah Validasi berlalu
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.

Untuk Application Insights

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

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 ExportBlobConfiguration dari model) yang diatur ke WithAppId, yang mengawali jalur ekspor dengan appID masing-masing.

Jalur ke blob diformat sebagai berikut:

• ketika enum diatur ke WithoutAppId=false adalah year/month/day/hour/minute
• ketika enum diatur ke WithAppId=true adalah 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 memakan waktu 5-10 menit untuk disebarluaskan, dan entitas dari titik itu kemudian akan ditulis menggunakan format jalur baru.

Penolakan pengisian kembali

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 Analytics (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 tidak termasuk data Analytics agar tidak diekspor dengan menambahkan no_logs nilai ke Entities array.

Mekanisme nonaktifkan otomatis

App Center dapat secara otomatis menonaktifkan konfigurasi ekspor yang 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.

Catatan

Jika ekspor diaktifkan kembali, aliran data akan berlanjut dari saat itu tanpa pengisian kembali untuk menghindari kemungkinan penimpaan atau duplikasi data. 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

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 Application Insights

Harga Blob Storage