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

  • Статья

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

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

Миграция

Screenshot that shows Application Insights overview and connection string.

  1. Перейдите в область обзора ресурса приложения Аналитика.

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

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

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

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

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

Поддерживаемые версии пакета 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 для ресурса приложения Аналитика под именем ConnectionStringполя.

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

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

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

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

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

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

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

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

Microsoft Q&A

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