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

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

Сценарии, наиболее затронутые этим изменением:

• Исключения брандмауэра или перенаправления прокси-сервера - Когда необходимо мониторинг веб-сервера интрасети, в нашем предыдущем решении было предложено добавить отдельные конечные точки службы в вашу конфигурацию. Дополнительные сведения см. в разделе " Можно ли отслеживать веб-сервер интрасети?". Строки подключения предлагают более эффективную альтернативу, сокращая эти усилия до одного параметра. Простая поправка к префиксу, суффиксу позволяет автоматически выполнять заполнение и перенаправление всех конечных точек в нужные службы.

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

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

Предпосылки

Миграция

1. Перейдите в область обзора ресурса Application Insights.

2. Найдите строку подключения , отображаемую справа.

3. Наведите указатель мыши на строку подключения и выберите значок копирования в буфер обмена.

4. Настройте пакет 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')]"
            }
        }
    ]
}

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

• .NET и .NET Core версии 2.12.0+
• Java версии 2.5.1 и Java 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 для сценариев автоинструментации . В будущем мы планируем устранить это ограничение.

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

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

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

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

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

Поместите вопросы на форум ответов.