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

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

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

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

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

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

Схема

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

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

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

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

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

Синтаксис

• 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
• Профилировщик: 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
  • Профилировщик: 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/
  • Профилировщик: 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

Примеры кода

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

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

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

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

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

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

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

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

• Виртуальные машины Azure и приложения, размещенные в СЛУЖБАх IIS, и Azure Масштабируемые наборы виртуальных машин
• Сервер IIS
• функция веб-приложения службы приложение Azure

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

• ASP.NET Core
• ASP.NET
• Java
• Node.js
• Python