Bagikan melalui

Versi dan riwayat skema konfigurasi ekstensi Windows Azure Diagnostics (WAD)

Artikel ini menyediakan riwayat versi ekstensi Azure Diagnostics untuk versi skema Windows (WAD) yang dikirim sebagai bagian dari Microsoft Azure SDK.

Bagan pengiriman Azure SDK dan versi diagnostik

Versi Azure SDK Versi ekstensi diagnostik Modél
1.x 1.0 plug-in
2.0 - 2.4 1.0 plug-in
2,5 1.2 ekstensi
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 Diagnostics versi 1.0 pertama kali dikirim dalam model plug-in -- yang berarti bahwa ketika Anda memasang Azure SDK, Anda mendapatkan versi diagnostik Azure yang dikirim dengannya.

Dimulai dengan SDK 2.5 (diagnostik versi 1.2), diagnostik Azure masuk ke model ekstensi. Alat untuk menggunakan fitur baru hanya tersedia di Azure SDK yang lebih baru, tetapi layanan apa pun yang menggunakan diagnostik Azure akan mengambil versi pengiriman terbaru langsung dari Azure. Misalnya, siapa pun yang masih menggunakan SDK 2.5 akan memuat versi terbaru yang ditampilkan di tabel sebelumnya, terlepas dari apakah mereka menggunakan fitur yang lebih baru.

Indeks skema

Versi diagnostik Azure yang berbeda menggunakan skema konfigurasi yang berbeda. Skema 1.0 dan 1.2 telah ditolak. Untuk informasi selengkapnya tentang versi 1.3 dan yang lebih baru, lihat Skema Konfigurasi Diagnostik 1.3 dan yang lebih baru

Riwayat versi

Ekstensi diagnostik 1.11

Menambahkan dukungan untuk sink Azure Monitor. Sink ini hanya berlaku untuk penghitung kinerja. Memungkinkan pengiriman penghitung kinerja yang dikumpulkan pada VM, VMSS, atau layanan cloud Anda ke Azure Monitor sebagai metrik kustom. Sink Azure Monitor mendukung:

  • Mengambil semua penghitung kinerja yang dikirim ke Azure Monitor melalui API metrik Azure Monitor.
  • Memperingatkan semua penghitung kinerja yang dikirim ke Azure Monitor melalui pengalaman peringatan terpadu baru di Azure Monitor
  • Memperlakukan operator kartubebas di penghitung kinerja sebagai dimensi "Instans" pada metrik Anda. Misalnya jika Anda mengumpulkan penghitung "LogicalDisk(*)/DiskWrites/sec" Anda akan dapat memfilter dan memisahkan dimensi "Instans" untuk memplot atau memperingatkan pada Disk Writes/detik untuk setiap Disk Logis (C:, D:, dll.)

Menetapkan Azure Monitor sebagai sink baru dalam konfigurasi ekstensi diagnostik Anda

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

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

Catatan

Mengonfigurasi sink Azure Monitor untuk VM Klasik dan Layanan CLoud Klasik memerlukan lebih banyak parameter untuk didefinisikan dalam konfigurasi pribadi ekstensi Diagnostik.

Untuk detail lebih lanjut, silakan merujuk pada dokumentasi skema ekstensi diagnostik terperinci.

Selanjutnya, Anda dapat mengonfigurasi penghitung kinerja untuk dirutekan ke Azure Monitor Sink.

"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>

Ekstensi diagnostik 1.9

Menambahkan dukungan Docker.

Ekstensi diagnostik 1.8.1

Dapat menentukan token SAS alih-alih kunci akun penyimpanan di konfigurasi privat. Jika token SAS disediakan, kunci akun penyimpanan diabaikan.

{
    "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>

Ekstensi diagnostik 1.8

Jenis Penyimpanan Ditambahkan ke PublicConfig. StorageType dapat berupa tabel,Blob, TableAndBlob. Tabel adalah default.

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

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

Ekstensi diagnostik 1.7

Menambahkan kemampuan untuk merutekan ke EventHub.

Ekstensi diagnostik 1.5

Menambahkan elemen sink dan kemampuan untuk mengirim data diagnostik ke Application Insights sehingga lebih mudah untuk mendiagnosis masalah di seluruh aplikasi Anda serta tingkat sistem dan infrastruktur.

Azure SDK 2.6 dan ekstensi diagnostik 1.3

Untuk proyek Cloud Service di Visual Studio, perubahan berikut dilakukan. (Perubahan ini juga berlaku untuk versi Azure SDK yang lebih baru.)

  • Emulator lokal sekarang mendukung diagnostik. Perubahan ini berarti Anda dapat mengumpulkan data diagnostik dan memastikan aplikasi Anda membuat jejak yang tepat saat Anda mengembangkan dan menguji di Visual Studio. String koneksi UseDevelopmentStorage=true memungkinkan pengumpulan data diagnostik saat Anda menjalankan proyek layanan cloud di Visual Studio dengan menggunakan Azure Storage Emulator. Semua data diagnostik dikumpulkan di akun penyimpanan (Penyimpanan Pengembangan).
  • String koneksi akun penyimpanan diagnostik (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) disimpan sekali lagi dalam file konfigurasi layanan (.cscfg). Di Azure SDK 2.5, akun penyimpanan diagnostik ditentukan dalam file diagnostics.wadcfgx.

Ada beberapa perbedaan penting antara cara kerja string koneksi di Azure SDK 2.4 dan yang lebih lama dan cara kerjanya di Azure SDK 2.6 dan yang lebih baru.

  • Di Azure SDK 2.4 dan yang lebih lama, string koneksi digunakan saat runtime bahasa umum oleh plugin diagnostik untuk mendapatkan informasi akun penyimpanan untuk mentransfer log diagnostik.
  • Di Azure SDK 2.6 dan yang lebih baru, Visual Studio menggunakan string koneksi diagnostik untuk mengonfigurasi ekstensi diagnostik dengan informasi akun penyimpanan yang sesuai selama penerbitan. String koneksi memungkinkan Anda menentukan akun penyimpanan yang berbeda untuk konfigurasi layanan berbeda yang akan digunakan Visual Studio saat memublikasikan. Namun, karena plugin diagnostik tidak lagi tersedia (setelah Azure SDK 2.5), file .cscfg dengan sendirinya tidak dapat mengaktifkan Ekstensi Diagnostik. Anda harus mengaktifkan ekstensi secara terpisah melalui alat seperti Visual Studio atau PowerShell.
  • Untuk menyederhanakan proses konfigurasi ekstensi diagnostik dengan PowerShell, output paket dari Visual Studio juga berisi XML konfigurasi publik untuk ekstensi diagnostik untuk setiap peran. Visual Studio menggunakan string koneksi diagnostik untuk mengisi informasi akun penyimpanan yang ada di konfigurasi publik. File konfigurasi publik dibuat di folder Ekstensi dan mengikuti pola PaaSDiagnostics.<RoleName>.PubConfig.xml. Setiap penyebaran berbasis PowerShell dapat menggunakan pola ini untuk memetakan setiap konfigurasi ke Peran.
  • String koneksi dalam file .cscfg juga digunakan oleh portal Microsoft Azure untuk mengakses data diagnostik sehingga dapat muncul di tab Pemantauan. String koneksi diperlukan untuk mengonfigurasi layanan untuk menampilkan data pemantauan verbose di portal.

Memigrasikan proyek ke Azure SDK 2.6 dan yang lebih baru

Saat melakukan migrasi dari Azure SDK 2.5 ke Azure SDK 2.6 atau yang lebih baru, jika Anda memiliki akun penyimpanan diagnostik yang ditentukan dalam file .wadcfgx, maka akun tersebut akan tetap di sana. Untuk memanfaatkan fleksibilitas menggunakan akun penyimpanan yang berbeda untuk konfigurasi penyimpanan yang berbeda, Anda harus menambahkan string koneksi ke project secara manual. Jika Anda memigrasikan proyek dari Azure SDK 2.4 atau yang lebih lama ke Azure SDK 2.6, maka string koneksi diagnostik dipertahankan. Namun, perhatikan perubahan dalam bagaimana string koneksi diperlakukan di Azure SDK 2.6 seperti yang ditentukan di bagian sebelumnya.

Bagaimana Visual Studio menentukan akun penyimpanan diagnostik

  • Jika string koneksi diagnostik ditentukan dalam file .cscfg, Visual Studio menggunakannya untuk mengonfigurasi ekstensi diagnostik saat menerbitkan, dan saat membuat file xml konfigurasi publik selama pengemasan.
  • Jika tidak ada string koneksi diagnostik yang ditentukan dalam file .cscfg, Visual Studio akan kembali menggunakan akun penyimpanan yang ditentukan dalam file .wadcfgx untuk mengonfigurasi ekstensi diagnostik saat memublikasikan, dan menghasilkan file xml konfigurasi publik saat pengemasan.
  • String koneksi diagnostik dalam file .cscfg lebih diutamakan daripada akun penyimpanan dalam file .wadcfgx. Jika string koneksi diagnostik ditentukan dalam file .cscfg, Visual Studio menggunakannya dan mengabaikan akun penyimpanan dalam .wadcfgx.

Apa yang "Perbarui string koneksi penyimpanan pengembangan..." kotak centang lakukan?

Kotak centang untuk Memperbarui string koneksi penyimpanan pengembangan untuk Diagnostik dan penembolokan dengan info masuk akun penyimpanan Microsoft Azure saat menerbitkan ke Microsoft Azure memberi Anda cara mudah untuk memperbarui string koneksi akun penyimpanan pengembangan dengan akun penyimpanan Azure yang ditentukan selama penerbitan.

Misalnya, Anda memilih kotak centang ini dan string koneksi diagnostik menentukan UseDevelopmentStorage=true. Saat Anda memublikasikan proyek ke Azure, Visual Studio akan memperbarui string koneksi diagnostik secara otomatis dengan akun penyimpanan yang Anda tentukan di wizard Terbitkan. Namun, jika akun penyimpanan riil ditentukan sebagai string koneksi diagnostik, maka akun tersebut digunakan sebagai gantinya.

Perbedaan fungsi diagnostik antara Azure SDK 2.4 dan yang lebih lama serta Azure SDK 2.5 dan yang lebih baru

Jika Anda memutakhirkan proyek dari Azure SDK 2.4 ke Azure SDK 2.5 atau yang lebih baru, Anda harus ingat perbedaan fungsionalitas diagnostik berikut ini.

  • API Konfigurasi tidak digunakan lagi - Konfigurasi diagnostik terprogram tersedia di Azure SDK 2.4 atau versi yang lebih lama, tetapi tidak digunakan lagi di Azure SDK 2.5 dan yang lebih baru. Jika konfigurasi diagnostik Anda saat ini didefinisikan dalam kode, Anda harus mengonfigurasi ulang pengaturan tersebut dari awal dalam proyek yang dimigrasikan agar diagnostik tetap berfungsi. File konfigurasi diagnostik untuk Azure SDK 2.4 adalah diagnostics.wadcfg, dan diagnostics.wadcfgx untuk Azure SDK 2.5 dan yang lebih baru.
  • Diagnostik untuk aplikasi layanan cloud hanya dapat dikonfigurasi pada tingkat peran, bukan pada tingkat instans.
  • Setiap kali Anda menerapkan aplikasi, konfigurasi diagnostik diperbarui - Ini dapat menyebabkan masalah paritas jika Anda mengubah konfigurasi diagnostik dari Server Explorer dan kemudian menebus aplikasi Anda.
  • Di Azure SDK 2.5 dan yang lebih baru, crash dump dikonfigurasi dalam file konfigurasi diagnostik, bukan dalam kode - Jika Anda memiliki crash dump yang dikonfigurasi dalam kode, Anda harus mentransfer konfigurasi secara manual dari kode ke file konfigurasi, karena crash dump tidak ditransfer selama migrasi ke Azure SDK 2.6.