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

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

Внимание

Строка подключения содержит ключ инструментирования (ikey) и идентификатор приложения (ApplicationId).

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

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

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

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

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

Скриншот, показывающий обзор Application Insights и строку подключения.

Схема

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

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

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

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

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

Совет

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

Синтаксис

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

  • Authorization (например, ikey). Этот параметр необязателен, так как сейчас пакет SDK поддерживает только авторизацию 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 Configuration и аутентификация Microsoft Entra для Application Insights.

Аутентифицированная телеметрия браузера с использованием строк подключения

Если организации отключают локальную проверку подлинности в Application Insights для принудительного применения Microsoft Entra ID, пакет SDK JavaScript не может выполнять проверку подлинности непосредственно для телеметрии на основе браузера, а телеметрия может перестать передаваться.

Практический шаблон — маршрутизация телеметрии браузера через Azure API Management (APIM), которая:

  • Выполняет проверку подлинности в Application Insights с помощью управляемого удостоверения.
  • Пересылает запросы к региональной конечной точке приема от вашего имени.

При этой настройке строка соединения продолжает идентифицировать целевой ресурс Application Insights, но IngestionEndpoint указывает на URL прокси-сервера для управления API (APIM).

Для всеобъемлющих инструкций, включая политики CORS и APIM, см. статью Использование Azure API Management в качестве прокси-сервера для телеметрии Application Insights.

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

Чтобы просмотреть часто задаваемые вопросы (вопросы и ответы), см. следующие сведения:

Начало работы с:

  • Last updated on