Переход с ключей инструментирования Application Insights на строки подключения

Статья
09/13/2024

В этой статье описывается переход с ключей инструментирования на строка подключения.

Необходимые компоненты

Поддерживаемая версия пакета SDK
Существующий ресурс Application Insights

Миграция

Перейдите в область обзора ресурса Application Insights.
Найдите строку подключения, отображаемую справа.
Наведите указатель мыши на строка подключения и щелкните значок копирования в буфер обмена.
Настройте пакет SDK для Application Insights с помощью указаний по настройке строк подключения.

Внимание

Не используйте как строка подключения, так и ключ инструментирования. Последний набор заменяет другой и может привести к тому, что данные телеметрии не отображаются на портале. Просмотр отсутствующих данных.

Миграция в большом масштабе

Используйте переменные среды для передачи строки подключения в пакет SDK или агент Application Insights.

Чтобы задать строка подключения с помощью переменной среды, поместите значение строка подключения в переменную среды с именемAPPLICATIONINSIGHTS_CONNECTION_STRING.

Этот процесс можно автоматизировать в развертываниях Azure. Например, в следующем шаблоне Azure Resource Manager показано, как автоматически включить правильный строка подключения с развертыванием службы приложение Azure. Не забудьте включить любые другие параметры приложения, необходимые приложению:

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

Новые возможности

Строки подключения служат единым параметром конфигурации, избавляя от необходимости управлять несколькими параметрами прокси-сервера.

Надежность: строки подключения делают процесс приема телеметрии надежнее, избавляя от зависимостей от глобальных конечных точек приема.
Безопасность. Строки подключения позволяют приему данных телеметрии с проверкой подлинности с помощью проверки подлинности Microsoft Entra для Application Insights.
Настраиваемые конечные точки (независимые или гибридные облачные среды): параметры конечной точки позволяют отправлять данные в определенный Azure для государственных организаций регион. (См. примеры.)
Конфиденциальность (региональные конечные точки): строки подключения упрощают проблемы конфиденциальности, отправляя данные в региональные конечные точки, гарантируя, что данные не покидают географический регион.

Поддерживаемые версии пакета SDK

.NET и .NET Core версии 2.12.0 и выше
Java версий 2.5.1 и 3.0 и выше
JavaScript версии 2.3.0 и выше
NodeJS версии 1.5.0 и выше
Python версии 1.0.0 и выше

Устранение неполадок

В этом разделе приведены решения по устранению неполадок.

Оповещение: переход на использование строк подключения для приема данных

Чтобы устранить это оповещение, выполните инструкции по переносу, описанные в этой статье.

Отсутствующие данные

Убедитесь, что вы используете поддерживаемую версию пакета SDK. Если вы используете интеграцию Application Insights в другом продукте Azure, изучите документацию, чтобы понять, как правильно настроить строку подключения.
Убедитесь, что не используете ключ инструментирования и строку подключения одновременно. Удалите из своей конфигурации параметры ключа инструментирования.
Убедитесь, что строка подключения в точности соответствует указанной на портале Azure.

Переменные среды не работают

Если вы жестко закодируйте ключ инструментирования в коде приложения, это программирование может иметь приоритет перед переменными среды.

Часто задаваемые вопросы

В этом разделы приводятся ответы на часто задаваемые вопросы.

Где еще можно найти строку подключения?

Строка подключения также включается в свойства ресурсов Resource Manager для ресурса Application Insights под именем ConnectionStringполя.

Как это влияет на автоинструментацию?

Сценарии автоинструментации не затрагиваются.

Можно ли использовать проверку подлинности Microsoft Entra с автоинструментацией?

Невозможно включить проверку подлинности Microsoft Entra для сценариев автоинструментации . Мы планируем устранить это ограничение в будущем.

Какова разница между глобальным и региональным приемом?

При глобальном приеме все данные телеметрии отправляются в одну конечную точку независимо от того, где они будут храниться. Региональное прием позволяет определить определенные конечные точки для каждого региона для приема данных. Эта возможность гарантирует, что данные остаются в определенном регионе во время обработки и хранения.

Как строка подключения влияют на выставление счетов?

Выставление счетов не влияет.

Майкрософт: вопросы и ответы

Размещайте свои вопросы на форуме Answers.

Поделиться через