Dela via


Skapa och konfigurera Application Insights-resurser

Viktigt!

Den här artikeln gäller för arbetsytebaserade Application Insights-resurser . Klassiska Application Insights-resurser har dragits tillbaka. Övergå till arbetsytebaserade Application Insights för att dra nytta av nya funktioner.

Application Insights integreras med Log Analytics och skickar telemetri till en gemensam Log Analytics-arbetsyta. Den här konfigurationen ger fullständig åtkomst till Log Analytics-funktioner, konsoliderar loggar på en plats och möjliggör enhetlig rollbaserad åtkomstkontroll i Azure , vilket eliminerar behovet av frågor mellan appar och arbetsytor.

Bland de förbättrade funktionerna finns:

Den här artikeln visar hur du skapar och konfigurerar Application Insights-resurser. Tillsammans med själva Application Insights-resursen kan du lägga till olika konfigurationer som att ange det dagliga taket och prisplanen. Du kan också skapa tillgänglighetstester, konfigurera måttaviseringar och automatisera processen med Hjälp av Azure Resource Manager.

Anteckning

Datainmatning och kvarhållning för arbetsytebaserade Application Insights-resurser faktureras via Log Analytics-arbetsytan där data finns. Mer information om fakturering finns i prisinformation för Azure Monitor-loggar.

Förutsättningar

  • En aktiv Azure-prenumeration.
  • Nödvändiga behörigheter för att skapa resurser.

Ytterligare krav

Inga ytterligare krav.

Skapa en Application Insights-resurs

  1. Logga in på Azure-portalen.
  2. Välj Skapa en resurs.
  3. Öppna kategorin Övervakning och diagnostik och välj sedan Application Insights.
  4. Ange all relevant information och Granska + skapa sedan din Application Insights-resurs.

Skärmbild som visar en Application Insights-resurs.

Anteckning

Om du inte ansluter till en befintlig Log Analytics-arbetsyta när resursen skapas skapas en ny Log Analytics-resurs automatiskt tillsammans med din Application Insights-resurs.

När du har skapat resursen hittar du motsvarande arbetsyteinformation i fönstret Översikt för Application Insights.

Skärmbild som visar ett arbetsytenamn.

Välj den blå länktexten för att gå till den associerade Log Analytics-arbetsytan där du kan dra nytta av den nya enhetliga arbetsytans frågemiljö.

Anteckning

Vi tillhandahåller fortfarande fullständig bakåtkompatibilitet för dina klassiska Application Insights-resursfrågor, arbetsböcker och loggbaserade aviseringar. Om du vill fråga eller visa den nya arbetsytebaserade tabellstrukturen eller schemat måste du först gå till Log Analytics-arbetsytan. Välj Loggar (analys) i Application Insights-fönstret för åtkomst till den klassiska Application Insights-frågeupplevelsen.

Konfigurera övervakning

När du har skapat en Application Insights-resurs konfigurerar du övervakning.

Hämta anslutningssträngen

Den anslutningssträng identifierar den resurs som du vill associera telemetridata med. Du kan också använda den för att ändra slutpunkterna som resursen använder som mål för telemetrin. Du måste kopiera anslutningssträng och lägga till den i programmets kod eller i en miljövariabel.

Så här hämtar du anslutningssträngen för application insights-resursen:

  1. Öppna din Application Insights-resurs på Azure-portalen.
  2. översiktsfönstret i avsnittet Essentials, leta efter anslutningssträng.
  3. Om du hovrar över anslutningssträngen visas en ikon som gör att du kan kopiera den till Urklipp.

Programövervakning med OpenTelemetry

För programövervakning med OpenTelemetry installerar du lämplig Azure Monitor OpenTelemetry-distribution och pekar anslutningssträngen på den resurs som du nyss skapade.

Information om hur du konfigurerar programövervakning med OpenTelemetry finns i följande dokumentation som är specifik för språket:

Anteckning

För webbappar som riktar sig till webbläsare rekommenderar vi att du använder Application Insights JavaScript SDK.

Automatisk instrumentering

För övervakningstjänster som Azure Functions och Azure App Service kan du först skapa din Application Insights-resurs och sedan peka på den när du aktiverar övervakning. Du kan också skapa en ny Application Insights-resurs under aktiveringsprocessen.

Konfigurera Application Insights-resurser

Ändra den associerade arbetsytan

När du har skapat en Application Insights-resurs kan du ändra den associerade Log Analytics-arbetsytan.

I Application Insights-resursen väljer du Egenskaper>Ändra arbetsyta>Log Analytics arbetsytor.

Exportera telemetri

Den äldre funktionen för kontinuerlig export stöds inte för arbetsytebaserade resurser. Använd i stället Diagnostikinställningar.

Anteckning

Export av diagnostikinställningar kan öka kostnaderna. Mer information finns i Exportera telemetri från Application Insights. Prisinformation för den här funktionen finns på sidan med priser för Azure Monitor. Innan faktureringen börjar skickas meddelanden. Om du fortsätter att använda telemetriexport efter meddelandeperioden debiteras du enligt tillämpligt pris.

I Application Insights-resursen väljer du Diagnostikinställningar>Lägg till diagnostikinställning.

Du kan välja alla tabeller eller en delmängd av tabeller som ska arkiveras till ett lagringskonto. Du kan också strömma till en händelsehubb.

Ange datakvarhållning

Datakvarhållning för Application Insights-resurser kan ställas in i den associerade Log Analytics-arbetsytan.

Mer information finns i Konfigurera standardperioden för interaktiv kvarhållning för Analytics-tabeller.

Ange det dagliga taket

Det dagliga taket måste anges oberoende av varandra för både Application Insights och den underliggande Log Analytics-arbetsytan. Det effektiva dagliga taket är minst av de två inställningarna.

Information om hur du anger det dagliga taket i Azure-portalen finns i Ange dagligt tak på Log Analytics-arbetsytan.

Ange prisplanen

Prisplanen för Application Insights-resurser kan anges på den associerade Log Analytics-arbetsytan. Mer information om tillgängliga prisplaner finns i Kostnadsberäkningar och alternativ för Azure Monitor-loggar.

Anteckning

Om du ser oväntade avgifter eller höga kostnader i Application Insights kan den här guiden hjälpa dig. Den omfattar vanliga orsaker som hög telemetrivolym, datainmatningstoppar och felkonfigurerad sampling. Det är särskilt användbart om du felsöker problem som rör kostnadstoppar, telemetrivolym, sampling som inte fungerar, datatak, hög inmatning eller oväntad fakturering. Information om hur du kommer igång finns i Felsöka hög datainmatning i Application Insights.

Information om hur du anger prisplanen i Azure-portalen finns i Application Insights-fakturering.

Inaktivera IP-maskering

Application Insights lagrar som standard inte IP-adresser. Information om hur du inaktiverar IP-maskering finns i Geoplats- och IP-adresshantering.

Skapa ytterligare resurser

Skapa ett tillgänglighetstest

Information om hur du skapar ett tillgänglighetstest i Azure-portalen finns i Tillgänglighetstester för Application Insights.

Lägga till en måttavisering

Tips/Råd

Varje Application Insights-resurs levereras med mått som är tillgängliga direkt. Om separata komponenter rapporterar till samma Application Insights-resurs kanske det inte är meningsfullt att avisera om dessa mått.

Information om hur du skapar en måttavisering i Azure-portalen finns i Självstudie: Skapa en måttavisering för en Azure-resurs.

Information om hur du automatiserar skapandet av måttaviseringar finns i mallartikeln Måttaviseringar.

Skapa fler Application Insights-resurser

Hur många Application Insights-resurser ska jag distribuera?

När du utvecklar nästa version av ett webbprogram vill du inte blanda ihop Application Insights-telemetrin från den nya versionen och den redan släppta versionen.

För att undvika förvirring skickar du telemetrin från olika utvecklingssteg för att separera Application Insights-resurser med separata anslutningssträng.

Om systemet är en instans av Azure Cloud Services finns det en annan metod för att ställa in separata anslutningssträng.

När du ska använda en enda Application Insights-resurs

Använd en enda Application Insights-resurs för:

  • Effektivisera DevOps/ITOps-hantering för program som distribueras tillsammans, vanligtvis utvecklade och hanterade av samma team.
  • Centralisera viktiga prestandaindikatorer, till exempel svarstider och felfrekvenser, på en instrumentpanel som standard. Segmentera efter rollnamn i metrics Explorer om det behövs.
  • När det inte finns något behov av olika rollbaserad åtkomstkontroll i Azure mellan programkomponenter.
  • När identiska måttaviseringsvillkor, kontinuerlig export och hantering av fakturering/kvoter mellan komponenter räcker.
  • När det är acceptabelt för en API-nyckel att komma åt data från alla komponenter på samma sätt och 10 API-nycklar uppfyller behoven för alla komponenter.
  • När samma inställningar för smart identifiering och arbetsobjektintegrering är lämpliga för alla roller.

Anteckning

Om du vill konsolidera flera Application Insights-resurser kan du peka dina befintliga programkomponenter på en ny konsoliderad Application Insights-resurs. Telemetrin som lagras i den gamla resursen överförs inte till den nya resursen. Ta bara bort den gamla resursen när du har tillräckligt med telemetri i den nya resursen för affärskontinuitet.

Övriga beaktanden

Om du vill aktivera portalupplevelser lägger du till anpassad kod för att tilldela meningsfulla värden till attributet Cloud_RoleName . Utan dessa värden fungerar inte portalfunktionerna.

För Azure Service Fabric-program och klassiska molntjänster konfigurerar SDK automatiskt tjänster genom att läsa från Azure-rollmiljön. För andra apptyper behöver du vanligtvis ange den explicit.

Live-mått kan inte dela upp data efter rollnamn.

Spårning av version och lansering

När du publicerar en ny version av programmet vill du kunna separera telemetrin från olika versioner. Du kan ange egenskapen Programversion så att du kan filtrera sök - och måttutforskarens resultat.

Det finns flera olika metoder för att ange egenskapen Programversion .

  • Alternativ 1: Ange versionen direkt

    Lägg till raden telemetryClient.Context.Component.Version = typeof(MyProject.MyClass).Assembly.GetName().Version; i programmets initieringskod.

    Om du vill säkerställa att alla TelemetryClient instanser anges konsekvent, omge den linjen med en telemetriinitierare.

  • Alternativ 2: Ange versionen i BuildInfo.config (endast ASP.NET)

    Application Insights-webbmodulen hämtar versionen från BuildLabel noden. Inkludera den här filen i projektet och kom ihåg att ange egenskapen Kopiera alltid i Solution Explorer.

    <?xml version="1.0" encoding="utf-8"?>
    <DeploymentEvent xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/VisualStudio/DeploymentEvent/2013/06">
      <ProjectName>AppVersionExpt</ProjectName>
      <Build type="MSBuild">
        <MSBuild>
          <BuildLabel kind="label">1.0.0.2</BuildLabel>
        </MSBuild>
      </Build>
    </DeploymentEvent>
    
    

    Generera BuildInfo.config automatiskt i Microsoft Build Engine. Lägg till följande rader i .csproj filen:

    <PropertyGroup>
      <GenerateBuildInfoConfigFile>true</GenerateBuildInfoConfigFile>
      <IncludeServerNameInBuildInfo>true</IncludeServerNameInBuildInfo>
    </PropertyGroup>
    

    Det här steget genererar en fil med namnet yourProjectName.BuildInfo.config. Publiceringsprocessen byter namn på den till BuildInfo.config.

    Byggetiketten innehåller en platshållare (*AutoGen_...*) när du skapar med Visual Studio. När platshållaren skapas med Microsoft Build Engine fylls den med rätt versionsnummer.

    Om du vill tillåta att Microsoft Build Engine genererar versionsnummer anger du versionen som 1.0.* i AssemblyReference.cs.

Versionsanteckningar

Om du använder Azure DevOps kan du få en anteckningsmarkör tillagd i dina diagram när du släpper en ny version.

Automatisera processen för att skapa resurser

Processen för att skapa resurser kan automatiseras med hjälp av Bicep- eller JSON-mallar med Azure Resource Manager. Du kan paketera flera resurser tillsammans för att skapa dem i en distribution. Du kan till exempel skapa en Application Insights-resurs med tillgänglighetstester, måttaviseringar och en diagnostikinställning för att skicka telemetri till ett Azure Storage-konto.

Generera en mall i Azure-portalen

Du kan generera en mall från befintliga resurser.

Endast Application Insights

  1. Gå till Application Insights-resursen i Azure-portalen.
  2. Öppna Exportmallen som visas under Automation i det vänstra navigeringsfältet.
  3. (Valfritt): Om du vill använda dina egna parametrar avmarkerar du Inkludera parametrar.
  4. Ladda ned mallfilen eller distribuera den direkt i Azure-portalen.

Flera resurser

  1. Gå till resursgruppen för application insights-resursen.
  2. Markera alla resurser som du vill inkludera i mallen i fönstret Översikt och välj sedan Exportera mall i det övre navigeringsfältet.
  3. (Valfritt): Om du vill använda dina egna parametrar avmarkerar du Inkludera parametrar.
  4. Ladda ned mallfilen eller distribuera den direkt i Azure-portalen.

Skapa en mall från grunden

Om du vill lära dig hur du skapar en ARM-mall från grunden går du till vår ARM-malldokumentation som innehåller självstudier för att skapa en mall, lägga till resurser, lägga till parametrar med mera.

Tillgängliga egenskaper för Application Insights, tillgänglighetstester, måttaviseringar, diagnostikinställningar och andra resurser finns i vår Azure-resursreferensdokumentation under nodenReferensövervakareInsikter>>.

Tips/Råd

Du kan också använda snabbstartsmallar som är tillgängliga längst ned på varje dokumentationssida för Azure-resursreferenser som är länkad i det här avsnittet. Mer information om hur du använder mallar finns i Självstudie: Använda Azure-snabbstartsmallar.

Nästa steg