Gli utenti che riscontrano problemi con un sito Web pubblico, un sondaggio, un messaggio di posta elettronica o un'altra app, possono scrivere o chiamare l'azienda proprietaria del sito Web per richiedere assistenza. In genere è possibile trovare le informazioni sul contatto per un sito Web o un sondaggio nella parte inferiore della pagina o nelle sezioni "Chi siamo" o "Contattaci" dei menu di navigazione.
Gli utenti aziendali che ricevono errori devono rivolgersi alla persona che gestisce il sito Web interno dell'azienda. Spesso, questo tipo di problemi può essere risolto solo dal webmaster (amministratore di SharePoint) o da qualcuno della propria azienda.
Se si è un amministratore SharePoint, un webmaster o un responsabile del sito, e i propri utenti fanno domande sugli ID di correlazione, questo articolo può essere utile.
Che cos'è (e non è) un ID di correlazione
L'ID di correlazione non è un numero o codice di errore. In pratica è un GUID (identificatore univoco globale) generato automaticamente per ciascuna richiesta ricevuta dal server SharePoint. È univoco per ogni richiesta, non per ogni errore. Tuttavia, quando si verifica un errore, il messaggio di errore contiene l'ID di correlazione valido al momento della richiesta.
L'ID di correlazione è pensato per aiutare un amministratore di SharePoint a tenere traccia di ciò che stava accadendo al momento dell'errore. È utile solo come strumento interattivo per aiutare l'amministratore a individuare l'errore. Un amministratore usa l'ID di correlazione come "percorsi di navigazione" per ripercorrere le richieste o i processi nel SharePointServizio di registrazione unificato (ULS) e individuare l'origine e le cause di un problema. Se SharePoint riceve un errore che non riesce a identificare durante l'esecuzione di tale attività, visualizza il messaggio "Si è verificato un errore imprevisto" e include l'ID di correlazione. L'ID di correlazione consente di scoprire che cosa è successo ma non identifica che cosa è successo.
Le richieste completate e non eseguite vengono ugualmente contrassegnate con un ID di correlazione. L'ID è univoco e diverso per ogni nuova richiesta e dura solo per la durata della richiesta. Non è come un errore di Windows che indica un numero 80xxxxxx che identifica il problema esatto. Non aiuta a cercare un ID di correlazione specifico sul Web, perché ciascuno di essi è diverso e univoco per il proprio server e momento.
L'ID di correlazione si rivela utile nel tracciamento di un processo. SharePoint crea un log (ULS) di tutte le operazioni eseguite durante l'elaborazione delle richieste e l'ID di correlazione è fondamentalmente il thread che collega ogni passaggio. Poiché SharePoint esegue migliaia di richieste contemporaneamente, l'ID di correlazione può essere usato per filtrare solo i passaggi eseguiti da SharePoint per una determinata richiesta.
L'amministratore può usare l'ID di correlazione per tenere traccia degli errori, oltre che dei problemi di prestazioni e di altra natura. Usando gli ID di correlazione per le richieste che mostrano un comportamento problematico, l'amministratore può indagare più a fondo. Se non c'è alcun problema e non viene generato alcun messaggio di errore, il dashboard di sviluppo può essere usato per visualizzare l'ID di correlazione generato dai processi.
L'utente finale probabilmente non avrà accesso ai file di log che contengono le informazioni in cui un ID di correlazione può rivelarsi utile. In questo caso, è possibile interrompere la procedura e chiamare il supporto tecnico dell'organizzazione o l'amministratore. Descrivere il problema e collaborare per diagnosticare più facilmente il problema. Può essere necessario fornire l'ID di correlazione visualizzato nel messaggio di errore.
Per risalire alla causa del problema, i professionisti e gli amministratori IT devono trovare i file di log del Servizio di registrazione unificato relativi al momento in cui si è verificato l'evento e cercare l'ID di correlazione all'interno degli stessi. Potrebbe essere necessario esaminare più front-end Web per trovare quello che include l'ID di correlazione che si sta cercando. L'ID di correlazione non risolverà l'errore, ma può aiutare a tenere traccia di una richiesta per scoprire con buona probabilità la causa del problema. Si potrebbero ottenere informazioni approfondite su quanto accaduto poco prima della generazione dell'errore, su quali messaggi di errore sono stati visualizzati o quali eventi sono stati eventualmente attivati a causa di questo errore. È possibile usare uno strumento come ULSViewer per agevolare l'analisi dei dati e filtrare le richieste che non si vogliono visualizzare. Per altre idee e suggerimenti, vedere il post di blog Registrazione e risoluzione dei problemi di SharePoint tramite ULSViewer.
Ecco un esempio di scenario tipico che verrà usato da un amministratore con un ID di correlazione:
-
L'utente riceve un errore durante l'apertura di un file in Excel, che fornisce all'amministrazione l'ID di correlazione e la data/ora dell'evento:
-
Trovare la directory di log e la data che si sta cercando e aprire il file in Excel:
-
Trovare l'ID di correlazione che si sta cercando. È possibile filtrare in base al livello degli eventi anche per avere un'idea su quello che succede:
-
Se non si trova l'ID di correlazione, provare con un altro server Web che era in rotazione al momento del problema segnalato.
Ecco altre risorse per l'amministratore utili per il debug degli errori di SharePoint. Oltre a questi collegamenti, è consigliabile provare a cercare sul Web, poiché esistono molti siti e community di terze parti che offrono supporto e strumenti per l'uso di SharePoint. Dato che SharePoint è una piattaforma, una community di migliaia di sviluppatori, professionisti IT e utenti collabora allo sviluppo di strumenti, app e documentazione per aiutarsi reciprocamente.
