Aracılığıyla paylaş

Windows Azure Tanılama (WAD) uzantısı yapılandırma şeması sürümleri ve geçmişi

  • Makale

Bu makale, Microsoft Azure SDK'sının bir parçası olarak gönderilen Windows (WAD) şema sürümleri için Azure Tanılama uzantısının sürüm geçmişini sağlar.

Azure SDK ve tanılama sürümleri gönderim grafiği

Azure SDK sürümü Tanılama uzantısı sürümü Model
1.x 1.0 eklenti
2.0 - 2.4 1.0 eklenti
2.5 1.2 uzantı
2,6 1.3 "
2.7 1.4 "
2.8 1.5 "
2.9 1.6 "
2.96 1.7 "
2.96 1.8 "
2.96 1.8.1 "
2.96 1.9 "
2.96 1.11 "
2.96 1.21 "

Azure Tanılama sürüm 1.0 ilk olarak bir eklenti modeliyle birlikte gönderilir; yani Azure SDK'yı yüklediğinizde azure tanılama sürümünü de onunla birlikte gönderebilirsiniz.

SDK 2.5 'den (tanılama sürümü 1.2) başlayarak Azure tanılaması bir uzantı modeline gitti. Yeni özellikleri kullanmaya yönelik araçlar yalnızca daha yeni Azure SDK'larında kullanılabilirdi, ancak Azure tanılamasını kullanan tüm hizmetler doğrudan Azure'dan en son gönderim sürümünü alabilir. Örneğin, sdk 2.5 kullanmaya devam eden herkes, yeni özellikleri kullanıp kullanmadıklarına bakılmaksızın önceki tabloda gösterilen en son sürümü yükler.

Şema dizini

Azure tanılamalarının farklı sürümleri farklı yapılandırma şemaları kullanır. Şema 1.0 ve 1.2 kullanım dışı bırakıldı. Sürüm 1.3 ve üzeri hakkında daha fazla bilgi için bkz . Tanılama 1.3 ve üzeri Yapılandırma Şeması

Sürüm geçmişi

Tanılama uzantısı 1.11

Azure İzleyici havuzu için destek eklendi. Bu havuz yalnızca performans sayaçları için geçerlidir. VM, VMSS veya bulut hizmetinizde toplanan performans sayaçlarının özel ölçümler olarak Azure İzleyici'ye gönderilmesini sağlar. Azure İzleyici havuzu aşağıdakileri destekler:

  • Azure İzleyici ölçüm API'leri aracılığıyla Azure İzleyici'ye gönderilen tüm performans sayaçlarını alma.
  • Azure İzleyici'deki yeni birleşik uyarılar deneyimi aracılığıyla Azure İzleyici'ye gönderilen tüm performans sayaçlarında uyarı verme
  • Performans sayaçlarındaki joker karakter işlecini ölçümünüzdeki "Örnek" boyutu olarak kabul etme. Örneğin, "LogicalDisk(*)/DiskWrites/sn" sayacını topladığınızda, her Mantıksal Disk için Disk Yazma/sn üzerinde çizim yapmak veya uyarmak için "Örnek" boyutuna filtreleyip bölebilirsiniz (C:, D:, vb.)

Tanılama uzantısı yapılandırmanızda Azure İzleyici'nin yeni havuz olarak tanımlanması

"SinksConfig": {
    "Sink": [
        {
            "name": "AzureMonitorSink",
            "AzureMonitor": {}
        },
    ]
}

<SinksConfig>  
  <Sink name="AzureMonitorSink">
      <AzureMonitor/>
  </Sink>
</SinksConfig>

Not

Klasik VM'ler ve Klasik CLoud Hizmeti için Azure İzleyici havuzu yapılandırmak için Tanılama uzantısının özel yapılandırmasında daha fazla parametre tanımlanması gerekir.

Daha fazla ayrıntı için lütfen ayrıntılı tanılama uzantısı şeması belgelerine başvurun .

Ardından performans sayaçlarınızı Azure İzleyici Havuzu'na yönlendirilecek şekilde yapılandırabilirsiniz.

"PerformanceCounters": {
    "scheduledTransferPeriod": "PT1M",
    "sinks": "AzureMonitorSink",
    "PerformanceCounterConfiguration": [
        {
            "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
            "sampleRate": "PT1M",
            "unit": "percent"
        }
    ]
},

<PerformanceCounters scheduledTransferPeriod="PT1M", sinks="AzureMonitorSink">  
  <PerformanceCounterConfiguration counterSpecifier="\Processor(_Total)\% Processor Time" sampleRate="PT1M" unit="percent" />  
</PerformanceCounters>

Tanılama uzantısı 1.9

Docker desteği eklendi.

Tanılama uzantısı 1.8.1

Özel yapılandırmada depolama hesabı anahtarı yerine SAS belirteci belirtebilir. SAS belirteci sağlanırsa, depolama hesabı anahtarı yoksayılır.

{
    "storageAccountName": "diagstorageaccount",
    "storageAccountEndPoint": "https://core.windows.net",
    "storageAccountSasToken": "{sas token}",
    "SecondaryStorageAccounts": {
        "StorageAccount": [
            {
                "name": "secondarydiagstorageaccount",
                "endpoint": "https://core.windows.net",
                "sasToken": "{sas token}"
            }
        ]
    }
}

<PrivateConfig>
    <StorageAccount name="diagstorageaccount" endpoint="https://core.windows.net" sasToken="{sas token}" />
    <SecondaryStorageAccounts>
        <StorageAccount name="secondarydiagstorageaccount" endpoint="https://core.windows.net" sasToken="{sas token}" />
    </SecondaryStorageAccounts>
</PrivateConfig>

Tanılama uzantısı 1.8

PublicConfig'e Depolama Türü eklendi. StorageType Table, Blob, TableAndBlob olabilir. Tablo varsayılandır.

{
    "WadCfg": {
    },
    "StorageAccount": "diagstorageaccount",
    "StorageType": "TableAndBlob"
}

<PublicConfig>
    <WadCfg />
    <StorageAccount>diagstorageaccount</StorageAccount>
    <StorageType>TableAndBlob</StorageType>
</PublicConfig>

Tanılama uzantısı 1.7

EventHub'a yönlendirme özelliği eklendi.

Tanılama uzantısı 1.5

Havuzlar öğesinin yanı sıra Application Insights'a tanılama verileri gönderebilme özelliği eklendi ve böylece uygulamanızdaki sorunları tanılamanın yanı sıra sistem ve altyapı düzeyi daha kolay hale getirildi.

Azure SDK 2.6 ve tanılama uzantısı 1.3

Visual Studio'daki Cloud Service projeleri için aşağıdaki değişiklikler yapıldı. (Bu değişiklikler Azure SDK'nın sonraki sürümleri için de geçerlidir.)

  • Yerel öykünücü artık tanılamayı destekliyor. Bu değişiklik, Tanılama verilerini toplayabileceğiniz ve Visual Studio'da geliştirme ve test yaparken uygulamanızın doğru izlemeleri oluşturduğundan emin olabileceğiniz anlamına gelir. bağlantı dizesiUseDevelopmentStorage=true, Azure Depolama Öykünücüsü'ni kullanarak Visual Studio'da bulut hizmeti projenizi çalıştırırken tanılama veri toplamayı etkinleştirir. Tüm tanılama verileri (Geliştirme Depolama) depolama hesabında toplanır.
  • Tanılama depolama hesabı bağlantı dizesi (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) bir kez daha hizmet yapılandırması (.cscfg) dosyasında depolanır. Azure SDK 2.5'te tanılama depolama hesabı diagnostics.wadcfgx dosyasında belirtildi.

bağlantı dizesi Azure SDK 2.4 ve önceki sürümlerinde nasıl çalıştığı ile Azure SDK 2.6 ve sonraki sürümlerde çalışma şekli arasında bazı önemli farklar vardır.

  • Azure SDK 2.4 ve önceki sürümlerde bağlantı dizesi, tanılama günlüklerini aktarmak için depolama hesabı bilgilerini almak üzere tanılama eklentisi tarafından çalışma zamanında kullanılmıştır.
  • Azure SDK 2.6 ve sonraki sürümlerde Visual Studio, yayımlama sırasında tanılama uzantısını uygun depolama hesabı bilgileriyle yapılandırmak için tanılama bağlantı dizesi kullanır. bağlantı dizesi, Visual Studio'nın yayımlarken kullanacağı farklı hizmet yapılandırmaları için farklı depolama hesapları tanımlamanıza olanak tanır. Ancak, tanılama eklentisi artık kullanılamadığından (Azure SDK 2.5'in ardından), .cscfg dosyası tek başına Tanılama Uzantısını etkinleştiremez. Uzantıyı Visual Studio veya PowerShell gibi araçlar aracılığıyla ayrı olarak etkinleştirmeniz gerekir.
  • Tanılama uzantısını PowerShell ile yapılandırma işlemini basitleştirmek için Visual Studio'dan alınan paket çıkışı, her rolün tanılama uzantısı için genel yapılandırma XML'sini de içerir. Visual Studio, genel yapılandırmada bulunan depolama hesabı bilgilerini doldurmak için tanılama bağlantı dizesi kullanır. Genel yapılandırma dosyaları Uzantılar klasöründe oluşturulur ve desenini PaaSDiagnostics.<RoleName>.PubConfig.xmlizler. Tüm PowerShell tabanlı dağıtımlar, her yapılandırmayı bir Role eşlemek için bu düzeni kullanabilir.
  • .cscfg dosyasındaki bağlantı dizesi, Azure portalı tarafından tanılama verilerine erişmek için de kullanılır ve bu sayede İzleme sekmesinde görünür. hizmeti portalda ayrıntılı izleme verilerini gösterecek şekilde yapılandırmak için bağlantı dizesi gereklidir.

Projeleri Azure SDK 2.6 ve sonraki sürümlere geçirme

Azure SDK 2.5'ten Azure SDK 2.6 veya sonraki bir sürümüne geçiş yaparken. .wadcfgx dosyasında belirtilen bir tanılama depolama hesabınız varsa orada kalır. Farklı depolama yapılandırmalarında farklı depolama hesaplarını kullanma esnekliğinden yararlanmak için bağlantı dizesi projenize el ile eklemeniz gerekir. Bir projeyi Azure SDK 2.4 veya önceki sürümlerinden Azure SDK 2.6'ya geçiriyorsanız tanılama bağlantı dizesi korunur. Ancak, önceki bölümde belirtildiği gibi Azure SDK 2.6'da bağlantı dizesi'ların nasıl ele alındıklarına ilişkin değişikliklere dikkat edin.

Visual Studio tanılama depolama hesabını nasıl belirler?

  • .cscfg dosyasında bir tanılama bağlantı dizesi belirtilirse, Visual Studio yayımlama sırasında ve paketleme sırasında genel yapılandırma xml dosyalarını oluştururken tanılama uzantısını yapılandırmak için bunu kullanır.
  • .cscfg dosyasında tanılama bağlantı dizesi belirtilmezse, Visual Studio yayımlama sırasında tanılama uzantısını yapılandırmak ve paketleme sırasında genel yapılandırma xml dosyalarını oluşturmak için .wadcfgx dosyasında belirtilen depolama hesabını kullanmaya geri döner.
  • .cscfg dosyasındaki tanılama bağlantı dizesi, .wadcfgx dosyasındaki depolama hesabından önceliklidir. .cscfg dosyasında bir tanılama bağlantı dizesi belirtilirse, Visual Studio bunu kullanır ve .wadcfgx içindeki depolama hesabını yoksayar.

"Güncelleştirme geliştirme depolama alanı bağlantı dizesi..." onay kutusu var mı?

Microsoft Azure'da yayımlarken Tanılama için güncelleştirme geliştirme depolama bağlantı dizesi ve Microsoft Azure depolama hesabı kimlik bilgileriyle önbelleğe alma onay kutusu, bağlantı dizesi geliştirme depolama hesaplarını yayımlama sırasında belirtilen Azure depolama hesabıyla güncelleştirmenin kullanışlı bir yolunu sunar.

Örneğin, bu onay kutusunu seçtiğinizi ve tanılama bağlantı dizesi öğesini belirttiğini UseDevelopmentStorage=truevarsayalım. Projeyi Azure'da yayımladığınızda Visual Studio, tanılama bağlantı dizesi Yayımlama sihirbazında belirttiğiniz depolama hesabıyla otomatik olarak güncelleştirir. Ancak tanılama bağlantı dizesi gerçek bir depolama hesabı belirtildiyse, bunun yerine bu hesap kullanılır.

Azure SDK 2.4 ve öncesi ile Azure SDK 2.5 ve üzeri arasındaki tanılama işlevselliği farklılıkları

Projenizi Azure SDK 2.4'ten Azure SDK 2.5 veya sonraki bir sürüme yükseltiyorsanız aşağıdaki tanılama işlev farklılıklarını göz önünde bulundurmanız gerekir.

  • Yapılandırma API'leri kullanım dışı bırakıldı – Tanılamaların programlı yapılandırması Azure SDK 2.4 veya önceki sürümlerde kullanılabilir, ancak Azure SDK 2.5 ve sonraki sürümlerde kullanım dışıdır. Tanılama yapılandırmanız şu anda kodda tanımlanıyorsa, tanılamanın çalışmaya devam edebilmesi için bu ayarları geçirilen projede sıfırdan yeniden yapılandırmanız gerekir. Azure SDK 2.4 için tanılama yapılandırma dosyası diagnostics.wadcfg ve Azure SDK 2.5 ve üzeri için diagnostics.wadcfgx'tir.
  • Bulut hizmeti uygulamaları için tanılamalar yalnızca rol düzeyinde yapılandırılabilir, örnek düzeyinde yapılandırılamaz.
  • Uygulamanızı her dağıttığınızda tanılama yapılandırması güncelleştirilir . Bu, tanılama yapılandırmanızı Sunucu Gezgini'nden değiştirip uygulamanızı yeniden dağıtırsanız eşlik sorunlarına neden olabilir.
  • Azure SDK 2.5 ve sonraki sürümlerde kilitlenme dökümleri kodda değil tanılama yapılandırma dosyasında yapılandırılır– Kodda yapılandırılmış kilitlenme dökümleriniz varsa, kilitlenme dökümleri Azure SDK 2.6'ya geçiş sırasında aktarılmadığından yapılandırmayı koddan yapılandırma dosyasına el ile aktarmanız gerekir.