Строки подключения в 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
• Профилировщик для .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

Примеры кода

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

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

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

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

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

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

Когда нужно задать переменную среды?

Вручную задайте параметры APPLICATIONINSIGHTS_CONNECTION_STRING во всех сценариях, в которых оно не предоставляется автоматически. Эти сценарии включают в себя, но не ограничиваются следующими примерами: локальная разработка и изолированные функции .NET с интеграцией ASP.NET Core. В таких случаях переменная среды гарантирует, что конвейер OpenTelemetry может отправлять данные телеметрии в Application Insights. Дополнительные сведения о настройке строк подключения с помощью переменной среды см. в разделе "Настройка OpenTelemetry" в Application Insights.

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

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

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

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

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