Analizzare e condividere i dati di utilizzo con cartelle di lavoro interattive in Application InsightsInvestigate and share usage data with interactive workbooks in Application Insights

Le cartelle di lavoro combinano le visualizzazioni dei dati di Azure Application Insights, le query di Analisi e il testo in documenti interattivi.Workbooks combine Azure Application Insights data visualizations, Analytics queries, and text into interactive documents. Le cartelle di lavoro possono essere modificate da altri membri del team con accesso alla stessa risorsa di Azure.Workbooks are editable by other team members with access to the same Azure resource. Ciò significa che le query e i controlli usati per creare una cartella di lavoro sono disponibili ad altri utenti che leggono la cartella di lavoro semplificandone l'esplorazione, l'estensione e la ricerca di errori.This means the queries and controls used to create a workbook are available to other people reading the workbook, making them easy to explore, extend, and check for mistakes.

Le cartelle di lavoro sono utili per scenari simili ai seguenti:Workbooks are helpful for scenarios like:

  • Esplorazione dell'utilizzo dell'app quando non si conoscono le metriche di interesse in anticipo, ovvero il numero di utenti, i tassi di fidelizzazione, i tassi di conversione e così via. A differenza di altri strumenti di analisi dell'utilizzo di Application Insights, le cartelle di lavoro consentono di combinare più tipi di visualizzazioni e analisi risultando ideali per questo tipo di esplorazione in formato libero.Exploring the usage of your app when you don't know the metrics of interest in advance: numbers of users, retention rates, conversion rates, etc. Unlike other usage analytics tools in Application Insights, workbooks let you combine multiple kinds of visualizations and analyses, making them great for this kind of free-form exploration.
  • Descrizione al proprio team delle prestazioni di una nuova funzionalità rilasciata visualizzando i conteggi degli utenti per le interazioni chiave e altre metriche.Explaining to your team how a newly released feature is performing, by showing user counts for key interactions and other metrics.
  • Condivisione dei risultati di un esperimento A/B nell'app con altri membri del team.Sharing the results of an A/B experiment in your app with other members of your team. È possibile descrivere gli obiettivi dell'esperimento usando testo e visualizzare ogni metrica di utilizzo e query di Analisi usate per valutare l'esperimento con callout chiari che indicano se la singola metrica è al di sopra o al di sotto del target.You can explain the goals for the experiment with text, then show each usage metric and Analytics query used to evaluate the experiment, along with clear call-outs for whether each metric was above- or below-target.
  • Segnalazione dell'impatto di un'interruzione nell'utilizzo dell'app, combinazione dei dati, spiegazione del testo e descrizione dei passaggi successivi per impedire interruzioni future.Reporting the impact of an outage on the usage of your app, combining data, text explanation, and a discussion of next steps to prevent outages in the future.

Nota

La risorsa di Application Insights deve contenere visualizzazioni di pagina o eventi personalizzati per usare le cartelle di lavoro.Your Application Insights resource must contain page views or custom events to use workbooks. Vedere le informazioni su come configurare l'app per la raccolta automatica delle visualizzazioni di pagina con Application Insights JavaScript SDK.Learn how to set up your app to collect page views automatically with the Application Insights JavaScript SDK.

Modifica, ridisposizione, clonazione ed eliminazione di sezioni delle cartelle di lavoroEditing, rearranging, cloning, and deleting workbook sections

Una cartella di lavoro è costituita da sezioni: visualizzazioni dell'utilizzo modificabili separatamente, grafici, tabelle, testo o risultati delle query di Analisi.A workbook is a made of sections: independently editable usage visualizations, charts, tables, text, or Analytics query results.

Per modificare il contenuto di una sezione di una cartella di lavoro, fare clic sul pulsante Modifica sotto e a destra della sezione.To edit the contents of a workbook section, click the Edit button below and to the right of the workbook section.

Controlli di modifica delle sezioni delle cartelle di controllo di Application Insights

  1. Dopo aver modificato una sezione, fare clic su Modifica completata nell'angolo inferiore sinistro della sezione.When you're done editing a section, click Done Editing in the bottom left corner of the section.

  2. Per creare un duplicato di una sezione, fare clic sull'icona Clona questa sezione.To create a duplicate of a section, click the Clone this section icon. La creazione di sezioni duplicate è un ottimo modo per eseguire l'iterazione in una query senza perdere le iterazioni precedenti.Creating duplicate sections is a great to way to iterate on a query without losing previous iterations.

  3. Per spostare una sezione verso l'alto in una cartella di lavoro, fare clic sull'icona Sposta in alto o Sposta giù.To move up a section in a workbook, click the Move up or Move down icon.

  4. Per rimuovere una sezione in modo permanente, fare clic sull'icona Rimuovi.To remove a section permanently, click the Remove icon.

Aggiunta di sezioni di visualizzazioni dei dati di utilizzoAdding usage data visualization sections

Le cartelle di lavoro offrono quattro tipi di visualizzazioni di analisi di utilizzo predefiniti.Workbooks offer four types of built-in usage analytics visualizations. Ogni tipo risponde a una domanda comune sull'utilizzo dell'app.Each answers a common question about the usage of your app. Per aggiungere tabelle e grafici diversi da queste quattro sezioni, aggiungere sezioni di query di Analisi (vedere sotto).To add tables and charts other than these four sections, add Analytics query sections (see below).

Per aggiungere una sezione Utenti, Sessioni, Eventi o Conservazione alla cartella di lavoro, usare il pulsante Aggiungi utenti o un pulsante corrispondente nella parte inferiore della cartella di lavoro o di una sezione.To add a Users, Sessions, Events, or Retention section to your workbook, use the Add Users or other corresponding button at the bottom of the workbook, or at the bottom of any section.

Sezione Utenti nelle cartelle di lavoro

Le sezioni Utenti rispondono alla domanda "Quanti utenti hanno visualizzato una pagina o usato una funzionalità del sito?"Users sections answer "How many users viewed some page or used some feature of my site?"

Le sezioni Sessioni rispondono alla domanda "Per quante sessioni gli utenti hanno visualizzato una pagina o usato una funzionalità del sito?"Sessions sections answer "How many sessions did users spend viewing some page or using some feature of my site?"

Le sezioni Eventi rispondono alla domanda "Quante volte gli utenti hanno visualizzato una pagina o usato una funzionalità del sito?"Events sections answer "How many times did users view some page or use some feature of my site?"

Ognuno di questi tre tipi di sezione include gli stessi insiemi di controlli e visualizzazioni:Each of these three section types offers the same sets of controls and visualizations:

  • Vedere le informazioni sulla modifica delle sezioni Utenti, Sessioni ed EventiLearn more about editing Users, Sessions, and Events sections
  • Attivare o disattivare il grafico principale, le griglie degli istogrammi, le informazioni dettagliate automatiche e le visualizzazioni utenti di esempio usando le caselle di controllo Mostra grafico, Mostra griglia, Mostra i dettagli e Esempio di questi utenti nella parte superiore di ogni sezione.Toggle the main chart, histogram grids, automatic insights, and sample users visualizations using the Show Chart, Show Grid, Show Insights, and Sample of These Users checkboxes at the top of each section.

Sezione Conservazione nelle cartelle di lavoro

Le sezioni Conservazione rispondono alla domanda "Degli utenti che hanno visualizzato una pagina o usato una funzionalità in un determinato giorno o settimana quanti sono tornati un giorno o una settimana successiva?"Retention sections answer "Of people who viewed some page or used some feature on one day or week, how many came back in a subsequent day or week?"

Aggiunta di sezioni di analisi di Application InsightsAdding Application Insights Analytics sections

Sezione di analisi nelle cartelle di lavoro

Per aggiungere una sezione di query di Analisi di Application Insights alla cartella di lavoro, usare il pulsante Aggiungi query di analisi nella parte inferiore della cartella di lavoro o nella parte inferiore di una sezione.To add an Application Insights Analytics query section to your workbook, use the Add Analytics query button at the bottom of the workbook, or at the bottom of any section.

Le sezioni delle query di Analisi consentono di aggiungere query arbitrarie nei dati di Application Insights nelle cartelle di lavoro.Analytics query sections let you add arbitrary queries over your Application Insights data into workbooks. Questa flessibilità consente di usare le sezioni di query di Analisi per rispondere a qualsiasi domanda sul sito diversa dalle quattro domande indicate in precedenza per le sezioni Utenti, Sessioni, Eventi e Conservazione, ad esempio:This flexibility means Analytics query sections should be your go-to for answering any questions about your site other than the four listed above for Users, Sessions, Events, and Retention, like:

  • Quante eccezioni ha generato il sito nello stesso periodo di tempo come riduzione dell'utilizzo?How many exceptions did your site throw during the same time period as a decline in usage?
  • Qual è stata la distribuzione dei tempi di caricamento della pagina per gli utenti che visualizzano una pagina?What was the distribution of page load times for users viewing some page?
  • Quanti utenti hanno visualizzato un insieme di pagine nel sito ma non un altro insieme di pagine?How many users viewed some set of pages on your site, but not some other set of pages? Queste informazioni possono essere utili per comprendere se sono presenti cluster di utenti che usano sottoinsiemi diversi di funzionalità del sito (usare l'operatore join con il modificatore kind=leftanti nel linguaggio di query di Log Analytics).This can be useful to understand if you have clusters of users who use different subsets of your site's functionality (use the join operator with the kind=leftanti modifier in the Log Analytics query language).

Usare le informazioni di riferimento sul linguaggio di query di Log Analytics per altre informazioni sulla scrittura di query.Use the Log Analytics query language reference to learn more about writing queries.

Aggiunta di sezioni di testo e MarkdownAdding text and Markdown sections

L'aggiunta di intestazioni, spiegazioni e commenti nelle cartelle di lavoro consente di trasformare un insieme di tabelle e grafici in un resoconto.Adding headings, explanations, and commentary to your workbooks helps turn a set of tables and charts into a narrative. Le sezioni di testo nelle cartelle di lavoro supportano la sintassi Markdown per la formattazione del testo, ad esempio intestazioni, grassetto, corsivo ed elenchi puntati.Text sections in workbooks support the Markdown syntax for text formatting, like headings, bold, italics, and bulleted lists.

Per aggiungere una sezione di testo alla cartella di lavoro, usare il pulsante Aggiungi testo nella parte inferiore della cartella di lavoro o nella parte inferiore di una sezione.To add a text section to your workbook, use the Add text button at the bottom of the workbook, or at the bottom of any section.

Salvataggio e condivisione delle cartelle di lavoro con il teamSaving and sharing workbooks with your team

Le cartelle di lavoro vengono salvate all'interno di una risorsa di Application Insights, ovvero nella sezione Report personali privata o nella sezione Report condivisi accessibile a tutti gli utenti che hanno accesso alla risorsa di Application Insights.Workbooks are saved within an Application Insights resource, either in the My Reports section that's private to you or in the Shared Reports section that's accessible to everyone with access to the Application Insights resource. Per visualizzare tutte le cartelle di lavoro della risorsa, fare clic sul pulsante Apri nella barra delle azioni.To view all the workbooks in the resource, click the Open button in the action bar.

Per condividere una cartella di lavoro che è attualmente in Report personali:To share a workbook that's currently in My Reports:

  1. Fare clic su Apri nella barra delle azioniClick Open in the action bar
  2. Fare clic sul pulsante "…" accanto alla cartella di lavoro da condividereClick the "..." button beside the workbook you want to share
  3. Fare clic su Sposta in Report condivisi.Click Move to Shared Reports.

Per condividere una cartella di lavoro con un collegamento o tramite posta elettronica, fare clic su Condividi nella barra delle azioni.To share a workbook with a link or via email, click Share in the action bar. Tenere presente che i destinatari del collegamento necessitano dell'accesso alla risorsa nel portale di Azure per visualizzare la cartella di lavoro.Keep in mind that recipients of the link need access to this resource in the Azure portal to view the workbook. Per apportare modifiche, i destinatari devono avere almeno le autorizzazioni di collaboratori per la risorsa.To make edits, recipients need at least Contributor permissions for the resource.

Per aggiungere un collegamento in una cartella di lavoro in un dashboard di Azure:To pin a link to a workbook to an Azure Dashboard:

  1. Fare clic su Apri nella barra delle azioniClick Open in the action bar
  2. Fare clic sul pulsante "…" accanto alla cartella di lavoro da aggiungereClick the "..." button beside the workbook you want to pin
  3. Fare clic su Aggiungi al dashboard.Click Pin to dashboard.

Passaggi successiviNext steps

Passaggi successiviNext steps