Riferimento dello schema del profilo in SharePoint Server

SI APPLICA A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

Quando si esegue lo script Microsoft PowerShell di BackupMonitoringSettings.ps1 in una farm di SharePoint, creare un file chiamato Profilo. Profilo segue un XML Schema. È possibile modificare le impostazioni degli elementi dello schema per creare un Profilo personalizzato. È possibile utilizzare quindi il Profilo personalizzato per automatizzare la configurazione delle impostazioni di monitoraggio in un ambiente di SharePoint. Per informazioni introduttive sulla configurazione del monitoraggio tramite script, vedere Panoramica sulla configurazione del monitoraggio tramite script in SharePoint Server.

Gli amministratori possono eseguire gli script prima, durante e dopo le modifiche alla farm, come ad esempio, topologia della farm, principali modifiche di sicurezza, applicazione degli aggiornamenti software o esecuzione di un test delle prestazioni. Gli script modificano le impostazioni affinché tutti i dati di monitoraggio necessari vengano raccolti durante l'evento senza sovraccaricare il database di registrazione durante il normale funzionamento.

Nota

[!NOTA] È necessario scaricare gli script PowerShell per eseguire il backup, ripristinare o modificare le impostazioni di monitoraggio della farm. Gli script sono disponibili in TechNet Gallery in Scripted Monitoring Configuration - BackupMonitoringSettings e Scripted Monitoring Configuration - AlterMonitoringSettings. Lo script BackupMonitoringSettings.ps1 PowerShell crea il Profilo di backup dal quale creare altri Profili.

È possibile creare uno o più Profili per regolare il livello di monitoraggio nelle varie fasi del ciclo di vita di SharePoint. È inoltre possibile utilizzare un Profilo personalizzato per configurare il monitoraggio in diverse farm contemporaneamente.

Generalmente vengono creati Profili per i seguenti scopi:

  • Per completare la configurazione delle impostazioni di monitoraggio in una farm dopo l'installazione di SharePoint Server

  • Per modificare le impostazioni di monitoraggio in una farm appena prima di una modifica amministrativa, ad esempio la modifica delle impostazioni in un'applicazione del servizio di ricerca nella farm

    Di conseguenza, è possibile acquisire più dati di monitoraggio correlati a tale modifica ed eliminare dati monitoraggio indesiderati. Quindi è possibile ripristinare le impostazioni di monitoraggio originali dopo aver completato la modifica.

  • Per ripristinare le impostazioni di monitoraggio in una farm dopo alcune modifiche amministrative

  • Per ripristinare un set di impostazioni di monitoraggio precedente

    È necessario eseguire tale operazione se si apportano modifiche manuali alle impostazioni e si decide di ripristinare le impostazioni precedenti.

  • Per ripristinare le impostazioni predefinite

  • Per creare un profilo che è possibile applicare a più farm

Eseguire il backup delle impostazioni originali

È necessario eseguire sempre il backup delle impostazioni di monitoraggio predefinite prima di modificarle. In questo modo, sarà possibile ripristinare le impostazioni in caso fosse necessario. Il Profilo di backup può inoltre fungere da punto di inizio per altri Profili che si desidera creare. Per ulteriori informazioni su come eseguire il backup delle impostazioni, vedere Eseguire la configurazione del monitoraggio tramite script in SharePoint Server.

Informazioni sullo schema Profilo

Quando si esegue lo script PowerShell BackupMonitoringSettings.ps1, si crea un Profilo che rispetta il seguente XML Schema. Gli elementi del file contengono le impostazioni di monitoraggio associate dalla farm.

<?xml version="1.0" standalone="yes"?>
<Configuration>
  <FarmDiagnosticConfig />
  <UsageServices>
    <UsageService />  
  </UsageServices>
  <UsageDefinitions>
    <UsageDefinition />
  </UsageDefinitions>
  <LogLevels>
    <LogLevel />
  </LogLevels>
  <TimerJobs>
    <TimerJob />
  </TimerJobs>
  <HealthAnalyzerRules>
    <HealthAnalyzerRule />
  </HealthAnalyzerRules>
</Configuration>

Importante

[!IMPORTANTE] Nelle tabelle seguenti, non è possibile modificare i valori nei campi contrassegnati come Di sola lettura. Se si modificano i valori nei campi di sola lettura nei Profili, potrebbero verificarsi risultati imprevisti.

Impostazioni per l'elemento FarmDiagnosticConfig

Nome Tipo valore Note
AllowLegacyTraceProviders
Booleano
Specifica che i provider di traccia creati per le versioni precedenti di Prodotti e tecnologie SharePoint possono scrivere nella sessione di traccia per SharePoint Server
AppAnalyticsAutomaticUploadEnabled
Booleano
Specifica se i dati di utilizzo aggregati delle applicazioni vengono caricati automaticamente per Microsoft.
CustomerExperienceImprovementProgramEnabled
Booleano
Specifica se Gruppo di gestione ha abilitato la funzionalità Analisi utilizzo software.
ErrorReportingEnabled
Booleano
Ottiene o imposta un valore per indicare se la raccolta dei dati su un arresto anomalo e la segnalazione errori sono abilitate.
ErrorReportingAutomaticUploadEnabled
Booleano
Specifica se la partecipazione al programma Analisi utilizzo software è abilitata. Tale programma è progettato per migliorare la qualità, l'affidabilità e le prestazioni dei prodotti e delle tecnologie Microsoft. Con il consenso esplicito degli utenti, vengono inviate informazioni anonime sul server a Microsoft allo scopo di migliorare SharePoint Server.
DownloadErrorReportingUpdatesEnabled
Booleano
Specifica se le segnalazioni errori vengono inviate automaticamente a Microsoft. Le segnalazioni errori includono quanto segue: Informazioni sulla condizione del server quando si verifica un problema, la versione del sistema operativo e l'hardware del computer in uso, nonché l'ID digitale del prodotto, che potrà essere utilizzato per identificare la licenza.
Nota:
Poiché per l'invio delle segnalazioni errori ci si connette a un servizio online, viene inoltre inviato l'indirizzo IP del computer, ma questo viene utilizzato solo a fini statistici.
DaysToKeepLogs
Intero
Specifica il numero di giorni per la conservazione dei file di registro di traccia. Il tipo deve essere un numero valido compreso tra 1 e 366. Il valore predefinito è 14 giorni.
LogMaxDiskSpaceUsageEnabled
Booleano
Specifica se limitare lo spazio massimo da utilizzare per i file di registro di traccia.
LogDiskSpaceUsageGB
Intero
Specifica la quantità massima di spazio di archiviazione da utilizzare per i file di registro di traccia, in gigabyte (GB). Il valore predefinito è 1000 e diventa effettivo solo quando il parametro LogMaxDiskSpaceusageEnabled viene impostato su True. Il tipo deve essere un numero valido compreso tra 1 e 1000.
LogLocation
String:Path
Questo è il percorso completo in cui archiviare i file di log. Può essere un percorso remoto. Esempio: "%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\16\LOGS" e "%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\15\LOGS"
LogCutInterval
Intero
Specifica un periodo di tempo per il rollover al file di registro successivo. Il tipo deve essere un numero valido compreso tra 0 e 1440.
EventLogFloodProtectionEnabled
Booleano
Specifica se la caratteristica di protezione da attacchi flood al registro eventi è abilitata. Se nel registro eventi vengono scritti più eventi simili, alcuni messaggi duplicati vengono eliminati. Dopo un periodo di tempo, un messaggio di riepilogo mostra quanti eventi sono stati eliminati.
EventLogFloodProtectionThreshold
Intero
Specifica il numero di eventi consentiti in un determinato intervallo di tempo prima che un evento sia considerato un tentativo di attacco flood del registro eventi. L'intervallo consentito di numeri interi è compreso tra 1 e 100. Il valore predefinito è 5.
EventLogFloodProtectionTriggerPeriod
Intero
Specifica l'intervallo in minuti di osservazione di eventi che potrebbero causare attacchi flood. L'intervallo consentito di numeri interi è compreso tra 1 e 1440. Il valore predefinito è 2.
EventLogFloodProtectionQuietPeriod
Intero
Specifica l'intervallo di tempo in minuti che deve trascorrere senza un evento che attiva l'uscita dalla protezione da attacchi flood. L'intervallo consentito di numeri interi è compreso tra 1 e 1440. Il valore predefinito è 2.
EventLogFloodProtectionNotifyInterval
Intero
Specifica la frequenza in minuti per la scrittura di un evento di riepilogo che indica il numero di eventi soppressi per la protezione da attacchi flood. L'intervallo consentito di numeri interi è compreso tra 1 e 1440. Il valore predefinito è 5.
ScriptErrorReportingEnabled
Booleano
Abilita o disabilita la segnalazione degli errori di script nel file di log.
ScriptErrorReportingRequireAuth
Booleano
Specifica se è richiesta l'autenticazione per la segnalazione errori di script.
ScriptErrorReportingDelay
Intero
Specifica il tempo in minuti tra le segnalazioni errori di script. Il valore deve essere un numero intero compreso tra 0 e 1440. Il valore è specificato in minuti. Il valore predefinito è 30.

Seguire la seguente tabella come riferimento per le impostazioni di UsageServices.

Elementi delle impostazioni UsageServices

Nome Tipo valore Note
ID
GUID: Sola lettura
Un GUID, nel formato 12345678-90ab-cdef-1234-567890bcdefgh.
UsageLogLocation
Percorso
Specifica il percorso di ogni computer della farm in cui vengono creati i file di registro. In tutti i computer nella farm deve esistere lo stesso percorso.
LoggingEnabled
Booleano
Specifica che i dati di utilizzo vengono registrati nei relativi file.
UsageLogMaxFileSizeKB
Intero
Specifica la dimensione massima di un singolo file di dati di utilizzo da applicare a tutti i provider di dati di utilizzo. Il valore minimo è 512 kilobyte (KB) e il valore massimo è 65536 KB.
UsageLogCutTime
Intero
Specifica per quanti minuti vengono raccolti i dati di utilizzo per ogni file di log dei dati di utilizzo. L'intervallo predefinito è di 5 minuti. Il valore deve essere un numero intero compreso tra 1 e 1440.

Utilizzare la seguente tabella come riferimento per le impostazioni di UsageDefinition.

Elementi delle impostazioni UsageDefinition

Nome Tipo valore Note
ID
GUID: Sola lettura
Un GUID, nel formato 12345678-90ab-cdef-1234-567890bcdefgh.
Name
Stringa: Sola lettura
Il nome della stringa di UsageDefinition.
DaysRetained
Intero
Specifica per quanti giorni vengono conservati i dati di utilizzo per il relativo provider nel database del servizio di utilizzo. Il valore predefinito è 14. Il tipo deve essere un numero intero compreso tra 0 e 31.
DaysToKeepUsageFiles
Intero
Specifica il numero di giorni per la conservazione dei file dei dati di utilizzo. Tale valore deve essere inferiore o uguale al valore del parametro DaysRetained.
Abilitata
Booleano
Attiva o disattiva il provider di dati di utilizzo specificato.

Seguire la seguente tabella come riferimento per le impostazioni di LogLevel.

Elementi delle impostazioni LogLevel

Nome Tipo valore Note
Area
Stringa: Sola lettura
Il componente o il servizio a cui si applica LogLevel.
Identità
Stringa: Sola lettura
Specifica i nomi della categoria o del set di categorie per cui impostare la limitazione, ad esempio "Unified Logging Service".
Nota:
Se non si specifica il parametro Identity, l'impostazione di limitazione degli eventi verrà applicata a tutte le categorie nella farm.
EventSeverity
String:[None | ErrorCritical |Error | Warning |Information | Verbose]
Specifica il livello di registrazione da impostare. Il livello di categoria p uno dei seguenti valori:[None | ErrorCritical |Error | Warning |Information | Verbose]
TraceSeverity
String:[None | Unexpected |Monitorable | High |Medium | Verbose | VerboseX]
Specifica la limitazione di traccia da impostare per le categorie specificate. I file di registro di traccia sono file di testo scritti nel percorso del registro di traccia definito nella pagina Diagnostic Logging Settings in il sito Web Amministrazione centrale SharePoint. Il tipo deve essere uno dei valori seguenti:[None | Unexpected |Monitorable | High |Medium | Verbose | VerboseX]

Seguire la seguente tabella come riferimento per le impostazioni di Processo timer.

Elementi delle impostazioni Processo timer

Nome Tipo valore Note
Identità
GUID: Sola lettura
Specifica il processo timer da aggiornare. Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh.
Pianificazione
String
Specifica la pianificazione per l'esecuzione del processo timer. Il tipo deve essere una pianificazione valida del servizio Timer di SharePoint (SPTimer) in uno dei formati di pianificazione seguenti: Ogni 5 minuti tra 0 e 59, ogni ora compreso tra 0 e 59, ogni giorno alle 15:00:00, ogni settimana tra venerdì alle 22:00:00 e domenica alle 06:00:00, ogni mese il 15 alle 15:00:00 e ogni anno il 1° gennaio alle 15:00:00
Abilitata
Booleano
Attiva o disattiva il processo timer.

Utilizzare la seguente tabella come riferimento per le impostazioni di HealthAnalyzerRule.

Elementi delle impostazioni HealthAnalyzerRule

Nome Tipo valore Note
Identità
GUID: Sola lettura
Specifica il nome o il GUID della regola dell'analizzatore dell'integrità da impostare.
Attivata
Booleano
Attiva o disattiva la regola analizzatore dell'integrità.

Creare Profili

È possibile creare un numero illimitato di Profili. Ogni Profilo può essere utilizzato per diversi scopi, ad esempio per aumentare i livelli di monitoraggio prima di una modifica specifica all'ambiente o per abbassare il livello dopo una modifica.

È necessario solo creare voci del profilo per le modifiche specifiche da applicare. Le altre impostazioni rimarranno invariate. Ad esempio, se si desidera modificare alcune impostazioni LogLevel, è sufficiente specificare tali impostazioni nel Profilo. Le impostazioni che non sono specificate nel Profilo non vengono modificate.

È consigliabile utilizzare una convenzione di denominazione per i Profili affinché sia possibile organizzarli e utilizzarli più facilmente.

Importante

[!IMPORTANTE] È necessario eseguire sempre il backup delle impostazioni di monitoraggio predefinite prima di modificarle. Utilizzare sempre la copia di backup del Profilo e mai il file originale.

Vedere anche

Concetti

Panoramica sulla configurazione del monitoraggio tramite script in SharePoint Server

Eseguire la configurazione del monitoraggio tramite script in SharePoint Server