Installare o abilitare il servizio Analytics
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
Per Azure DevOps Server 2020 e versioni successive, il servizio Analytics è disponibile a livello generale. Viene abilitata automaticamente per tutte le nuove raccolte di progetti aggiunte al server. Per le raccolte di progetti aggiornate da una versione precedente, potrebbe essere necessario abilitarla manualmente. È possibile abilitare Analytics per ogni raccolta di progetti per cui si vogliono generare report di Analisi.
Analisi è disponibile in anteprima per Azure DevOps Server 2019. Per Azure DevOps Server 2019, installare l'estensione Analytics dal marketplace locale per ogni raccolta di progetti che si vuole usare Analytics. Per Azure DevOps Server 2019.1, si abilita Analytics per ogni raccolta di progetti che si vuole usare Analytics. Analytics supporta
Nota
L'estensione Di Analytics Marketplace e Analytics non sono supportate per TFS 2018 o versioni precedenti.
Analytics supporta l'accesso ai widget di Analisi per tutti i progetti definiti nella raccolta di progetti. Per altre informazioni, vedere Informazioni su Analisi e widget basati su Analytics. I dati disponibili in Analytics sono riepilogati in Dati disponibili in Analisi.
Prerequisiti
Per Azure DevOps Server 2019.1:
- È necessario aver installato e configurato il Azure DevOps Server. Per informazioni dettagliate, vedere Installare e configurare Azure DevOps in locale.
- È necessario aver aggiunto almeno una raccolta di progetti. Per aggiungere raccolte di progetti, vedere Gestire le raccolte di progetti.
- Per abilitare, sospendere, disabilitare o riprendere Analisi, è necessario essere membri del gruppoAmministratori raccolta progetti con autorizzazioniModifica informazioni a livello di raccolta.
Per Azure DevOps Server 2019:
- È necessario aver installato e configurato il Azure DevOps Server. Per informazioni dettagliate, vedere Installare e configurare Azure DevOps in locale.
- È necessario aver aggiunto almeno una raccolta di progetti. Per aggiungere raccolte di progetti, vedere Gestire le raccolte di progetti.
- Per installare un'estensione, è necessario essere un membro del gruppo Amministratoriraccolta progetti con autorizzazioni Modifica informazioni a livello di raccolta Se non si dispone delle autorizzazioni, è possibile richiedere estensioni.
- Per caricare un'estensione, è necessario essere un membro del gruppo Azure DevOps Server Administrators con autorizzazioniModifica informazioni a livello di istanza.
Abilitare Analisi
Se è stato eseguito l'aggiornamento a Azure DevOps Server 2019.1, è possibile abilitare Analytics per una raccolta di progetti seguendo questa procedura. In caso contrario, per Azure DevOps Server 2019, vedere Installare Analytics.
Nota
Analisi viene abilitata automaticamente per tutte le raccolte di progetti appena create.
Da un Web browser selezionare (1) la raccolta di progetti, (2) Impostazioni raccolta o Amministrazione impostazioni e quindi (3) Analisi.
Selezionare Abilita analisi.
Dopo l'abilitazione, i processi di gestione temporanea di Analytics iniziano a popolare le tabelle dati di Analytics. Questo processo potrebbe richiedere del tempo a seconda delle dimensioni della raccolta. Per altre informazioni sulle tabelle dati, vedere Modello di dati di Analisi.
Sospendere o disabilitare Analisi
Se è stato eseguito l'aggiornamento a Azure DevOps Server 2019.1, è possibile sospendere o disabilitare Analisi per una raccolta di progetti seguendo questa procedura. In caso contrario, per Azure DevOps Server 2019, le azioni equivalenti sono disabilitare o disinstallare l'estensione Analytics.
È possibile sospendere o disabilitare solo Analisi abilitata in precedenza.
Nella pagina Impostazioni di Analisi selezionare Sospendi Analisi o Disabilita Analisi.
Verificare di voler sospendere o disabilitare il servizio.
Riprendi Analisi
Per Azure DevOps Server 2019.1, è possibile riprendere Analytics dopo averlo sospeso per una raccolta di progetti. La ripresa del servizio riabiliterà i processi di staging, che aggiorneranno le tabelle dati e li renderanno correnti, aggiornandoli dopo l'ora in cui è stata sospesa.
Nella pagina Impostazioni di Analisi selezionare Riprendi analisi.
Verificare di voler riprendere il servizio.
Dopo l'abilitazione, i processi di gestione temporanea di Analytics iniziano a popolare le tabelle dati di Analytics. Questo processo potrebbe richiedere del tempo a seconda delle dimensioni della raccolta.
Cosa accade se si sospende o si disabilita Analytics?
La sospensione di Analytics o la disabilitazione dell'estensione Analytics (2019) disabilita le funzionalità seguenti:
- Widget di analisi
- Report in contesto di analisi, ad esempio report di pipeline e test
- Integrazione di Power BI con le visualizzazioni di Analytics
- Query di endpoint OData
La sospensione di Analytics mantiene i dati, ma impedisce ai processi di gestione temporanea di aggiornare i dati. È possibile riprendere il servizio in un secondo momento e i dati verranno quindi aggiornati.
La disabilitazione di Analytics o la rimozione dell'estensione Analytics (2019), disattiva tutti i processi di gestione temporanea di Analytics ed elimina i dati di Analytics archiviati nelle tabelle di Analisi. Tutti i dati di Analisi che acquisisce tendenze cronologiche vengono persi. Non elimina altri dati archiviati nella raccolta. Non è possibile annullare questa azione. Una volta eliminati i dati cronologici e i dati di tendenza, non è possibile ripristinarli. La riattivazione di Analytics non ripristina i dati cronologici.
Con Analytics disabilitato o rimosso, si verificano le azioni seguenti:
- Non vengono eseguiti processi di staging e le tabelle di Analisi non avranno informazioni aggiornate.
- I dati delle tabelle vengono eliminati e, se Analytics è riabilitata, tutti i dati dovranno essere ripopolati da zero.
Nota
La disabilitazione di Analytics in Azure DevOps Server 2019.1 equivale alla disinstallazione dell'estensione Analytics per Azure DevOps Server 2019.
Per altre informazioni sulle tabelle dati, vedere Modello di dati di Analisi.
Installare l'estensione Analytics
Se non è stato eseguito l'aggiornamento a Azure DevOps Server 2019.1, è possibile installare l'estensione Analytics per ottenere l'accesso ai widget e ai report di Analisi per la raccolta di progetti. L'estensione Analytics viene fornita all'interno del programma di installazione locale. L'installazione dell'estensione consente semplicemente di abilitare la funzionalità. Non è necessario scaricare manualmente i file di estensione per l'installazione.
Suggerimento
L'estensione Analytics viene visualizzata nella raccolta locale per Azure DevOps Server in modo che non sia necessario scaricarla da Azure DevOps Marketplace.
Da un Web browser selezionare (1) la raccolta di progetti, (2) Amministrazione impostazioni e quindi (3) Estensioni.
Selezionare Sfoglia estensioni locali.
Nota
L'installazione dell'estensione dal marketplace locale è identica all'installazione dal marketplace ospitato. L'unica differenza è che il marketplace ospitato mostra le classificazioni delle estensioni e i commenti degli utenti.
Il Marketplace locale viene aperto in una nuova scheda del browser. Selezionare la scheda dell'estensione Analytics.
Selezionare Scarica gratuitamente.
Selezionare la raccolta di progetti e quindi selezionare Installa.
Al termine dell'installazione, verrà visualizzata un'immagine simile alla seguente. Selezionare Vai alla raccolta per tornare al portale Web per la raccolta.
Facoltativamente, se si vuole installare l'estensione Analytics in altre raccolte di progetti, selezionare il pulsante indietro del browser.
Disabilitare o disinstallare l'estensione Analytics
Se si sceglie di disabilitare l'estensione Analytics, i processi verranno arrestati. I dati di analisi non saranno sincronizzati e le funzionalità associate non saranno disponibili. Tuttavia, nessun dato viene eliminato. La disinstallazione dell'estensione Analisi elimina i dati dalle tabelle di database di Analisi. Dopo la reinstallazione dell'estensione, i dati vengono ripopolati da zero.
Aprire il menu estensioni e selezionare Gestisci estensioni.
Nella scheda Gestisci aprire il menu di scelta rapida per l'estensione.
Selezionare Disabilita o Disinstalla in base alle esigenze.
Ripristinare l'estensione analisi se rimossa dalla distribuzione
Se si rimuove l'estensione Analytics dalla distribuzione, è possibile installare l'estensione dal marketplace online per ripristinarla. Potrebbe non essere possibile usare il marketplace online a causa della configurazione del server. Ad esempio, il firewall potrebbe bloccare alcune connessioni in uscita. Anche se questo è il caso, è possibile ripristinarlo nel marketplace locale usando la procedura seguente.
Aprire le impostazioni della raccolta seguendo le istruzioni fornite nella sezione Installare l'estensione Analytics.
Selezionare Estensioni e quindi Sfoglia estensioni locali.
Scorrere fino alla fine della pagina e selezionare Gestisci estensioni.
Selezionare Carica estensione e quindi fare clic su per caricare. Passare alla cartella contenente il file Microsoft.TeamFoundation.Extension.Analytics.vsix.
Il file con estensione vsix è disponibile nell'installazione della cartella a livello di applicazione nel percorso seguente.
C:\Program Files\Azure DevOps Server 2019\Tools\Deploy\TfsServicingFiles\Extensions\Microsoft.TeamFoundation.Extension.Analytics.vsixIl caricamento dell'estensione lo ripristina nel marketplace locale. Da qui è possibile installarlo in una raccolta.
Come determinare se il server è disconnesso?
Se il server è disconnesso da Internet, è necessario installare Analytics dal marketplace locale.
È possibile determinare se la Azure DevOps Server è in uno stato disconnesso. Verificare se l'icona connessa e il nome del server vengono visualizzati nella parte superiore durante l'esplorazione del marketplace ospitato.
Quando si passa al Marketplace dal server locale, un errore non viene visualizzato se non si è connessi. Passa semplicemente al contesto del servizio cloud.
Problema noto
Se si usa un URL pubblico per installare l'estensione, ad esempio , è possibile che venga visualizzato un errore di callback, ad esempio https://OnPrem.MyCompany.comun errore TLS/SSL.
Per risolvere questo problema, è possibile installare l'estensione da un computer che ospita il livello applicazione e puntare all'URL del computer locale, ad esempio https://myMachineName.
Articoli correlati
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per