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

Bu makalede, Microsoft Azure SDK'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şi sağlanır.

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

Azure SDK sürümü	Tanılama uzantısı sürümü	Modelleme
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; başka bir deyişle Azure SDK'yı yüklediğinizde azure tanılama sürümünü de bu modelle birlikte gönderilmiştir.

SDK 2.5 'den (tanılama sürümü 1.2) başlayarak Azure tanılaması bir uzantı modeline geçti. 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 en son gönderim sürümünü doğrudan Azure'dan alır. Ö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.

Şemalar dizini

Farklı Azure tanılama 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 Azure İzleyici'ye özel ölçümler olarak 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üzde "Örnek" boyutu olarak kabul etme. Örneğin ,"LogicalDisk(*)/DiskWrites/sec" sayacını topladığınızda, her Mantıksal Disk için Disk Yazma/sn'de (C:, D:, vb.) çizim yapmak veya uyarı vermek için "Örnek" boyutuna filtreleyip bölebilirsiniz.

Tanılama uzantısı yapılandırmanızda Azure İzleyici'nin yeni bir 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 Tablo, Blob, TableAndBlob olabilir. Tablo varsayılan değerdir.

{
    "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 öğesini ve application insights'a tanılama verileri gönderebilme özelliğini ekleyerek hem uygulamanızdaki sorunları hem de sistem ve altyapı düzeyini tanılamayı kolaylaştırın.

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

Visual Studio'daki Bulut Hizmeti 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ı dizesi UseDevelopmentStorage=true , Azure Depolama Öykünücüsü'ni kullanarak Visual Studio'da bulut hizmeti projenizi çalıştırırken tanılama verisi 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), hizmet yapılandırması (.cscfg) dosyasında bir kez daha depolanır. Azure SDK 2.5'te tanılama depolama hesabı diagnostics.wadcfgx dosyasında belirtildi.

Bağlantı dizesinin 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ümlerinde 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ı dizesini kullanır. Bağlantı dizesi, Visual Studio'nın yayımlarken kullanacağı farklı hizmet yapılandırmaları için farklı depolama hesapları tanımlamanızı sağlar. 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ı dizesini kullanır. Genel yapılandırma dosyaları Uzantılar klasöründe oluşturulur ve desenini PaaSDiagnostics.<RoleName>.PubConfig.xmlizler. Herhangi bir PowerShell tabanlı dağıtım, 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, böylece İzleme sekmesinde görünür. Portalda ayrıntılı izleme verilerini göstermek üzere hizmeti 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ı dizesini projenize el ile eklemeniz gerekir. Bir projeyi Azure SDK 2.4 veya önceki bir sürümden Azure SDK 2.6'ya geçiriyorsanız, tanılama bağlantı dizeleri korunur. Ancak, önceki bölümde belirtildiği gibi bağlantı dizelerinin Azure SDK 2.6'da nasıl ele alındıklarına ilişkin değişiklikleri not edin.

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

• .cscfg dosyasında bir tanılama bağlantı dizesi belirtilirse, Visual Studio yayımlarken 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 hiçbir 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.

"Geliştirme depolama bağlantı dizelerini güncelleştir..." onay kutusu yapar mı?

Microsoft Azure'da yayımlarken Tanılama ve Microsoft Azure depolama hesabı kimlik bilgileriyle önbelleğe alma için geliştirme depolama bağlantı dizelerini güncelleştir onay kutusu, geliştirme depolama hesabı bağlantı dizelerini yayımlama sırasında belirtilen Azure depolama hesabıyla güncelleştirmenin kolay bir yolunu sağlar.

Örneğin, bu onay kutusunu seçtiğinizi ve tanılama bağlantı dizesinin öğesini belirttiğini UseDevelopmentStorage=truevarsayalım. Projeyi Azure'da yayımladığınızda, Visual Studio tanılama bağlantı dizesini Yayımla sihirbazında belirttiğiniz depolama hesabıyla otomatik olarak güncelleştirir. Ancak, tanılama bağlantı dizesi olarak 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şlevi 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ı aklınızda bulundurmalısınız.

• Yapılandırma API'leri kullanım dışı bırakıldı – Tanılamanı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ımlanmışsa, 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'dir.
• 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 bilgi 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.