Konfigurera spårning i Microsoft Foundry

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 endast för promptagenter. Arbetsflöden, värdbaserade och anpassade agenter finns 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.

Förutsättningar

Ansluta Application Insights till ditt Foundry-projekt

Foundry lagrar spårningar i Application Insights med hjälp av OpenTelemetry-semantiska konventioner.

  1. Logga in på Microsoft Foundry. Kontrollera att växlingsknappen New Foundry är aktiverad. De här stegen hänvisar till Foundry (ny).
  2. Öppna ditt Foundry-projekt.
  3. I det vänstra navigeringsfältet väljer du Agenter.
  4. Längst upp väljer du Spårningar.
  5. 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 guiden.

Skärmbild av fliken Agenter som visar spårningar och knappen Anslut.

Ett bekräftelsemeddelande visas när anslutningen lyckas.

När du har anslutit resursen är projektet redo att använda spårning.

Om du inte ser meddelandefältet eller knappen Anslut, här är ett alternativt sätt att aktivera Azure Monitor Application Insights.

  1. Välj Projektdetaljer från listrutan under ditt projektnamn. Skärmbild av projektnamnsmenyn med projektinformation markerad.
  2. Gå till fliken Anslutna resurser och välj sedan Lägg till anslutning. Skärmbild av projektinformation med fliken Anslutna resurser markerad för att lägga till anslutning.
  3. Välj Application Insights på menyn Välj en anslutning . Skärmbild av Välj en anslutning med Application Insights markerat.

Viktigt

Kontrollera att du har de behörigheter som du behöver för att fråga telemetri.

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 möjliggör också enkel integrering med de främsta agentramverken.

Spårningar på klientsidan med Microsoft Foundry SDK (Python)

Installera OpenTelemetry och Azure SDKs-spårningsplugin genom att använda:

pip install azure-ai-projects azure-identity opentelemetry-sdk azure-core-tracing-opentelemetry

Viktigt

Om du använder ett projekts slutpunkt i programmet 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 börja 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 Foundry Toolkit i VS Code

Med Foundry Toolkit kan du spåra lokalt i VS Code med hjälp av en lokal OTLP-kompatibel insamlare, vilket är idealiskt för utveckling och felsökning.

Verktygslådan stöder AI-ramverk som Foundry Agents 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. Detta 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.

Du kan välja en konversationssökning efter ett svars-ID eller söka efter ett spårnings-ID som mappar till den här konversationen. Välj sedan Konversations-ID för att granska konversationen:

  • 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

Skärmbild av fönstret Konversationsinformation i Foundry som visar ett konversations-ID med en spårningstidslinje och körningsstegsinformation.

Kontrollera att spårning fungerar

  1. 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.

  2. Kör din agent eller ditt arbetsflöde minst en gång (till exempel med hjälp av portalen eller din app).

  3. 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.
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 spårningen har konfigurerats kan du utforska dessa resurser för att fördjupa din förståelse och utöka dina observerbarhetsfunktioner:

  • Last updated on