Introduzione ad Application Insights con Java in EclipseGet started with Application Insights with Java in Eclipse

SDK di Application Insights invia dati di telemetria dall'applicazione Web Java in modo da poter analizzare l'uso e le prestazioni.The Application Insights SDK sends telemetry from your Java web application so that you can analyze usage and performance. Il plug-in Eclipse per Application Insights installa automaticamente SDK nel progetto in modo da ottenere i dati di telemetria predefiniti, oltre a un'API che è possibile usare per scrivere dati di telemetria personalizzati.The Eclipse plug-in for Application Insights automatically installs the SDK in your project so that you get out of the box telemetry, plus an API that you can use to write custom telemetry.

PrerequisitiPrerequisites

Attualmente il plug-in funziona per progetti Mavern e progetti Dynamic Web in Eclipse.Currently the plug-in works for Maven projects and Dynamic Web Projects in Eclipse. Aggiungere Application Insights ad altri tipi di progetti Java.(Add Application Insights to other types of Java project.)

Sono necessari gli elementi seguenti:You'll need:

Installare SDK su Eclipse (una volta)Install the SDK on Eclipse (one time)

È sufficiente eseguire questa operazione una volta per ogni macchina.You only have to do this one time per machine. Con questo passaggio viene installato un toolkit che può quindi aggiungere SDK a ciascun progetto Web dinamico.Con questo passaggio viene installato un toolkit che può quindi aggiungere SDK a ciascun Dynamic Web Project.This step installs a toolkit which can then add the SDK to each Dynamic Web Project.

  1. Dal menu Help di Eclipse scegliere Install New Software.In Eclipse, click Help, Install New Software.

    Guida in linea, Installa nuovo Software

  2. L'SDK è disponibile alla pagina http://dl.microsoft.com/eclipse in Azure Toolkit.The SDK is in http://dl.microsoft.com/eclipse, under Azure Toolkit.
  3. Deselezionare l'opzione Contatta tutti i siti di aggiornamento...Uncheck Contact all update sites...

    Per Application Insights SDK deselezionare tutti i siti di aggiornamento Contatta tutti

Seguire i passaggi rimanenti per ogni progetto Java.Follow the remaining steps for each Java project.

Creare una risorsa di Application Insights in AzureCreate an Application Insights resource in Azure

  1. Accedere al portale di Azure.Sign in to the Azure portal.
  2. Creare una nuova risorsa di Application Insights.Create a new Application Insights resource. Impostare il tipo di applicazione nell'applicazione Web Java.Set the application type to Java web application.

    Fare clic su + e scegliere Application Insights

  3. Ottenere la chiave di strumentazione della nuova risorsa.Find the instrumentation key of the new resource. Dopo poco sarà necessario incollarla in questo progetto del codice.You'll need to paste this into your code project shortly.

    Nella panoramica della nuova risorsa, fare clic su Proprietà e copiare la chiave di strumentazione

Aggiunta di Application Insights al progettoAdd Application Insights to your project

  1. Aggiungere Application Insights dal menu di scelta rapida del progetto Web Java.Add Application Insights from the context menu of your Java web project.

    Nella panoramica della nuova risorsa, fare clic su Proprietà e copiare la chiave di strumentazione

  2. Incollare la chiave di strumentazione recuperata dal portale di Azure.Paste the instrumentation key that you got from the Azure portal.

    Nella panoramica della nuova risorsa, fare clic su Proprietà e copiare la chiave di strumentazione

La chiave viene inviata insieme a tutti gli elementi di dati di telemetria e indica ad Application Insights di visualizzarla nella risorsa.The key is sent along with every item of telemetry and tells Application Insights to display it in your resource.

Eseguire l'applicazione e visualizzare le metricheRun the application and see metrics

Eseguire l'applicazione.Run your application.

Tornare alla risorsa di Application Insights in Microsoft Azure.Return to your Application Insights resource in Microsoft Azure.

Nel pannello Panoramica verranno visualizzati i dati delle richieste HTTP.HTTP requests data will appear on the overview blade. Se non sono visualizzati, attendere alcuni secondi e quindi fare clic su Aggiorna.(If it isn't there, wait a few seconds and then click Refresh.)

<span data-ttu-id="3fa5a-142">Risposta del server, conteggi delle richieste ed errori</span><span class="sxs-lookup"><span data-stu-id="3fa5a-142">Server response, request counts, and failures</span></span>

Fare clic su qualsiasi grafico per visualizzare metriche più dettagliate.Click through any chart to see more detailed metrics.

Numero di richieste per nome

Altre informazioni sulle metriche.Learn more about metrics.

E quando si visualizzano le proprietà di una richiesta, è possibile visualizzare gli eventi di telemetria associati, ad esempio le richieste e le eccezioni.And when viewing the properties of a request, you can see the telemetry events associated with it such as requests and exceptions.

Tutte le tracce per questa richiesta

Telemetria sul lato clientClient-side telemetry

Dal pannello Avvio rapido fare clic su Recupera codice per monitorare le pagine Web:From the QuickStart blade, click Get code to monitor my web pages:

Nel pannello di panoramica delle app, scegliere Avvio rapido, quindi ottenere il codice per monitorare le pagine Web.

Inserire il frammento di codice nella parte iniziale dei file HTML.Insert the code snippet in the head of your HTML files.

Visualizzare i dati lato clientView client-side data

Aprire le pagine Web aggiornate e usarle.Open your updated web pages and use them. Attendere uno o due minuti, quindi tornare ad Application Insights e aprire il pannello Utilizzo.Wait a minute or two, then return to Application Insights and open the usage blade. (Nel pannello Panoramica scorrere verso il basso e fare clic su Utilizzo.)(From the Overview blade, scroll down and click Usage.)

Le metriche di visualizzazioni pagine, utenti e sessioni verranno visualizzate nel pannello Utilizzo:Page view, user, and session metrics will appear on the usage blade:

Sessioni, utenti e visualizzazioni pagina

Altre informazioni sulla configurazione della telemetria sul lato client.Learn more about setting up client-side telemetry.

Pubblicare l'applicazionePublish your application

A questo punto è possibile pubblicare l'applicazione nel server, permettere agli utenti di utilizzarla e visualizzare la telemetria mostrata nel portale.Now publish your app to the server, let people use it, and watch the telemetry show up on the portal.

  • Verificare che il firewall consenta all'applicazione di inviare i dati di telemetria a queste porte:Make sure your firewall allows your application to send telemetry to these ports:

    • dc.services.visualstudio.com:443dc.services.visualstudio.com:443
    • dc.services.visualstudio.com:80dc.services.visualstudio.com:80
    • f5.services.visualstudio.com:443f5.services.visualstudio.com:443
    • f5.services.visualstudio.com:80f5.services.visualstudio.com:80
  • Nei server Windows installare:On Windows servers, install:

Eccezioni e richieste non eseguiteExceptions and request failures

Vengono raccolte automaticamente le eccezioni non gestite:Unhandled exceptions are automatically collected:

Per raccogliere dati su altre eccezioni, sono disponibili due opzioni:To collect data on other exceptions, you have two options:

Monitorare le chiamate al metodo e le dipendenze esterneMonitor method calls and external dependencies

Installare l'agente Java per registrare i metodi interni specificati e le chiamate effettuate tramite JDBC, con i dati relativi alle durate.Install the Java Agent to log specified internal methods and calls made through JDBC, with timing data.

Contatori delle prestazioniPerformance counters

Nel pannello Panoramica scorrere verso il basso e fare clic sul riquadro Server.On your Overview blade, scroll down and click the Servers tile. Verrà visualizzato un intervallo di contatori delle prestazioni.You'll see a range of performance counters.

Scorrere verso il basso fare clic sul riquadro Server

Personalizzare la raccolta del contatore delle prestazioniCustomize performance counter collection

Per disabilitare la raccolta del set standard di contatori delle prestazioni, aggiungere il seguente codice al di sotto del nodo principale del file ApplicationInsights.xml:To disable collection of the standard set of performance counters, add the following code under the root node of the ApplicationInsights.xml file:


    <PerformanceCounters>
       <UseBuiltIn>False</UseBuiltIn>
    </PerformanceCounters>

Raccogliere dei contatori di prestazioni aggiuntiveCollect additional performance counters

È possibile specificare altri contatori di prestazioni da raccogliere.You can specify additional performance counters to be collected.

Contatori JMX (esposti da Java Virtual Machine)JMX counters (exposed by the Java Virtual Machine)


    <PerformanceCounters>
      <Jmx>
        <Add objectName="java.lang:type=ClassLoading" attribute="TotalLoadedClassCount" displayName="Loaded Class Count"/>
        <Add objectName="java.lang:type=Memory" attribute="HeapMemoryUsage.used" displayName="Heap Memory Usage-used" type="composite"/>
      </Jmx>
    </PerformanceCounters>
  • displayName : il nome visualizzato nel portale di Application Insights.displayName – The name displayed in the Application Insights portal.
  • objectName : il nome dell'oggetto JMX.objectName – The JMX object name.
  • attribute : l'attributo del nome dell'oggetto JMX da recuperareattribute – The attribute of the JMX object name to fetch
  • type (facoltativo): il tipo di attributo dell'oggetto JMX:type (optional) - The type of JMX object’s attribute:
    • Impostazione predefinita: un tipo semplice come int o long.Default: a simple type such as int or long.
    • composite: i dati del contatore delle prestazioni sono nel formato 'Attribute.Data'composite: the perf counter data is in the format of 'Attribute.Data'
    • tabular: i dati del contatore delle prestazioni sono nel formato della riga di una tabellatabular: the perf counter data is in the format of a table row

Contatori delle prestazioni di WindowsWindows performance counters

Ogni contatore delle prestazioni Windows è un membro di una categoria (nello stesso modo in cui un campo è un membro di una classe).Each Windows performance counter is a member of a category (in the same way that a field is a member of a class). Le categorie possono essere globali o possono disporre di istanze numerate o denominate.Categories can either be global, or can have numbered or named instances.


    <PerformanceCounters>
      <Windows>
        <Add displayName="Process User Time" categoryName="Process" counterName="%User Time" instanceName="__SELF__" />
        <Add displayName="Bytes Printed per Second" categoryName="Print Queue" counterName="Bytes Printed/sec" instanceName="Fax" />
      </Windows>
    </PerformanceCounters>
  • displayName: il nome visualizzato nel portale di Application Insights.displayName – The name displayed in the Application Insights portal.
  • categoryName: la categoria del contatore delle prestazioni (oggetto prestazioni) a cui è associato questo contatore delle prestazioni.categoryName – The performance counter category (performance object) with which this performance counter is associated.
  • counterName: il nome del contatore delle prestazioni.counterName – The name of the performance counter.
  • instanceName: il nome dell'istanza di categoria del contatore delle prestazioni o una stringa vuota (""), se la categoria contiene una singola istanza.instanceName – The name of the performance counter category instance, or an empty string (""), if the category contains a single instance. Se categoryName è il processo e il contatore delle prestazioni di cui raccogliere i dati proviene dal processo JVM corrente su cui è in esecuzione l'app, specificare "__SELF__".If the categoryName is Process, and the performance counter you'd like to collect is from the current JVM process on which your app is running, specify "__SELF__".

I contatori delle prestazioni sono visibili come metriche personalizzate in Esplora metriche.Your performance counters are visible as custom metrics in Metrics Explorer.

Contatori delle prestazioni UnixUnix performance counters

Test Web di disponibilitàAvailability web tests

Application Insights può testare il sito Web a intervalli regolari per verificare che funzioni e risponda correttamente.Application Insights can test your website at regular intervals to check that it's up and responding well. Per eseguire la configurazione, scorrere verso il basso e fare clic su Disponibilità.To set up, scroll down to click Availability.

Scorrere verso il basso, fare clic su Disponibilità, quindi su Aggiungi test Web

Se il sito è inattivo, si otterranno grafici dei tempi di risposta, nonché notifiche di posta elettronica.You'll get charts of response times, plus email notifications if your site goes down.

Esempio di test Web

Altre informazioni sui test Web di disponibilità.Learn more about availability web tests.

Log di diagnosticaDiagnostic logs

Se si usa Logback o Log4J (v1.2 o v2.0) per la traccia, è possibile inviare automaticamente i log di traccia ad Application Insights dove è possibile esplorarli e eseguirvi ricerche.If you're using Logback or Log4J (v1.2 or v2.0) for tracing, you can have your trace logs sent automatically to Application Insights where you can explore and search on them.

Altre informazioni sui log di diagnosticaLearn more about diagnostic logs

Telemetria personalizzataCustom telemetry

Inserire alcune righe di codice nell'applicazione Web Java per scoprire come viene usato dagli utenti o per agevolare la diagnosi dei problemi.Insert a few lines of code in your Java web application to find out what users are doing with it or to help diagnose problems.

È possibile inserire il codice sia nella pagina Web JavaScript che in Java lato server.You can insert code both in web page JavaScript and in the server-side Java.

Informazioni sulla telemetria personalizzataLearn about custom telemetry

Passaggi successiviNext steps

Rilevare e diagnosticare i problemiDetect and diagnose issues

Tenere traccia dell'utilizzoTrack usage