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, 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 WithoutAppId
veriler 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
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": "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"
}
]
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:
- Application Insights hakkında genel bilgi edinin
- AI'da App Center ile Tümleştirme blogu hakkında bilgi edinin
- App Center'da Daha İyi Analiz ile Daha İyi Kararlar hakkında bilgi edinin blogu
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.
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.
- 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.
- App Center portalında oturum açın.
- Kullanıcı ayarlarına gidin.
- Azure'ın altında Abonelik ekle'ye tıklayın
- Mevcut bir Azure aboneliğini seçin veya yeni bir abonelik oluşturun.
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.
- App Center portalında Uygulamayı seçin.
- Uygulama Ayarları'na gidin.
- Dışarı Aktar'a tıklayın ve Yeni Dışarı Aktarma seçeneğini belirleyin.
- Uygulama gereksinimlerinize göre blob depolama veya Application Insights'ı seçin.
- İ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, 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, kullanıcıların Azure'da dışarı aktarma yapılandırmasını özelleştirmesine olanak tanır.
Blob Depolama için
- Azure Portal’ında oturum açın.
- Yeni kaynak oluştur'a tıklayın
- Markette Ara bölümünde Depolama hesabını arayın.
- Oluştur'a tıklayın. Bu işlem Depolama hesabı oluştur sayfasını açar.
- Bir Azure Aboneliği seçin.
- 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)
- 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.
- Gözden geçir ve oluştur'a tıklayın
- Doğrulama başarılı olduktan sonra
- Oluştur'a tıklayın
- Dağıtım başarılı olduktan sonra kaynağa gidin
- Ayarlar sekmesinde Erişim Anahtarları'nı bulma
- bağlantı dizesi kopyalayın ve App Center özel yapılandırmalarınıza ekleyin.
Application Insights için
- Azure Portal’ında oturum açın.
- Kaynak > Yönetim Araçları > Application Insights oluştur'u seçin.
- Bir yapılandırma kutusu görüntülenir
- Uygulama Türü'nüApp Center uygulaması olarak ayarlayın.
- 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.
Dışarı aktarma hakkında daha fazla bilgi için Application Insights hızlı başlangıç kılavuzuna bakın.
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ış WithAppId
bir 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=false
year/month/day/hour/minute
- sabit listesi olarak ayarlandığında
WithAppId=true
appId/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.
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
.
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) , crashes
ve attachments
birleşimine errors
ayarlanarak Entities
dış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.
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
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: