Bermigrasi dari kunci instrumentasi Application Insights ke string koneksi

Panduan ini menjelaskan tentang bermigrasi dari kunci instrumentasi ke string koneksi.

Prasyarat

• Versi SDK yang didukung
• Sumber daya application insights yang ada

Migration

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

2. Temukan string koneksi Anda yang ditampilkan di sebelah kanan.

3. Arahkan ke string koneksi dan pilih ikon “Salin ke clipboard”.

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

Penting

Tidak disarankan menggunakan string koneksi dan kunci instrumentasi. Apa pun yang ditetapkan terakhir akan diutamakan.

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, template ARM berikut menunjukkan cara Anda dapat secara otomatis menyertakan string koneksi yang benar dengan penyebaran App Services (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 memungkinkan penyerapan telemetri yang diautentikasi dengan menggunakan autentikasi Azure Active Directory untuk Application Insights.

• Titik akhir yang disesuaikan (lingkungan cloud sovereign atau hibrid): Pengaturan titik akhir memungkinkan mengirimkan data ke wilayah Azure Government tertentu. (lihat contoh)

• Privasi (titik akhir regional) – String koneksi meredakan masalah privasi dengan mengirimkan data ke titik akhir regional, memastikan data tidak meninggalkan wilayah geografis.

Versi SDK yang Didukung

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

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 mengodekan kunci instrumentasi secara permanen dalam kode aplikasi Anda, pemrograman tersebut mungkin diutamakan sebelum variabel lingkungan.

FAQ

Di mana lagi saya dapat menemukan string koneksi saya?

String koneksi juga disertakan dalam properti sumber daya ARM untuk sumber daya Application Insights Anda, di bawah nama bidang “ConnectionString”.

Bagaimana pengaruhnya terhadap instrumentasi otomatis?

Skenario instrumentasi otomatis tidak terpengaruh.

Dapatkah saya menggunakan autentikasi Azure Active Directory dengan instrumentasi otomatis?

Anda tidak dapat mengaktifkan autentikasi Azure Active Directory untuk skenario instrumentasi otomatis. 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 setiap wilayah untuk penyerapan data, memastikan data tetap berada dalam wilayah tertentu selama pemrosesan dan penyimpanan.

Bagaimana string koneksi memengaruhi tagihan?

Tagihan tidak terpengaruh.

Microsoft Q&A

Kirim pertanyaan ke forum jawaban.