Dışarı Aktarma

Önemli

Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.

Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.

App Center, tüm Analytics ham verilerinizi sürekli olarak Azure'a aktarmanızı sağlar. 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, bekletme gibi ek zengin ö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 Application hem de Backend Analytics'in 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 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 bilgiedinin Application Insights hakkında daha fazla bilgi edinin

Azure Blob Depolama

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 blob_path_format_kind olarak ayarlandığında WithoutAppIdveriler yıl/ay/gün/saat/dakika biçiminde (örneğin, https://<blob-storage-account>.blob.core.windows.net/archive/2017/12/09/04/03/logs.v1.data) depolanır. config özelliği olarak ayarlandığındaWithAppId, 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 gösterilmesi 5 dakika kadar sürer.

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

Azure Blob Depolama'de veri görselleştirme

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

[
    {
        "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, App Center olay verileriniz üzerinde sorgulama, segmentlere ayırma, 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 Analizi. 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ı anlama. 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. Nereye ve neden bıraktı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çiminde eşlenir. Eşlenen alanlar arasındaki denklik aşağıdadır:

Application Insights App Center
timestamp Olayın saati
name Özel olayın adı veya veri türü
customDimensions 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ı
application_Version Uygulamanın sürümü
client_Type, client_Model Cihaz Modeli
client_OS İşletim sistemi türü ve sürümü
sdkVersion 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 derleme numarası
AppId App Center Uygulama Kimliği
AppNamespace Uygulama ad alanı
CarrierCountry Taşıyıcı ülke
CarrierName Taşıyıcı türü
EventId App Center Olay Kimliği
IngressTimestamp Günlük alımı zaman damgası
Yerel Ayar Cihaz dili
MessageType Olay türü (oturum, olay, ...)
OsApiLevel İşletim sistemi API'si düzeyi
OsBuild İşletim sistemi derleme 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ı
SdkVersion App Center SDK sürümü
TimeZoneOffset Saat dilimi uzaklığı
UserId Ö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ğinizin olması gerekir; Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun.

Azure Aboneliği Bağlama

Not

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, bu uygulamanın 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ğinize göre ücretlendirilen ilişkili bir maliyete sahiptir.

Dışarı Aktarmayı Ayarlama

  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ı Aktarma 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, gerekli tüm 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 Depolama için

  1. Azure Portal’ında oturum 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 işlem Depolama hesabı oluştur sayfasını açar.
  5. Bir Azure Aboneliği seçin.
  6. Mevcut bir kaynak grubunu seçin veya yeni bir kaynak grubu oluşturun. (Kaynak grubu, Bir Azure çözümü için ilgili kaynakları tutan 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 başarılı olduktan 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 Anahtarları'nı bulma
  13. bağlantı dizesi kopyalayın ve App Center özel yapılandırmalarınıza ekleyin.

App Center'da bağlantı dizesi ekleme

Application Insights için

  1. Azure Portal’ında oturum açın.
  2. Kaynak > Yönetim Araçları > Application Insights oluştur'u seçin.
  3. Bir yapılandırma kutusu görüntülenir
  4. Uygulama Türü'nüApp Center uygulaması olarak ayarlayın.
  5. Azure portal izleme anahtarını kopyalayın ve App Center özel yapılandırmalarınıza ekleyin. İzleme anahtarını Application Insights kaynağının Genel Bakış sayfasında bulabilirsiniz.

App Center'da izleme 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, dışarı aktarma yolunun önüne ilgili appID'nin ön ekini ekleyen (modelin ExportBlobConfiguration parçası) olarak ayarlanmış WithAppIdbir yapılandırma blob_path_format_kind oluşturmanız veya güncelleştirmeniz gerekir.

Blob yolu aşağıdaki gibi biçimlendirilir:

  • sabit listesi olarak ayarlandığında WithoutAppId=falseyear/month/day/hour/minute
  • sabit listesi olarak ayarlandığında WithAppId=trueappId/year/month/day/hour/minute

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 geri çevirme

Varsayılan olarak, yeni bir dışarı aktarma yapılandırması yapay zeka kaynakları için son iki günlük verileri ve blob depolama için 30 günü geriye doğru 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 özelliğini olarak false ayarlayınbackfill.

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

Varsayılan olarak, yeni bir dışarı aktarma yapılandırması yalnızca Analytics verilerini (olaylar, oturumlar vb.) dışarı aktarır. Tanılamayla ilgili veriler, özelliği (export_entity model) , crashesve attachmentsbirleşimine errorsayarlanarak Entitiesdışarı aktarılabilir. özelliği, diziye değer ekleyerek no_logs Analytics verilerinin dışarı aktarılmasını dışlamanıza Entities da olanak tanır.

Otomatik devre dışı bırakma mekanizması

App Center, dışarı aktarma işlem hattının tamamında olası gecikmeyi ö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 izleme anahtarı geçersiz.
  • Blob kaynağının kimliği doğrulanamaz veya uzak ad çözümlenemez.

Not

Dışarı aktarma işlemi yeniden etkinleştirildiyse, olası verileri geçersiz kılma veya yinelemeyi önlemek için veri akışı 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 üzere 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ı