Application Insights izleme anahtarlarından bağlantı dizelerine geçiş

Makale
11/05/2024

Bu makalede izleme anahtarlarından bağlantı dizesi geçiş adımları verilmiştir.

Önkoşullar

Desteklenen bir SDK sürümü
Mevcut bir Application Insights kaynağı

Geçiş

Application Insights kaynağınızın Genel Bakış bölmesine gidin.
Sağ tarafta görüntülenen Bağlantı Dizenizi bulun.
bağlantı dizesi üzerine gelin ve Panoya kopyala simgesini seçin.
bağlantı dizesi ayarlama'yı izleyerek Application Insights SDK'sını yapılandırın.

Önemli

Hem bağlantı dizesi hem de izleme anahtarı kullanmayın. İkinci küme diğerinin yerini alır ve telemetrinin portalda görünmemesiyle sonuçlanabilir. Eksik verilere bakın.

Büyük ölçekte geçiş

Application Insights SDK'sına veya aracısına bir bağlantı dizesi geçirmek için ortam değişkenlerini kullanın.

Ortam değişkeni aracılığıyla bir bağlantı dizesi ayarlamak için, bağlantı dizesi değerini adlı APPLICATIONINSIGHTS_CONNECTION_STRINGbir ortam değişkenine yerleştirin.

Bu işlem Azure dağıtımlarınızda otomatikleştirilebilir. Örneğin, aşağıdaki Azure Resource Manager şablonu, Azure Uygulaması Hizmeti dağıtımına doğru bağlantı dizesi otomatik olarak nasıl ekleyebileceğinizi gösterir. Uygulamanızın gerektirdiği diğer uygulama ayarlarını eklediğinizden emin olun:

{
    "$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')]"
            }
        }
    ]
}

Yeni özellikler

Bağlantı dizeleri tek bir yapılandırma ayarı sağlar ve birden çok ara sunucu ayarı gereksinimini ortadan kaldırır.

Güvenilirlik: Bağlantı dizeleri, genel alım uç noktalarındaki bağımlılıkları kaldırarak telemetri alımını daha güvenilir hale getirir.
Güvenlik: Bağlantı dizeleri, Application Insights için Microsoft Entra kimlik doğrulamasını kullanarak kimliği doğrulanmış telemetri alımına izin verir.
Özelleştirilmiş uç noktalar (bağımsız veya karma bulut ortamları): Uç nokta ayarları belirli bir Azure Kamu bölgeye veri gönderilmesine izin verir. (Örneklere bakın.)
Gizlilik (bölgesel uç noktalar): Bağlantı dizeleri, verileri bölgesel uç noktalara göndererek gizlilik sorunlarını kolaylaştırır ve verilerin coğrafi bölgeden ayrılmamasını sağlar.

Desteklenen SDK sürümleri

.NET ve .NET Core v2.12.0+
Java v2.5.1 ve Java 3.0+
JavaScript v2.3.0+
NodeJS v1.5.0+
Python v1.0.0+

Sorun giderme

Bu bölümde sorun giderme çözümleri sağlanır.

Uyarı: "Veri alımı için bağlantı dizesi kullanmaya geçiş"

Bu uyarıyı çözmek için bu makaledeki geçiş adımlarını izleyin.

Eksik veriler

Desteklenen bir SDK sürümü kullandığınızı onaylayın. Application Insights tümleştirmesini başka bir Azure ürün teklifinde kullanıyorsanız, bağlantı dizesi düzgün şekilde yapılandırma hakkındaki belgelerine bakın.
Aynı anda hem izleme anahtarı hem de bağlantı dizesi ayarlamadığınızdan emin olun. İzleme anahtarı ayarları yapılandırmanızdan kaldırılmalıdır.
bağlantı dizesi tam olarak Azure portalında sağlanan şekilde olduğunu onaylayın.

Ortam değişkenleri çalışmıyor

Uygulama kodunuzda bir izleme anahtarını sabit kodlarsanız, bu programlama ortam değişkenlerinden önce öncelikli olabilir.

Sık sorulan sorular

Bu bölüm, sık sorulan soruların yanıtlarını sağlar.

bağlantı dizesi başka nerede bulabilirim?

bağlantı dizesi, Application Insights kaynağınızın Resource Manager kaynak özelliklerine alan adının ConnectionStringaltında da eklenir.

Bu, otomatik yetkisiz girişi nasıl etkiler?

Otomatik yetkisiz erişim senaryoları etkilenmez.

Microsoft Entra kimlik doğrulamasını otomatik yetkisiz erişimle kullanabilir miyim?

Otomatik yetkisiz erişim senaryoları için Microsoft Entra kimlik doğrulamasını etkinleştiremezsiniz. Gelecekte bu sınırlamayı ele almak için planlarımız var.

Küresel ve bölgesel alım arasındaki fark nedir?

Genel veri alımı, bu verilerin nerede depolanacağına bakılmaksızın tüm telemetri verilerini tek bir uç noktaya gönderir. Bölgesel veri alımı, veri alımı için bölge başına belirli uç noktaları tanımlamanızı sağlar. Bu özellik, işleme ve depolama sırasında verilerin belirli bir bölgede kalmasını sağlar.

bağlantı dizesi faturalamayı nasıl etkiler?

Faturalama bundan etkilenmez.

Microsoft Q&A

Soruları yanıtlar forumuna gönderin.

Aracılığıyla paylaş