Conecta una fuente de telemetría

Conecta una fuente de telemetría para fundamentar las respuestas de tu agente en tus propias señales, no en conocimientos generales. Después de configurar un conector de telemetría, haz una pregunta de investigación en lenguaje claro. El agente ejecuta la consulta y responde con números reales.

Este tutorial cubre los conectores en la categoría de Telemetría . Azure Data Explorer utiliza la ruta Azure MCP Kusto. Los conectores de telemetría de terceros también aparecen en la pestaña de Telemetría , incluso cuando usan MCP entre bastidores. La configuración utiliza el mismo asistente que todos los conectores gestionados, por lo que este artículo se centra en los detalles de la telemetría: cómo se autentican las fuentes, qué operaciones habilitar y cómo validar mediante una consulta.

Importante

Los conectores gestionados están en vista previa. La disponibilidad de conectores, los campos y las operaciones pueden cambiar.

Prerequisites

  • Un agente SRE en funcionamiento y acceso a sre.azure.com.
  • Permiso para configurar conectores en el agente.
  • Lee el acceso a la fuente de telemetría que estás conectando. Para una fuente de Azure, la identidad que autoriza la conexión necesita al menos acceso de lectura al recurso objetivo.

Si nunca has configurado un conector, empieza con Configurar un conector gestionado para la guía completa del asistente. Este artículo señala únicamente las diferencias en la fuente de la telemetría.

Conectores de telemetría

Conector Service Authentication Uso típico
Azure Data Explorer (via Azure MCP) Azure Data Explorer (Kusto) Identidad administrada Ejecutar consultas KQL contra clústeres ADX
Área de trabajo de Log Analytics Log Analytics Identidad administrada Consulta de los logs del espacio de trabajo en modo de solo lectura
Application Insights Application Insights Identidad administrada Consulta la telemetría de la aplicación en modo de solo lectura
Datadog Datadog Credenciales de servicio mostradas por el conector Métricas de consulta, registros y monitores
Elasticsearch Elasticsearch Credenciales de servicio mostradas por el conector Registros de búsqueda y telemetría indexada
Dynatrace Dynatrace Credenciales de servicio mostradas por el conector Datos de observabilidad y trazas de consulta
Nueva reliquia Nueva reliquia Credenciales de servicio mostradas por el conector Telemetría de consulta e incidentes
Splunk Splunk Credenciales de servicio mostradas por el conector Busca registros y eventos de Splunk
Ojo de Halcón (NeuBird) Hawkeye por NeuBird Credenciales de servicio mostradas por el conector Consulta datos de observabilidad impulsados por IA

Los conectores de telemetría de terceros incluyen URL predeterminada, autenticación y consejos para la cabecera que te ayudan a configurar la conexión.

También puedes añadir otra fuente de telemetría a través de un conector proporcionado por el usuario. Usa esta opción cuando tu equipo tenga una herramienta personalizada o una fuente que no esté listada en el selector de conectores.

Paso 1: Añadir el conector

  1. Vaya a sre.azure.com y seleccione el agente.

  2. En la barra lateral izquierda, expande Constructor y luego selecciona Conectores.

  3. Seleccione Agregar conector.

  4. Selecciona la pestaña de Telemetría y luego elige tu fuente de telemetría. Para Azure Data Explorer, selecciona Azure Data Explorer, que utiliza la ruta Azure MCP Kusto.

Paso 2: Autenticar

Para conectores de telemetría Azure:

  1. Completa los campos que muestra el conector.

    • Para Azure Data Explorer, nombra el conector, selecciona la identidad gestionada que utiliza el agente para consultar Kusto y luego añade uno o más grupos de clúster con URLs de clúster.
    • Para Log Analytics Workspace, selecciona un espacio de trabajo desde el selector de espacio de trabajo, o introduce manualmente el ID de recurso ARM del espacio de trabajo.
    • Para Application Insights, selecciona un recurso de Application Insights desde el selector de recursos, o introduce manualmente el ID de recurso ARM de recurso.

  2. Selecciona una identidad gestionada cuando el conector la solicite.

  3. Continúa con el paso de revisión, clúster o selección de herramientas que muestra el asistente.

La identidad gestionada debe tener acceso de lectura al recurso objetivo. Si las consultas fallan posteriormente con un error de permiso, concede acceso de lectura a esa identidad e intenta la consulta de nuevo.

Paso 3: Configurar herramientas de consulta

En el paso de Configurar herramientas , activa las operaciones que leen telemetría. Las operaciones de consulta son el núcleo de un conector de telemetría, así que selecciona las operaciones run-query o search. Deja las operaciones administrativas deshabilitadas a menos que las necesites.

Configura cada operación de lectura en Permitir para que el agente pueda responder preguntas sin pausar. Si activas alguna operación que cambie datos, configúrala en Preguntar.

Para Azure Data Explorer a través de Azure MCP, el asistente incluye un paso de grupo de clúster y otro de revisión con pruebas de conexión. Configura los grupos del clúster, prueba la conectividad y guarda el conector. El conjunto de herramientas Kusto se gestiona mediante la ruta Kusto MCP de Azure.

Sugerencia

Mantén el conjunto habilitado pequeño. Un conector de telemetría normalmente solo necesita sus operaciones de consulta. Menos herramientas significa que el agente elige la adecuada de forma más fiable y se mantiene dentro del presupuesto de 80 herramientas.

Paso 4: Validar con una pregunta

  1. Abre un chat con tu agente.

  2. Haz una pregunta que requiera tu telemetría. Por ejemplo:

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

  3. Observa la respuesta. Una tarjeta de herramienta muestra al agente seleccionar la herramienta de consulta del conector y ejecutar la consulta, seguida de una respuesta basada en tu telemetría.

Cuando ves un recuento real de tu propia fuente en lugar de una explicación general, el conector funciona de extremo a extremo.

Troubleshooting

Problema Causa Corregir
La consulta devuelve "No autorizado" o "Prohibido" La identidad de conexión carece de acceso de lectura Concede acceso a la lectura de identidad al recurso objetivo y luego vuelve a intentarlo.
La consulta devuelve "no encontrado" Nombre incorrecto de espacio de trabajo, clúster, base de datos o tabla Confirma el nombre exacto en el servicio. Los nombres distinguen entre mayúsculas y minúsculas.
El conector de terceros no puede conectarse El valor de la URL, token o encabezado está mal Confirma los valores con tu administrador de observabilidad y actualiza el conector.
La respuesta es genérica y no aparece ninguna tarjeta de herramientas La pregunta no requería tu telemetría Reformula para que la pregunta necesite tu telemetría, como "cuenta las solicitudes fallidas en el servicio X para el último día."
Conector guardado pero no se devolvió la telemetría Resultado vacío o filtrado Amplía el rango de tiempo en tu pregunta, o confirma que la fuente tiene telemetría reciente.

Contenido relacionado

  • Last updated on