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

Подключите источник телеметрии, чтобы заземлить ответы вашего агента в ваших собственных сигналах, а не в общих знаниях. После того как настроите телеметрический разъём, задайте вопрос для расследования простым языком. Агент выполняет запрос и отвечает с реальными числами.

В этом руководстве рассматриваются разъёмы в категории телеметрии . Azure Data Explorer использует путь Azure MCP Kusto. Сторонние разъёмы телеметрии также отображаются во вкладке Telemetry даже при использовании MCP за кулисами. Настройка использует тот же мастер, что и любой управляемый коннектор, поэтому эта статья сосредоточена на деталях телеметрии: как источники аутентифицируются, какие операции включать и как проверить с помощью запроса.

Это важно

Управляемые разъёмы находятся в предварительном просмотре. Доступность соединителей, поля и эксплуатация могут меняться.

Необходимые условия

  • Действующий агент SRE и доступ к sre.azure.com.
  • Разрешение на настройку разъёмов на агенте.
  • Читайте доступ к источнику телеметрии, к которому вы подключаетесь. Для источника Azure идентификатор, авторизующий соединение, должен иметь как минимум доступ к целевой ресурсу.

Если вы раньше не настраивали разъём, начните с «Настройте управляемый разъём » для полного мастерского прохождения. В этой статье упоминаются только различия в источниках телеметрии.

Телеметрические разъёмы

Разъём Услуга Authentication Типичное использование
Azure Data Explorer (via Azure MCP) Azure Data Explorer (Kusto) Манажируемая идентичность Запускайте запросы KQL к кластерам ADX
Рабочая область Log Analytics Log Analytics Манажируемая идентичность Запрос к журналам рабочих пространств в режиме только чтения
Application Insights Application Insights Манажируемая идентичность Запрос телеметрии приложений в режиме только чтения
Datadog Datadog Сервисные учетные данные, отображаемые коннектором Запросы к метрикам, журналам и мониторам
Elasticsearch Elasticsearch Сервисные учетные данные, отображаемые коннектором Журналы поиска и индексированная телеметрия
Dynatrace Dynatrace Сервисные учетные данные, отображаемые коннектором Запрос данных и трассировок наблюдаемости
New Relic New Relic Сервисные учетные данные, отображаемые коннектором Телеметрия запроса и инциденты
Splunk Splunk Сервисные учетные данные, отображаемые коннектором Поисковые журналы и события Splunk
Соколиный глаз (NeuBird) Соколиный глаз от NeuBird Сервисные учетные данные, отображаемые коннектором Запрос данных о наблюдаемости на базе ИИ

Сторонние телеметрические разъёмы включают стандартный URL, аутентификацию и подсказки к заголовку для настройки соединения.

Вы также можете добавить ещё один источник телеметрии через пользовательский разъём. Используйте эту опцию, если у вашей команды есть пользовательский инструмент или источник, который не указан в picker connector.

Шаг 1: Добавьте разъём

  1. Перейдите к sre.azure.com и выберите агент.

  2. В левой боковой панели разверните Builder, а затем выберите Connectors.

  3. Выберите "Добавить соединитель".

  4. Выберите вкладку «Телеметрия », а затем выберите источник телеметрии. Для Azure Data Explorer выберите Azure Data Explorer, который использует путь Azure MCP Kusto.

Шаг 2: Аутентифицировать

For Azure telemetry connectors:

  1. Заполните поля, показанные соединителем.

    • Для Azure Data Explorer укажите имя коннектора, выберите управляемую идентичность, которую агент использует для запроса Kusto, а затем добавьте одну или несколько групп кластеров с URL кластера.
    • Для Log Analytics Workspace выберите рабочее пространство из выбора workspace или вручную введите идентификатор ресурса ARM workspace.
    • Для Application Insights выберите ресурс Application Insights из выборщика ресурсов или вручную введите идентификатор ресурса ARM.

  2. Выбирайте управляемую идентичность , когда соединитель попросит её.

  3. Переходите к этапу обзора, кластера или выбора инструмента, показанного мастером.

Управляемая идентичность должна иметь доступ к целевому ресурсу для чтения. Если позже запросы не сдаются из-за ошибки разрешения, предоставьте доступ к чтению этой идентичности и попробуйте запрос снова.

Шаг 3: Настройте инструменты запросов

На шаге «Настройка инструментов » включите операции, которые читают телеметрию. Операции запроса являются ядром телеметрического разъёма, поэтому выберите операции run-query или поиск. Оставьте административные операции отключенными, если они вам не нужны.

Установите каждую операцию чтения в режим «Разрешить », чтобы агент мог отвечать на вопросы без пауз. Если вы включили какую-либо операцию, меняющую данные, установите её в режим Ask.

Для Azure Data Explorer через Azure MCP мастер включает этап группы кластера и этап проверки с тестированием соединения. Настройте группы кластеров, проверьте подключение и сохраните коннектор. Набор инструментов Kusto управляется путём Azure MCP Kusto.

Совет

Держите включённый набор небольшим. Телеметрический разъём обычно требует только операций запроса. Меньшее количество инструментов означает, что агент более надёжно выбирает правильный и остаётся в рамках бюджета из 80 инструментов.

Шаг 4: Подтвердите вопросом

  1. Откройте чат с вашим агентом.

  2. Задайте вопрос, который требует вашей телеметрии. Рассмотрим пример.

    How many errors were logged in the last hour, grouped by service?

  3. Следите за ответом. На карточке инструмента агент выбирает инструмент запроса коннектора и запускает запрос, а затем следует ответ, закреплённый в вашей телеметрии.

Когда вы видите реальный счёт из собственного источника вместо общего объяснения, разъём работает от одного до другого.

Troubleshooting

Проблема. Cause Исправление
Запрос возвращает «Несанкционированный» или «Запрещённый» Идентификатор соединения не имеет доступа к чтению Дайте идентификационному доступу к целевой ресурсу, затем попробуйте снова.
Запрос возвращает «не найден» Неправильное имя рабочего пространства, кластера, базы данных или таблицы Подтвердите точное название в сервисе. В именах учитывается регистр.
Сторонний разъём не может подключиться URL, токен или заголовок неверны Подтвердите значения с администратором наблюдаемости и обновите разъём.
Ответ общий, и карта инструмента не отображается Вопрос не требовал вашей телеметрии Переформулируйте так, чтобы вопрос требовал вашей телеметрии, например, «подсчитать неудачные запросы в сервисе X за последний день».
Разъём сохранён, но телеметрия не вернулась Пустой или отфильтрованный результат Расширьте временной диапазон в вашем вопросе или убедитесь, что у источника есть недавняя телеметрия.

Связанные материалы

  • Last updated on