Bermigrasi dari kunci instrumentasi Application Insights ke string koneksi

Artikel ini membahas migrasi dari kunci instrumentasi ke string koneksi.

Prasyarat

• Versi SDK yang didukung
• Sumber daya Application Insights yang ada

Migration

1. Buka panel Gambaran Umum sumber daya Application Insights Anda.

2. Temukan String Koneksi ion Anda yang ditampilkan di sebelah kanan.

3. Arahkan mouse ke atas string koneksi dan pilih ikon Salin ke clipboard.

4. Konfigurasikan SDK Application Insights dengan mengikuti Cara mengatur string koneksi.

Penting

Jangan gunakan string koneksi dan kunci instrumentasi. Satu set terakhir menggantikan yang lain, dan dapat mengakibatkan telemetri tidak muncul di portal. Lihat data yang hilang.

Migrasi dalam skala besar

Gunakan variabel lingkungan untuk meneruskan string koneksi ke SDK Application Insights atau agen.

Untuk mengatur string koneksi melalui variabel lingkungan, tempatkan nilai string koneksi ke dalam variabel lingkungan bernama APPLICATIONINSIGHTS_CONNECTION_STRING.

Proses ini dapat diotomatiskan dalam penyebaran Azure Anda. Misalnya, templat Azure Resource Manager berikut menunjukkan bagaimana Anda dapat secara otomatis menyertakan string koneksi yang benar dengan penyebaran Azure App Service. Pastikan untuk menyertakan pengaturan aplikasi lain yang diperlukan aplikasi Anda:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "appServiceName": {
            "type": "string",
            "metadata": {
                "description": "Name of the App Services resource"
            }
        },
        "appServiceLocation": {
            "type": "string",
            "metadata": {
                "description": "Location to deploy the App Services resource"
            }
        },
        "appInsightsName": {
            "type": "string",
            "metadata": {
                "description": "Name of the existing Application Insights resource to use with this App Service. Expected to be in the same Resource Group."
            }
        }
    },
    "resources": [
        {
            "apiVersion": "2016-03-01",
            "name": "[parameters('appServiceName')]",
            "type": "microsoft.web/sites",
            "location": "[parameters('appServiceLocation')]",
            "properties": {
                "siteConfig": {
                    "appSettings": [
                        {
                            "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
                            "value": "[reference(concat('microsoft.insights/components/', parameters('appInsightsName')), '2015-05-01').ConnectionString]"
                        }
                    ]
                },
                "name": "[parameters('appServiceName')]"
            }
        }
    ]
}

Kapabilitas baru

String koneksi menyediakan pengaturan konfigurasi tunggal dan menghilangkan kebutuhan untuk beberapa pengaturan proksi.

• Keandalan: String koneksi membuat penyerapan telemetri lebih andal dengan menghapus dependensi pada titik akhir penyerapan global.
• Keamanan: string Koneksi ion memungkinkan penyerapan telemetri terautentikasi dengan menggunakan autentikasi Microsoft Entra untuk Application Insights.
• Titik akhir yang disesuaikan (lingkungan sovereign atau cloud hibrid): Pengaturan titik akhir memungkinkan pengiriman data ke wilayah Azure Government tertentu. (Lihat contoh.)
• Privasi (titik akhir regional): string Koneksi meringankan masalah privasi dengan mengirim data ke titik akhir regional, memastikan data tidak meninggalkan wilayah geografis.

Versi SDK yang didukung

• .NET and .NET Core v2.12.0+
• Java v2.5.1 dan Java 3.0+
• JavaScript v2.3.0+
• NodeJS v1.5.0+
• Python v1.0.0+

Pemecahan Masalah

Bagian ini menyediakan solusi pemecahan masalah.

Peringatan: "Transisi menggunakan string koneksi untuk penyerapan data"

Ikuti langkah migrasi dalam artikel ini untuk mengatasi peringatan ini.

Data yang hilang

• Konfirmasikan bahwa Anda menggunakan versi SDK yang didukung. Jika Anda menggunakan integrasi Application Insights dalam penawaran produk Azure lainnya, periksa dokumentasinya tentang cara mengonfigurasi string koneksi dengan benar.
• Konfirmasikan bahwa Anda tidak mengatur kunci instrumentasi dan string koneksi secara bersamaan. Pengaturan kunci instrumentasi harus dihapus dari konfigurasi Anda.
• Konfirmasikan string koneksi Anda persis seperti yang disediakan di portal Microsoft Azure.

Variabel lingkungan tidak berfungsi

Jika Anda melakukan hardcode kunci instrumentasi dalam kode aplikasi, pemrograman tersebut mungkin diutamakan sebelum variabel lingkungan.

Pertanyaan yang Sering Ditanyakan

Bagian ini menyediakan jawaban atas pertanyaan umum.

Di mana lagi saya dapat menemukan string koneksi saya?

string koneksi juga disertakan dalam properti sumber daya Resource Manager untuk sumber daya Application Insights Anda, dengan nama ConnectionStringbidang .

Bagaimana hal ini memengaruhi autoinstrumentasi?

Skenario autoinstrumentasi tidak terpengaruh.

Dapatkah saya menggunakan autentikasi Microsoft Entra dengan autoinstrumentasi?

Anda tidak dapat mengaktifkan autentikasi Microsoft Entra untuk skenario autoinstrumentasi . Kami memiliki rencana untuk mengatasi keterbatasan ini di masa mendatang.

Apa perbedaan antara penyerapan global dan regional?

Penyerapan global mengirimkan semua data telemetri ke satu titik akhir, di mana pun data ini akan disimpan. Penyerapan regional memungkinkan Anda menentukan titik akhir tertentu per wilayah untuk penyerapan data. Kemampuan ini memastikan data tetap berada dalam wilayah tertentu selama pemrosesan dan penyimpanan.

Bagaimana string koneksi memengaruhi penagihan?

Penagihan tidak terpengaruh.

Microsoft Q&A

Kirim pertanyaan ke forum jawaban.