Dela via


Aspire Utforska instrumentpanelen

I de kommande avsnitten upptäcker du hur du skapar ett Aspire projekt och påbörjar följande uppgifter:

Skärmbilderna som visas i den här artikeln visar det mörka temat. Mer information om temaval finns i Temaval.

Instrumentpanelen Aspire innehåller GitHub även Copilot, din AI-felsökningsassistent, som kan hjälpa dig att analysera resurser, loggar, spårningar och telemetridata. Copilot är tillgängligt när du startar din app från VS Code eller Visual Studio med ett GitHub konto som har en Copilot-prenumeration. Fullständig information finns GitHub i Copilot på Aspire instrumentpanelen.

Instrumentpanelsautentisering

När du kör en Aspire AppHost startar orkestratorn alla appens beroende resurser och öppnar sedan ett webbläsarfönster på instrumentpanelen. Instrumentpanelen Aspire kräver tokenbaserad autentisering för sina användare eftersom den visar miljövariabler och annan känslig information.

När instrumentpanelen startas från Visual Studio eller Visual Studio Code (med C# Dev Kit-tillägget) loggas webbläsaren automatiskt in och instrumentpanelen öppnas direkt. Det här är den typiska F5-upplevelsen för utvecklare och autentiseringsinloggningsflödet automatiseras av verktygen Aspire .

Men om du startar AppHost från kommandoraden visas inloggningssidan. Konsolfönstret visar en URL som du kan välja på för att öppna instrumentpanelen i webbläsaren.

.NET CLI kör kommandoutdata som visar inloggnings-URL:en med tokenfrågesträngen.

URL:en innehåller en tokenfrågesträng (med tokenvärdet mappat till t namndelen) som används för att logga in på instrumentpanelen. Om konsolen stöder det kan du hålla ned Ctrl-tangenten och sedan välja länken för att öppna instrumentpanelen i webbläsaren. Den här metoden är enklare än att kopiera token från konsolen och klistra in den på inloggningssidan. Om du hamnar på instrumentpanelens inloggningssida utan någon av de tidigare beskrivna metoderna kan du alltid gå tillbaka till konsolen för att kopiera token.

Aspire inloggningssida för instrumentpanelen.

Inloggningssidan accepterar en token och innehåller användbara instruktioner för hur du hämtar token, enligt följande skärmbild:

Aspire instrumentpanelsinloggningssida med instruktioner om hur du hämtar token.

När du har kopierat token från konsolen och klistrat in den på inloggningssidan väljer du knappen Logga in .

Aspire instrumentpanelsinloggningssida med token inklistrade i textrutan.

Instrumentpanelen bevarar token som en webbläsarbeständig cookie, som förblir giltig i tre dagar. Beständiga cookies har ett förfallodatum och är giltiga även efter att webbläsaren har stängts. Det innebär att användarna inte behöver logga in igen om de stänger och öppnar webbläsaren igen. Mer information finns i Säkerhetsöverväganden för att köra dokumentationen för Aspire instrumentpanelen .

Tip

Du kan också hämta inloggningstoken från containerloggarna. Mer information finns i Logga in på instrumentpanelen.

Sidan Resurser

Sidan Resurser är standardstartsidan för Aspire instrumentpanelen. På den här sidan visas alla .NET projekt, containrar och körbara filer som ingår i din Aspire lösning. Startprogrammet innehåller till exempel två projekt:

  • apiservice: Ett serverdels-API-projekt som skapats med minimala API:er.
  • webfrontend: Det klientdelsgränssnittsprojekt som skapats med hjälp av Blazor.

Instrumentpanelen innehåller också viktig information om varje resurs:

  • Typ: Visar om resursen är ett projekt, en container eller en körbar fil.
  • Namn: Namnet på resursen.
  • Tillstånd: Visar om resursen körs eller inte.
    • Fel: I kolumnen Tillstånd visas fel som ett märke med antalet fel. Det är användbart att snabbt förstå vilka resurser som rapporterar fel. Om du väljer märket kommer du till semantikloggarna för resursen med filtret på felnivå.
  • Starttid: När resursen började köras.
  • Källa: Platsen för resursen på enheten.
  • Slutpunkter: En eller flera URL:er för att nå den resurs som körs direkt.
  • Loggar: En länk till resursloggsidan.
  • Åtgärder: En uppsättning åtgärder som kan utföras på resursen:
    • Stoppa/Starta: Stoppa (eller Starta) resursen beroende på aktuell tillstånd.
    • Konsolloggar: Navigera till resursens konsolloggar.
    • Ellips: En undermeny med extra resursspecifika åtgärder:
      • Visa information: Visa resursinformationen.
      • Konsollogg: Navigera till resursens konsolloggar.
      • Strukturerade loggar: Navigera till resursens strukturerade loggar.
      • Spårningar: Navigera till resursens spårningar.
      • Mått: Navigera till resursens mått.
      • Starta om: Stoppa och starta sedan resursen.

Överväg följande skärmbild av resurssidan:

En skärmbild av sidan Resurser på Aspire instrumentpanelen.

Du kan också visa resurserna som ett diagram. Diagramvyn ger en visuell representation av resurserna och deras beroenden. Den här vyn är användbar för att förstå hur de olika resurserna i appen är anslutna och hur de interagerar med varandra:

En skärmbild av sidan Resurser på Aspire instrumentpanelen i grafvyn.

Du kan interagera med diagrammet genom att välja en resurs för att visa dess information. Den övergripande vyn stöder också in- och utzoomning.

Resursåtgärder

Varje resurs har en uppsättning tillgängliga åtgärder som är villkorligt aktiverade baserat på resursens aktuella tillstånd. Om en resurs till exempel körs aktiveras åtgärden Stoppa . Om resursen stoppas aktiveras startåtgärden . På samma sätt inaktiveras vissa åtgärder när de inte är tillgängliga, till exempel att vissa resurser inte har strukturerade loggar. I dessa situationer inaktiveras åtgärden Strukturerade loggar .

Stoppa eller starta en resurs

På Aspire instrumentpanelen kan du stoppa eller starta en resurs genom att välja knappen Stoppa eller Starta i kolumnen Åtgärder . Överväg följande skärmbild av resurssidan med knappen Stoppa markerad:

Aspire instrumentpanelens stoppresurs.

När du väljer Stoppa slutar resursen att köras och kolumnen Tillstånd uppdateras för att återspegla ändringen.

Note

När felsökaren är ansluten för projektresurser kopplas den på nytt vid omstart.

Knappen Start aktiveras sedan så att du kan starta resursen igen. Dessutom visar instrumentpanelen ett popup-meddelande om resultatet av åtgärden:

Aspire instrumentpanelens resurs har stoppats.

När en resurs är i ett tillstånd som inte körs aktiveras startknappen . Om du väljer Starta startas resursen och kolumnen Tillstånd uppdateras för att återspegla ändringen. Knappen Stoppa aktiveras sedan så att du kan stoppa resursen igen. Instrumentpanelen visar ett popup-meddelande om resultatet av åtgärden:

Aspire instrumentpanelen startade resursen.

Tip

Resurser som är beroende av andra resurser som stoppas eller startas om kan uppleva tillfälliga fel. Detta är ett förväntat beteende och löses vanligtvis när de beroende resurserna är i ett körningstillstånd igen.

Resursundermenyåtgärder

Om du väljer den vågräta ellipsikonen i kolumnen Åtgärder öppnas en undermeny med ytterligare resursspecifika åtgärder. Förutom de inbyggda resursundermenyåtgärderna kan du också definiera anpassade resursåtgärder genom att definiera anpassade kommandon. Mer information finns i Anpassade resurskommandon i Aspire. Tänk på följande skärmbild för de inbyggda resursundermenyåtgärderna:

Aspire instrumentpanelsresursundermenyåtgärder.

Följande undermenyåtgärder är tillgängliga:

  • Visa information: Visa resursinformationen.
  • Konsollogg: Navigera till resursens konsolloggar.
  • Strukturerade loggar: Navigera till resursens strukturerade loggar.
  • Spårningar: Navigera till resursens spårningar.
  • Mått: Navigera till resursens mått.
  • Starta om: Stoppa och starta sedan resursen.

Important

Det kan finnas resurser med inaktiverade undermenyåtgärder. De är nedtonade när de är inaktiverade. Följande skärmbild visar till exempel inaktiverade undermenyåtgärder:

Aspire instrumentpanelen inaktiverade undermenyåtgärder.

När GitHub Copilot är tillgängligt (när du startar från VS Code eller Visual Studio med en Copilot-prenumeration) innehåller resurskontextmenyerna även alternativet Fråga GitHub Copilot . På så sätt kan du undersöka resurser med hjälp av AI-analys.

Kopiera eller öppna i textvisualiserare

Om du vill visa en textvisualiserare för vissa kolumner visas en lodrät ellipsikon vid hovring. Välj ikonen för att visa tillgängliga alternativ:

  • Kopiera till Urklipp
  • Öppna i

Överväg följande skärmbild av alternativen på ellipsmenyn:

En skärmbild av sidan Resurser på Aspire instrumentpanelen som visar alternativen på ellipsmenyn.

När du väljer alternativet Öppna i textvisualiserare öppnas en modal dialogruta med texten som visas i ett större format. Överväg följande skärmbild av dialogrutan för ändring av textvisualiseraren:

En skärmbild av sidan Resurser på Aspire instrumentpanelen som visar textvisualiseraren.

Vissa värden formateras som JSON eller XML. I dessa fall gör textvisualiseraren att listrutan Välj format kan växla mellan de olika formaten.

Resursinformation

Du kan få fullständig information om varje resurs genom att välja ellipsknappen i kolumnen Åtgärder och sedan välja Visa information. Sidan Information innehåller en omfattande vy över resursen:

En skärmbild av sidan Resurser på Aspire instrumentpanelen med information om en vald resurs som visas.

Sökfältet längst upp till höger på instrumentpanelen ger också möjlighet att filtrera listan, vilket är användbart för Aspire projekt med många resurser. Om du vill välja vilka typer av resurser som visas kan du släppa pilen till vänster om textrutan filter:

En skärmbild av listan med resurstypsväljare på sidan Resurser på Aspire instrumentpanelen.

I det här exemplet visas endast containrar i listan. Om du till exempel aktiverar Använd Redis för cachelagring när du skapar ett Aspire projekt bör du se en Redis container i listan:

En skärmbild av sidan Resurser på Aspire instrumentpanelen filtrerad för att endast visa containrar.

Körbara filer är fristående processer. Du kan konfigurera ett Aspire projekt att köra en fristående körbar fil under starten, men standardmallarna för start innehåller inga körbara filer som standard.

Följande skärmbild visar ett exempel på ett projekt som har fel:

En skärmbild av sidan Resurser på Aspire instrumentpanelen som visar ett projekt med fel.

Om du väljer märket för antal fel navigerar du till sidan Strukturerade loggar med ett filter som används för att endast visa loggarna som är relevanta för resursen:

En skärmbild av Aspire sidan Strukturerade loggar på instrumentpanelen som visar ett filter som tillämpas för att endast visa loggarna som är relevanta för resursen.

Om du vill se loggposten i detalj för felet väljer du knappen Visa för att öppna ett fönster under listan med information om den strukturerade loggposten:

En skärmbild av sidan Strukturerade loggar på Aspire instrumentpanelen som visar ett lägre fönster med information om den strukturerade loggposten.

Mer information och exempel på strukturerade loggar finns på sidan Strukturerade loggar avsnittet.

Note

Resurssidan är inte tillgänglig om instrumentpanelen startas utan en konfigurerad resurstjänst. Instrumentpanelen startar på sidan Strukturerade loggar i stället. Detta är standardupplevelsen när instrumentpanelen körs i fristående läge utan ytterligare konfiguration.

Mer information om hur du konfigurerar en resurstjänst finns i Instrumentpanelskonfiguration.

Övervakningssidor

Instrumentpanelen Aspire innehåller olika sätt att visa loggar, spårningar och mått för din app. Med den här informationen kan du spåra appens beteende och prestanda och diagnostisera eventuella problem som uppstår.

Sidan Konsolloggar

Sidan Konsolloggar visar text som varje resurs i din app har skickat till standardutdata. Loggar är ett användbart sätt att övervaka hälsotillståndet för din app och diagnostisera problem. Loggar visas på olika sätt beroende på källan, till exempel projekt, container eller körbar fil.

När du öppnar sidan Konsolloggar måste du välja en källa i listrutan Välj en resurs.

Om du väljer ett projekt återges liveloggarna med en stiliserad uppsättning färger som motsvarar loggens allvarlighetsgrad. grön för information som exempel. Överväg följande exempel på skärmbild av projektloggar med det apiservice projektet valt:

En skärmbild av sidan Konsolloggar på Aspire instrumentpanelen med en vald källa.

När fel inträffar är de formaterade i loggarna så att de är lätta att identifiera. Överväg följande exempel på skärmbild av projektloggar med fel:

En skärmbild av sidan Konsolloggar på Aspire instrumentpanelen som visar loggar med fel.

Om du väljer en container eller körbar fil skiljer sig formateringen från ett projekt, men utförlig beteendeinformation är fortfarande tillgänglig. Tänk dig följande exempel på en skärmbild av en containerlogg med den cache containern vald:

En skärmbild av sidan konsolloggar på Aspire instrumentpanelen med en containerkälla vald.

Du kan ladda ned valfri konsollogg till din lokala dator och använda de textprogram du föredrar för att analysera den:

En skärmbild av sidan konsolloggar på Aspire instrumentpanelen som visar hur du laddar ned en logg till den lokala datorn.

Resursrepliker

När projektresurser replikeras med hjälp av WithReplicas-API:et representeras de i resursväljaren under en resurspost på den översta nivån med en ikon som indikator. Varje replikerad resurs visas under resursposten på den översta nivån med motsvarande unika namn. Tänk dig följande exempel på en skärmbild av en replikerad projektresurs:

Aspire instrumentpanel: Resursväljare för konsolloggar med kapslade replikresurser.

Föregående skärmbild visar projektet catalogservice (application) med två repliker, catalogservice-2bpj2qdq6k och catalogservice-6ljdin0hc0. Varje replik har en egen uppsättning loggar som kan visas genom att välja repliknamnet.

Sidan Strukturerade loggar

Aspire konfigurerar automatiskt dina projekt med loggning med hjälp av OpenTelemetry. Gå till sidan Strukturerade loggar för att visa semantiska loggar för projektet Aspire . semantisk eller strukturerad loggning gör det enklare att lagra och köra frågor mot logghändelser, eftersom log-event-meddelandemallen och meddelandeparametrarna bevaras, i stället för att bara omvandla dem till ett formaterat meddelande. Du ser en ren struktur för de olika loggar som visas på sidan med hjälp av kolumner:

  • Resurs: Resursen som loggen kommer från.
  • Nivå: Loggnivån för posten, till exempel information, varning eller fel.
  • Tidsstämpel: Tiden då loggen inträffade.
  • Meddelande: Information om loggen.
  • Spårning: En länk till relevant spårning för loggen, om tillämpligt.
  • Information: Ytterligare information eller metadata om loggposten.

Överväg följande exempel på skärmbild av semantiska loggar:

En skärmbild av sidan semantiska loggar på Aspire instrumentpanelen.

Filtrera strukturerade loggar

Sidan strukturerade loggar innehåller också ett sökfält för att filtrera loggarna efter tjänst, nivå eller meddelande. Du använder listrutan Nivå för att filtrera efter loggnivå. Du kan också filtrera efter vilken loggegenskap som helst genom att välja knappen filterikon, vilket öppnar dialogrutan avancerat filter.

Överväg följande skärmbilder som visar dialogrutan för filter för strukturerade loggar:

En skärmbild av Aspire sidan Strukturerade loggar på instrumentpanelen som visar filterdialogrutan.

När GitHub Copilot är tillgängligt och appen har strukturerade loggar med fel visas knappen Förklara fel på sidan strukturerade loggar. Om du väljer det blir alla fel tillgängliga för Copilot för AI-baserad undersökning. Dessutom innehåller strukturerade loggposter alternativet Fråga GitHub Copilot i sina snabbmenyer.

Sidan Spårningar

Gå till sidan Spårningar för att visa alla spårningar för din app. Aspire konfigurerar automatiskt spårning för de olika projekten i din app. Distribuerad spårning är en diagnostikteknik som hjälper tekniker att lokalisera fel och prestandaproblem i program, särskilt sådana som kan distribueras över flera datorer eller processer. Mer information finns i .NET distribuerad spårning. Den här tekniken spårar begäranden via ett program och korrelerar arbete som utförs av olika programintegreringar. Spårningar hjälper också till att identifiera hur lång tid det tog för olika steg i begäran att slutföras. Spårningssidan visar följande information:

  • Tidsstämpel: När spårningen har slutförts.
  • Namn: Namnet på spårningen, prefixet med projektnamnet.
  • Intervall: De resurser som ingår i begäran.
  • Varaktighet: Den tid det tog att slutföra begäran. Den här kolumnen innehåller en radiell ikon som illustrerar varaktigheten för begäran i jämförelse med de andra i listan.

En skärmbild av sidan Spårning av Aspire instrumentpanelen.

Filtrera spårningar

Spårningssidan innehåller också ett sökfält för att filtrera spårningarna efter namn eller intervall. Använd ett filter och observera att spårningsresultaten uppdateras omedelbart. Överväg följande skärmbild av spårningar med ett filter som tillämpas på weather och lägg märke till hur sökordet är markerat i resultaten:

En skärmbild av sidan Spårning av Aspire instrumentpanelen som visar ett filter som tillämpas för att endast visa spårningar med termen

När du filtrerar spårningar i dialogrutan Lägg till filter fylls valet Värde i i förväg med de tillgängliga värdena för den valda parametern när du har valt en parameter och motsvarande Villkor. Överväg följande skärmbild av dialogrutan Lägg till filter med den valda parametern http.route :

En skärmbild av sidan Spårning av Aspire instrumentpanelen som visar dialogrutan Lägg till filter med parametern http.route markerad.

Kombinera telemetri från flera resurser

När en resurs har flera repliker kan du filtrera telemetri för att visa data från alla instanser samtidigt. Välj den överordnade resursen, märkt (application), enligt följande skärmbild:

Filtrera efter alla instanser av en resurs

När du har valt den överordnade resursen visar spårningssidan telemetri från alla instanser av resursen.

Spårningsinformation

Sidan med spårningsinformation innehåller olika detaljer som är relevanta för begäran, inklusive:

  • Spårningsinformation: När spårningen startade.
  • Varaktighet: Den tid det tog att slutföra begäran.
  • Resurser: Antalet resurser som ingår i begäran.
  • Djup: Antalet lager som ingår i begäran.
  • Totalt intervall: Det totala antalet intervall som ingår i begäran.

Varje intervall representeras som en rad i tabellen och innehåller ett Namn. Intervall visar även felikonen om ett fel uppstod inom det specifika intervallet för spårningen. Intervall som har en typ av klient/konsument, men som inte har något intervall på servern, visar en pilikon och sedan måladressen. Detta representerar ett klientanrop till ett system utanför Aspire projektet. Till exempel en HTTP-begäran om ett externt webb-API eller ett databasanrop.

På sidan spårningsinformation finns knappen Visa loggar som tar dig till sidan med strukturerade loggar med ett filter som tillämpas för att endast visa loggarna som är relevanta för begäran. Överväg ett exempel på en skärmbild som visar sidan med strukturerade loggar med ett filter som tillämpas för att endast visa loggarna som är relevanta för spårningen:

En skärmbild av Aspire sidan Strukturerade loggar på instrumentpanelen som visar ett filter som tillämpas för att endast visa loggarna som är relevanta för spårningen.

När GitHub Copilot är tillgängligt innehåller sidan med spårningsinformation även en förklara spårningsknapp som ger ett snabbt sätt att analysera den spårning som visas med AI. Dessutom inkluderar spårningar och enskilda intervall Alternativ för Fråga GitHub Copilot i sina snabbmenyer för detaljerad undersökning.

Sidan strukturerade loggar beskrivs mer detaljerat på sidan Strukturerade loggar avsnittet.

Spårningsexempel

Varje spårning har en färg som genereras för att skilja mellan intervall – en färg för varje resurs. Färgerna återspeglas på både spårningssidan och spårningsinformationssidan. När spårningar visar en pilikon färgas även dessa ikoner för att matcha målspårningens intervall. Tänk dig följande exempel på en skärmbild av spårningar:

En skärmbild av sidan Spårning av Aspire instrumentpanelen.

I kolumnen Åtgärder kan du välja Visa information för att navigera till en detaljerad vy över begäran och hur lång tid den har ägnat åt att resa genom varje programlager. Överväg ett exempel på ett val av en spårning för att visa dess information:

En skärmbild av sidan Spårningsinformation på Aspire instrumentpanelen.

För varje intervall i spårningen väljer du Visa information för att se mer information:

En skärmbild av sidan Spårningsinformation på Aspire instrumentpanelen med information om ett intervall som visas.

Rulla nedåt i spann information smärta för att se fullständig information. Längst ned i fönstret spaninformation visar vissa intervalltyper, till exempel det här anropet till en cache, tidsintervall för händelser:

En skärmbild av sidan Spårningsinformation på Aspire instrumentpanelen med händelsetidsinställningar för ett intervall som visas.

För komplexa spårningar med många intervall använder du textrutan Filter för att endast visa matchande intervall:

En skärmbild av sidan Spårningsinformation på Aspire instrumentpanelen med det filter som används för att endast visa väderintervall.

När det finns fel återger sidan en felikon bredvid spårningsnamnet. Överväg ett exempel på en skärmbild av spårningar med fel:

En skärmbild av sidan Spårning av Aspire instrumentpanelen som visar spårningar med fel.

Och motsvarande detaljerade vy över spårningen med fel:

En skärmbild av sidan Spårningsinformation på Aspire instrumentpanelen som visar en spårning med fel.

Sidan Mått

Gå till sidan Mått för att visa måtten för din app. Aspire konfigurerar automatiskt mått för de olika projekten i din app. Mått är ett sätt att mäta hälsotillståndet för ditt program och kan användas för att övervaka appens prestanda över tid.

Varje måttpubliceringsprojekt i din app har egna mått. Sidan mått visar ett urvalsfönster för varje mätare på den översta nivån och motsvarande instrument som du kan välja för att visa måttet.

Tänk på följande exempel på skärmbilden av måttsidan, där webfrontend projektet är valt och System.Net.Http mätarens http.client.request.duration mått valt:

En skärmbild av Aspire instrumentpanelens måttsida.

Förutom måttdiagrammet innehåller måttsidan ett alternativ för att visa data som en tabell i stället. Överväg följande skärmbild av måttsidan med tabellvyn vald:

En skärmbild av Aspire instrumentpanelens måttsida med tabellvyn markerad.

Under diagrammet finns en lista med filter som du kan använda för att fokusera på de data som intresserar dig. I följande skärmbild filtreras till exempel fältet http.request.method så att endast GET-begäranden visas:

En skärmbild av Aspire instrumentpanelens måttsida med ett filter som tillämpas på diagrammet.

Du kan också välja att välja antalet mått som visas för den lodräta åtkomsten i stället för dess värden:

En skärmbild av Aspire instrumentpanelens måttsida med count-alternativet tillämpat.

Mer information om mått finns i inbyggda mått i .NET.

GenAI-telemetrivisualisering

Instrumentpanelen Aspire innehåller en specialiserad dialogruta för att visa GenAI-telemetridata (Generative AI). Den här funktionen hjälper dig att analysera och förstå AI-relaterade åtgärder i ditt program, inklusive chattavslut, inbäddningar och andra AI-interaktioner.

Följande är en animering som demonstrerar genAI-telemetrivisualiseraren i praktiken:

En animerad skärmbild av Aspire instrumentpanelens GenAI-telemetrivisualiserare i praktiken.

GenAI-telemetrivisualiseraren fungerar bäst när meddelandeinnehåll registreras till telemetri. Utan meddelandeinnehåll visas en anteckning i dialogrutan och en länk till dokumentationen om hur du aktiverar den här funktionen.

Konfigurera inspelning av meddelandeinnehåll

Om du vill få ut mesta möjliga av GenAI-telemetrivisualiseraren konfigurerar du dina AI-integreringar för att registrera meddelandeinnehåll. Den här konfigurationen varierar beroende på vilket AI-klientbibliotek du använder:

Microsoft.Extensions.AI

När du använder Microsoft.Extensions.AI (IChatClient och relaterade abstraktioner) kan du aktivera inspelning av känsliga data genom att konfigurera alternativen för chattklienten. Specifika AI-integreringar som stöder Microsoft.Extensions.AIfinns i deras enskilda dokumentation för den exakta konfigurationssyntaxen. Konfigurationen omfattar vanligtvis att ange en EnableSensitiveData egenskap eller liknande telemetrirelaterat alternativ

Miljövariabelkonfiguration

Många OpenTelemetry bibliotek stöder OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT miljövariabeln för att aktivera avbildning av meddelandeinnehåll. Ange den här miljövariabeln till true:

OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true

Du kan ange den här miljövariabeln i programmets konfiguration, i utvecklingsmiljön eller i distributionsinställningarna.

Azure OpenAI och andra AI-integreringar

Specifik vägledning om hur du konfigurerar inspelning av meddelandeinnehåll med olika AI-integreringar finns i dokumentationen för varje integrering:

Tip

När inspelning av meddelandeinnehåll är inaktiverat ger GenAI-telemetrivisualiseraren fortfarande värdefull information om AI-åtgärder, inklusive tids-, metadata- och prestandamått. Om du aktiverar inspelning av meddelandeinnehåll får du dock den mest omfattande vyn av dina AI-interaktioner.

Exemplars

Instrumentpanelen Aspire stöder och visar OpenTelemetryexemplar. Ett exempel länkar en måttdatapunkt till den åtgärd som registrerade den, som fungerar som en brygga mellan mått och spårningar.

Exempel är användbara eftersom de ger ytterligare kontext om varför ett specifikt måttvärde registrerades. Om du till exempel ser en ökning av svarstiden i måttet http.client.request.duration kan ett exempel peka på en specifik spårning eller ett visst spann som orsakade toppen, vilket hjälper dig att förstå rotorsaken.

Exempel visas i måttdiagrammet som en liten rund punkt bredvid datapunkten. När du hovra över indikatorn visar en knappbeskrivning exempelinformationen enligt följande skärmbild:

Aspire Instrumentpanel: Måttsida med föredömlig indikator hovringsinformation.

Föregående skärmbild visar exempelinformationen för måttet http.client.request.duration. Exempelinformationen omfattar:

  • Resursnamn.
  • Åtgärden utfördes, i det här fallet en HTTP GET till /catalog/images/{id}.
  • Motsvarande värde och tidsstämpel.

Om du väljer exempelindikatorn öppnas sidan med spårningsinformation, där du kan visa spårningen som är associerad, till exempel tänk på följande skärmbild:

Aspire Instrumentpanel: Spårningssida, navigerad till från motsvarande måttsida.

Mer information finns i OpenTelemetry Docs: Exemplars.

Interagera med telemetri

Telemetriinformation genereras kontinuerligt medan du kör ett Aspire program och den kan översvämma instrumentpanelen med information. Instrumentpanelen innehåller verktyg som du kan använda för att minska mängden data som visas på övervakningssidor och göra det enklare att rikta in sig på specifika händelser.

Pausa telemetriutdata

I konsolloggarna, strukturerade loggar, spårningar och måttsidor kan du pausa insamlingen av telemetridata:

En skärmbild av sidan konsolloggar på Aspire instrumentpanelen som visar hur du pausar telemetri.

Pausknappen påverkar bara vilken typ av telemetri som visas på den sidan. Om du till exempel pausar insamlingen av konsolloggar fortsätter appen att samla in strukturerade loggar, spårningar och måtttelemetri.

Ta bort data

Bredvid knappen Pausa kan du med knappen Ta bort data rensa telemetrin på den aktuella sidan. Listrutan och välj om du vill ta bort telemetrin för alla resurser eller endast för den aktuella resursen:

En skärmbild av sidan Strukturerade loggar på Aspire instrumentpanelen som visar hur du tar bort telemetri.

Knappen är tillgänglig för kontrollloggar, strukturerade loggar, spårningar och mått. Den fungerar oberoende av varandra för varje typ av data.

Om du vill ta bort all telemetri av alla typer och för alla resurser i ett enda steg använder du knappen Ta bort alla i dialogrutan Inställningar :

En skärmbild av sidan Inställningar för Aspire instrumentpanelen som visar hur du tar bort all telemetri.

Dialogrutan Inställningar

Instrumentpanelen Aspire innehåller en inställningsdialogruta där du kan konfigurera temat, språket, funktionerna för att rensa alla loggar och telemetri samt den .NET version som används av instrumentpanelen.

Som standard är temat inställt på att följa systemtemat, vilket innebär att instrumentpanelen använder samma tema som operativsystemet. Du kan också välja temat Ljus eller Mörk för att åsidosätta systemtemat. Temaval sparas.

Följande skärmbild visar dialogrutan för temaval med standardtemat System valt:

Dialogrutan Aspire Inställningar för instrumentpanelen som visar standardval för systemtema.

Om du föredrar temat Ljus kan du välja det i dialogrutan för temaval:

Dialogrutan Aspire Inställningar för instrumentpanelen som visar valet Ljust tema.

Genvägar till instrumentpanelen

Instrumentpanelen Aspire innehåller olika genvägar som hjälper dig att navigera och styra olika delar av instrumentpanelen. Om du vill visa kortkommandon trycker du på Skift + ? eller väljer frågemarkeringsikonen i det övre högra hörnet på instrumentpanelen:

Aspire instrumentpanelen Hjälp modal dialogruta.

Följande genvägar är tillgängliga:

Panels:

  • +: Öka panelens storlek.
  • -: Minska panelens storlek.
  • Skifta + r: Reset panelstorlek.
  • Skifta + t:Växlingspanelens orientering.
  • Skifta + x: Stäng panelen.

Sidnavigering:

  • r: Gå till Resources.
  • c: Gå till Console-loggar.
  • s: Gå till Strunkerade loggar.
  • t: Gå till T-tävlingar.
  • m: Gå till Metrics.

Webbplatsomfattande navigering:

  • ?: Måste hjälpa till.
  • Skifta + s: Gå till Settings.

Interaktionsprompter

Vissa resurser eller kommandon kan fråga dig om värden när du använder instrumentpanelen. Den här interaktiva funktionen drivs av interaktionstjänsten, som gör det möjligt för integreringar att visa meddelanden eller begära indata från användare vid behov.

Till exempel Azure kan resurser som saknar nödvändig konfiguration fråga dig om konfigurationsvärden när instrumentpanelen startar eller när du interagerar med dessa resurser. Dessa uppmaningar hjälper till att säkerställa att resurserna är korrekt konfigurerade och kan fungera korrekt i ditt Aspire program.

I instrumentpanelen visas interaktionsprompter som:

  • Indatadialogrutor för saknade konfigurationsvärden.
  • Bekräftelsedialogrutor för viktiga åtgärder.
  • Meddelanden med information om resursstatus.

Dessa uppmaningar visas direkt i instrumentpanelens gränssnitt, vilket gör det enkelt att tillhandahålla nödvändig information utan att växla till externa verktyg eller konfigurationsfiler.

Detaljerad information om hur du använder API:et för interaktionstjänsten, inklusive exempel och CLI-stöd, finns i Interaktionstjänst.

GitHub Copilot på instrumentpanelen

Instrumentpanelen Aspire innehåller GitHub Copilot som din AI-felsökningsassistent när du startar appen från VS Code eller Visual Studio med ett GitHub konto som har en Copilot-prenumeration. Copilot kan hjälpa dig:

  • Granska hundratals loggmeddelanden med ett enda klick.
  • Undersök rotorsaken till fel i flera appar.
  • Markera prestandaproblem i spårningar.
  • Förklara obskyra felkoder med hjälp av AI:s stora kunskapslagringsplats.

Copilot-funktioner visas i hela instrumentpanelens gränssnitt:

  • Copilot-knapp: Den här knappen är tillgänglig i det övre högra hörnet för att öppna Copilot-chattgränssnittet.
  • Snabbmenyer: Alternativen "Fråga GitHub Copilot" visas i snabbmenyerna resurs, logg, spårning och span.
  • Förklara knappar: Knapparna "Förklara fel" visas i strukturerade loggar och knapparna "Förklara spårning" visas på spårningsinformationssidor.
  • Föreslagna frågor: Kontextuella AI-förslag visas baserat på den aktuella sidan.

Omfattande information om GitHub Copilot-funktioner, krav, felsökning och konfigurationsalternativ GitHub finns i Copilot på Aspire instrumentpanelen.

Nästa steg