Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Viktigt
Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller har begränsade funktioner. Mer information finns i Supplemental Terms of Use for Microsoft Azure Previews.
Observera
Spårning är allmänt tillgänglig för promptagenter och värdbaserade agenter. Arbetsflödet och externa agenter är i förhandsversion.
Använd spårning för att felsöka dina AI-agenter och övervaka deras beteende i produktion. Spårning samlar in detaljerad telemetri – inklusive svarstid, undantag, fråga efter innehåll och hämtningsåtgärder – så att du kan identifiera och åtgärda problem snabbare.
Den rekommenderade startpunkten är spårning på serversidan. Foundry aktiverar den automatiskt när du har anslutit en Application Insights-resurs till projektet. Inga kodändringar krävs och spårningar är tillgängliga inom några minuter efter aktiveringen. Spårning på serversidan fungerar för alla agenter som finns i Foundry. När du behöver insyn i din egen programkod – till exempel för att spåra anpassad logik kring ett agentanrop – kan du lägga till instrumentering på klientsidan som ett andra steg.
Microsoft Foundry Skill kan hjälpa dig att välja spårning på serversidan eller på klientsidan och felsöka telemetri som saknas.
Förutsättningar
- Ett Foundry-projekt.
- En Azure Monitor Application Insights-resurs för att lagra spårningar (skapa en ny eller ansluta en befintlig).
- Åtkomst till Application Insights-resursen som är ansluten till projektet.
- Rollen Log Analytics Reader på den anslutna Application Insights-resursen (krävs för att fråga telemetri). Om de underliggande Log Analytics tabellerna är skyddade tilldelar du även rollen Privilegierad övervakningsdataläsare.
Ansluta Application Insights till ditt Foundry-projekt
Foundry lagrar spårningar i Application Insights med hjälp av OpenTelemetry-semantiska konventioner.
-
Logga in på Microsoft Foundry. Kontrollera att växlingsknappen New Foundry är aktiverad. De här stegen hänvisar till Foundry (ny).
Öppna ditt Foundry-projekt.
I det vänstra navigeringsfältet väljer du Agenter.
Längst upp väljer du Spårningar.
Till höger väljer du Anslut för att skapa eller ansluta en Application Insights-resurs.
- Om du vill ansluta en befintlig resurs väljer du resursen och väljer sedan Anslut.
- Om du vill skapa en ny resurs väljer du Skapa ny och slutför sedan guiden.
Ett bekräftelsemeddelande visas när anslutningen lyckas.
Använd anslutningssökvägen för projektdetaljer
Om du inte ser meddelandefältet eller knappen Anslut använder du det här alternativa sättet att aktivera Azure Monitor Application Insights.
- Välj Hantera i navigeringen uppe till höger och välj sedan Projektinformation.
- Välj fliken Anslutna resurser och välj sedan Lägg till anslutning.
- I Välj en anslutning väljer du Application Insights.
För Entra-autentiserad spårningsinmatning, se Konfigurera Microsoft Entra autentisering för Foundry Agent-spårningsinmatning (förhandsversion).
När du har anslutit resursen är projektet redo att använda spårning.
Viktigt
Kontrollera att du har de behörigheter som du behöver för att fråga telemetri.
- För loggbaserade frågor börjar du med att tilldela rollen Log Analytics Reader. Om de underliggande Log Analytics tabellerna är skyddade tilldelar du även rollen Privilegierad övervakningsdataläsare.
- Information om hur du tilldelar roller finns i Tilldela Azure roller med hjälp av Azure-portalen.
- Om du vill hantera åtkomst i stor skala använder du Microsoft Entra grupper.
Instrument-AI-agenter
Välj den metod som matchar hur du skapar och kör din agent.
Servrars spårning i Foundry-portalen
Börja med spårning på serversidan. Foundry loggar spårningar för vanliga agent- och arbetsflödesscenarier utan att ändra din kod.
- Foundry loggar automatiskt spårningar på serversidan för prompt-agenter, värd-agenter och arbetsflöden i Foundry-portalen. När spårning har aktiverats i ditt Foundry-projekt har du åtkomst till färdiga spårningar under de senaste 90 dagarna.
- Foundry har också stöd för enkel integrering med de främsta agentramverken.
Spårningar på klientsidan med Microsoft Foundry SDK (Python)
Installera OpenTelemetry och Azure SDKs:s spårningsplugin genom att följa stegen nedan:
pip install azure-ai-projects azure-identity opentelemetry-sdk azure-core-tracing-opentelemetry
Referens: azure-ai-projects, azure-core-tracing-opentelemetry
Viktigt
Om du vill använda ett projekts slutpunkt i ditt program måste du konfigurera Microsoft Entra ID. Om du inte konfigurerar Microsoft Entra ID använder du Application Insights-reťazec pripojenia.
När du har kört din agent kan du visa och analysera spårningar i Foundry-portalen.
Detaljerade instruktioner och SDK-specifika kodexempel finns i Spårning med azure-ai-projects (Python SDK) och Telemetry-exempel för agenter.
Spåra lokalt med Microsoft Foundry Toolkit för Visual Studio Code-tillägget
Med Microsoft Foundry Toolkit for Visual Studio Code-tillägget kan du spåra lokalt i VS Code med hjälp av en lokal OTLP-kompatibel insamlare. Den här metoden är perfekt för utveckling och felsökning.
Verktygslådan stöder AI-ramverk som Foundry Agent Service, OpenAI, Anthropic och LangChain via OpenTelemetry. Du kan se spårningar direkt i VS Code utan att behöva molnåtkomst.
Detaljerade installationsinstruktioner och SDK-specifika kodexempel finns i Spårning i Foundry Toolkit.
Visa och analysera spårningar
Visa spårningar i Foundry-portalen
I ditt Foundry-projekt går du till fliken Spårningar i dina agenter eller arbetsflöden. Du kan söka, filtrera eller sortera inmatade spårningar från de senaste 90 dagarna.
Välj en spårning för att gå igenom varje intervall, identifiera problem och se hur programmet svarar. Den här processen hjälper dig att felsöka och hitta problem i ditt program.
Visa spårningar i Azure Monitor
Dina spårningar skickas till Azure Monitor Application Insights, så att du kan visa dem där.
Mer information om hur du skickar spårningar till Azure Monitor och skapar en Azure Monitor resurs finns i Azure Monitor OpenTelemetry-dokumentation.
Visa konversationsresultat
En konversation är den beständiga kontexten för en dialoghistorik från slutpunkt till slutpunkt mellan en användare och en agent. I Foundry-portalen kan du se konversationsresultat för din agent direkt, tillsammans med spår på sidan Spår.
Sök efter svars-ID eller ett spårnings-ID som mappar till den här konversationen. Välj sedan ett konversations-ID att granska:
- Information om konversationshistorik
- Svarsinformation och tokens i en körning
- Ordnade åtgärder, körsteg och verktygsanrop
- Indata och utdata mellan en användare och en agent
Kontrollera att spårning fungerar
Bekräfta att projektet är anslutet till Application Insights. Om det behövs följer du stegen i Anslut Application Insights till ditt Foundry-projekt.
Kör din agent eller ditt arbetsflöde minst en gång (till exempel med hjälp av portalen eller din app).
I ditt Foundry-projekt öppnar du vyn Spårningar och bekräftar att en ny spårning visas.
När spårningen fungerar korrekt visas en lista över de senaste spårningarna med tidsstämplar, varaktigheter och statusindikatorer. Välj ett spår för att visa dess spanninformation.
Om du inte ser nya spårningar väntar du några minuter och uppdaterar och läser sedan Felsökning.
Säkerhet och sekretess
Spårning kan samla in känslig information, till exempel användarindata, modellutdata och verktygsargument och resultat. Använd dessa metoder för att minska risken:
- Lagra inte hemligheter, autentiseringsuppgifter eller token i prompter, verktygsargument eller span-attribut.
- Redigera eller minimera personliga data och annat känsligt innehåll innan de visas i telemetri.
- Behandla spårningsdata som produktionstelemetri och tillämpa samma åtkomstkontroller och kvarhållningsprinciper som du använder för loggar och mått.
Mer information finns i Säkerhet och sekretess.
Datakvarhållning och kostnad
Foundry lagrar spårningar i Application Insights-resursen som är ansluten till projektet. Datakvarhållning och fakturering följer din Application Insights- och Log Analytics-konfiguration.
Felsökning
| Frågan | Orsak | Upplösning |
|---|---|---|
| Du ser inga spårningar i Foundry-portalen | Spårningen är inte ansluten, det finns ingen ny trafik eller inmatningen fördröjs | Bekräfta Application Insights-anslutningen, generera ny agenttrafik och uppdatera efter några minuter. |
| Du ser auktoriseringsfel när du frågar eller visar telemetri | RBAC-behörigheter saknas för Application Insights eller Log Analytics | Bekräfta åtkomsten i Åtkomstkontroll (IAM) för de anslutna resurserna. För loggfrågor tilldelar du rollen Log Analytics Reader. Om tabellerna är skyddade tilldelar du även Privileged Monitoring Data Reader. |
| Spårningar på klientsidan visas inte | Instrumentation är inte installerad eller konfigurerad | Kontrollera paketinstallationen igen och följ SDK-vägledningen som är länkad i Client-side traces med Microsoft Foundry SDK (Python). |
| Känsligt innehåll visas i spårningar | Prompter, verktygsargument eller utdata innehåller känsliga data | Redigera känsliga data innan de går in i telemetrin och följ anvisningarna i Säkerhet och sekretess. |
Relaterat innehåll
Nu när du har konfigurerat spårning kan du utforska dessa resurser för att fördjupa din förståelse och utöka dina observerbarhetsfunktioner: