Distribuire il dashboard di telemetria di Office

Si applica a:Office 2019, Office 2016

Importante

Questo articolo consente di distribuire i cinque componenti del dashboard di telemetria di Office: il dashboard stesso, il processore, l'agente, il database e una cartella condivisa. Prima di distribuire questi componenti, assicurarsi di consultare Pianificare una distribuzione del dashboard di telemetria di Office per informazioni su topologia, scalabilità e hardware.

Importante

  • Il dashboard di telemetria di Office è uno strumento locale che raccoglie i dati di inventario, utilizzo e integrità relativi ai documenti e alle soluzioni di Office, ad esempio i componenti aggiuntivi, usati nell'organizzazione. I dati sono progettati principalmente per aiutare l'organizzazione a eseguire test di compatibilità delle applicazioni.
  • I dati raccolti per il dashboard di telemetria di Office vengono archiviati in un database SQL Server controllato dall'organizzazione e i dati raccolti non vengono inviati a Microsoft. Per altre informazioni, vedere Dati raccolti dall'agente per il dashboard di telemetria di Office.
  • I dati raccolti per il dashboard di telemetria di Office sono diversi da quelli di diagnostica di Office, che possono essere inviati a Microsoft. Per altre informazioni sui dati di diagnostica di Office, vedere Panoramica dei controlli della privacy per Microsoft 365 Apps.
  • Le impostazioni usate per gestire il dashboard di telemetria di Office non influiscono sui dati di diagnostica di Office e viceversa. Per altre informazioni sulla gestione dei dati di diagnostica di Office, vedere Usare le impostazioni dei criteri per gestire i controlli della privacy per Microsoft 365 Apps.

Dashboard di telemetria di Office

Il dashboard di telemetria di Office è una cartella di lavoro di Excel configurata per la connessione a un database. Il dashboard di telemetria di Office viene installato insieme a Office Professional Plus 2019, Office Professional Plus 2016 o Office Standard 2016. Per visualizzare il dashboard di telemetria di Office, è necessario che Excel sia installato da Office 2019 o Office 2016.

Dopo l'installazione di Office, è possibile avviare il dashboard di telemetria di Office usando una delle procedure riportate nella tabella seguente:

Come avviare il dashboard di telemetria di Office

Sistema operativo Come avviare il dashboard di telemetria di Office
Windows 10, Windows Server 2008 R2 o Windows 7 con Service Pack 1
Dal menu Start scegliere Tutti i programmi, quindi Strumenti di Microsoft Office 2016, quindi Dashboard di telemetria per Office 2016.
Windows 8.1
Nella schermata Start digitare Dashboard di telemetria, quindi selezionare questo elemento dai risultati di ricerca.
Windows Server 2012 R2 o Windows Server 2012
Scorrere rapidamente dal bordo destro per visualizzare gli accessi e quindi scegliere Cerca per visualizzare tutte le app installate nel computer. Scegliere quindi Dashboard di telemetria per Office 2016.

Per Office 2019, cercare Dashboard di telemetria per Office in Strumenti di Microsoft Office.

Nota

  • Il supporto per Windows 7 e Windows Server 2008 R2 è terminato il 14 gennaio 2020.
  • Il supporto per Windows 8.1 è terminato il 10 gennaio 2023.

SQL Server

SQL Server deve essere distribuito prima di configurare il dashboard di telemetria di Office. Non è necessario disporre di un database esistente, ma occorre installare o avere accesso a una delle versioni seguenti di SQL Server:

  • SQL Server 2016 o SQL Server 2016 Express

  • SQL Server 2014 o SQL Server 2014 Express

  • SQL Server 2012 o SQL Server 2012 Express

  • SQL Server 2008 R2 o SQL Server 2008 R2 Express Edition

  • SQL Server 2008 o SQL Server 2008 Express Edition

  • SQL Server 2005 o SQL Server 2005 Express Edition

Nota

Per verificare quali versioni di SQL Server sono attualmente supportate, passare alla pagina Cerca informazioni sul ciclo di vita di prodotti e servizi.

Il foglio di lavoro Attività iniziali nel dashboard di telemetria di Office fornisce un collegamento per scaricare SQL Server 2014 Express. Se SQL Server non è già installato, seguire la procedura descritta in Per scaricare e installare SQL Server 2014 Express. Prima di installare SQL Server 2014 Express, verificare le linee guida seguenti.

  • Assicurarsi che il computer soddisfi i requisiti hardware e software per SQL Server 2014. Ciò è particolarmente importante se si pianifica una configurazione all-in-one per il test perché SQL Server ha requisiti aggiuntivi, ad esempio l'installazione di Service Pack di Windows non necessari per il dashboard di telemetria di Office. Questi requisiti sono descritti in Requisiti hardware e software per l'installazione di SQL Server 2014.

  • Per installazioni locali, è necessario eseguire il programma di installazione come amministratore. Se si installa SQL Server da una cartella condivisa remota, è necessario utilizzare un account di dominio che disponga delle autorizzazioni di lettura ed esecuzione per la cartella condivisa remota. Per altre informazioni, vedere Installare SQL Server 2014 dall'Installazione guidata (installazione).

Per scaricare e installare SQL Server 2014 Express

  1. Nel dashboard di telemetria di Office, nel foglio di lavoro Introduzione, sotto 1. Configurare i prerequisiti, scegliere il collegamento per scaricare e installare SQL Server 2014 Express with Tools. Scegliere l'edizione appropriata, a 32 o 64 bit. In alternativa, usare questo collegamento: Microsoft SQL Server 2014 Express.

  2. Il processo di installazione di SQL Server 2014 Express richiede tempo per scaricare ed estrarre i file. Accettare le varie richieste e attendere che la prima pagina di SQL Server 2014 Express, denominata Centro installazione SQL Server, venga visualizzata al termine dell'estrazione. Quindi seguire la procedura seguente:

    1. Nel Centro installazione SQL Server scegliere Nuova installazione autonoma di SQL Server o aggiunta di funzionalità a un'installazione esistente.

    2. Nella configurazione guidata SQL Server 2014 leggere le condizioni di licenza, accettarle e quindi scegliere Avanti.

    3. Nella pagina Selezione funzionalità accettare le impostazioni predefinite. Scegliere Avanti.

    4. Nella pagina Configurazione dell'istanza creare un'istanza denominata, ad esempio, "dashtele". Scegliere Avanti.

    5. Nella pagina Configurazione del server accettare gli account di servizio predefiniti. Scegliere Avanti.

    6. Nella pagina Configurazione del Motore di database accettare la modalità di autenticazione predefinita (Modalità di autenticazione di Windows). L'account utente viene visualizzato come amministratore SQL Server. Avviso: Non usare la modalità mista perché il dashboard di telemetria di Office non supporta l'autenticazione SQL Server. Scegliere Avanti.

    7. Se si desidera inviare segnalazioni degli errori a Microsoft, nella pagina Segnalazione errori selezionare la relativa casella di controllo. In alternativa, è sufficiente scegliere Avanti.

    8. Attendere il completamento del processo di installazione, quindi uscire dalla procedura guidata e dal Centro installazione SQL Server.

Processore di telemetria di Office

Il processore di telemetria di Office viene eseguito in uno o più computer e raccoglie i dati di inventario, utilizzo e integrità dalla cartella condivisa e importa i dati nel database. Il processore viene installato come servizio Windows denominato "Processore di telemetria di Office" e il processore supporta Transport Layer Security (TLS) 1.2.

Importante

Se i computer che eseguono la coppia di processore e cartella condivisa non fanno parte di un dominio, è necessario installare questi componenti utilizzando lo script disponibile in Configurare rapidamente il dashboard di telemetria di Office in un computer di gruppo di lavoro o aggiunto a un dominio.

Il processore genera i log degli errori in un file denominato dperrorlog.txt. Tale file si trova in una cartella nascosta in %systemroot%\ServiceProfiles\NetworkService\AppData\Local\Temp.

Ogni computer in cui si installano i processori e il database deve eseguire anche la versione più recente del runtime C universale (CRT) per la versione di Windows in esecuzione nel computer. Per informazioni, vedere Aggiornamento di Universal C Runtime in Windows.

È consigliabile usare i sistemi operativi seguenti per i computer che eseguono il processore:

Per gli ambienti di produzione: Per ottenere prestazioni ottimali, è consigliabile usare una versione supportata di Windows Server, ad esempio Windows Server 2019.

Per ambienti di produzione di piccole dimensioni o di test: È possibile usare computer che eseguono Windows 10 o Windows 11 in ambienti di test e in ambienti di produzione di piccole dimensioni. I sistemi operativi client sono soggetti al limite di 20 connessioni contemporanee, ma negli ambienti di piccole dimensioni, l'impostazione della sequenza casuale degli agenti dovrebbe ridurre al minimo le probabilità che si connettano più di 20 agenti contemporaneamente.

Assicurarsi di avere a disposizione quanto segue prima di eseguire la procedura guidata per configurare il processore.

  • Nome di istanza di SQL Server. L'esempio indicato sopra è "teledash".

  • Database SQL. Se non si specifica un database esistente, ne verrà creato uno nuovo.

  • Autorizzazioni per creare una cartella condivisa o il percorso UNC di una cartella condivisa esistente. La procedura guidata che configura il processore può creare una cartella condivisa se dispone delle autorizzazioni per farlo. Se si specifica una cartella condivisa esistente, le eventuali autorizzazioni esistenti per NTFS e la cartella condivisa vengono sovrascritte con le autorizzazioni impostate dalla procedura guidata.

  • Autorizzazioni per creare un database (ruolo sysadmin di SQL Server). Per creare e configurare un nuovo database, l'account che esegue la procedura guidata per configurare il processore deve essere un account di dominio membro del ruolo a livello di server sysadmin nella SQL Server. Per l'uso continuo del dashboard di telemetria di Office, l'appartenenza al ruolo sysadmin non è necessaria e può essere rimossa dopo la creazione del database. È anche possibile usare un database esistente.

  • Almeno 11 GB di spazio libero sul disco rigido. Questo spazio su disco è necessario per archiviare temporaneamente i dati raccolti dagli utenti.

Per installare il processore di telemetria di Office

  1. Nel computer in cui si vuole installare il processore installare la versione più recente di CRT. Per ulteriori informazioni, vedere Aggiornamento di Universal C Runtime in Windows.

  2. Nel foglio di lavoro Introduzione del dashboard di telemetria di Office scegliere il collegamento di installazione in 2. Installare il processore di telemetria. Selezionare la versione x86 o x64 che corrisponde all'architettura del sistema operativo Windows in cui verrà eseguito il processore.

  3. Facoltativamente, è possibile usare i collegamenti nel dashboard di telemetria di Office per salvare il file .msi in un altro computer ed eseguire il programma di installazione. Questo passaggio è necessario se si installano processori in computer separati.

  4. Scegliere Avanti e quindi per accettare la richiesta di controllo dell'account utente per installare il processore. Scegliere Fine, che avvia la procedura guidata per le impostazioni del processore di telemetria di Office .

  5. Scegliere per confermare e quindi Avanti.

  6. Digitare il nome dell'istanza di SQL Server e quindi scegliere Connetti.

  7. Digitare il nome di un nuovo database, scegliere Crea e quindi Avanti.

  8. Scegliere per creare le autorizzazioni per il database e il ruolo del database.

  9. Nella pagina Cartella condivisa eseguire una delle operazioni seguenti:

    • Specificare il percorso UNC di una cartella condivisa esistente e quindi scegliere Avanti. Scegliere per consentire alla procedura guidata di impostare le autorizzazioni appropriate.

    • Per creare una nuova cartella condivisa nel computer locale, scegliere Sfoglia. Passare al percorso in cui si vuole creare la cartella condivisa. Aprire il menu di scelta rapida per la cartella padre (fare clic con il pulsante destro del mouse), scegliere Nuovo e quindi scegliere Cartella. Digitare il nome della nuova cartella, assicurarsi di scegliere di nuovo la cartella per selezionarla e quindi scegliere Seleziona cartella. Scegliere Avanti e quindi Sì per consentire alla procedura guidata di condividere la cartella e impostare le autorizzazioni appropriate.

  10. Accettare l'opzione predefinita per iscriversi al programma Analisi utilizzo software o scegliere l'opzione di non iscriversi in questo momento e quindi fare clic su Avanti.

  11. Scegliere Fine per uscire dalla procedura guidata.

Database usato dal dashboard di telemetria di Office

Il database, creato dalla procedura guidata per le impostazioni del processore di telemetria di Office , è pronto per essere configurato e connesso al dashboard di telemetria di Office.

Per connettersi al database

  1. Nel dashboard di telemetria di Office, nel foglio di lavoro Attività iniziali , inferiore a 5. Connettersi al database per visualizzare i dati di telemetria, scegliere Connetti al database.

  2. Specificare il nome del SQL Server e del database SQL specificato durante l'installazione del processore.

Dopo la connessione, alla cartella di lavoro vengono aggiunti molti nuovi fogli di lavoro. Non contengono dati fino a quando non si distribuiscono e si abilitano gli agenti.

Per concedere ad altri amministratori l'autorizzazione per accedere al database

  • È possibile usare lo strumento di amministrazione del dashboard di telemetria (Tdadm) nel computer che esegue SQL Server per consentire ad altri amministratori di visualizzare i dati nel dashboard di telemetria di Office. Non è necessario eseguire questa operazione per il proprio account se è stato creato un database quando è stato installato il processore. Aggiornare i valori relativi a dbserver, dbname e domain\user secondo le esigenze.

    tdadm.exe -o permission -databaseserver dbserver -databasename dbname -add domain\user
    

Per ulteriori informazioni sullo strumento Tdadm, vedere il wiki sullo strumento di amministrazione del dashboard di telemetria.

Per altre informazioni su come configurare la soglia di creazione di report nel database per proteggere la privacy degli utenti, vedere Gestire la privacy dei dati monitorati dal dashboard di telemetria di Office. In caso di difficoltà di connessione al database, vedere Risoluzione dei problemi relativi alle distribuzioni del dashboard di telemetria di Office.

Se i dati (ad esempio nomi di file, nomi di soluzioni, nomi utenti, nomi di computer o valori di tag) includono caratteri supplementari (coppie di surrogati), utilizzare le regole di confronto SC seguenti disponibili in SQL Server per una migliore gestione dei caratteri.

  • Regole di confronto Windows versione 90, ad esempio Chinese_PRC_Stroke_90

  • Regole di confronto Windows versione 100, ad esempio Latin1_General_100_CI_AS_SC

Per ulteriori dettagli sulle impostazioni delle regole di confronto, vedere la documentazione relativa alla versione di SQL Server in uso.

agente di telemetria di Office

Le informazioni e le istruzioni seguenti consentono di ottenere altre informazioni su come distribuire e abilitare l'agente di telemetria di Office.

Distribuzione dell'agente

L'agente è integrato in Office 2019, Office 2016 e Office 2013 e non deve essere distribuito separatamente. Se l'organizzazione ha una delle versioni seguenti di Office, è necessario distribuire l'agente di Office 2019 o Office 2016 a questi client.

  • Office 2003

  • Office 2007

  • Office 2010

Nota

Office 2003, Office 2007, Office 2010 e Office 2013 non sono più supportati.

Per i computer che eseguono Office 2013 e l'agente di Office 2013 è installato nel computer, sono disponibili diverse considerazioni aggiuntive:

  • È possibile monitorare i computer che eseguono Office 2013 dal dashboard di telemetria di Office 2019 o Office 2016. Affinché questo funzioni, il computer deve anche eseguire l'agente Office 2013. L'agente deve essere configurato in modo che punti al dashboard di telemetria di Office 2019 o Office 2016.

  • Non è possibile usare un agente di Office 2019 o Office 2016 con Office 2013. L'agente di Office 2019 o Office 2016 non sarà in grado di leggere gli eventi da un'installazione di Office 2013.

  • Dopo aver aggiornato un computer a Office 2019 o Office 2016, è possibile continuare a eseguire l'agente di Office 2013 precedente. L'agente continuerà a segnalare i dati al dashboard di telemetria di Office 2013. Allo stesso tempo, il nuovo agente di Office 2019 o Office 2016 installato durante l'aggiornamento a Office 2019 o Office 2016 fornirà gli stessi dati al dashboard di telemetria di Office 2019 o Office 2016. Tale operazione potrebbe consumare risorse utili della larghezza di banda di rete e del computer. È consigliabile disabilitare l'agente di Office 2013 quando si è pronti per passare al dashboard di telemetria di Office 2019 o Office 2016.

  • Quando si installa l'agente di Office 2019 o Office 2016, l'agente di Office 2013 non viene sovrascritto. È invece necessario disabilitare l'agente di Office 2013. È possibile disabilitare l'agente usando Criteri di gruppo. Per altre informazioni sulle impostazioni Criteri di gruppo usate per disabilitare l'agente, vedere Abilitazione e configurazione dell'agente.

  • È consigliabile non distribuire l'agente di Office 2019 o Office 2016 nei computer che eseguono solo Office 2013.

Per eseguire l'agente, i computer client devono eseguire una delle versioni seguenti di Windows (a 32 bit o a 64 bit):

  • Window 10

  • Windows 8.1

  • Windows 7 con Service Pack 1

  • Windows Server 2016

  • Windows Server 2012 R2

  • Windows Server 2012

  • Windows Server 2008 R2

  • Windows Server 2008

L'agente potrebbe non funzionare correttamente nei Service Pack di Windows che non sono più supportati da Microsoft. È consigliabile verificare che il Service Pack sia supportato nelle informazioni sul ciclo di vita dei prodotti e dei servizi di ricerca prima di installare l'agente.

Nota

  • Windows 7 con Service Pack 1, Windows 8.1, Windows Server 2008 R2 e Windows Server 2008 non sono più supportati.

Il computer che esegue l'agente deve eseguire anche la versione più recente di Universal C Runtime (CRT) per la versione di Windows. Per informazioni, vedere Aggiornamento di Universal C Runtime in Windows.

Per distribuire l'agente di Office 2019 o Office 2016 nei client di Office 2010, Office 2007 e Office 2003

  1. Nel dashboard di telemetria di Office, nel foglio di lavoro Introduzione , sotto 3. Distribuire l'agente di telemetria, scegliere il collegamento appropriato (x86 o x64) per salvare l'agente .msi file in un percorso specificato.

  2. Utilizzando il metodo più appropriato, distribuire il file msi nei computer client che si desidera monitorare. Assicurarsi di associare la versione x86 o x64 dell'agente all'architettura del sistema operativo Windows in esecuzione nel client, non all'architettura client di Office.

    Per installazioni in client locali, è necessario eseguire il file msi come amministratore. Il pacchetto MSI può essere distribuito in modo invisibile all'utente utilizzando il parametro /quiet con il file MSI. Fare riferimento alla Guida di MSI per l'insieme completo dei parametri disponibili.

    Per le distribuzioni su larga scala, è possibile distribuire l'agente di telemetria usando Microsoft Configuration Manager.

Abilitazione e configurazione dell'agente

Per abilitare e configurare l'agente, è possibile modificare il Registro di sistema in ogni computer client monitorato in ambienti di piccole dimensioni o di test. Per gli ambienti di produzione che contengono centinaia o migliaia di computer client, è possibile utilizzare i modelli amministrativi dei Criteri di gruppo. Due impostazioni, AgentInitWait e AgentRandomDelay, sono configurabili solo nel Registro di sistema.

Usare il Registro di sistema per abilitare e configurare l'agente

Il modo più semplice per aggiornare il Registro di sistema in un singolo client consiste nell'eseguire un file reg che imposta i valori del Registro di sistema che consentono all'agente di raccogliere e caricare dati. Il file reg può essere creato copiando uno degli esempi seguenti in un file di testo, aggiornando i campi necessari, salvando il file come agent.reg ed eseguendolo a un prompt dei comandi con privilegi elevati. Nel file reg assicurarsi di specificare il percorso UNC della cartella condivisa in cui l'agente carica i dati. Facoltativamente, è possibile aggiornare i campi <TAG> per facilitare l'identificazione dei dati raccolti nell'organizzazione, utilizzando ad esempio valori quali reparto, sede o gruppo di distribuzione.

Nell'esempio seguente vengono impostate le impostazioni predefinite necessarie per abilitare l'agente. AgentInitWait e AgentRandomDelay vengono impostati sui rispettivi valori predefiniti, come appropriato per le distribuzioni di produzione.

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\osm]
"CommonFileShare"="\\\\<SERVERNAME>\\<SHARENAME>"
"Tag1"="<TAG1>"
"Tag2"="<TAG2>"
"Tag3"="<TAG3>"
"Tag4"="<TAG4>"
"AgentInitWait"=dword:00000258
"Enablelogging"=dword:00000001
"EnableUpload"=dword:00000001
"EnableFileObfuscation"=dword:00000000
"AgentRandomDelay"=dword:000000F0

Il codice nell'esempio seguente consente al dashboard di telemetria di Office di iniziare immediatamente il caricamento dei dati impostando AgentInitWait e AgentRandomDelay sui valori più piccoli. Utilizzare questo esempio solo negli ambienti di testing.

Windows Registry Editor Version 5.00
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\osm]
"CommonFileShare"="\\\\<SERVERNAME>\\<SHARENAME>"
"Tag1"="<TAG1>"
"Tag2"="<TAG2>"
"Tag3"="<TAG3>"
"Tag4"="<TAG4>"
"AgentInitWait"=dword:00000001
"Enablelogging"=dword:00000001
"EnableUpload"=dword:00000001
"EnableFileObfuscation"=dword:00000000
"AgentRandomDelay"=dword:00000000

È possibile distribuire gli aggiornamenti del Registro di sistema in più computer client inserendo un file reg in una cartella condivisa e indicando agli utenti di eseguire il file oppure aggiungendo un comando allo script di accesso degli utenti in modo da importare automaticamente il file reg al momento dell'accesso degli utenti. Per avviare il file reg da uno script di accesso, utilizzare la sintassi dell'esempio seguente:

%windir%\regedit.exe /s <PATH>\<NAME>.reg

Per ulteriori informazioni sull'utilizzo dei file con estensione reg, vedere Aggiunta, modifica o eliminazione di sottochiavi e valori del Registro di sistema mediante un file REG (Registration Entries).

Nella tabella seguente vengono descritti i singoli valori del Registro di sistema.

Nota

Se non si è amministratori, sarà necessario modificare HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\OSM nel Registro di sistema. Tali modifiche possono essere sovrascritte dalle impostazioni dei criteri presenti in HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM.

Impostazioni del Registro di sistema dell'agente in HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM

Nome valore Tipo Dati e descrizione valore Obbligatorio o facoltativo
enablelogging
REG_DWORD
Abilita la registrazione di runtime e l'analisi statica. In questo modo l'agente può raccogliere dati.

Valore:

1 = abilita registrazione e agente
0 = disabilita registrazione e agente
Predefinito = 0 (disabilita registrazione e agente)
Obbligatorio
enableupload
REG_DWORD
Attiva la funzionalità di caricamento dei dati nell'agente in modo che l'agente possa caricare periodicamente i dati nella cartella condivisa specificata in CommonFileShare.

Valore:

0 = non caricare
1 = carica
Predefinito = 0 (non caricare)
Obbligatorio
commonfileshare
REG_SZ
Specifica il percorso UNC della cartella condivisa per l'archiviazione dei dati.

Valore:

\\server\share
Obbligatorio
tag1
tag2
tag3
tag4
REG_SZ
Aggiunge tag personalizzati ai dati inviati dall'agente. Se si abilita questa impostazione di criterio, i tag personalizzati specificati vengono visualizzati nel dashboard di telemetria di Office, in cui è possibile filtrare i dati raccolti in base al nome del tag. È possibile sostituire tag1, tag2, tag3 e tag4 con stringhe personalizzate per classificare e filtrare i dati raccolti, ad esempio sostituire tag1 con un nome di reparto, sostituire tag2 con la posizione degli utenti e così via.

Valore:

tag1
tag2
tag3
tag4
Facoltativo
enablefileobfuscation
REG_DWORD
Configura l'agente per mascherare o offuscare determinate proprietà di file segnalate nei dati. Se si abilita questa impostazione di criterio, l'agente offusca il nome file, il percorso del file e il titolo dei documenti di Office prima di caricare i dati nella cartella condivisa. Per altre informazioni sull'offuscamento dei file e altre impostazioni di privacy per il dashboard di telemetria di Office, vedere Gestire la privacy dei dati monitorati dal dashboard di telemetria di Office.

Valore:

0 = non offuscare
1 = offusca
Predefinito = 0 (non offuscare)
Facoltativo
AgentInitWait
REG_DWORD
IMPORTANTE: Per evitare di influire sulle prestazioni di rete o client, ridurre questo valore solo negli ambienti di test.

Regola il tempo di attesa dell'agente prima di analizzare un client e caricare i dati nella cartella condivisa. Se questo valore non viene specificato, il tempo di attesa predefinito è di 10 minuti (600 secondi). Negli ambienti di testing è possibile specificare 1 secondo per rimuovere il ritardo nei test di Windows 7 con Service Pack 1 e dei client precedenti. È consigliabile impostare questo valore almeno su 60 secondi per i computer che eseguono Windows "8".

Valore:

x = tempo di attesa in secondi
Facoltativo
AgentRandomDelay
REG_DWORD
IMPORTANTE: Per evitare di influire sulle prestazioni di rete o client, ridurre questo valore solo negli ambienti di test.

Regola il ritardo casuale massimo, in minuti. L'agente attende in modo casuale tra 0 e AgentRandomDelay minuti, oltre al valore AgentInitWait , prima di iniziare a analizzare o caricare i dati. Se questo valore non viene specificato, l'agente attende tra 0 e 240 minuti. Negli ambienti di testing è possibile specificare 0 per rimuovere il ritardo casuale relativo nei test.

Valore:

x = ritardo casuale in minuti
Facoltativo

Impostazioni del Registro di sistema dell'agente in HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM\preventedapplications

Nome valore Tipo valore Dati e descrizione valore Obbligatorio o facoltativo
accesssolution
olksolution
onenotesolution
pptsolution
projectsolution
publishersolution
visiosolution
wdsolution
xlsolution
REG_DWORD
Impedisce che i dati per applicazioni di Office specifiche vengano segnalati al dashboard di telemetria di Office. Per altre informazioni su questa impostazione del Registro di sistema, vedere Gestire la privacy dei dati monitorati dal dashboard di telemetria di Office.

Valore:

1 = Impedisci segnalazione
0 = Consenti segnalazione
Predefinito = 0 (consenti segnalazione)
Facoltativo

Impostazioni del Registro di sistema dell'agente in HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM\preventedsolutiontypes

Nome valore Tipo valore Dati e descrizione valore Obbligatorio o facoltativo
agave
appaddins
comaddins
documentfiles
templatefiles
REG_DWORD
Impedisce che i dati per soluzioni specifiche vengano segnalati al dashboard di telemetria di Office. Il tipo di soluzione viene comunque riportato. Per altre informazioni su questa impostazione del Registro di sistema, vedere Gestire la privacy dei dati monitorati dal dashboard di telemetria di Office.

Valore:

1 = Impedisci segnalazione
0 = Consenti segnalazione
Predefinito = 0 (consenti segnalazione)
Facoltativo

Usare Criteri di gruppo per abilitare e configurare l'agente

È anche possibile usare Criteri di gruppo per abilitare e configurare gli agenti. Scaricare i file del modello amministrativo (ADMX/ADML) per Office dall'Area download Microsoft. Le impostazioni dei criteri elencate nella tabella seguente sono disponibili nel percorso Configurazione utente\Criteri\Modelli amministrativi\Microsoft Office 2016\Telemetry Dashboard.

Impostazioni dei criteri dell'agente

Nome dell'impostazione Descrizione Obbligatorio o facoltativo
Attivare la raccolta dei dati di telemetria
Attiva le funzionalità di raccolta dati in Office usate dal dashboard di telemetria di Office e dal log di telemetria di Office. Per impostazione predefinita, la raccolta dati è disabilitata in Office.
Obbligatorio
Attivare il caricamento dei dati per l'agente di telemetria di Office
Attiva la funzionalità di caricamento dei dati nell'agente in modo che l'agente possa caricare periodicamente i dati in una cartella condivisa. Per impostazione predefinita, il caricamento dei dati è disabilitato.
Obbligatorio
Specifica il percorso UNC per l'archiviazione dei dati di telemetria di Office
Specifica il percorso UNC (Uniform Naming Convention) di una cartella condivisa a cui l'agente invia i dati.
Obbligatorio
Specifica tag personalizzati per i dati di telemetria di Office
Aggiunge tag personalizzati ai dati inviati dall'agente. Se si abilita questa impostazione di criterio, i tag personalizzati specificati vengono visualizzati nel dashboard di telemetria di Office, in cui è possibile filtrare i dati raccolti in base al nome del tag. È possibile specificare qualsiasi stringa che si desidera categorizzare e filtrare i dati raccolti, ad esempio il nome del reparto, il titolo dell'utente e così via.
Facoltativo
Attivare le impostazioni di privacy nell'agente di telemetria di Office
Configura l'agente per mascherare o offuscare determinate proprietà di file segnalate nei dati. Se si abilita questa impostazione di criterio, l'agente offusca il nome file, il percorso del file e il titolo dei documenti di Office prima di caricare i dati nella cartella condivisa.

Per altre informazioni sull'offuscamento dei file e altre impostazioni di privacy per il dashboard di telemetria di Office, vedere Gestire la privacy dei dati monitorati dal dashboard di telemetria di Office.
Facoltativo
Applicazioni di Office da escludere dal report dell'agente di telemetria di Office
Impedisce che i dati per applicazioni di Office specifiche vengano segnalati al dashboard di telemetria di Office.
Facoltativo
Soluzioni di Office da escludere dal report dell'agente di telemetria di Office
Impedisce che i dati per soluzioni di Office specifiche vengano segnalati al dashboard di telemetria di Office.
Facoltativo

Attivazione manuale della raccolta dati

Quando un utente accede a un client di Office, l'agente attende 10 minuti per consentire il completamento di altri processi di accesso e quindi attende un numero casuale di minuti fino a 4 ore (o il ritardo massimo impostato per il valore del Registro di sistema AgentRandomDelay) per evitare che i computer client inviino dati alla rete contemporaneamente. Dopo questa analisi iniziale, l'agente analizza e raccoglie i dati ogni 8 ore.

Se si vuole attivare manualmente la raccolta dati e visualizzare i dati caricati immediatamente nel dashboard di telemetria di Office, impostare i valori del Registro di sistema seguenti come descritto nella tabella precedente:

Per i computer che eseguono Windows 7 con Service Pack 1 e versioni precedenti

  • AgentInitWait: 1

  • AgentRandomRelay: 0

Per i computer che eseguono Windows 8.1 e versioni successive

Poiché l'accesso utente è più veloce in Windows 8.1 e versioni successive di Microsoft Windows, è consigliabile impostare AgentInitWait su almeno 60 secondi per assicurarsi che la connessione di rete sia pronta dopo l'accesso dell'utente.

  • AgentInitWait: 60

  • AgentRandomRelay: 0

Per attivare una scansione manualmente, utilizzare una delle procedure seguenti.

Per attivare la scansione e la raccolta dati nei client Windows

  1. Accertarsi che il computer sia connesso all'alimentazione CA.

  2. Nell'utilità di pianificazione del computer client espandere Libreria Utilità di pianificazione, espandere Microsoft e quindi scegliere Office.

  3. Fare clic su OfficeTelemetryAgentLogOn, quindi scegliere Esegui.

Domande frequenti sul dashboard di telemetria di Office

D: Cosa accade se un computer client resta disconnesso per un certo tempo?

Un: Se un client monitorato è disconnesso o se la cartella condivisa è temporaneamente non disponibile, i dati vengono comunque raccolti localmente nel client. Quando la connessione viene ripristinata, il backlog di informazioni viene recapitato alla cartella condivisa.

D: Quanti dati vengono trasferiti in ogni sessione?

R: La quantità varia in base al numero di file utilizzati e alle soluzioni installate. Di seguito sono riportate le stime della quantità di dati inviati dall'agente per le diverse versioni di Office:

  • Le versioni precedenti di Office inviano circa 50 KB ad ogni caricamento.

  • Office 2013 e versioni successive inviano circa 64 KB di dati per ogni caricamento.

La quantità di dati trasferiti può aumentare quando si imposta un intervallo maggiore di quello predefinito o quando i dati rimangono nel computer locale per lunghi periodi. Si noti che non viene trasferito il contenuto effettivo del file, ma solo i metadati.

D: Qual è l'impatto sulle prestazioni dell'installazione e dell'esecuzione dell'agente?

R: L'agente funziona in modo trasparente per l'utente ed esegue attività a basso impatto, come l'analisi del contenuto dell'elenco MRU e di impostazioni specifiche del Registro di sistema locale. Non esegue una scansione attiva dei file. Tiene conto dello stato di alimentazione del monitor e dello stato della rete per non incidere sulle prestazioni del client.

D: In che modo è possibile reinizializzare un agente?

Un: L'agente viene archiviato localmente nel computer client in %localappdata%\Microsoft\Office\16.0\Telemetry. È possibile eliminare il contenuto di questa cartella per reinizializzare il computer e avviare una nuova individuazione. Si noti che questo percorso dati è individuale.

D: Con quale frequenza vengono inviati i dati alla cartella condivisa?

Un: I dati vengono trasferiti dal client alla cartella condivisa quando gli utenti accedono e ogni 8 ore mentre l'utente è connesso. Tale intervallo può essere modificato nell'utilità di pianificazione.

D: Qual è il formato dei dati raccolti?

R: I dati raccolti vengono archiviati e trasferiti in formato binario per ottimizzare i requisiti di archiviazione e trasferimento.

D: Se si modificano le etichette personalizzate dopo la distribuzione degli agenti, quando verranno aggiornate le nuove etichette nel database?

Un: Solo i file inclusi nell'elenco Utilizzato più di recente avranno le etichette aggiornate nel database. Questa operazione si verificherà alla successiva invio dei dati di utilizzo da parte dell'agente. Per i file che non sono inclusi nell'elenco Usato più di recente, continueranno a mostrare le etichette precedenti nel database fino a quando l'utente non apre il file e l'agente carica i dati di utilizzo.

Risoluzione dei problemi relativi alle distribuzioni del dashboard di telemetria di Office

La tabella seguente descrive alcuni sintomi che potrebbero verificarsi dopo la distribuzione del dashboard di telemetria di Office e dei relativi componenti.

Risoluzione dei problemi relativi alle distribuzioni del dashboard di telemetria di Office

Problema Descrizione Risoluzione
Le impostazioni guidate del processore di telemetria di Office hanno esito negativo
La procedura guidata termina negativamente con il messaggio "L'Impostazione guidata Processore di telemetria di Office può essere eseguita solo in computer che fanno parte di un dominio. Aggiungere il computer a un dominio ed eseguire di nuovo la procedura guidata".
I computer che eseguono il processore, la cartella condivisa e il database SQL devono essere aggiunti a un dominio in modo che sia possibile configurare le impostazioni di sicurezza appropriate. Verificare che il computer o i computer appartengano a domini trusted.

È possibile installare questi componenti in un singolo computer di gruppo di lavoro o aggiunto a un dominio utilizzando lo script descritto nel post di blog che spiega come configurare rapidamente il dashboard di telemetria di Office in un computer di gruppo di lavoro o aggiunto a un dominio.
Le impostazioni guidate del processore di telemetria di Office hanno esito negativo
Il processore usa l'istanza di SQL Server errata.
Se sono presenti due o più istanze di SQL Server, assicurarsi di puntare all'istanza di SQL Server corretta usando il formato Servername\SQLServerinstance durante l'installazione del processore.
Dashboard di telemetria di Office non mostra dati
L'agente non carica i dati e il processo di Msoia.exe non è in esecuzione in Gestione attività.
Controllare il percorso del Registro di sistema e i valori di CommonFileShare, EnableLogging e EnableUpload. Questi sono descritti in Abilitazione e configurazione dell'agente, più indietro in questo articolo.
Dashboard di telemetria di Office non mostra dati
L'agente non esegue l'analisi o il caricamento dei dati. Il processo Msoia.exe viene eseguito in Task Manager per lungo tempo.
Per impostazione predefinita, l'agente dispone di un timer di attesa iniziale e di una funzionalità di randomizzazione per evitare di caricare grandi quantità di dati contemporaneamente ad altri agenti e influire sulla larghezza di banda di rete. Per rimuovere questi ritardi negli ambienti di testing, aggiornare i valori AgentInitWait e AgentRandomDelay del Registro di sistema. In caso contrario, il processo di caricamento potrà essere ritardato fino a 4 ore e 10 minuti. Questi valori del Registro di sistema sono descritti in Abilitazione e configurazione dell'agente, più indietro in questo articolo. È possibile apprendere come attivare l'analisi e il caricamento in Attivazione manuale della raccolta dati.
Dashboard di telemetria di Office non mostra dati
L'agente non carica i dati. Il processo Msoia.exe viene eseguito in Task Manager per lungo tempo.
Verificare la connessione di rete tra l'agente e la cartella condivisa.

Verificare che il computer sia unito a un dominio. La cartella condivisa è configurata per consentire l'accesso solo agli utenti autenticati nel dominio.

L'agente continua a tentare di caricare i dati dopo l'esito negativo del caricamento. Quando si utilizzano i valori predefiniti del Registro di sistema, l'agente continua a essere eseguito come un processo in Task Manager per un tempo massimo di 4 ore e 10 minuti. Per modificare i valori del Registro di sistema, vedere Abilitazione e configurazione dell'agente, più indietro in questo articolo. È possibile apprendere come attivare l'analisi e il caricamento in Attivazione manuale della raccolta dati.
Dashboard di telemetria di Office non mostra dati
L'attività dell'agente non sembra funzionare.
Controllare le informazioni contenute nella colonna Risultato ultima esecuzione nell'unità di pianificazione. Se l'operazione ha esito positivo, il codice restituito è 0. Se l'agente non può caricare i dati nella cartella condivisa, nella colonna Risultato ultima esecuzione viene visualizzato il messaggio "Impossibile trovare il nome della rete". Questo è l'unico errore che l'agente registra nella colonna Risultato ultima esecuzione. Se vengono elencati altri errori, sono imputabili a cause diverse o l'attività pianificata non è stata eseguita.
Dashboard di telemetria di Office non mostra dati
Il processore non funziona. Nella cartella condivisa sono presenti molte cartelle e file.
Verificare la connessione di rete tra il processore e la cartella condivisa. Il processore è stato configurato dalla procedura guidata per le impostazioni del processore di telemetria di Office ? Le autorizzazioni per la cartella condivisa possono variare a seconda del percorso del processore e del database. Eseguire di nuovo le impostazioni del processore di telemetria di Office dal collegamento sul desktop.
Dashboard di telemetria di Office non mostra dati
Il processore funziona, ma nella cartella Failed della cartella condivisa sono presenti molte cartelle e file.
Il processore elabora i file nella cartella condivisa nel database una volta al minuto. Se il processore non riesce a elaborare i file tre volte, sposterà i file non riusciti nella cartella Failed. Per altre informazioni, vedere il log del processore (%windows%\ServiceProfiles\NetworkService\AppData\Local\Temp\dperrorlog.txt).
Dashboard di telemetria di Office non mostra dati
Il processore non funziona a causa delle impostazioni di autenticazione SQL Server.
Verificare il tipo di autenticazione per SQL Server. Il dashboard di telemetria di Office non supporta l'autenticazione SQL. È necessario utilizzare l'autenticazione di Windows.
Dashboard di telemetria di Office non mostra dati
Il processore non funziona a causa di problemi del firewall tra il processore e il database.
Se è presente un firewall tra il dashboard di telemetria di Office e il database, verificare se la porta SQL è abilitata nella configurazione del firewall. La porta predefinita per SQL Server è la 1433. Per ulteriori informazioni, vedere Configurazione di Windows Firewall per l'accesso al Motore di database.
Dashboard di telemetria di Office non mostra dati
Il processore non funziona a causa di problemi del firewall tra il processore, il database e SQL Express.
Se è presente un firewall tra il dashboard di telemetria di Office e il database, verificare se la porta SQL è abilitata nella configurazione del firewall. La porta predefinita per SQL Express non ha un valore fisso. Controllare il numero di porta in Configuration Manager SQL Server e aggiungere la porta alla configurazione del firewall. Per ulteriori informazioni, vedere Configurazione di Windows Firewall per l'accesso al Motore di database.
Dashboard di telemetria di Office non mostra dati
Il processore non funziona.
Per altre informazioni, vedere il log del processore (%windows%\ServiceProfiles\NetworkService\AppData\Local\Temp\dperrorlog.txt).
Il dashboard di telemetria di Office non può connettersi al database
Dashboard di telemetria di Office mostra un messaggio di errore che indica che non è possibile connettersi al database a causa delle autorizzazioni di SQL Server.
Controllare il ruolo di autorizzazione per il dashboard di telemetria di Office. Aggiungere l'utente al ruolo td_readonly utilizzando OSQL, SQLCMD, Enterprise Manager o lo strumento di amministrazione del dashboard di telemetria (Tdadm). Per altre informazioni, vedere Database usato dal dashboard di telemetria di Office più indietro in questo articolo.
Il dashboard di telemetria di Office non può connettersi al database
Il dashboard di telemetria di Office mostra un messaggio di errore che indica che non è possibile connettersi al database.
Se sono presenti due o più istanze di SQL Server, assicurarsi che la finestra di dialogo Impostazioni connessione dati nel dashboard di telemetria di Office usi l'istanza di SQL Server corretta nel formato NomeServer\SQLServeristanza.
Il dashboard di telemetria di Office non può connettersi al database
Il dashboard di telemetria di Office mostra un messaggio di errore che indica che non è possibile connettersi al database.
Se SQL Server è SQL Express, verificare che il nome dell'istanza di SQL Server sia corretto. Il nome dell'istanza predefinito per SQL Express è diverso da SQL Server, ad esempio: NomeServer\SQLExpress.
Il dashboard di telemetria di Office non può connettersi al database
Il dashboard di telemetria di Office mostra un messaggio di errore che indica che non è possibile connettersi al database.
Se le regole di confronto predefinite SQL Server fanno distinzione tra maiuscole e minuscole( ad esempio, la versione giapponese di SQL Server fa distinzione tra maiuscole e minuscole per impostazione predefinita), assicurarsi di aver immesso un nome di database con distinzione tra maiuscole e minuscole nella finestra di dialogo Impostazioni connessione dati nel dashboard di telemetria di Office.