Risoluzione dei problemi relativi al servizio aggregatore Analytics

  • Articolo

Hh973127.collapse(it-it,VS.110).gifHh973127.expand(it-it,VS.110).gifHh973127.copycode(it-it,VS.110).gifHh973127.copycodeHighlight(it-it,VS.110).gifHh973127.drpdown(it-it,VS.110).gifHh973127.drpdown_orange(it-it,VS.110).gif
Manuale dell'utente di PreEmptive Analytics for TFS
Risoluzione dei problemi relativi al servizio aggregatore Analytics
www.preemptive.com

Glossary Item Box

Questa sezione fornisce informazioni sulla risoluzione dei problemi relativi al servizio aggregatore PreEmptive Analytics. Il servizio è responsabile dell'invio delle richieste al servizio query per ottenere i dati di eccezione e gestire i criteri (regole) per i tipi di eccezione nonché della connessione a TFS per la creazione degli elementi di lavoro.

I problemi verificatisi nel servizio aggregatore vengono registrati nel Registro eventi di Windows nel nodo di PreEmptive della sezione Registri applicazioni e servizi. L'analisi di questo registro spesso fornisce l'assistenza necessaria per risolvere i problemi relativi al servizio aggregatore.

Problema Causa potenziale Soluzione
Gli elementi di lavoro non vengono visualizzati come previsto. L'endpoint del servizio dati non elaborati non è in esecuzione. Vedere l'argomento Risoluzione dei problemi relativi ai servizi endpoint Analytics.
L'endpoint del servizio dati non elaborati non è accessibile dal computer che ospita il servizio aggregatore.
  1. Tentare di effettuare il ping del server che ospita il servizio dati non elaborati dal computer che ospita il servizio aggregatore.
  2. Verificare le impostazioni del firewall in entrambi i computer.
  3. Assicurarsi di poter accedere all'URL dell'endpoint del servizio dati non elaborati. Se sono stati utilizzati i valori predefiniti durante l'installazione, l'URL dovrebbe avere il formato http://<nome computer servizi endpoint>/analytics/FaultQuery.svc.
  4. Se è possibile accedere all'URL dell'endpoint, ma viene visualizzato un codice di errore HTTP, fare riferimento all'argomento Risoluzione dei problemi relativi ai servizi endpoint Analytics con qualsiasi codice di errore HTTP visualizzato.
Nel servizio dati non elaborati si è verificato un errore. Vedere l'argomento Risoluzione dei problemi relativi ai servizi endpoint Analytics.
L'endpoint del servizio dati non elaborati utilizza l'autenticazione di base e le credenziali nel file .config del servizio aggregatore sono mancanti o non corrette.
  1. Aprire il file PreEmptive.Analytics.Aggregator.exe.config dalla sottodirectory Servizio nella directory di installazione del servizio aggregatore PreEmptive Analytics (per impostazione predefinita, C:\Programmi (x86)\PreEmptive Solutions\PreEmptive Analytics CE) mediante un editor di testo.
  2. Individuare l'elemento <appSettings>, quindi specificare il nome utente e la password utilizzati per accedere al servizio dati non elaborati endpoint nei valori EndpointUserName e EndpointPassword.
L'endpoint del servizio dati non elaborati utilizza l'autenticazione di base e il nome di accesso nel file .config del servizio aggregatore non è un nome utente autorizzato in IIS.
  1. Fare clic su Start.
  2. Nella casella di testo Cerca programmi e file digitare inetmgr.
  3. Espandere Siti.
  4. Espandere Sito Web predefinito.
  5. Fare clic su analytics.
  6. Fare doppio clic su Regole di autorizzazione .NET.
  7. Assicurarsi che EndpointUserName sia elencato nel file PreEmptive.Analytics.Aggregator.exe.config (o sia membro di un gruppo elencato).
L'endpoint del servizio dati non elaborati utilizza l'autenticazione di base, il servizio aggregatore è configurato per connettersi tramite lo schema URI http (non https). L'uso dell'autenticazione di base su SSL è fortemente consigliato poiché le credenziali vengono trasmesse come testo normale. Se tuttavia la configurazione richiede il servizio dati non elaborati endpoint PreEmptive Analytics per utilizzare l'autenticazione di base su HTTP non protetto anziché SSL, è necessario individuare l'elemento <binding> denominato BasicSecurity e modificarne il valore relativo alla modalità di sicurezza da Transport a TransportCredentialOnly.
Il servizio aggregatore non è in esecuzione.
  1. Avviare il Pannello di controllo, quindi aprire la cartella Strumenti di amministrazione. Fare doppio clic sull'icona Servizi.
  2. Fare clic con il pulsante destro del mouse sulla voce Servizio aggregatore PreEmptive Analytics, quindi scegliere Esegui.
Il servizio aggregatore non è in esecuzione con un account che dispone delle autorizzazioni per creare e modificare gli elementi di lavoro in Team Foundation Server.

È necessario configurare il servizio aggregatore Analytics per consentirne l'esecuzione con un account che dispone delle autorizzazioni per creare e modificare gli elementi di lavoro in Team Foundation Server.

  1. Avviare il Pannello di controllo, quindi aprire la cartella Strumenti di amministrazione. Fare doppio clic sull'icona Servizi.
  2. Fare clic con il pulsante destro del mouse sulla voce Servizio aggregatore PreEmptive Analytics, quindi scegliere Proprietà.
  3. Selezionare la scheda Accedi.
  4. Specificare l'ID utente e la password dell'account del servizio TFS corrente. Se l'account è un account locale, specificare il nome account completo, ad esempio COMPUTER\TfsService anziché solamente .\TfsService o TfsService.
  5. Scegliere OK.

Per determinare il nome di un account che dispone delle autorizzazioni per creare e modificare gli elementi di lavoro in Team Foundation Server, avviare la console di amministrazione di Team Foundation Server, quindi fare clic sul nodo Livello applicazione. Scegliere Appartenenza a gruppo, quindi individuare un account che sia membro di un gruppo che dispone delle autorizzazioni per creare e modificare gli elementi di lavoro, ad esempio il gruppo Team Foundation Administrators.
I criteri della regola non sono stati soddisfatti.

Utilizzare SQL Server Management Studio per connettersi al database delle eccezioni utilizzato per rendere persistenti i dati di eccezione. Eseguire una query sulla tabella Eccezioni, quindi verificare il numero di messaggi di report di eccezioni che hanno superato la soglia e sono stati resi persistenti nell'intervallo di tempo specificato nella regola.
  Ricevute eccezioni non incluse nel set eccezioni della regola. Esaminare il set eccezioni assegnato alla regola e verificare che le eccezioni ricevute siano incluse oppure creare un nuovo set eccezioni che includa le eccezioni ricevute e assegnarlo alla regola.
Non è stato eseguito il provisioning del progetto team per PreEmptive Analytics. Vedere la sezione Eseguire il provisioning dei progetti team dell'argomento Esecuzione del provisioning dei progetti team.
La query elemento di lavoro TFS non include gli elementi di lavoro per eventi imprevisti. Verificare che il tipo di elemento di lavoro per eventi imprevisti sia incluso nella query elemento di lavoro TFS da utilizzare per visualizzare gli elementi di lavoro creati dal servizio aggregatore.
Il nodo di PreEmptive Analytics non è visibile in Team Explorer. Non è stato eseguito il provisioning del progetto team per PreEmptive Analytics. Vedere la sezione Eseguire il provisioning dei progetti team dell'argomento Esecuzione del provisioning dei progetti team.
L'utilità di configurazione o l'estensione di Visual Studio non è in grado di connettersi al servizio di configurazione. Il servizio aggregatore non è in esecuzione.
  1. Avviare il Pannello di controllo, quindi aprire la cartella Strumenti di amministrazione. Fare doppio clic sull'icona Servizi.
  2. Fare clic con il pulsante destro del mouse sulla voce Servizio aggregatore PreEmptive Analytics, quindi scegliere Esegui.
Le credenziali del servizio aggregatore non sono corrette.
  1. Avviare il Pannello di controllo, quindi aprire la cartella Strumenti di amministrazione. Fare doppio clic sull'icona Servizi.
  2. Fare clic con il pulsante destro del mouse sulla voce Servizio aggregatore PreEmptive Analytics, quindi scegliere Proprietà.
  3. Selezionare la scheda Accedi.
  4. Verificare l'ID utente, quindi inserire di nuovo la password dell'account del servizio da utilizzare. Se l'account è un account locale, specificare il nome account completo, ad esempio COMPUTER\TfsService anziché solamente .\TfsService o TfsService.
  5. Scegliere OK.
  6. Se l'account del servizio è stato modificato, è necessario concedere al servizio anche le autorizzazioni per ospitare il servizio di configurazione sulla porta 80:
    1. Avviare un prompt dei comandi con privilegi elevati, quindi eseguire il comando netsh http del urlacl url=http://+:80/AggregatorConfigurationService/ per rimuovere le autorizzazioni da qualsiasi altro account. Se l'esecuzione del comando restituisce un errore, significa semplicemente che non sono state concesse le autorizzazioni per ospitare il servizio ad altri account ed è possibile procedere al passaggio successivo.
    2. Eseguire il comando netsh http add urlacl url=http://+:80/AggregatorConfigurationService/ user="<Nome utente account servizio>" per concedere le autorizzazioni al nuovo account del servizio per ospitare il servizio di configurazione aggregatore.
L'account del servizio aggregatore non dispone dei diritti Accedi come servizio.
  1. Avviare il Pannello di controllo, quindi aprire la cartella Strumenti di amministrazione. Fare doppio clic sull'icona Servizi.
  2. Fare clic con il pulsante destro del mouse sulla voce Servizio aggregatore PreEmptive Analytics, quindi scegliere Proprietà.
  3. Selezionare la scheda Accedi.
  4. Verificare l'ID utente e inserire di nuovo la password dell'account del servizio da utilizzare. Se l'account è un account locale, specificare il nome account completo, ad esempio COMPUTER\TfsService anziché solamente .\TfsService o TfsService.
  5. Scegliere OK. Se le autorizzazioni per accedere come servizio non sono state assegnate in precedenza all'account, si riceve una notifica e le autorizzazioni vengono concesse automaticamente.
L'account del servizio aggregatore non dispone delle autorizzazioni per ospitare il servizio di configurazione sulla porta 80.
  1. Fare clic su Start.
  2. Nella casella di testo Cerca programmi e file digitare eventvwr.msc.
  3. In Registri applicazioni e servizi selezionare il nodo PreEmptive.
  4. Cercare una voce del registro degli errori che contenga la frase "HTTP non è stato in grado di registrare l'URL http://+:80/AggregatorConfigurationService/. Il processo non dispone dei diritti di accesso a questo spazio dei nomi".
  5. Se esiste, è necessario concedere all'account del servizio le autorizzazioni per ospitare il servizio di configurazione sulla porta 80:
    1. Avviare un prompt dei comandi con privilegi elevati, quindi eseguire il comando netsh http del urlacl url=http://+:80/AggregatorConfigurationService/ per rimuovere le autorizzazioni da qualsiasi altro account. Se l'esecuzione del comando restituisce un errore, significa semplicemente che non sono state concesse le autorizzazioni per ospitare il servizio ad altri account ed è possibile procedere al passaggio successivo.
    2. Eseguire il comando netsh http add urlacl url=http://+:80/AggregatorConfigurationService/ user="<Nome utente account servizio>" per concedere le autorizzazioni al nuovo account del servizio per ospitare il servizio di configurazione aggregatore.
Il servizio di configurazione aggregatore viene bloccato da un firewall. Avviare lo strumento di configurazione per il firewall in uso. Consentire all'applicazione PreEmptive.Analytics.Aggregator.exe di accettare le connessioni in ingresso sulla porta 80. L'applicazione PreEmptive.Analytics.Aggregator.exe si trova nella sottocartella Servizio nella directory di installazione di PreEmptive Analytics (per impostazione predefinita, C:\Programmi (x86)\PreEmptive Solutions\PreEmptive Analytics CE)
La connessione di dati non elaborati del servizio aggregatore non è configurata correttamente oppure il servizio dati non elaborati non è accessibile.
  1. Aprire il file PreEmptive.Analytics.Aggregator.exe.config dalla sottodirectory Servizio nella directory di installazione del servizio aggregatore PreEmptive Analytics (per impostazione predefinita, C:\Programmi (x86)\PreEmptive Solutions\PreEmptive Analytics CE) mediante un editor di testo.
  2. Individuare l'elemento <endpoint> e verificare che il valore dell'attributo indirizzo sia un URL del servizio query endpoint di eccezione valido.

Se è stato configurato in modo corretto:

  1. Tentare di effettuare il ping del server che ospita l'endpoint del servizio dati non elaborati dal computer in cui è in esecuzione il servizio aggregatore.
  2. Verificare le impostazioni del firewall in entrambi i computer.
  3. Assicurarsi di poter accedere all'URL dell'endpoint del servizio dati non elaborati. Se sono stati utilizzati i valori predefiniti durante l'installazione, l'URL dovrebbe avere il formato http://<nome computer servizi endpoint>/analytics/FaultQuery.svc.
  4. Se è possibile accedere all'URL dell'endpoint, ma viene visualizzato un codice di errore HTTP, fare riferimento all'argomento Risoluzione dei problemi relativi ai servizi endpoint Analytics con qualsiasi codice di errore HTTP visualizzato.
(Per le estensioni di Visual Studio) Il servizio aggregatore non è accessibile dal computer in cui è in esecuzione Visual Studio.
  1. Tentare di effettuare il ping del server che ospita il servizio aggregatore dal computer in cui è in esecuzione Visual Studio.
  2. Verificare le impostazioni del firewall in entrambi i computer.
  3. Assicurarsi di poter accedere all'URL del servizio di configurazione aggregatore. L'URL dovrebbe avere il formato http://<nome computer servizio aggregatore>/AggregatorConfigurationService/.
Esecuzione del provisioning di un progetto team non riuscita. Il servizio aggregatore non è in esecuzione con un account che dispone delle autorizzazioni per creare e modificare gli elementi di lavoro in Team Foundation Server.

È necessario configurare il servizio aggregatore Analytics per consentirne l'esecuzione con un account che dispone delle autorizzazioni per creare e modificare gli elementi di lavoro in Team Foundation Server.

  1. Avviare il Pannello di controllo, quindi aprire la cartella Strumenti di amministrazione. Fare doppio clic sull'icona Servizi.
  2. Fare clic con il pulsante destro del mouse sulla voce Servizio aggregatore PreEmptive Analytics, quindi scegliere Proprietà.
  3. Selezionare la scheda Accedi.
  4. Specificare l'ID utente e la password dell'account del servizio TFS corrente. Se l'account è un account locale, specificare il nome account completo, ad esempio COMPUTER\TfsService anziché solamente .\TfsService o TfsService.
  5. Scegliere OK.

Per determinare il nome di un account che dispone delle autorizzazioni per creare e modificare gli elementi di lavoro in Team Foundation Server, avviare la console di amministrazione di Team Foundation Server, quindi fare clic sul nodo Livello applicazione. Scegliere Appartenenza a gruppo, quindi individuare un account che sia membro di un gruppo che dispone delle autorizzazioni per creare e modificare gli elementi di lavoro, ad esempio il gruppo Team Foundation Administrators.
L'hub di PreEmptive Analytics non è visibile in Visual Studio. Non è stato eseguito il provisioning del progetto team per PreEmptive Analytics. Vedere la sezione Eseguire il provisioning dei progetti team per PreEmptive Analytics dell'argomento Esecuzione del provisioning dei progetti team.
È necessario aggiornare la cache dell'estensione di Visual Studio. Avviare un'istanza del prompt dei comandi di Visual Studio, quindi eseguire il comando devenv.exe /setup per aggiornare la cache dell'estensione.
I report basati su esempi non funzionano in modo corretto. Il data warehouse TFS non è stato esegu‭ito.

Il processo di data warehouse TFS viene eseguito ogni due ore per impostazione predefinita. È possibile attendere che si verifichi il processo oppure eseguire manualmente il processo di data warehouse seguendo le istruzioni riportate nell'argomento Elaborare manualmente il data warehouse e il cubo di Analysis Services per Team Foundation Server della documentazione di Team Foundation Server.
I dati di report vengono memorizzati nella cache.
  1. Avviare Internet Explorer e accedere al sito dei report TFS (in genere, http://<server TFS>/Reports/).
  2. Fare clic sulla cartella TfsReports, quindi aprire la cartella della raccolta di progetti team e la cartella PreEmptive Analytics.
  3. Passare il mouse sul report in questione, quindi fare clic per aprire il menu a discesa. Fare clic su Gestisci.
  4. Fare clic su Opzioni d elaborazione nel riquadro di navigazione sinistro.
  5. Selezionare il pulsante di opzione Esegui sempre il report con i dati più recenti e scegliere Non memorizzare nella cache copie temporanee del report al di sotto di esso.
  6. Nella parte inferiore della pagina fare clic su Applica.
In TFS Web Access, nell'elemento di lavoro per eventi imprevisti non vengono visualizzate le informazioni sull'eccezione oppure viene visualizzato un errore. L'estensione del visualizzatore del servizio aggregatore PreEmptive Analytics è disabilitato o non è stato installato. Seguire la procedura di installazione nell'argomento Installazione dell'estensione del visualizzatore Analytics per TFS Web Access. Assicurarsi di aver abilitato l'estensione dopo l'installazione.

Visualizzazione della console di debug del servizio aggregatore

In alcuni casi è possibile che si verifichi un problema nel servizio aggregatore PreEmptive Analytics senza che venga scritto un evento significativo nel Registro eventi di Windows. In questi casi può essere utile visualizzare l'output di debug del servizio aggregatore mediante la console di debug del servizio aggregatore. L'esecuzione del servizio in modalità debug è un'operazione da effettuare solo per eseguire il debug di problemi specifici. Dopo aver risolto i problemi, non continuare a eseguire il servizio in modalità debug. Uscire dalla console di debug e avviare il servizio aggregatore PreEmptive Analytics direttamente dalla console Servizi.

  1. Verificare che il servizio aggregatore PreEmptive Analytics sia stato interrotto dalla console Servizi.
  2. Dal prompt dei comandi modificare la directory della sottocartella Servizio nella directory di installazione di PreEmptive Analytics (per impostazione predefinita, C:\Programmi (x86)\PreEmptive Solutions\PreEmptive Analytics CE).
  3. Eseguire il comando PreEmptive.Analytics.Aggregator.exe /debug per avviare la console di debug.
  4. Fare clic sul pulsante Start per avviare il servizio in modalità debug, quindi controllare i messaggi di debug visualizzati nella finestra Log di traccia.
  5. Al termine, fare clic sul pulsante Termina e chiudere la console di debug. Riavviare il servizio aggregatore PreEmptive Analytics dalla console Servizi.

 

Vedi Anche

Risoluzione dei problemi relativi ai servizi endpoint Analytics

Installazione di PreEmptive Analytics
Installazione dell'estensione del visualizzatore Analytics per TFS Web Access

Configurazione dei progetti team per PreEmptive Analytics
Esecuzione del provisioning dei progetti team
Definizione di set eccezioni e regole

 

 

© 2012 PreEmptive Solutions. Tutti i diritti riservati.