Procedure consigliate per l'analisi

  • Articolo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

L'analisi è la piattaforma di creazione di report per Azure DevOps, che consente di ottenere informazioni dettagliate dai dati e prendere decisioni basate sui dati. L'analisi è ottimizzata per l'accesso in lettura veloce e le aggregazioni basate su server e offre vari strumenti per visualizzare e analizzare i dati. In questo articolo vengono condivise alcune procedure consigliate per l'uso di Analytics in Azure DevOps.

Prerequisiti

  • Per visualizzare i dati di Analisi ed eseguire query sul servizio, è necessario essere membri di un progetto con accesso basic o superiore. Per impostazione predefinita, a tutti i membri del progetto vengono concesse le autorizzazioni per eseguire query su Analisi e definire le visualizzazioni di Analisi.
  • Per altre informazioni sugli altri prerequisiti relativi all'abilitazione di servizi e funzionalità e alle attività generali di rilevamento dei dati, vedere Autorizzazioni e prerequisiti per l'accesso ad Analytics.
  • Se si è uno sviluppatore di estensioni, assicurarsi di esaminare le linee guida per le query di OData Analytics.

Acquisire familiarità con i metadati di Analytics

Eseguire query sui metadati di Analytics per acquisire familiarità con i tipi di entità, i set di entità, le proprietà e gli elenchi enumerati. Per altre informazioni, vedere Eseguire query sul servizio Analisi, sui metadati OData di Analisi e sulle entità e informazioni di riferimento sulle proprietà per Azure Boards.

Strutturare la query per restituire i dati necessari

Per eseguire una query sul set di dati minimo necessario creare il report, seguire queste procedure:

Scegliere il set di entità per supportare il report

Anche se nel modello di dati di Analisi sono supportati diversi EntitySets , solo alcuni vengono usati per generare report.EntitySets usato per creare report rientrano in tre categorie:

  • Corrente: contiene informazioni sulla configurazione corrente dell'oggetto EntityTypes contenuto all'interno di EntitySet.
  • Snapshot: entità composite che combinano dati cronologici e relativi alla data. Le entità snapshot devono essere usate per supportare i report di aggregazione.
  • Revisione: contiene informazioni cronologiche. Ad esempio, WorkItemRevision mantiene i dati relativi alla cronologia degli elementi di lavoro.

Ecco un riferimento rapido per EntityTypes per specificare per supportare i report. Per una descrizione di ognuno di questi EntityType, vedere Modello di dati per Analisi.

Dati di Azure DevOps Corrente Snapshot Revisione
Azure Boards WorkItems WorkItemSnapshot
WorkItemBoardSnapshot		 WorkItemRevisions
Azure Pipelines Pipelines
PipelineTasks		 ParallelPipelineJobsSnapshot
PipelineRuns, PipelineRunActivityResults
Azure Pipelines e test TestResultsDaily TestRuns
Azure Test Plans Tests
TestConfiguration
TestPoints
WorkItems		 TestResultsDaily
TestPointHistorySnapshot

Specificare le parti della query nell'ordine in cui vengono eseguite

L'ordine consigliato per le varie parti di query consiste nel specificarli nell'ordine seguente, ovvero l'ordine in cui vengono valutate. Per una descrizione di ogni parte di query, vedere Eseguire query sul servizio Analisi, Opzioni di query.

  1. $apply
  2. $filter
  3. $orderby
  4. $expand
  5. $select
  6. $skip
  7. $top

Tutte le query devono contenere una $apply clausola o $select . In caso contrario, potrebbe essere visualizzato un messaggio di avviso.

Limitare le colonne richieste nella query

Specificare colonne di dati da restituire usando la $select clausola . Con la personalizzazione, gli elementi di lavoro possono avere numerosi campi associati. Più proprietà o campi a cui fa riferimento una query, più costoso è elaborare. Prendere in considerazione il report da generare e assicurarsi di richiedere solo i campi necessari.

Ad esempio, per restituire i campi ID, Tipo elemento di lavoro, Titolo e Stato per un set filtrato di elementi di lavoro, specificare la clausola seguente $select : $select=WorkItemId, WorkItemType, Title, State.

Per cercare l'elenco delle proprietà e i relativi nomi di campo, vedere Informazioni di riferimento su entità e proprietà per Azure Boards.

Creare query di anteprima

Le query di anteprima sono query che restituiscono un singolo record o un piccolo subset di record. Creando una query di anteprima, è possibile perfezionare la query per assicurarsi di richiedere i dati necessari. A partire da una query minima, è possibile creare la query per assicurarsi di specificare i record desiderati e i dati delle colonne necessari.

apply=aggregate($count as Count)Usando , è possibile identificare il numero di record richiesti. Ad esempio, la sintassi seguente esegue una query sul numero di elementi di lavoro per il progetto Fabrikam Fiber .

https://analytics.dev.azure.com/content-learn/Content/_odata/v4.0-preview/WorkItems? $apply=aggregate($count as Count)

La risposta restituisce un totale di 1415 elementi di lavoro.

{
  "@odata.context": "https://analytics.dev.azure.com/fabrikam/Fabrikam Fbier/_odata/v4.0-preview/$metadata#WorkItems(Count)",
   "value": [
  {
     "@odata.id": null,
   "Count": 1415
  }
  ]
}

Limitare le query ai progetti a cui si ha accesso

Le query con ambito di progetto restituiscono informazioni su un singolo progetto, mentre le query nell'ambito dell'organizzazione sono progettate per restituire informazioni che superano i limiti del progetto. Le query con ambito organizzazione richiedono autorizzazioni utente più ampie o restrizioni di ambito accurate per garantire che la query non venga bloccata a causa di una mancanza di autorizzazioni per il progetto.

Se si ha accesso a uno o più progetti, ma non a tutti i progetti e si invia una query con ambito organizzazione, viene visualizzato un messaggio di errore.

"VS403496: The query results include data in one or more projects for which you do not have access. Add one or more projects filters to specify the project(s) you have access to in 'WorkItems' entity. If you're using $expand or navigation properties, project filter is required for those entities. More information can be found here: https://go.microsoft.com/fwlink/?LinkId=786441."

Per altre informazioni, vedere Query con ambito di progetto e organizzazione.

Esaminare i messaggi di avviso e di errore

Analisi esamina ogni query ricevuta per le violazioni alle relative regole. Restituisce messaggi di avviso quando rileva una violazione. È consigliabile esaminare questi messaggi per correggere o migliorare la struttura di query.

Limiti di velocità e limitazione

Le query eseguite in Analytics per Azure DevOps Services sono soggette a limiti di frequenza. Se vengono inviate troppe query che richiedono la restituzione di grandi quantità di dati entro un breve intervallo di tempo, il servizio potrebbe essere soggetto a limitazioni. Per altre informazioni, vedere Limiti di frequenza e utilizzo.

È possibile esaminare l'utilizzo per il servizio e per i singoli utenti passando a Organization Impostazioni> Usage ed esercitando i filtri. Ad esempio, l'immagine seguente mostra l'utilizzo di Jamal Hartnett al servizio Analytics.

Screenshot della pagina Utilizzo per un singolo utente e Analisi.