Migrasi dari kunci instrumentasi di Application Insights ke string koneksi

2024-10-10

Application Insights berubah dari titik akhir penyerapan global ke titik akhir regional yang menggunakan string koneksi, yang menyediakan kemampuan tambahan.

Skenario yang paling terpengaruh oleh perubahan ini:

Pengecualian firewall atau pengalihan proksi - Dalam kasus di mana pemantauan untuk server web intranet diperlukan, solusi kami sebelumnya meminta Anda untuk menambahkan titik akhir layanan individual ke konfigurasi Anda. Untuk informasi selengkapnya, lihat Dapatkah saya memantau server web intranet?. String koneksi menawarkan alternatif yang lebih baik dengan mengurangi upaya ini ke satu pengaturan. Amendemen awalan dan akhiran yang sederhana memungkinkan konfigurasi otomatis dan pengalihan semua endpoint ke layanan yang sesuai.
Lingkungan cloud kedaulatan atau hybrid - Pengguna dapat mengirim data ke wilayah Azure Government yang ditentukan. Dengan menggunakan string koneksi, Anda dapat menentukan pengaturan titik akhir untuk server intranet atau pengaturan cloud hibrid Anda.

Artikel ini menjelaskan migrasi dari kunci instrumentasi ke string koneksi.

Prasyarat

Migrasi

Buka panel Gambaran Umum sumber daya Application Insights Anda.
Temukan String Koneksi Anda yang ditampilkan di sebelah kanan.
Arahkan mouse ke atas string koneksi dan pilih ikon Salin ke clipboard.
Konfigurasikan Application Insights SDK 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 Application Insights SDK atau agen.

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

Proses ini dapat diotomatisasi 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')]"
            }
        }
    ]
}

Versi SDK yang didukung

.NET dan .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.

Pemberitahuan: "Transisi ke menggunakan string koneksi untuk penyerapan data"

Ikuti langkah-langkah migrasi dalam artikel ini untuk mengatasi pemberitahuan ini.

Data yang hilang

Konfirmasikan bahwa Anda menggunakan versi SDK yang didukung. Jika Anda menggunakan integrasi Application Insights dalam penawaran produk Azure lain, periksa dokumentasinya tentang cara mengonfigurasi string koneksi dengan benar.
Pastikan bahwa Anda tidak mengatur baik kunci instrumentasi maupun 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.

Tanya jawab umum

Bagian ini menyediakan jawaban atas pertanyaan umum.

Di mana lagi saya dapat menemukan string koneksi saya?

String sambungan juga disertakan dalam properti sumber daya Resource Manager untuk sumber daya Application Insights Anda, di bawah nama bidang ConnectionString.

Bagaimana hal ini memengaruhi autoinstrumentasi?

Skenario autoinstrumentasi tersebut tidak terpengaruh.

Dapatkah saya menggunakan autentikasi Microsoft Entra dengan autoinstrumentasi?

Anda tidak dapat mengaktifkan autentikasi Microsoft Entra untuk skenario autoinstrumentation. Kami memiliki rencana untuk mengatasi batasan ini di masa depan.

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.

Tanya Jawab Microsoft

Posting pertanyaan ke forum jawaban.

Bagikan melalui