Live Metrics Stream: monitorare e diagnosticare con una latenza di 1 secondoLive Metrics Stream: Monitor & Diagnose with 1-second latency

Usando Live Metrics Stream da Application Insights è possibile testare il funzionamento dell'applicazione Web live nell'ambiente di produzione.Probe the beating heart of your live, in-production web application by using Live Metrics Stream from Application Insights. Selezionare e filtrare le metriche e i contatori delle prestazioni in tempo reale, senza distorsioni del servizio.Select and filter metrics and performance counters to watch in real time, without any disturbance to your service. Esaminare le analisi dello stack da richieste ed eccezioni di esempio non riuscite.Inspect stack traces from sample failed requests and exceptions. Insieme al Profiler, al debugger di snapshot e al test delle prestazioni, Live Metrics Stream offre uno strumento di diagnostica non invasivo e potente per il sito Web live.Together with Profiler, Snapshot debugger, and performance testing, Live Metrics Stream provides a powerful and non-invasive diagnostic tool for your live web site.

Con Live Metrics Stream, è possibile:With Live Metrics Stream, you can:

  • Convalidare una correzione durante il rilasciato, osservando i contatori delle prestazioni e degli errori.Validate a fix while it is released, by watching performance and failure counts.
  • Osservare l'effetto dei carichi di test e diagnosticare i problemi live.Watch the effect of test loads, and diagnose issues live.
  • Concentrarsi sulle sessioni di test specifiche o filtrare i problemi noti, selezionando e filtrando le metriche che si desidera osservare.Focus on particular test sessions or filter out known issues, by selecting and filtering the metrics you want to watch.
  • Ottenere le eccezioni delle tracce in tempo reale.Get exception traces as they happen.
  • Provare a usare i filtri per individuare gli indicatori di prestazioni chiave più rilevanti.Experiment with filters to find the most relevant KPIs.
  • Monitorare ogni contatore delle prestazioni di Windows live.Monitor any Windows performance counter live.
  • Identificare facilmente un server che presenta problemi e filtrare tutti gli indicatori KPI o i feed live solo per tale server.Easily identify a server that is having issues, and filter all the KPI/live feed to just that server.

Video di Live Metrics StreamLive Metrics Stream video

Live Metrics Stream è attualmente disponibile nelle app ASP.NET in esecuzione in locale o nel cloud.Live Metrics Stream is currently available on ASP.NET apps running on-premises or in the Cloud.

Attività inizialiGet started

  1. Se Application Insights non è stato ancora installato nell'app Web ASP.NET o nell'app del server Windows, è possibile farlo ora.If you haven't yet installed Application Insights in your ASP.NET web app or Windows server app, do that now.
  2. Eseguire l'aggiornamento alla versione più recente del pacchetto Application Insights.Update to the latest version of the Application Insights package. In Visual Studio fare clic con il pulsante destro del mouse sul progetto e scegliere Gestisci pacchetti NuGet.In Visual Studio, right-click your project and choose Manage Nuget packages. Aprire la scheda Aggiornamenti, spuntare Includi versione preliminare e selezionare tutti i pacchetti Microsoft.ApplicationInsights..Open the **Updates* tab, check Include prerelease, and select all the Microsoft.ApplicationInsights.* packages.

    Ridistribuire l'app.Redeploy your app.

  3. Nel portale di Azure aprire la risorsa di Application Insights per l'app e quindi Live Stream.In the Azure portal, open the Application Insights resource for your app, and then open Live Stream.

  4. Proteggere il canale di controllo se è possibile usare i dati sensibili, ad esempio i nomi dei clienti, nei filtri.Secure the control channel if you might use sensitive data such as customer names in your filters.

Nel pannello Panoramica fare clic su Flusso attivo

Dati non visualizzatiNo data? Controllare il firewall del serverCheck your server firewall

Controllare che le porte in uscita di Live Metrics Stream siano aperte nel firewall del server.Check the outgoing ports for Live Metrics Stream are open in the firewall of your servers.

Differenze tra Live Metrics Stream ed Esplora metriche e AnalisiHow does Live Metrics Stream differ from Metrics Explorer and Analytics?

Live StreamLive Stream Esplora metriche e AnalisiMetrics Explorer and Analytics
LatencyLatency Dati visualizzati in un secondoData displayed within one second Aggregati in minutiAggregated over minutes
Nessuna conservazioneNo retention I dati vengono mantenuti finché si trovano nel grafico, poi vengono eliminatiData persists while it's on the chart, and is then discarded Dati mantenuti per 90 giorniData retained for 90 days
On demandOn demand I dati vengono trasmessi durante l'apertura di Live MetricsData is streamed while you open Live Metrics I dati vengono inviati ogni volta che l'SDK viene installato e attivatoData is sent whenever the SDK is installed and enabled
GratuitoFree Non sono previste spese per i dati di Live StreamThere is no charge for Live Stream data Soggetto al piano tariffarioSubject to pricing
CampionamentoSampling Tutte le metriche selezionate e i contatori vengono trasmessi.All selected metrics and counters are transmitted. Gli errori e le analisi dello stack vengono usati come esempi.Failures and stack traces are sampled. TelemetryProcessors non viene applicato.TelemetryProcessors are not applied. Eventi potrebbero essere usati come esempiEvents may be sampled
Canale di controlloControl channel I segnali di controllo del filtro vengono inviati all'SDK.Filter control signals are sent to the SDK. È consigliabile proteggere questo canale.We recommend you secure this channel. La comunicazione è unidirezionale al portaleCommunication is one-way, to the portal

Selezionare e filtrare le metricheSelect and filter your metrics

(Disponibile in app ASP.NET classiche con l'SDK più recente.)(Available on classic ASP.NET apps with the latest SDK.)

È possibile monitorare gli indicatori KPI personalizzati live applicando filtri arbitrari su eventuali dati di Application Insights Telemetry dal portale.You can monitor custom KPI live by applying arbitrary filters on any Application Insights telemetry from the portal. Fare clic sul controllo del filtro che viene mostrato quando il puntatore del mouse passa su un grafico.Click the filter control that shows when you mouse-over any of the charts. Il grafico seguente traccia un indicatore KPI del conteggio di richieste personalizzato con filtri sugli attributi dell'URL e della durata.The following chart is plotting a custom Request count KPI with filters on URL and Duration attributes. Convalidare i filtri nella sezione Anteprima flusso che mostra un feed live di telemetria che corrisponde ai criteri specificati in qualsiasi punto nel tempo.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.

Indicatore KPI di richieste personalizzato

È possibile monitorare un valore diverso dal conteggio.You can monitor a value different from Count. Le opzioni dipendono dal tipo di flusso, che può essere una qualsiasi Application Insights Telemetry: richieste, dipendenze, eccezioni, tracce, eventi o metriche.The options depend on the type of stream, which could be any Application Insights telemetry: requests, dependencies, exceptions, traces, events, or metrics. Può essere la propria misura personalizzata:It can be your own custom measurement:

Opzioni del valore

Oltre ai dati di Application Insights Telemetry, è anche possibile monitorare un contatore delle prestazioni di Windows selezionandolo dalle opzioni di flusso e inserendo il nome del contatore delle prestazioni.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.

Le metriche attive vengono aggregate in due punti: in locale su ciascun server e quindi su tutti i server.Live metrics are aggregated at two points: locally on each server, and then across all servers. È possibile modificare l'impostazione predefinita per entrambi selezionando altre opzioni nei rispettivi elenchi a discesa.You can change the default at either by selecting other options in the respective drop-downs.

Telemetria di esempio: eventi di diagnostica live personalizzatiSample Telemetry: Custom Live Diagnostic Events

Per impostazione predefinita, il feed live degli eventi mostra esempi di richieste non riuscite e chiamate di dipendenza, eccezioni, eventi e tracce.By default, the live feed of events shows samples of failed requests and dependency calls, exceptions, events, and traces. Fare clic sull'icona del filtro per visualizzare i criteri applicati in un punto qualsiasi nel tempo.Click the filter icon to see the applied criteria at any point in time.

Feed live predefinito

Così come con le metriche, è possibile specificare i criteri arbitrari per i tipi di dati di Application Insights Telemetry.As with metrics, you can specify any arbitrary criteria to any of the Application Insights telemetry types. In questo esempio, vengono selezionati eventi, tracce e richieste non riuscite specifiche.In this example, we are selecting specific request failures, traces, and events. Vengono selezionate anche tutte le eccezioni e gli errori di dipendenza.We are also selecting all exceptions and dependency failures.

Feed live personalizzati

Nota: attualmente, per i criteri di eccezione basati sul messaggio, usare il messaggio di eccezione più esterno.Note: Currently, for Exception message-based criteria, use the outermost exception message. Nell'esempio precedente, per filtrare l'eccezione di tipo benigno con messaggio di eccezione interna, segue il delimitatore "<--", "Il client si è disconnesso."In the preceding example, to filter out the benign exception with inner exception message (follows the "<--" delimiter) "The client disconnected." usare un criterio che non contiene il messaggio "Errore durante la lettura del contenuto della richiesta".use a message not-contains "Error reading request content" criteria.

Visualizzare i dettagli di un elemento nel feed live facendovi clic sopra.See the details of an item in the live feed by clicking it. È possibile sospendere il feed facendo clic su Sospendi o semplicemente scorrendo verso il basso o facendo clic su un elemento.You can pause the feed either by clicking Pause or simply scrolling down, or clicking an item. Il feed live verrà ripreso se, scorrendo, si torna all'inizio o facendo clic sul contatore degli elementi raccolti che era stato sospeso.Live feed will resume after you scroll back to the top, or by clicking the counter of items collected while it was paused.

Errori live campionati

Filtro per istanza di serverFilter by server instance

Se si vuole monitorare un'istanza specifica del ruolo server, è possibile applicare un filtro per server.If you want to monitor a particular server role instance, you can filter by server.

Errori live campionati

Requisiti SDKSDK Requirements

Live Metrics Stream personalizzato è disponibile con la versione 2.4.0-beta2 o più recente di Application Insights SDK per il Web.Custom Live Metrics Stream is available with version 2.4.0-beta2 or newer of Application Insights SDK for web. Ricordarsi di selezionare l'opzione "Includi versione preliminare" da Gestione pacchetti di NuGet.Remember to select "Include Prerelease" option from NuGet package manager.

Proteggere il canale di controlloSecure the control channel

I criteri di filtri personalizzati specificati dall'utente vengono inviati al componente Metriche attive in Application Insights SDK.The custom filters criteria you specify are sent back to the Live Metrics component in the Application Insights SDK. I filtri potrebbero contenere informazioni riservate, ad esempio ID cliente.The filters could potentially contain sensitive information such as customerIDs. È possibile proteggere il canale con una chiave privata API e con la chiave di strumentazione.You can make the channel secure with a secret API key in addition to the instrumentation key.

Creare una chiave APICreate an API Key

Creare una chiave API

Aggiungere una chiave API alla configurazioneAdd API key to Configuration

Nel file applicationinsights.config aggiungere AuthenticationApiKey a 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> 

Oppure nel codice impostarla in QuickPulseTelemetryModule:Or in code, set it on the QuickPulseTelemetryModule:


    module.AuthenticationApiKey = "YOUR-API-KEY-HERE";

Tuttavia, se l'utente riconosce tutti i server collegati e li ritiene affidabili, è possibile provare i filtri personalizzati senza il canale autenticato.However, if you recognize and trust all the connected servers, you can try the custom filters without the authenticated channel. Questa opzione è disponibile per sei mesi.This option is available for six months. Questa sostituzione è necessaria una volta per ogni nuova sessione oppure quando un nuovo server è online.This override is required once every new session, or when a new server comes online.

Opzioni di autenticazione delle metriche attive

Nota

È consigliabile configurare il canale autenticato prima di immettere informazioni potenzialmente riservate, ad esempio CustomerID nei criteri di filtro.We strongly recommend that you set up the authenticated channel before entering potentially sensitive information like CustomerID in the filter criteria.

Generazione di un carico di test delle prestazioniGenerating a performance test load

Se si desidera osservare l'effetto di un aumento del carico, usare il pannello Test delle prestazioni.If you want to watch the effect of a load increase, use the Performance Test blade. Simula le richieste da un certo numero di utenti simultanei.It simulates requests from a number of simultaneous users. Può eseguire "test manuale", ovvero test ping, di un singolo URL o un test delle prestazioni Web in più passaggi caricato, proprio come un test di disponibilità.It can run either "manual tests" (ping tests) of a single URL, or it can run a multi-step web performance test that you upload (in the same way as an availability test).

Suggerimento

Dopo aver creato il test delle prestazioni, aprire il test e il pannello Live Stream in finestre distinte.After you create the performance test, open the test and the Live Stream blade in separate windows. È possibile visualizzare l'avvio del test delle prestazioni in coda e il flusso live nello stesso momento.You can see when the queued performance test starts, and watch live stream at the same time.

Risoluzione dei problemiTroubleshooting

Dati non visualizzatiNo data? Se l'applicazione si trova in una rete protetta: Live Metrics Stream usa un indirizzo IP diverso dagli altri dati di Application Insights Telemetry.If your application is in a protected network: Live Metrics Stream uses a different IP addresses than other Application Insights telemetry. Assicurarsi che tali indirizzi IP siano aperti nel firewall.Make sure those IP addresses are open in your firewall.

Passaggi successiviNext steps