Строки подключения в Application Insights

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

Внимание

Строка подключения содержит ikey и ApplicationId.

Ikey — это уникальный идентификатор, используемый службой приема данных для связывания телеметрии с определенным ресурсом Application Insights. Уникальные идентификаторы Ikey не являются маркерами безопасности или ключами безопасности и не считаются секретами. Строки подключения улучшены путем добавления значения ApplicationId. Это обновление представляет собой новую функцию, которая поддерживает автоматическое инструментирование для сценариев, использующих пакет SDK для открытой телеметрии. Если вы хотите защитить ресурс Application Insights от неправильного использования, конечная точка приема предоставляет параметры приема данных телеметрии с проверкой подлинности на основе идентификатора Microsoft Entra.

Примечание.

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

Возможности строки подключения

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

Получение строки подключения

Строка подключения отображается в разделе "Обзор " ресурса Application Insights.

Схема

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

Максимальная длина

Максимальная поддерживаемая длина строки подключения составляет 4096 символов.

Пары "ключ-значение"

Строка подключения состоит из списка параметров, представленных в виде разделенных точкой с запятой пар "ключ — значение": key1=value1;key2=value2;key3=value3.

Совет

Настраиваемые пары "ключ-значение" рассматриваются в этом документе. Некоторые пары "ключ-значение" не настраиваются и задаются автоматически, например ApplicationId. Эти пары можно безопасно игнорировать, если они наблюдаются в вашей среде.

Синтаксис

• InstrumentationKey (например, 00000000-0000-0000-0000-000000000000). InstrumentationKey является обязательным полем.

• Authorization (например, ikey). Этот параметр является необязательным, так как на сегодняшний день поддерживается только авторизация ikey.

• EndpointSuffix (например, applicationinsights.azure.cn). Настройка суффикса конечной точки указывает SDK, к какому облаку Azure подключаться. Пакет SDK собирает оставшуюся часть конечной точки для отдельных служб.

• Явные конечные точки. Любую службу можно явным образом переопределить в строке подключения:

  • IngestionEndpoint (например, https://dc.applicationinsights.azure.com)
  • LiveEndpoint (например, https://live.applicationinsights.azure.com)
  • ProfilerEndpoint (например, https://profiler.monitor.azure.com)
  • SnapshotEndpoint (например, https://snapshot.monitor.azure.com)

Схема конечной точки

<prefix>.<suffix>

• Приставка: Определяет службу.
• Суффикс: Определяет общее доменное имя.

Допустимые суффиксы

• applicationinsights.azure.cn
• applicationinsights.us

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

Допустимые префиксы

• Прием данных телеметрии: dc
• Динамические метрики: live
• Профилировщик для .NET: profiler
• Моментальный снимок: snapshot

Примеры строк подключения

Далее приведены примеры строк подключения.

Строка подключения с суффиксом конечной точки

InstrumentationKey=00000000-0000-0000-0000-000000000000;EndpointSuffix=ai.contoso.com;

В этом примере строка подключения указывает суффикс конечной точки, а пакет SDK создает конечные точки службы:

• По умолчанию используется схема авторизации ikey.
• Ключ инструментирования: 00000000-0000-0000-0000-000000000000
• Универсальные идентификаторы ресурсов региональной службы (URI) основаны на суффиксе предоставленной конечной точки:
  • Прием: https://dc.ai.contoso.com
  • Динамические метрики: https://live.ai.contoso.com
  • Профилировщик для .NET: https://profiler.ai.contoso.com
  • Отладчик: https://snapshot.ai.contoso.com

Строка подключения с явным переопределением конечных точек

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://custom.com:111/;LiveEndpoint=https://custom.com:222/;ProfilerEndpoint=https://custom.com:333/;SnapshotEndpoint=https://custom.com:444/;

В этом примере строка подключения указывает явные переопределения для каждой службы. Пакет SDK использует точные конечные точки, предоставляемые без изменений:

• По умолчанию используется схема авторизации ikey.
• Ключ инструментирования: 00000000-0000-0000-0000-000000000000
• URI региональной службы основаны на явно переопределенных значениях:
  • Прием: https://custom.com:111/
  • Динамические метрики: https://custom.com:222/
  • Профилировщик для .NET: https://custom.com:333/
  • Отладчик: https://custom.com:444/

Строка подключения с явно заданным регионом

InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://southcentralus.in.applicationinsights.azure.com/

В этом примере строка подключения указывает регион центрально-южной части США:

• По умолчанию используется схема авторизации ikey.
• Ключ инструментирования: 00000000-0000-0000-0000-000000000000
• URI региональной службы основаны на явно переопределенных значениях:
  • Прием: https://southcentralus.in.applicationinsights.azure.com/

Чтобы получить список доступных регионов, выполните следующую команду в Azure CLI:

az account list-locations -o table

Установить строку подключения

Все наши продукты OpenTelemetry и последующие версии SDK поддерживают строки подключения.

• .NET версии 2.12.0
• JavaScript версия 2.3.0
• NodeJS версии 1.5.0
• Python версии 1.0.0
• Java версии 3.1.1

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

Переменная среды

Строка подключения: APPLICATIONINSIGHTS_CONNECTION_STRING

Примеры кода

Язык	Классический API	OpenTelemetry
ASP.NET Core	Application Insights SDK	AzMon OTel Distro
Платформа .NET Framework	Application Insights SDK	AzMon Exporter
Ява	Н/Д	Агент Java
JavaScript	Скрипт загрузчика пакета SDK для JavaScript (Web)	Н/Д
Node.js	Application Insights SDK	AzMon OTel Distro
Питон	OpenCensus Python SDK	AzMon OTel Distro

Следующие шаги

Чтобы просмотреть часто задаваемые вопросы (вопросы и ответы):

• Строки подключения в Application Insights: вопросы и ответы

Приступите к работе в процессе выполнения с помощью:

• Приложения, размещенные в IIS на виртуальных машинах Azure и в масштабируемых наборах виртуальных машин Azure
• Сервер IIS
• Функция веб-приложений службы приложений Azure

Приступите к работе во время разработки с помощью:

• ASP.NET Core
• ASP.NET
• Java
• Node.js
• Питон