Aracılığıyla paylaş


İhracat

Önemli

Visual Studio App Center, 30 Haziran 2026'ya kadar desteklenmeye devam edecek Analiz ve Tanılama özellikleri dışında 31 Mart 2025'te kullanımdan kaldırılmıştır. Daha fazla bilgi edinin.

App Center, tüm Analytics ham verilerinizi sürekli olarak Azure'a aktarmanıza olanak tanır. Analiz verilerini hem Blob Depolama'ya hem de Application Insights'a (Azure İzleyici) aktarabilirsiniz. Verileri dışarı aktararak şu avantajlardan yararlanabilirsiniz:

  • Sınırsız veri saklama
  • Ayrıntılı Kullanım Analizi
  • Birleşik pano
  • Application Insights'ın huniler, müşteri tutma gibi zengin ek özellikleri

App Center, iki günlük yedeklenmiş verilerle birlikte dışarı aktarmayı yapılandırdığınız andan itibaren Analytics verilerini sürekli olarak Application Insights'a aktarır. Application Insights'taki yeni güncelleştirilmiş panoyla, App Center kullanıcıları tek bir panoda hem Uygulama hem de Arka Uç Analizi'nin birleşik bir görünümünü elde edebilir.

App Center, dışarı aktarmayı yapılandırdığınız andan itibaren 28 günlük yedeklenmiş verilerle birlikte Analiz verilerini sürekli olarak Blob Depolama'ya aktarır. Blob Depolama hakkında daha fazla bilgi edinin

Verileri Azure Genel Amaçlı v2 Depolama Blobu'na da dışarı aktarabilirsiniz. Genel amaçlı v2 depolama hesapları en son Azure Depolama özelliklerini destekler ve genel amaçlı v1 ve Blob depolama hesaplarının tüm işlevlerini birleştirir.

Genel Amaçlı v2 Depolama hakkında daha fazla bilgi edininApplication Insights hakkında daha fazla bilgi edinin

Azure Blob Saklama Alanı

Azure Blob Depolama, HTTP veya HTTPS aracılığıyla dünya çapında kullanılabilen metin veya ikili veriler gibi büyük miktarlarda yapılandırılmamış nesne verilerini depolamaya yönelik bir hizmettir. Blob Depolama'yı kullanarak verileri genel kullanıma açabilir veya verileri özel olarak depolayabilirsiniz.

Veriler dakikada bir dışarı aktarılır ve her seferinde yeni bir alt klasör oluşturulur. Varsayılan olarak, https://<blob-storage-account>.blob.core.windows.net/archive/2017/12/09/04/03/logs.v1.data olarak ayarlandığında, veriler blob_path_format_kind biçiminde (örneğin, WithoutAppId) depolanır. config özelliği olarak WithAppIdayarlandığında, veriler appId/year/month/day/hour/minute biçiminde depolanır ve bu da varsayılan yola appID ön ekini ekler. Verilerin Azure Blob Depolama'da gösterilmesi 5 dakika kadar sürer.

Veriler "Analiz" verileri (oturumlar, olaylar), "Kilitlenmeler", "Hatalar" ve "Ekler" olarak bölünür. Tanılama verilerini dışarı aktarma hakkında daha fazla bilgi edinin

Azure Blob Depolama'da veri görselleştirme

Blob dosyasının içeriği, Analiz verileri için şöyle görünen bir JSON istemci cihaz günlükleri dizisidir:

[
    {
        "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, App Center olay verileriniz üzerinde sorgulama, segmentasyon, filtreleme ve kullanım analizi özellikleri sunan bir uygulama performans yönetimi (APM) hizmetidir. Uygulamanıza App Center SDK'sını ekleyerek ve verileri App Center uygulama türündeki bir Application Insights kaynağına aktararak aşağıdaki özelliklere erişebilirsiniz:

  • Application Insights Analytics. Ham olay verilerinizi analiz etmek ve görselleştirmeler oluşturmak için güçlü bir sorgu dili kullanın. Sorgularınızın sonuçlarını Power BI veya Excel'e aktarabilirsiniz.
  • Kullanıcılar, Oturumlar ve Olaylar. Uygulamanızın her sayfasını ve özelliğini kaç kişinin kullandığını öğrenin, ardından nedenini anlamak için ülkeye, tarayıcıya veya diğer özelliklere göre segmentlere ayırın.
  • Huniler ve Kullanıcı akışları. Kullanıcıların uygulamanızda nasıl gezinladığını anlayın. Performans sorunlarını belirleyin. Dönüşüm oranlarını artırmanın ve ağrı noktalarını ortadan kaldırmanın yollarını keşfedin.
  • Bekletme. Uygulamanızı kullanmak için kaç kullanıcının geri döndüğünü keşfedin. Nerede eğitimden neden ayrıldıklarını öğrenin.
  • Çalışma kitapları. Ekibinizde içgörü paylaşmak için kullanım analizi görselleştirmelerini, Application Insights Analytics sorgularını ve metinleri birleştiren etkileşimli çalışma kitapları oluşturun.

App Center alanları Application Insights biçimine eşlenir. Eşlenen alanlar arasındaki denklik aşağıdadır:

Application Insights App Center
Tarih damgası Olayın saati
isim Özel olayın adı veya veri türü
Özel Boyutlar Bu, aşağıdaki tabloda gösterilen birkaç alanı içerir
session_Id Benzersiz oturum tanımlayıcısı
user_Id Yükleme tanımlayıcısı
Uygulama_Sürümü Uygulamanın sürümü
müşteri_Tipi, müşteri_Modeli Cihaz Modeli
istemci_işletim_sistemi İşletim sistemi türü ve sürümü
SDK sürümü App Center SDK sürümü

Aşağıdaki tabloda "customDimensions" alanının alan eşlemesi gösterilmektedir.

Application Insights App Center
AppBuild Uygulama yapı numarası
AppId App Center Uygulama Kimliği
AppNamespace Uygulama ad alanı
TaşıyıcıÜlke Taşıyıcı ülke
Taşıyıcı Adı Taşıyıcı türü
EventId App Center Etkinlik Kimliği
IngressTimestamp Kayıt alımı zaman damgası
Yerel Cihaz dili
Mesaj Tipi Olay türü (oturum, olay, ...)
OsApiLevel İşletim sistemi API'si düzeyi
OsBuild İşletim sistemi yapı numarası
OsName İşletim sistemi adı
OsVersion İşletim sistemi sürümü
Özellikler Özel bir olaya eklenen özellikler
Ekran Boyutu Cihazın ekran boyutu
SdkName App Center SDK adı
SDK Versiyonu App Center SDK sürümü
TimeZoneOffset Saat dilimi farkı
Kullanıcı Kimliği Özel kullanıcı tanımlayıcısı (geliştirici kümesi)
WrapperRuntimeVersion App Center SDK sarmalayıcı çalışma zamanı sürümü
WrapperSdkName App Center SDK sarmalayıcı adı
WrapperSdkVersion App Center SDK sarmalayıcı sürümü

Özel olayları almak için örnek bir yapay zeka sorgusu:

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

Application Insights ve App Center hakkında daha fazla bilgi:

Önkoşullar

Dışarı Aktarma özelliğini kullanmak için bir Azure Aboneliğiniz olmalıdır; Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun.

Azure Abonelik Bağlantısı

Uyarı

Bu adım yalnızca Standart Dışarı Aktarma için gereklidir; Özel Dışarı Aktarma için Azure aboneliği gerekmez.

App Center'ın uygulama verilerini Azure'a standart olarak dışarı aktarması için App Center uygulamasına bağlı bir Azure aboneliği gerekir. Aboneliği ekleme ve bir uygulamaya bağlama işlemi uygulama sahibi (uygulama bir kuruluşa ait değilse) veya kuruluşun yöneticisi tarafından yapılmalıdır.

Azure Aboneliği Ekleme

  • Bir kuruluşa ait uygulama: Kuruluş yöneticisiyseniz, uygulamanın ait olduğu kuruluşun altındaki Yönet bölümüne gidin.
  • Kullanıcıya ait uygulama: Uygulama sahibiyseniz aşağıdaki adımları izleyin.
  1. App Center portalında oturum açın.
  2. Kullanıcı ayarlarına gidin.
  3. Azure'ın altında Abonelik ekle'ye tıklayın
  4. Mevcut bir Azure aboneliğini seçin veya yeni bir abonelik oluşturun.

Bir uygulamayı Azure Aboneliğine bağlama

Azure aboneliğinizi kullanıcı veya kuruluş hesabına ekledikten sonra, aboneliğin bu uygulama içinde kullanılabilmesi için uygulamalara erişim sağlamanız gerekir. Bunu yaparak, bu uygulamadaki herhangi bir yöneticinin/geliştiricinin aboneliği dışarı aktarma amacıyla kullanmasına izin verirsiniz. Bu, Azure Aboneliğiniz için ücretlendirilen ilişkili bir maliyete sahiptir.

Dışarı Aktarma'yı Kur

  1. App Center portalında Uygulamayı seçin.
  2. Uygulama Ayarları'na gidin.
  3. Dışarı Aktar'a tıklayın ve Yeni Dışarı Aktar seçeneğini belirleyin.
  4. Uygulama gereksinimlerinize göre blob depolama veya Application Insights'ı seçin.
  5. İstediğiniz yapılandırma türünü seçin (standart ve özel).

App Center verilerinizi dışarı aktarmak için iki yol sunar: standart dışarı aktarma ve özel dışarı aktarma. Standart dışarı aktarma, uygulamaya bağlı Azure aboneliğini kullanarak tek tıklamayla verileri dışarı aktarmanızı sağlar. Özel dışarı aktarma size daha fazla esneklik sağlar ve yapılandırmalar Azure'da özelleştirilir.

Standart Dışarı Aktarma

Standart Dışarı Aktarma, verilerinizi dışarı aktarmak için tek tıklamayla bir deneyim sağlar. Bu seçenekle tüm gerekli kaynaklar Azure'da otomatik olarak oluşturulur.

Özel Dışarı Aktarma

Özel Dışarı Aktarma, kullanıcıların Azure'da dışarı aktarma yapılandırmasını özelleştirmesine olanak tanır.

Blob Storage için

  1. Azure portalınaoturum açın.
  2. Yeni kaynak oluştur'a tıklayın
  3. Markette Ara bölümünde Depolama hesabını arayın.
  4. Oluştur'a tıklayın. Bu, Depolama hesabı oluştur sayfasını açar.
  5. Bir Azure Aboneliği seçin.
  6. Mevcut bir kaynak grubunu seçin ya da yeni bir tane oluşturun. (Kaynak grubu, Bir Azure çözümü için ilgili kaynakları barındıran bir kapsayıcıdır)
  7. Hesap türleri için aşağıdaki açılan listeyi görürsünüz. Desteklenen üç seçenek vardır. Size uygun olanı seçin. Desteklenen Blob Depolama hesapları
  8. Gözden Geçir ve oluştur'a tıklayın
  9. Doğrulama tamamlandıktan sonra
  10. Oluştur'a tıklayın
  11. Dağıtım başarılı olduktan sonra kaynağa gidin
  12. Ayarlar sekmesinde Erişim Tuşlarını bulma
  13. Bağlantı dizesini kopyalayın ve App Center özel yapılandırmalarınıza ekleyin.

App Center'da bağlantı dizesini ekleme

Application Insights için

  1. Azure portalınaoturum açın.
  2. Kaynak oluştur> Yönetimi Araçları > Application Insights.
  3. Bir yapılandırma kutusu görüntülenir
  4. Uygulama Türü'nüApp Center uygulaması olarak ayarlayın.
  5. Azure portalından enstrümantasyon anahtarını kopyalayın ve App Center özel yapılandırmalarınıza ekleyin. Ölçümleme anahtarı Application Insights kaynağının Genel Bakış sayfasında bulunur.

App Center'da instrumentasyon anahtarını ekleme

Dışarı aktarma hakkında daha fazla bilgi için Application Insights hızlı başlangıç kılavuzuna bakın.

Birden çok uygulamayı aynı depolama hesabına aktarma

Birden çok uygulama için dışarı aktarmayı yapılandırırken, modelin blob_path_format_kind parçası olarak ayarlanmış ExportBlobConfiguration ile dışarı aktarma yolunu ilgili appID'lere ön ekleyen bir yapılandırma WithAppId oluşturmanız veya güncelleştirmeniz gerekir.

Blob yolunun biçimlendirme düzeni aşağıdaki gibidir:

  • sabit listesi WithoutAppId=false olarak ayarlandığında, year/month/day/hour/minute olur
  • sabit listesi WithAppId=true olarak ayarlandığında, appId/year/month/day/hour/minute olur

Dışarı aktarma yapılandırması oluşturma API'sinin ana hatları yukarıda verilmiştir. Mevcut yapılandırmalar için kısmi güncelleştirme API'sini aşağıda bulabilirsiniz:

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

Değişikliklerin yayılması 5-10 dakika sürer ve bu noktadan itibaren varlıklar yeni yol biçimi kullanılarak yazılır.

Geri doldurma vazgeçme

Varsayılan olarak, yeni bir dışarı aktarma yapılandırması yapay zeka kaynakları için verilerin son iki gününü ve blob depolama için 30 günü geri doldurur. Geri doldurmanın gerekli olmadığı senaryolar vardır; örneğin, bunun yapılması verilerin üzerine yazılması veya çoğaltılmasıyla sonuçlanır. Bu durumda, yeni bir yapılandırma oluştururken backfill özelliğini false olarak ayarlayın.

Dışarı aktaracak veri türünü seçme

Varsayılan olarak, yeni bir dışa aktarma yapılandırması yalnızca Analytics verilerini (olaylar, oturumlar vb.) dışa aktarır. Tanılamayla ilgili veriler, özelliği Entities modelinde export_entity, errors ve crashes birleşimine ayarlanarak attachments. Özellik, Analytics verilerinin dışarı aktarılmasını engellemek için no_logs dizisine Entities değer eklenmesini sağlar.

Otomatik devre dışı bırakma mekanizması

App Center, dışarı aktarma işlem hattının tamamında olası gecikmeleri önlemek için hatalı dışarı aktarma yapılandırmasını otomatik olarak devre dışı bırakabilir. Örneğin App Center, Azure'dan gelen aşağıdaki hataları işler.

  • Application Insights enstrümantasyon anahtarı geçersiz.
  • Blob kaynağının kimliği doğrulanamaz veya uzak ad çözümlenemez.

Uyarı

Dışarı aktarma işlemi yeniden etkinleştirildiyse veri akışı, olası verilerin geçersiz kılınmasını veya çoğaltılmasını önlemek için o andan itibaren geri doldurma olmadan devam eder. Eksik verileri geri doldurmanız gerekiyorsa dışarı aktarma yapılandırmanızı yeniden oluşturmanız gerekir. Application Insights'a giden veriler Blob Depolama için 48 saat 30 gün kalır.

Geri yükleme eylemi gerçekleştirmek için durumu denetlemek için aşağıdaki API'lerden birini kullanabilirsiniz.

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

Dışarı aktarma yapılandırmanızı etkinleştirmek için aşağıdaki API'yi kullanabilirsiniz

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

Fiyatlandırma

Dışarı Aktarma'yı ayarlamak için bir Azure aboneliği oluşturmanız gerekir. Verileri dışarı aktarmanın, dışarı aktardığınız Azure hizmetine bağlı olacak ilişkili bir maliyeti vardır. Her hizmetin fiyatlandırması hakkındaki ayrıntıları şu adreste bulabilirsiniz:

Application Insights fiyatlandırması

Blob Depolama fiyatlandırması