Koppla en telemetrikälla

Koppla en telemetrikälla för att förankra din agents svar i dina egna signaler, inte allmän kunskap. Efter att du har satt upp en telemetrikoppling, ställ en undersökningsfråga på ett enkelt språk. Agenten kör frågan och svarar med riktiga siffror.

Denna handledning täcker kontakter i kategorin telemetri. Azure Data Explorer använder Azure MCP Kusto-path. Tredjeparts telemetrikontakter visas också i telemetrifliken , även när de använder MCP bakom kulisserna. Uppsättningen använder samma guide som varje hanterad koppling, så den här artikeln fokuserar på telemetridetaljer: hur källor autentiseras, vilka operationer som ska aktiveras och hur man validerar med en fråga.

Viktigt!

Hanterade kopplingar är i förhandsvisning. Tillgänglighet, fält och operationer i anslutningar kan förändras.

Prerequisites

  • En pågående SRE-agent och tillgång till sre.azure.com.
  • Behörighet att konfigurera kontakter på agenten.
  • Läs tillgång till telemetrikällan du kopplar upp. För en Azure-källkod behöver identiteten som auktoriserar anslutningen minst läsåtkomst till målresursen.

Om du inte har satt upp en kontakt tidigare, börja med Sätt upp en hanterad kontakt för hela guidens genomgång. Den här artikeln lyfter endast fram skillnaderna i telemetrikällor.

Telemetrikontakter

Anslutning Tjänst Authentication Typisk användning
Azure Data Explorer (via Azure MCP) Azure Data Explorer (Kusto) Hanterad identitet Kör KQL-frågor mot ADX-kluster
Log Analytics-arbetsyta Logganalys Hanterad identitet Sök i arbetsytloggar i skrivskyddat läge
Application Insights Application Insights Hanterad identitet Sökapplikationstelemetri i skrivskyddat läge
Datadog Datadog Tjänsteuppgifter visas av kontakten Sök på mätvärden, loggar och övervakar
Elasticsearch Elasticsearch Tjänsteuppgifter visas av kontakten Sökloggar och indexerad telemetri
Dynatrace Dynatrace Tjänsteuppgifter visas av kontakten Sök på observerbarhetsdata och spår
Ny relik Ny relik Tjänsteuppgifter visas av kontakten Frågetelemetri och incidenter
Splunk Splunk Tjänsteuppgifter visas av kontakten Sök i Splunk-loggar och händelser
Hawkeye (NeuBird) Hawkeye av NeuBird Tjänsteuppgifter visas av kontakten Sök AI-drivna observabilitetsdata

Tredjepartstelemetrikopplingar inkluderar standard-URL, autentisering och header-tips för att hjälpa dig konfigurera anslutningen.

Du kan också lägga till en annan telemetrikälla via en användaransluten kontakt. Använd detta alternativ när ditt team har ett anpassat verktyg eller en källa som inte finns med i connector-väljaren.

Steg 1: Lägg till kontakten

  1. Gå till sre.azure.com och välj din agent.

  2. I vänstra sidofältet, expandera Byggare och välj sedan Connectors.

  3. Välj Lägg till anslutning.

  4. Välj fliken Telemetri och välj sedan din telemetrikälla. För Azure Data Explorer, välj Azure Data Explorer, som använder Azure MCP Kusto-vägen.

Steg 2: Autentisera

For Azure telemetry connectors:

  1. Fyll i fälten som visas av kontakten.

    • För Azure Data Explorer, namnge connectorn, välj den hanterade identitet som agenten använder för att fråga Kusto, och lägg sedan till en eller flera klustergrupper med kluster-URL:er.
    • För Log Analytics Workspace, välj en arbetsplats från workspace-pickern eller ange workspace ARM-resource ID manuellt.
    • För Application Insights, välj en Application Insights-resurs från resursväljaren eller ange resurs-ARM-ID:t manuellt.

  2. Välj en hanterad identitet när kopplaren ber om en.

  3. Fortsätt till gransknings-, klustret eller verktygsvalssteget som visas av guiden.

Den hanterade identiteten måste ha läsåtkomst till målresursen. Om frågor senare misslyckas med ett behörighetsfel, ge läsåtkomst till den identiteten och försök förfrågan igen.

Steg 3: Sätt upp frågeverktyg

I steget Konfigurera verktyg, aktivera operationerna som läser telemetri. Frågeoperationer är kärnan i en telemetrikoppling, så välj kör-fråga- eller sökoperationer. Låt administrativa operationer vara avstängda om du inte behöver dem.

Ställ in varje läsoperation på Tillåt så att agenten kan svara på frågor utan paus. Om du aktiverar någon operation som ändrar data, ställ in den på Fråga.

För Azure Data Explorer via Azure MCP inkluderar guiden ett klustergruppsteg och ett granskningssteg med anslutningstestning. Konfigurera klustergrupperna, testa anslutningen och spara kontakten. Kusto-verktygsuppsättningen hanteras av Azure MCP Kusto-vägen.

Tips

Håll den aktiverade uppsättningen liten. En telemetrikoppling behöver vanligtvis bara sina frågeoperationer. Färre verktyg innebär att agenten väljer rätt mer pålitligt och håller sig inom budgeten på 80 verktyg.

Steg 4: Bekräfta med en fråga

  1. Öppna en chatt med din agent.

  2. Ställ en fråga som kräver din telemetri. Ett exempel:

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

  3. Titta på responsen. Ett verktygskort visar att agenten väljer kopplarens frågeverktyg och kör frågan, följt av ett svar baserat på din telemetri.

När du ser en riktig räkning från din egen källa istället för en allmän förklaring, fungerar kontakten från början till ände.

Troubleshooting

Problem Cause Reparera
Sökningen ger "Obehörig" eller "Förbjuden" Anslutningsidentiteten saknar läsåtkomst Ge identitetsläsbehörighet till målresursen, försök sedan igen.
Sökfrågan ger "ej hittad" Fel arbetsyta, kluster, databas eller tabellnamn Bekräfta det exakta namnet i tjänsten. Namnen är skiftlägeskänsliga.
Tredjepartskontakt kan inte ansluta URL, token eller headervärde är fel Bekräfta värdena med din observabilitetsadministratör och uppdatera kopplingen.
Svaret är generiskt och inget verktygskort visas Frågan krävde inte din telemetri Omformulera så att frågan behöver din telemetri, till exempel "räkna de misslyckade förfrågningarna i tjänst X för sista dagen."
Kontakten sparad men ingen telemetri returnerades Tomt eller filtrerat resultat Vidga tidsintervallet i din fråga, eller bekräfta att källan har nyligen telemetri.

Relaterat innehåll

  • Last updated on