Collega una sorgente di telemetria

Collega una fonte di telemetria per basare le risposte del tuo agente sui tuoi segnali, non sulle culture generali. Dopo aver configurato un connettore di telemetria, fai una domanda investigativa in modo chiaro. L'agente esegue la query e risponde con numeri reali.

Questo tutorial copre i connettori nella categoria Telemetria . Esplora dati di Azure usa il percorso Azure MCP Kusto. I connettori di telemetria di terze parti appaiono anche nella scheda Telemetria , anche quando usano MCP dietro le quinte. La configurazione utilizza lo stesso assistente di ogni connettore gestito, quindi questo articolo si concentra sui dettagli della telemetria: come le sorgenti si autenticano, quali operazioni abilitare e come validare con una query.

Importante

I connettori gestiti sono in anteprima. La disponibilità dei connettori, i campi e le operazioni possono cambiare.

Prerequisiti

• Un agente SRE in esecuzione e accesso a sre.azure.com.
• Permesso di configurare i connettori sull'agente.
• Leggi l'accesso alla sorgente di telemetria che stai collegando. Per una sorgente Azure, l'identità che autorizza la connessione necessita almeno di accesso di lettura alla risorsa di destinazione.

Se non hai mai configurato un connettore prima, inizia con Configura un connettore gestito per la guida completa del wizard. Questo articolo evidenzia solo le differenze nella fonte di telemetria.

Connettori di telemetria

Connettore	Servizio	Authentication	Uso tipico
Esplora dati di Azure (via Azure MCP)	Esplora dati di Azure (Kusto)	Identità gestita	Esegui query KQL contro cluster ADX
Area di lavoro Log Analytics	Log Analytics	Identità gestita	Consulta i log dello spazio di lavoro in modalità di sola lettura
Application Insights	Application Insights	Identità gestita	Consulta la telemetria dell'applicazione in modalità di sola lettura
Cane dati	Cane dati	Credenziali di servizio mostrate dal connettore	Metriche di interrogazione, log e monitor
Elasticsearch	Elasticsearch	Credenziali di servizio mostrate dal connettore	Registri di ricerca e telemetria indicizzata
Dynatrace	Dynatrace	Credenziali di servizio mostrate dal connettore	Dati di osservabilità e tracce per query
New Relic	New Relic	Credenziali di servizio mostrate dal connettore	Telemetria e incidenti di interruzione
Splunk	Splunk	Credenziali di servizio mostrate dal connettore	Cerca nei log e negli eventi Splunk
Occhio di Falco (NeuBird)	Hawkeye di NeuBird	Credenziali di servizio mostrate dal connettore	Consulta i dati di osservabilità alimentati dall'IA

I connettori di telemetria di terze parti includono URL predefiniti, autenticazione e suggerimenti per l'intestazione per aiutarti a configurare la connessione.

Puoi anche aggiungere un'altra sorgente di telemetria tramite un connettore fornito dall'utente. Usa questa opzione quando il tuo team ha uno strumento personalizzato o una sorgente che non è elencata nel connector picker.

Passo 1: Aggiungi il connettore

1. Passare a sre.azure.com e selezionare l'agente.

2. Nella barra laterale sinistra, espandi Builder e poi seleziona Connectors.

3. Selezionare Aggiungi connettore.

4. Seleziona la scheda Telemetria , poi scegli la tua sorgente di telemetria. Per Esplora dati di Azure, seleziona Esplora dati di Azure, che utilizza il percorso Azure MCP Kusto.

Passo 2: Autenticazione

Azure telemetry sources

Per Azure telemetry connectors:

1. Completa i campi mostrati dal connettore.

   • Per Esplora dati di Azure, si nomina il connettore, seleziona l'identità gestita che l'agente usa per interrogare Kusto, e poi aggiungi uno o più gruppi di cluster con URL di cluster.
   • Per Log Analytics Workspace, seleziona uno spazio di lavoro dal selezionatore di workspace oppure inserisci manualmente l'ID risorsa ARM dello spazio di lavoro.
   • Per Application Insights, seleziona una risorsa Application Insights dal selezionatore di risorse, oppure inserisci manualmente l'ID risorsa ARM.

2. Seleziona un'identità gestita quando il connettore ne chiede una.

3. Continua con il passaggio di revisione, cluster o selezione degli strumenti mostrato dal wizard.

L'identità gestita deve avere accesso in lettura alla risorsa target. Se le query falliscono successivamente con un errore di permesso, concedi l'accesso in lettura a quell'identità e riprova la query.

Fonti di telemetria di terze parti

Per connettori di telemetria di terze parti e connettori forniti dall'utente:

1. Rivedi l'URL, l'autenticazione e i campi di header mostrati dal connettore.

2. Inserisci i valori richiesti per il tuo servizio di telemetria.

3. Selezionare Connetti.

I connettori di terze parti includono predefiniti e suggerimenti. Il tuo servizio potrebbe comunque richiedere un URL del tenant, un token API o un valore di header personalizzato dall'amministratore dell'osservabilità.

Passo 3: Configura strumenti di query

Nel passaggio Configura strumenti , abilita le operazioni che leggono la telemetria. Le operazioni di query sono il nucleo di un connettore di telemetria, quindi seleziona le operazioni run-query o di ricerca. Lascia le operazioni amministrative disabilitate a meno che tu non ne abbia bisogno.

Imposta ogni operazione di lettura su Permetti , così l'agente può rispondere alle domande senza fermarsi. Se abiliti un'operazione che modifica dati, impostala su Demand.

Per Esplora dati di Azure tramite Azure MCP, il wizard include un passaggio di gruppo cluster e un passaggio di revisione con test di connessione. Configura i gruppi del cluster, testa la connettività e salva il connettore. Il set di strumenti Kusto è gestito dal percorso Kusto Azure MCP.

Suggerimento

Mantieni il set abilitato piccolo. Un connettore di telemetria di solito necessita solo delle sue operazioni di interrogazione. Meno strumenti significa che l'agente sceglie quello giusto in modo più affidabile e rimane entro il budget di 80 strumenti.

Passo 4: Convalida con una domanda

1. Apri una chat con il tuo agente.

2. Fai una domanda che richieda la tua telemetria. Per esempio:

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

3. Guarda la risposta. Una scheda strumento mostra l'agente selezionare lo strumento di query del connettore ed eseguire la query, seguita da una risposta basata sulla tua telemetria.

Quando vedi un conteggio reale dalla tua stessa fonte invece di una spiegazione generale, il connettore funziona da capo a capo.

Troubleshooting

Problema	Cause	Correzione
La query restituisce "Non autorizzato" o "Proibito"	L'identità della connessione non offre accesso di lettura	Concedi alla lettura identità l'accesso alla risorsa target, poi riprova.
La query restituisce "non trovato"	Nome sbagliato dello spazio di lavoro, cluster, database o tabella	Conferma il nome esatto nel servizio. I nomi sono sensibili alla distinzione tra maiuscole e minuscole.
Il connettore di terze parti non può collegarsi	URL, token o valore di header è sbagliato	Conferma i valori con il tuo amministratore di osservabilità e aggiorna il connettore.
La risposta è generica e non appare nessuna scheda degli strumenti	La domanda non richiedeva la tua telemetria	Riformula in modo che la domanda richieda la tua telemetria, ad esempio "conta le richieste fallite nel servizio X per l'ultimo giorno."
Connettore salvato ma nessuna telemetria restituita	Risultato vuoto o filtrato	Allarga l'intervallo temporale della tua domanda, oppure conferma che la fonte ha telemetria recente.

Contenuti correlati

• Collega un servizio di codice sorgente
• Collega un servizio di notifica
• Configura un connettore gestito