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

Статья
10/29/2024

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

Внимание

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

Если вы хотите защитить ресурс Application Insights от неправильного использования, конечная точка приема предоставляет параметры приема данных телеметрии с проверкой подлинности на основе идентификатора Microsoft Entra.

Примечание.

Поддержка приема ключей инструментирования будет завершена 31 марта 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

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

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

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

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

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

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.

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

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

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

Примеры кода

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

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

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

Требуется ли использовать строки подключения для новых регионов Azure?

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

Следует ли использовать строки подключения или ключи инструментирования?

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

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

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

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

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