Live Metrics Stream: övervaka & diagnostisera med en andra svars tidLive Metrics Stream: Monitor & Diagnose with 1-second latency

Använd Live Metrics Stream från Application Insightsför att avhjälpa det taktiga hjärtat i din Live-, produktions webb tillämpning.Probe the beating heart of your live, in-production web application by using Live Metrics Stream from Application Insights. Välj och filtrera mått och prestanda räknare för att se Real tid utan störningar på tjänsten.Select and filter metrics and performance counters to watch in real time, without any disturbance to your service. Undersök stack spårningar från exempel misslyckade förfrågningar och undantag.Inspect stack traces from sample failed requests and exceptions. Tillsammans med profiler, ögonblicks bilds fel sökning.Together with Profiler, Snapshot debugger. Live Metrics Stream ger en kraftfull och icke-invasiv diagnos verktyg för din Live-webbplats.Live Metrics Stream provides a powerful and non-invasive diagnostic tool for your live web site.

Med Live Metrics Stream kan du:With Live Metrics Stream, you can:

  • Verifiera en åtgärd när den släpps genom att titta på prestanda-och antal haverier.Validate a fix while it is released, by watching performance and failure counts.
  • Se resultatet av test belastningar och diagnostisera problem Live.Watch the effect of test loads, and diagnose issues live.
  • Fokusera på specifika testsessioner eller filtrera bort kända problem genom att välja och filtrera de mått som du vill titta på.Focus on particular test sessions or filter out known issues, by selecting and filtering the metrics you want to watch.
  • Hämta undantags spårningar när de sker.Get exception traces as they happen.
  • Experimentera med filter för att hitta de mest relevanta KPI: erna.Experiment with filters to find the most relevant KPIs.
  • Övervaka alla Windows prestanda räknare Live.Monitor any Windows performance counter live.
  • Identifiera enkelt en server som har problem och filtrera alla KPI/Live-flöden på bara den servern.Easily identify a server that is having issues, and filter all the KPI/live feed to just that server.

Live Metrics Stream videoLive Metrics Stream video

Live-mått stöds för närvarande för ASP.NET-, ASP.NET Core-, Azure Functions-, Java-och Node. js-appar.Live Metrics are currently supported for ASP.NET, ASP.NET Core, Azure Functions, Java, and Node.js apps.

Kom i gångGet started

  1. Om du ännu inte har installerat Application Insights i din webbapp gör du det nu.If you haven't yet install Application Insights in your web app, do that now.

  2. Förutom standard Application Insightss paketen Microsoft. ApplicationInsights. PerfCounterCollector krävs för att aktivera Live Metrics Stream.In addition to the standard Application Insights packages Microsoft.ApplicationInsights.PerfCounterCollector is required to enable Live Metrics stream.

  3. Uppdatera till den senaste versionen av Application Insights-paketet.Update to the latest version of the Application Insights package. I Visual Studio högerklickar du på projektet och väljer Hantera NuGet-paket.In Visual Studio, right-click your project and choose Manage Nuget packages. Öppna fliken uppdateringar och markera alla Microsoft. ApplicationInsights. *-paket.Open the Updates tab, and select all the Microsoft.ApplicationInsights.* packages.

    Distribuera om din app.Redeploy your app.

  4. I Azure Portalöppnar du Application Insights resurs för din app och öppnar sedan Live Stream.In the Azure portal, open the Application Insights resource for your app, and then open Live Stream.

  5. Skydda kontroll kanalen om du kan använda känsliga data som kund namn i dina filter.Secure the control channel if you might use sensitive data such as customer names in your filters.

Inga data?No data? Kontrol lera serverns brand väggCheck your server firewall

Kontrol lera att de utgående portarna för Live Metrics Stream är öppna i brand väggen för dina servrar.Check the outgoing ports for Live Metrics Stream are open in the firewall of your servers.

Hur skiljer sig Live Metrics Stream från Metrics Explorer och analyser?How does Live Metrics Stream differ from Metrics Explorer and Analytics?

Direktsänd strömLive Stream Metrics Explorer och analysMetrics Explorer and Analytics
SvarstidLatency Data som visas inom en sekundData displayed within one second Sammanställt över minuterAggregated over minutes
Ingen kvarhållningNo retention Data sparas medan de finns i diagrammet och ignoreras sedanData persists while it's on the chart, and is then discarded Data kvarhållna i 90 dagarData retained for 90 days
På begäranOn demand Data strömmas när du öppnar Live-måttData is streamed while you open Live Metrics Data skickas när SDK är installerat och aktiveratData is sent whenever the SDK is installed and enabled
KostnadsfriFree Det kostar inget att Live Stream dataThere is no charge for Live Stream data Omfattas av prissättningSubject to pricing
SamplingSampling Alla valda mått och räknare överförs.All selected metrics and counters are transmitted. Felen och stack spåren samplas.Failures and stack traces are sampled. TelemetryProcessors tillämpas inte.TelemetryProcessors are not applied. Händelser kan samplasEvents may be sampled
Kontroll kanalControl channel Filter kontroll signaler skickas till SDK: n.Filter control signals are sent to the SDK. Vi rekommenderar att du skyddar den här kanalen.We recommend you secure this channel. Kommunikation är ett sätt, till portalenCommunication is one way, to the portal

Välj och filtrera dina måttSelect and filter your metrics

(Tillgänglig med ASP.NET, ASP.NET Core och Azure Functions (v2).)(Available with ASP.NET, ASP.NET Core, and Azure Functions (v2).)

Du kan övervaka anpassad KPI Live genom att använda godtyckliga filter på alla Application Insights telemetri från portalen.You can monitor custom KPI live by applying arbitrary filters on any Application Insights telemetry from the portal. Klicka på den filter kontroll som visas när du pekar på ett diagram.Click the filter control that shows when you mouse-over any of the charts. Följande diagram ritar en anpassad KPI för antalet begär Anden med filter på URL-och duration-attribut.The following chart is plotting a custom Request count KPI with filters on URL and Duration attributes. Verifiera dina filter med avsnittet för hands version av data ström som visar en live-feed med telemetri som matchar de kriterier som du har angett vid en viss tidpunkt.Validate your filters with the Stream Preview section that shows a live feed of telemetry that matches the criteria you have specified at any point in time.

KPI för anpassad begäran

Du kan övervaka ett värde som skiljer sig från antalet.You can monitor a value different from Count. Vilka alternativ som är tillgängliga beror på vilken typ av data ström som kan vara en Application Insights telemetri: begär Anden, beroenden, spårningar, händelser eller mått.The options depend on the type of stream, which could be any Application Insights telemetry: requests, dependencies, exceptions, traces, events, or metrics. Det kan vara din egen anpassade mått enhet:It can be your own custom measurement:

Värde alternativ

Förutom att Application Insights telemetri kan du också övervaka Windows prestanda räknare genom att välja det från data Ströms alternativen och ange namnet på prestanda räknaren.In addition to Application Insights telemetry, you can also monitor any Windows performance counter by selecting that from the stream options, and providing the name of the performance counter.

Live-mått sammanställs på två punkter: lokalt på varje server och sedan på alla servrar.Live metrics are aggregated at two points: locally on each server, and then across all servers. Du kan ändra standardvärdet genom att välja andra alternativ i respektive listruta.You can change the default at either by selecting other options in the respective drop-downs.

Exempel på telemetri: anpassade Live Diagnostic-händelserSample Telemetry: Custom Live Diagnostic Events

Som standard visar live-matningen av händelser exempel på misslyckade förfrågningar och beroende anrop, undantag, händelser och spår.By default, the live feed of events shows samples of failed requests and dependency calls, exceptions, events, and traces. Klicka på filter ikonen för att se de tillämpade kriterierna vid varje tidpunkt.Click the filter icon to see the applied criteria at any point in time.

Standard-live-feed

Precis som med mått kan du ange valfria villkor till vilken typ av Application Insights telemetri som helst.As with metrics, you can specify any arbitrary criteria to any of the Application Insights telemetry types. I det här exemplet väljer vi vissa förfrågningar, spårningar och händelser.In this example, we are selecting specific request failures, traces, and events. Vi väljer också alla undantag och beroende fel.We are also selecting all exceptions and dependency failures.

Anpassad live-feed

Obs: för närvarande, för undantags meddelande villkor, använder du det yttersta undantags meddelandet.Note: Currently, for Exception message-based criteria, use the outermost exception message. I föregående exempel kan du filtrera bort det ofarliga undantaget med ett internt undantags meddelande (efter "<--"-avgränsare) "klienten kopplades från."In the preceding example, to filter out the benign exception with inner exception message (follows the "<--" delimiter) "The client disconnected." Använd meddelandet not-contains "fel vid läsning av begär ande innehåll".use a message not-contains "Error reading request content" criteria.

Se information om ett objekt i Live-flödet genom att klicka på det.See the details of an item in the live feed by clicking it. Du kan pausa matningen antingen genom att klicka på pausa eller helt enkelt rulla nedåt eller klicka på ett objekt.You can pause the feed either by clicking Pause or simply scrolling down, or clicking an item. Live-matningen återupptas när du har rullat överst eller genom att klicka på objekt räknaren som samlats in när den pausades.Live feed will resume after you scroll back to the top, or by clicking the counter of items collected while it was paused.

Exempel på aktiva startfel

Filtrera efter Server instansFilter by server instance

Om du vill övervaka en viss server roll instans kan du filtrera efter server.If you want to monitor a particular server role instance, you can filter by server.

Exempel på aktiva startfel

Skydda kontroll kanalenSecure the control channel

De anpassade filter kriterier som du anger skickas tillbaka till komponenten Live Metrics i Application Insights SDK.The custom filters criteria you specify are sent back to the Live Metrics component in the Application Insights SDK. Filtren kan eventuellt innehålla känslig information, till exempel customerID.The filters could potentially contain sensitive information such as customerIDs. Du kan göra kanalen säker med en hemlig API-nyckel förutom Instrumentation-nyckeln.You can make the channel secure with a secret API key in addition to the instrumentation key.

Skapa en API-nyckelCreate an API Key

Skapa API-nyckel

Lägg till API-nyckel i konfigurationenAdd API key to Configuration

Klassisk ASP.NETClassic ASP.NET

I filen applicationinsights. config lägger du till AuthenticationApiKey i QuickPulseTelemetryModule:In the applicationinsights.config file, add the AuthenticationApiKey to the QuickPulseTelemetryModule:


<Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector">
      <AuthenticationApiKey>YOUR-API-KEY-HERE</AuthenticationApiKey>
</Add>

Eller i kod, ställer du in den på QuickPulseTelemetryModule:Or in code, set it on the QuickPulseTelemetryModule:

using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;
using Microsoft.ApplicationInsights.Extensibility;

             TelemetryConfiguration configuration = new TelemetryConfiguration();
            configuration.InstrumentationKey = "YOUR-IKEY-HERE";

            QuickPulseTelemetryProcessor processor = null;

            configuration.TelemetryProcessorChainBuilder
                .Use((next) =>
                {
                    processor = new QuickPulseTelemetryProcessor(next);
                    return processor;
                })
                        .Build();

            var QuickPulse = new QuickPulseTelemetryModule()
            {

                AuthenticationApiKey = "YOUR-API-KEY"
            };
            QuickPulse.Initialize(configuration);
            QuickPulse.RegisterTelemetryProcessor(processor);
            foreach (var telemetryProcessor in configuration.TelemetryProcessors)
                {
                if (telemetryProcessor is ITelemetryModule telemetryModule)
                    {
                    telemetryModule.Initialize(configuration);
                    }
                }

Azure-funktionsapparAzure Function Apps

För Azure Function Apps (v2) kan du skydda kanalen med en API-nyckel med en miljö variabel.For Azure Function Apps (v2), securing the channel with an API key can be accomplished with an environment variable.

Skapa en API-nyckel inifrån din Application Insights-resurs och gå till program inställningar för din Funktionsapp.Create an API key from within your Application Insights resource and go to Application Settings for your Function App. Välj Lägg till ny inställning och ange ett namn på APPINSIGHTS_QUICKPULSEAUTHAPIKEY och ett värde som motsvarar din API-nyckel.Select add new setting and enter a name of APPINSIGHTS_QUICKPULSEAUTHAPIKEY and a value that corresponds to your API key.

ASP.NET Core (kräver Application Insights ASP.NET Core SDK 2.3.0 eller senare)ASP.NET Core (Requires Application Insights ASP.NET Core SDK 2.3.0 or greater)

Ändra din startup.cs-fil på följande sätt:Modify your startup.cs file as follows:

Börja med att lägga tillFirst add

using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;

Lägg sedan till följande i metoden ConfigureServices:Then within the ConfigureServices method add:

services.ConfigureTelemetryModule<QuickPulseTelemetryModule> ((module, o) => module.AuthenticationApiKey = "YOUR-API-KEY-HERE");

Men om du känner igen och litar på alla anslutna servrar kan du prova anpassade filter utan den autentiserade kanalen.However, if you recognize and trust all the connected servers, you can try the custom filters without the authenticated channel. Det här alternativet är tillgängligt i sex månader.This option is available for six months. Den här åsidosättningen krävs en gång i varje ny session, eller när en ny server är online.This override is required once every new session, or when a new server comes online.

Alternativ för Live Metrics-autentisering

Anteckning

Vi rekommenderar starkt att du konfigurerar den autentiserade kanalen innan du anger potentiellt känslig information som CustomerID i filter kriterierna.We strongly recommend that you set up the authenticated channel before entering potentially sensitive information like CustomerID in the filter criteria.

Tabell med funktioner som stödsSupported features table

SpråkLanguage Grundläggande måttBasic Metrics PrestandamåttPerformance metrics Anpassad filtreringCustom filtering Exempel på telemetriSample telemetry CPU-delning per processCPU split by process
.NET.NET Stöds (V-2.7.2 +)Supported (V2.7.2+) Stöds (V-2.7.2 +)Supported (V2.7.2+) Stöds (V-2.7.2 +)Supported (V2.7.2+) Stöds (V-2.7.2 +)Supported (V2.7.2+) Stöds (V-2.7.2 +)Supported (V2.7.2+)
.NET Core (Target =. NET Framework).NET Core (target=.NET Framework) Stöds (V 2.4.1 +)Supported (V2.4.1+) Stöds (V 2.4.1 +)Supported (V2.4.1+) Stöds (V 2.4.1 +)Supported (V2.4.1+) Stöds (V 2.4.1 +)Supported (V2.4.1+) Stöds (V 2.4.1 +)Supported (V2.4.1+)
.NET Core (Target =. NET Core).NET Core (target=.NET Core) Stöds (V 2.4.1 +)Supported (V2.4.1+) Stöds*Supported* Stöds (V 2.4.1 +)Supported (V2.4.1+) Stöds (V 2.4.1 +)Supported (V2.4.1+) Stöds inteNot Supported
Azure Functions v2Azure Functions v2 StödsSupported StödsSupported StödsSupported StödsSupported Stöds inteNot Supported
JavaJava Stöds (V-2.0.0 +)Supported (V2.0.0+) Stöds (V-2.0.0 +)Supported (V2.0.0+) Stöds inteNot Supported Stöds inteNot Supported Stöds inteNot Supported
Node.jsNode.js Stöds (V-1.3.0 +)Supported (V1.3.0+) Stöds (V-1.3.0 +)Supported (V1.3.0+) Stöds inteNot Supported Stöds (V-1.3.0 +)Supported (V1.3.0+) Stöds inteNot Supported

Grundläggande mått inkluderar begäran, beroende och undantags frekvens.Basic metrics include request, dependency, and exception rate. Prestanda mått (prestanda räknare) inkluderar minne och CPU.Performance metrics (performance counters) include memory and CPU. Exempel på telemetri visar en data ström med detaljerad information om misslyckade förfrågningar och beroenden, undantag, händelser och spår.Sample telemetry shows a stream of detailed information for failed requests and dependencies, exceptions, events, and traces.

* PerfCounters-stöd varierar något mellan versioner av .NET Core som inte är riktade mot .NET Framework:* PerfCounters support varies slightly across versions of .NET Core that do not target the .NET Framework:

  • PerfCounters-mått stöds när de körs i Azure App Service för Windows.PerfCounters metrics are supported when running in Azure App Service for Windows. (AspNetCore SDK version 2.4.1 eller senare)(AspNetCore SDK Version 2.4.1 or higher)
  • PerfCounters stöds när appen körs i Windows-datorer (virtuell dator eller moln tjänst eller lokal osv.) (AspNetCore SDK version 2.7.1 eller senare), men för appar som riktar sig till .NET Core 2,0 eller högre.PerfCounters are supported when app is running in ANY Windows machines (VM or Cloud Service or On-prem etc.) (AspNetCore SDK Version 2.7.1 or higher), but for apps targeting .NET Core 2.0 or higher.
  • PerfCounters stöds när appen körs var som helst (Linux, Windows, App Service för Linux, behållare osv.) i den senaste beta versionen (dvs.PerfCounters are supported when app is running ANYWHERE (Linux, Windows, app service for Linux, containers, etc.) in the latest beta (i.e AspNetCore SDK-version 2.8.0-beta1 eller högre), men för appar som riktar sig mot .NET Core 2,0 eller högre.AspNetCore SDK Version 2.8.0-beta1 or higher), but for apps targeting .NET Core 2.0 or higher.

Som standard är Live-måtten inaktiverade i Node. js SDK.By default Live Metrics is disabled in the Node.js SDK. Om du vill aktivera Live-mått lägger du till setSendLiveMetrics(true) till dina konfigurations metoder när du initierar SDK: n.To enable Live Metrics, add setSendLiveMetrics(true) to your configuration methods as you initialize the SDK.

FelsökaTroubleshooting

Inga data?No data? Om ditt program finns i ett skyddat nätverk: Live Metrics Stream använder andra IP-adresser än andra Application Insights telemetri.If your application is in a protected network: Live Metrics Stream uses different IP addresses than other Application Insights telemetry. Kontrol lera att de här IP-adresserna är öppna i brand väggen.Make sure those IP addresses are open in your firewall.

Nästa stegNext steps