Condividi tramite

Cercare i log di acquisizione creati dal servizio di registrazione centralizzato in Skype for Business 2015

Sommario: Informazioni su come cercare e leggere i log di acquisizione del servizio di registrazione centralizzata in Skype for Business Server 2015.

Le funzionalità di ricerca nel servizio di registrazione centralizzata sono utili e potenti per i motivi seguenti:

  • Le ricerche e i risultati vengono eseguiti in un singolo computer, in un pool, in un sito o in un ambito globale, in base ai criteri definiti.

  • Le ricerche possono essere inizialmente ampie e quindi limitate a criteri più mirati, ad esempio tempo, componente o computer. La ricerca viene eseguita negli stessi log e non è necessario eseguire di nuovo una sessione di registrazione quando i criteri di ricerca vengono modificati.

  • I risultati della ricerca vengono raccolti da tutti i computer e pool nell'ambito, raccolti e aggregati in un unico file di output che rappresenta tutti i risultati dei criteri di ricerca, limitati agli scenari in esecuzione e ai dati acquisiti dagli scenari. È possibile usare strumenti familiari come Snooper o Blocco note per leggere il file di output e i messaggi di traccia dall'intera distribuzione.

ClsAgent su ogni singolo computer crea i log in base allo scenario o scenari (due scenari per computer possono essere in esecuzione in un determinato momento). I log e i relativi file di indice e cache associati vengono gestiti da CLSAgent. Quando si definisce ed esegue una ricerca, il comando di ricerca indica a CLSAgent quali informazioni devono essere recuperate. CLSAgent esegue la query sui file di log, i file di cache e i file di indice e restituisce i risultati della ricerca al CLSContoller. Il CLSController riceve i risultati della ricerca da tutti i computer e pool nell'ambito della ricerca. Il CLSController aggrega quindi (combina) i log e li inserisce in ordine delta temporale, prima voce meno recente e procedendo in tempo fino all'ultima voce.

Dopo ogni ricerca, viene eseguito il cmdlet Sync-CsClsLogging e scarica la cache utilizzata dalle ricerche (da non confondere con i file di cache gestiti da CLSAgent). Lo svuotamento della cache consente di verificare che vi sia un log pulito e un buffer di acquisizione file di traccia presso CLSController per l'operazione di ricerca successiva.

Per sfruttare al meglio il servizio di registrazione centralizzata, è necessario comprendere bene come configurare la ricerca in modo da restituire solo i messaggi di traccia provenienti dal computer e i log del pool rilevanti per il problema cercato. problemi

Per eseguire le funzioni di ricerca del servizio di registrazione centralizzata utilizzando Skype for Business Server Management Shell, è necessario essere un membro dei gruppi di sicurezza CsAdministrator o CsServerAdministrator di controllo dell'accesso basato sul ruolo (RBAC) o un ruolo RBAC personalizzato che contiene uno di questi due gruppi. Per restituire un elenco di tutti i ruoli di controllo degli accessi in base al ruolo assegnato a questo cmdlet, inclusi eventuali ruoli di controllo degli accessi in base al ruolo creati personalmente, eseguire il comando seguente da Skype for Business Server Management Shell o dal prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Skype for Business Server 2015 cmdlet"}

Ad esempio:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}

Il resto di questo argomento è incentrato su come definire una ricerca per ottimizzare la risoluzione dei problemi.

Per eseguire una ricerca di base tramite il servizio di registrazione centralizzata

  1. Avviare Skype for Business Server Management Shell: fare clic sul pulsante Start, scegliere Tutti i programmi, Skype for Business 2015 e quindi fare clic su Skype for Business Server Management Shell.

  2. Verificare che lo scenario AlwaysOn sia in esecuzione nella distribuzione nell'ambito globale e quindi digitare quanto segue al prompt dei comandi:

    Search-CsClsLogging -OutputFilePath <string value of path and file to write the output file>

Nota

Per impostazione predefinita, Search-CsClsLogging invia i risultati della ricerca alla console. Per salvare i risultati della ricerca in un file, usare il percorso> completo della stringa -OutputFilePath<. Per definire il parametro -OutputFilePath, specificare un percorso e un nome file come parte del parametro in un formato di stringa racchiuso tra virgolette, ad esempio C:\LogFiles\SearchOutput.txt. In questo esempio, è necessario verificare che la directory C:\LogFiles esista e che si dispone delle autorizzazioni di lettura e scrittura (ntfs autorizzazione Modifica) file nella cartella. L'output viene aggiunto e non sovrascritto. Se sono necessari file separati, definire un nome file distinto per ogni ricerca.

Ad esempio:

Search-CsClsLogging -OutputFilePath "C:\LogFiles\logfile.txt"

Per eseguire una ricerca di base in un pool o computer tramite il servizio di registrazione centralizzata

  1. Per limitare la ricerca a uno specifico pool o computer, usare il parametro -Computers con il computer definito da un nome completo del computer, racchiuso tra virgolette e separato da una virgola come indicato di seguito:

    Search-CsClsLogging -Computers <string value of computer names> -OutputFilePath <string value of path and file to write the output file>

Ad esempio:

Search-CsClsLogging -Computers "fe01.contoso.net" -OutputFilePath "C:\LogFiles\logfile.txt"

  1. Per cercare in più computer, digitare più nomi di computer racchiusi tra virgolette e separati da virgole, ad esempio:

    Search-CsClsLogging -Computers "fe01.contoso.net", "fe02.contoso.net", "fe03.contoso.net" -OutputFilePath "C:\LogFiles\logfile.txt"

  2. Se è necessario eseguire una ricerca in un intero pool anziché in un singolo computer, modificare il parametro -Computers in -Pool, rimuovere il nome del computer e sostituirlo con il pool o i pool tra virgolette separate da virgole.

    Ad esempio:

    Search-CsClsLogging -Pools "pool01.contoso.net" -OutputFilePath "C:\Logfiles\logfile.txt"

  3. Quando si usano i comandi di ricerca, i pool possono essere qualsiasi pool nella distribuzione, ad esempio pool Front End, pool Edge, pool del server chat persistente o altri che sono definiti come pool nella distribuzione.

    Ad esempio:

    Search-CsClsLogging -Pools "pool01.contoso.net", "pchatpool01.contoso.net", "intedgepool01.contoso.net" -OutputFilePath "C:\Logfiles\logfile.txt"

Per eseguire una ricerca usando parametri temporali

  1. Avviare Skype for Business Server Management Shell: fare clic sul pulsante Start, scegliere Tutti i programmi, Skype for Business 2015 e quindi fare clic su Skype for Business Server Management Shell.

  2. Per impostazione predefinita, l'ora iniziale per i parametri specifici dell'ora di una ricerca è di 25 minuti prima di cinque minuti dopo l'avvio della ricerca. In altre parole, se si effettua una ricerca alle 16:00,00, l'ora di inizio della ricerca sarà indicata dalle 15:35:00 alle 16:05:00. Se è necessario eseguire una ricerca 60 minuti o 3 ore prima dell'ora corrente, usare il parametro -StartTime e impostare la stringa di data e ora per indicare l'ora di inizio della ricerca.

    Ad esempio, usando -StartTime e -EndTime per definire un intervallo di data e ora, è possibile definire una ricerca tra le 8.00 e le 9.00 del 20/11/2012 nel pool. È possibile impostare il percorso di output per scrivere i risultati in un file denominato c:\logfile.txt come indicato di seguito:

    Search-CsClsLogging -Pools "pool01.contoso.net" -StartTime "11/20/2012 08:00:00 AM" -EndTime "11/20/2012 09:00:00 AM" -OutputFilePath "C:\Logfiles\logfile.txt"

Nota

La stringa di data e ora specificata può essere "data/ ora" o "data ora. " Il comando analizza la stringa e usa i valori appropriati per data e ora e le impostazioni locali e delle impostazioni cultura nel computer da cui si esegue il cmdlet.

  1. Se si desidera recuperare i log a partire dalle 11:00:00 del 20/11/2012, definire -StartTime. L'intervallo di tempo predefinito per la ricerca è di 30 minuti, a meno che non si definisca un valore -EndTime specifico. La ricerca risultante restituirà i log dal computer o dai pool definiti dalle 11:00:00 alle 11:30:00.

Ad esempio:

Search-CsClsLogging -Pools "pool01.contoso.net" -StartTime "11/20/2012 11:00:00 AM" -OutputFilePath "C:\Logfiles\logfile.txt"
  1. Per eseguire una ricerca di log in un periodo di tempo specifico, definire -StartTime e -EndTime. Sono necessari log dalle 13.00 alle 14.45 nel computer edge01.contoso.net.

Ad esempio:

Search-CsClsLogging -Computers "edge01.contoso.net" -StartTime "11/20/2012 1:00:00 PM" -EndTime "11/20/2012 2:45:00 PM" -OutputFilePath "C:\Logfiles\logfile.txt"

Per eseguire una ricerca avanzata usando altri criteri e opzioni di corrispondenza

  1. Avviare Skype for Business Server Management Shell: fare clic sul pulsante Start, scegliere Tutti i programmi, Skype for Business 2015 e quindi fare clic su Skype for Business Server Management Shell.

  2. Per eseguire un comando per raccogliere le tracce per componenti specifici, digitare quanto segue:

    Search-CsClsLogging -Components <components to search on> -OutputFilePath <fully qualified path to output logs>

Ad esempio:

Search-CsClsLogging -Components "SIPStack","S4","UserServices" -OutputFilePath "C:\Logfiles\logfile.txt"

La ricerca risultante restituisce tutte le voci di log che contengono componenti di traccia per SIPStack, S4 e UserServices in tutti i computer e pool nella distribuzione per gli ultimi 30 minuti.

  1. Per limitare la ricerca con gli stessi componenti solo al pool Front End denominato pool01.contoso.net, digitare:

    Search-CsClsLogging -Components "SIPStack","S4","UserServices" -OutputFilePath "C:\Logfiles\logfile.txt"

  2. La logica di ricerca predefinita per i comandi con più parametri consiste nell'usare l'OR logico con ognuno dei parametri definiti. È possibile modificare questo comportamento specificando il parametro -MatchAll . A tale scopo, digitare quanto segue:

    Search-CsClsLogging -CallId "d0af828e49fa4dcb99f5f80223a634bc" -Components "SIPStack","S4","UserServices" -MatchAll -OutputFilePath "C:\Logfiles\logfile.txt"

  3. Se gli scenari sono impostati per l'esecuzione continua, ad esempio AlwaysOn, o se è stato definito un registro scenari a esecuzione prolungata, è possibile che il computer locale venga distribuito nella condivisione file. È possibile definire la condivisione file utilizzando il parametro CacheFileNetworkFolder utilizzando New-CsClsConfiguration per creare una nuova configurazione o modificare una configurazione esistente con Set-CsClsConfiguration. Se non si vuole che la ricerca includa la condivisione file nell'insieme di log in cui eseguire la ricerca, utilizzare il parametro SkipNetworkLogs come indicato di seguito:

    Search-CsClsLogging -Components "SIPStack","S4","UserServices" -StartTime "11/1/2012 00:00:01 AM" -EndTime "11/20/2012 2:45:00 PM" -SkipNetworkLogs -OutputFilePath "C:\Logfiles\logfile.txt"

Leggere i log di acquisizione dal servizio di registrazione centralizzata

Si capisce il vero vantaggio del servizio di registrazione centralizzata dopo aver eseguito la ricerca e si dispone di un file che è possibile usare per individuare un problema segnalato. Esistono vari modi per leggere il file. Il file di output è in un formato di testo standard ed è possibile usare Notepad.exe o qualsiasi altro programma che consenta di aprire e leggere un file di testo. Per file più grandi e problemi più complessi, è possibile usare uno strumento come Snooper.exe progettato per leggere e analizzare l'output di registrazione dal servizio di registrazione centralizzata. Snooper è incluso con gli strumenti di debug disponibili come download separato. È possibile scaricare gli strumenti di debug qui: https://go.microsoft.com/fwlink/?LinkId=285257. Quando si installano gli strumenti di debug, non vengono creati short cut e voci di menu. Dopo aver installato gli strumenti di debug, aprire Esplora risorse, una finestra della riga di comando o Skype for Business Server Management Shell e passare alla directory (percorso predefinito) C:\Programmi\Skype for Business Server 2015\Debugging Tools. Fare doppio clic su Snooper.exe o digitare Snooper.exe e quindi premere INVIO se si usa la riga di comando o Skype for Business Server Management Shell.

Importante

Lo scopo di questo argomento non è quello di fornire dettagli e discutere le tecniche di risoluzione dei problemi. La risoluzione dei problemi e i processi che lo circondano sono un argomento complesso. Per informazioni dettagliate sulla risoluzione dei problemi di base e sui carichi di lavoro specifici, vedere l'articolo del Resource Kit di Microsoft Lync Server 2010 all'indirizzo https://go.microsoft.com/fwlink/p/?linkId=211003. I processi e le procedure si applicano ancora a Skype for Business Server 2015.

Per aprire un file di log in Snooper

  1. Per usare Snooper e aprire i file di log, è necessario l'accesso in lettura ai file di log. Per usare Snooper e accedere ai file di log, è necessario essere membri dei gruppi di sicurezza CsAdministrator o CsServerAdministrator con controllo dell'accesso basato sul ruolo (RBAC) oppure un ruolo RBAC personalizzato che contiene uno di questi due gruppi.

  2. Dopo l'installazione degli strumenti di debug (LyncDebugTools.msi), modificare la directory nel percorso di Snooper.exe utilizzando Esplora risorse o dalla riga di comando. Per impostazione predefinita, gli strumenti di debug si trovano in C:\Programmi\Skype for Business Server 2015\Debugging Tools. Fare doppio clic o eseguire Snooper.exe.

  3. Dopo aver aperto Snooper, fare clic con il pulsante destro del mouse su File, scegliere ApriFile, trovare i file di log, selezionare un file nella finestra di dialogo Apri e quindi fare clic su Apri.

  4. I messaggi di traccia del file di log vengono visualizzati nella scheda Traccia . Fare clic sulla scheda Messaggi per visualizzare il contenuto del messaggio delle tracce raccolte.

Per visualizzare un diagramma di flusso delle chiamate

  1. Per usare Snooper e aprire i file di log, è necessario l'accesso in lettura ai file di log. Per usare Snooper e accedere ai file di log, è necessario essere membri dei gruppi di sicurezza CsAdministrator o CsServerAdministrator con controllo dell'accesso basato sul ruolo (RBAC) oppure un ruolo RBAC personalizzato che contiene uno di questi due gruppi.

  2. Aprire un file di log e fare clic sulla scheda Messaggi , selezionare una conversazione nella visualizzazione messaggi o selezionare un componente di traccia nella scheda Traccia .

  3. Fare clic su Flusso chiamate.

Nota

Se si fa clic su un messaggio o una traccia che non fa parte di un flusso delle chiamate, il diagramma non viene visualizzato e nella parte inferiore di Snooper viene visualizzato un messaggio di stato che indica che "Questo messaggio non è idoneo per il richiamo". Scegliere un altro messaggio o traccia per visualizzare il flusso delle chiamate se il messaggio o la traccia fa parte di un flusso di chiamata.

  1. Spostarsi tra le righe Messaggi o Traccia e verificare se il diagramma del flusso delle chiamate viene aggiornato o modificato per visualizzare un nuovo diagramma.

  2. Passare il mouse sugli elementi per ottenere informazioni su messaggi di chiamata, endpoint e altri componenti.