Implantar o Painel de Telemetria do Office

Aplica-se a:Office 2019, Office 2016

Importante

Este artigo ajuda você a implantar os cinco componentes do Painel de Telemetria do Office: o próprio dashboard, o processador, o agente, o banco de dados e uma pasta compartilhada. Verifique se você revisa Planejar uma implantação do Painel de Telemetria do Office para obter diretrizes de topologia, escalabilidade e hardware antes de implantar esses componentes.

Importante

  • O Painel de Telemetria do Office é uma ferramenta local que coleta dados de inventário, uso e integridade sobre os documentos e soluções do Office, como suplementos, usados em sua organização. Os dados são projetados principalmente para ajudar sua organização com testes de compatibilidade de aplicativo.
  • Os dados coletados para o Painel de Telemetria do Office são armazenados em um banco de dados SQL Server controlado pela sua organização e os dados coletados não são enviados para a Microsoft. Para obter mais informações, confira Dados coletados pelo agente para o Painel de Telemetria do Office.
  • Os dados coletados para o Painel de Telemetria do Office são diferentes dos dados de diagnóstico do Office, que podem ser enviados para a Microsoft. Para obter mais informações sobre dados de diagnóstico do Office, consulte Visão geral dos controles de privacidade para Microsoft 365 Apps.
  • As configurações usadas para gerenciar o Painel de Telemetria do Office não têm impacto nos dados de diagnóstico do Office e vice-versa. Para obter mais informações sobre como gerenciar dados de diagnóstico do Office, consulte Usar configurações de política para gerenciar controles de privacidade para Microsoft 365 Apps.

Painel de Telemetria do Office

O Painel de Telemetria do Office é uma pasta de trabalho do Excel configurada para se conectar a um banco de dados. O Painel de Telemetria do Office é instalado junto com Office Professional Plus 2019, Office Professional Plus 2016 ou Office Standard 2016. Para exibir o Painel de Telemetria do Office, você deve ter o Excel instalado do Office 2019 ou do Office 2016.

Depois que o Office for instalado, você poderá iniciar o Painel de Telemetria do Office usando um dos procedimentos na tabela a seguir:

Como iniciar o Painel de Telemetria do Office

Sistema operacional Como iniciar o Painel de Telemetria do Office
Windows 10, Windows Server 2008 R2 ou Windows 7 com Service Pack 1
No menu Iniciar , escolha Todos os Programas e, em seguida, Ferramentas do Microsoft Office 2016 e Painel de Telemetria para Office 2016.
Windows 8.1
Na tela Iniciar, digite Painel de Telemetria e então escolha-o nos resultados da pesquisa.
Windows Server 2012 R2 ou Windows Server 2012
Passe o dedo a partir da borda direita para exibir os botões e selecione Pesquisa para ver todos os aplicativos instalados no computador. Em seguida, escolha Painel de Telemetria para Office 2016.

Para o Office 2019, procure o Painel de Telemetria do Office emFerramentas do Microsoft Office.

Observação

  • O suporte para Windows 7 e Windows Server 2008 R2 terminou em 14 de janeiro de 2020.
  • O suporte para Windows 8.1 terminou em 10 de janeiro de 2023.

SQL Server

SQL Server deve ser implantado antes de configurar o Painel de Telemetria do Office. Você não precisa ter um banco de dados existente, mas precisa instalar ou ter acesso a uma dessas versões do SQL Server:

  • SQL Server 2016 ou SQL Server Express 2016

  • SQL Server 2014 ou SQL Server Express 2014

  • SQL Server 2012 ou SQL Server 2012 Express

  • SQL Server 2008 R2 ou SQL Server 2008 R2 Express Edition

  • SQL Server 2008 ou SQL Server Express Edition 2008

  • SQL Server 2005 ou SQL Server 2005 Express Edition

Observação

Para marcar quais versões do SQL Server têm suporte no momento, acesse a página Pesquisar Informações sobre Ciclo de Vida de Produtos e Serviços.

A planilha Introdução no Painel de Telemetria do Office fornece um link para baixar SQL Server Express 2014. Se você ainda não tiver SQL Server instalado, siga as etapas em Para baixar e instalar SQL Server Express 2014. Examine as diretrizes a seguir antes de instalar SQL Server Express 2014.

  • Verifique se o computador atende aos requisitos de hardware e software para SQL Server 2014. Isso é especialmente importante se você estiver planejando uma configuração all-in-one para teste porque SQL Server tem requisitos adicionais, como instalar pacotes de serviço do Windows que não são necessários para o Painel de Telemetria do Office. Esses requisitos são descritos nos Requisitos de Hardware e Software para Instalação SQL Server 2014.

  • Para instalações locais, é necessário executar a Instalação como administrador. Se você instalar SQL Server de uma pasta compartilhada remota, deverá usar uma conta de domínio que tenha permissões de leitura e execução na pasta compartilhada remota. Para obter mais informações, consulte Instalar SQL Server 2014 no Assistente de Instalação (Instalação).

Para baixar e instalar SQL Server 2014 Express

  1. No Painel de Telemetria do Office, na planilha Introdução, abaixo de 1. Configure os pré-requisitos, escolha o link para baixar e instalar SQL Server 2014 Express with Tools. Escolha a versão de 32 bits ou de 64 bits, conforme apropriado. Ou use este link: Microsoft SQL Server 2014 Express.

  2. O processo de instalação do SQL Server 2014 Express leva um tempo para baixar e extrair arquivos. Aceite os vários prompts e aguarde a primeira página do SQL Server Express 2014, que é chamado de Centro de Instalação SQL Server, a ser exibida após a conclusão da extração. Em seguida, execute estas etapas:

    1. No Centro de Instalação SQL Server, escolha Nova SQL Server instalação autônoma ou adicione recursos a uma instalação existente.

    2. No assistente de configuração SQL Server 2014, leia os termos da licença, aceite-os e escolha Avançar.

    3. Na página Seleção de Recursos, aceite as configurações padrão. Escolha Avançar.

    4. Na página Configuração da Instância , crie uma instância nomeada (por exemplo, use o nome "teledash"). Escolha Avançar.

    5. Na página Configuração do Servidor, aceite as contas de serviço padrão. Escolha Avançar.

    6. Na página Configuração de Mecanismo de Banco de Dados, aceite o modo de autenticação padrão (modo de autenticação do Windows). Sua conta de usuário é exibida como um administrador SQL Server. (Aviso: não use o Modo Misto porque o Painel de Telemetria do Office não dá suporte SQL Server autenticação.) Escolha Avançar.

    7. Na página Relatório de Erro, marque a caixa de seleção se você quiser enviar relatórios de erro para a Microsoft. Caso contrário, basta escolher Avançar.

    8. Aguarde a conclusão do processo de instalação e, em seguida, saia do assistente e do Centro de Instalação SQL Server.

Processador de Telemetria do Office

O Processador de Telemetria do Office é executado em um ou mais computadores e coleta dados de inventário, uso e integridade da pasta compartilhada e importa os dados para o banco de dados. O processador é instalado como um serviço windows chamado "Processador de Telemetria do Office" e o processador dá suporte ao TLS (Transport Layer Security) 1.2.

Importante

Se os computadores que executam o processador e o par de pastas compartilhadas e o banco de dados SQL não forem unidos a um domínio, você deverá instalar esses componentes usando o script descrito em Configurar rapidamente o Painel de Telemetria do Office em um grupo de trabalho ou computador ingressado no domínio.

O processador gera logs de erro em um arquivo chamado dperrorlog.txt. Ele está localizado em uma pasta oculta em %systemroot%\ServiceProfiles\NetworkService\AppData\Local\Temp.

Cada computador no qual você instala os processadores e o banco de dados também deve executar a versão mais recente do CRT (Universal C Runtime) para a versão do Windows em execução no computador. Para obter informações, consulte Atualizar para o Universal C Runtime no Windows.

Recomendamos os seguintes sistemas operacionais para computadores que executam o processador:

Para ambientes de produção: Para obter o melhor desempenho, é recomendável usar uma versão com suporte do Windows Server, como o Windows Server 2019.

Para ambientes de produção de teste ou pequenos: Você pode usar computadores que executam Windows 10 ou Windows 11 em ambientes de teste e em ambientes de produção pequenos. Há um limite de 20 conexões simultâneas para sistemas operacionais cliente, mas em ambientes pequenos, a configuração de randomização do agente deve minimizar qualquer chance de mais de 20 agentes se conectarem ao mesmo tempo.

Verifique se você tem o seguinte disponível antes de executar o assistente para configurar o processador.

  • SQL Server nome da instância. O exemplo usado anteriormente é "teledash".

  • Banco de dados SQL. Um novo banco de dados será criado se você não especificar um banco de dados existente.

  • Permissões para criar uma pasta compartilhada, ou o caminho UNC de uma pasta compartilhada existente. O assistente que configura o processador pode criar uma pasta compartilhada se ele tiver permissões para fazer isso. Se uma pasta compartilhada existente for especifixada, todas as permissões de pasta compartilhada e NTFS existentes serão substituídas por permissões definidas pelo assistente.

  • Permissões para criar um banco de dados (função sysadmin no servidor SQL). Para criar e configurar um novo banco de dados, a conta que executa o assistente para configurar o processador deve ser uma conta de domínio que é membro da função de nível de servidor sysadmin no SQL Server. Para o uso contínuo do Painel de Telemetria do Office, a associação à função sysadmin não é necessária e pode ser removida após a criação do banco de dados. É possível utilizar um banco de dados existente.

  • Pelo menos 11 GB de espaço no disco rígido. Esse espaço em disco é necessário para armazenar temporariamente os dados coletados dos usuários.

Para instalar o Processador de Telemetria do Office

  1. No computador em que você deseja instalar o processador, instale a versão mais recente do CRT. Para obter mais informações, consulte Atualizar para o Universal C Runtime no Windows.

  2. No Painel de Telemetria do Office, na planilha Introdução , escolha o link de instalação em 2. Instale o Processador de Telemetria. Selecione a versão x86 ou x64 que é a mesma da arquitetura do sistema operacional Windows em que o processador será executado.

  3. Opcionalmente, você pode usar os links no Painel de Telemetria do Office para salvar o arquivo .msi em outro computador e executar o programa de instalação lá. Essa etapa será necessária se você estiver instalando processadores em computadores separados.

  4. Escolha Avançar e escolha Sim para aceitar o prompt de Controle de Conta de Usuário para instalar o processador. Escolha Concluir, que inicia o assistente de configurações do Processador de Telemetria do Office .

  5. Escolha Sim para aceitar o prompt e escolha Avançar.

  6. Digite o nome da instância SQL Server e escolha Conectar.

  7. Digite o nome de um novo banco de dados, escolha Criar e escolha Avançar.

  8. Escolha Sim para criar permissões de banco de dados e a função do banco de dados.

  9. Execute uma das seguintes opções na página Pasta Compartilhada:

    • Especifique o caminho UNC de uma pasta compartilhada existente e escolha Avançar. Escolha Sim para permitir que o assistente defina as permissões apropriadas.

    • Para criar uma nova pasta compartilhada no computador local, escolha Procurar. Navegue até o local em que deseja criar a pasta compartilhada. Abra o menu de atalho da pasta pai (clique com o botão direito do mouse), aponte para Novo e escolha Pasta. Digite o nome da nova pasta, verifique se você escolhe a pasta novamente para selecioná-la e escolha Selecionar Pasta. Escolha Avançar e escolha Sim para permitir que o assistente compartilhe a pasta e defina as permissões apropriadas.

  10. Aceite a opção padrão para se inscrever no Programa de Aperfeiçoamento da Experiência do Usuário ou escolha a opção de não se inscrever no programa no momento e escolha Avançar.

  11. Escolha Concluir para sair do assistente.

Banco de dados usado pelo Painel de Telemetria do Office

O banco de dados, que foi criado pelo assistente de configurações do Processador de Telemetria do Office , está pronto para ser configurado e conectado ao Painel de Telemetria do Office.

Para se conectar ao banco de dados

  1. No Painel de Telemetria do Office, na planilha Introdução , abaixo de 5. Conecte-se ao banco de dados para exibir dados de telemetria, escolha Conectar-se ao Banco de Dados.

  2. Especifique o nome do banco de dados SQL Server e SQL especificado durante a instalação do processador.

Quando a conexão é estabelecida, muitas planilhas novas são adicionadas à pasta de trabalho. Eles não conterão dados até que você implante e habilite os agentes.

Para conceder permissão a outros administradores para acessar o banco de dados

  • Você pode usar a Tdadm (Ferramenta de Administração do Painel de Telemetria) no computador que está executando SQL Server para permitir que outros administradores exibam dados no Painel de Telemetria do Office. Você não precisa executar isso para sua própria conta se você criou um banco de dados quando instalou o processador. Atualize os valores para dbserver, dbname e domínio\usuário conforme necessário.

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

Para obter mais informações sobre o Tdadm, consulte o wiki Tdadm.

Para obter mais informações sobre como configurar o limite de relatórios no banco de dados para ajudar a proteger a privacidade do usuário, consulte Gerenciar a privacidade dos dados monitorados pelo Painel de Telemetria do Office. Se encontrar problemas na conexão com o banco de dados, consulte Como solucionar problemas em implantações do Painel de Telemetria do Office.

Se seus dados (por exemplo, nomes de arquivo, nomes de solução, nomes de usuário, nomes de computador ou valores de marca) incluirem caracteres suplementares (pares substitutos), use as seguintes ordenações SC disponíveis em SQL Server para dar suporte a um melhor tratamento dos caracteres.

  • Agrupamentos do Windows versão 90, como Chinese_PRC_Stroke_90

  • Agrupamentos do Windows versão 100, como Latin1_General_100_CI_AS_SC

Para obter mais detalhes sobre as configurações de ordenação, consulte a documentação da versão do SQL Server que você está usando.

Agente de Telemetria do Office

As seguintes informações e instruções ajudarão você a saber mais sobre como implantar e habilitar o Agente de Telemetria do Office.

Implantando o agente

O agente é integrado ao Office 2019, Office 2016 e Office 2013 e não precisa ser implantado separadamente. Se sua organização tiver alguma das versões a seguir do Office, você deverá implantar o agente do Office 2019 ou do Office 2016 nesses clientes.

  • Office 2003

  • Office 2007

  • Office 2010

Observação

O Office 2003, o Office 2007, o Office 2010 e o Office 2013 não têm mais suporte.

Para computadores que estão executando o Office 2013 e você tem o agente do Office 2013 instalado no computador, há várias considerações adicionais:

  • Você pode monitorar computadores que executam o Office 2013 no Office 2019 ou no Painel de Telemetria do Office 2016. Para que isso funcione, o computador também deve estar executando o agente do Office 2013. O agente deve ser configurado para apontar para o Painel de Telemetria do Office 2019 ou office 2016.

  • Você não pode usar um agente do Office 2019 ou office 2016 com o Office 2013. O agente do Office 2019 ou do Office 2016 não poderá ler eventos de uma instalação do Office 2013.

  • Depois de atualizar um computador para o Office 2019 ou Office 2016, você pode continuar executando o antigo agente do Office 2013. O agente continuará a relatar dados ao Painel de Telemetria do Office 2013. Ao mesmo tempo, o novo agente do Office 2019 ou office 2016 instalado quando você atualizou para o Office 2019 ou Office 2016 fornecerá os mesmos dados para o Office 2019 ou Office 2016 Office Telemetry Dashboard. Isso pode usar recursos valiosos de largura de banda de computador e rede. Recomendamos desabilitar o agente do Office 2013 depois de estar pronto para migrar para o Office 2019 ou Office 2016 Office Telemetry Dashboard.

  • Quando você instala o agente do Office 2019 ou office 2016, ele não substitui o agente do Office 2013. Em vez disso, você precisa desabilitar o agente do Office 2013. Desabilite o agente usando Política de Grupo. Para obter mais informações sobre as configurações de Política de Grupo que você usa para desabilitar o agente, consulte Habilitar e configurar o agente.

  • Recomendamos que você não implante o agente do Office 2019 ou do Office 2016 em computadores que executam apenas o Office 2013.

Para executar o agente, os computadores cliente devem executar uma das seguintes versões do Windows (32 bits ou 64 bits):

  • Janela 10

  • Windows 8.1

  • Windows 7 com Service Pack 1

  • Windows Server 2016

  • Windows Server 2012 R2

  • Windows Server 2012

  • Windows Server 2008 R2

  • Windows Server 2008

O agente pode não funcionar corretamente em service packs do Windows que não têm mais suporte da Microsoft. É recomendável verificar se o pacote de serviços tem suporte em Informações do Ciclo de Vida do Produto e dos Serviços de Pesquisa antes de instalar o agente.

Observação

  • O Windows 7 com Service Pack 1, Windows 8.1, Windows Server 2008 R2 e Windows Server 2008 não tem mais suporte.

O computador que executa o agente também deve executar a versão mais recente do CRT (Universal C Runtime) para a versão do Windows. Para obter informações, consulte Atualizar para o Universal C Runtime no Windows.

Para implantar o agente do Office 2019 ou office 2016 nos clientes do Office 2010, Office 2007 e Office 2003

  1. No Painel de Telemetria do Office, na planilha Introdução , abaixo de 3. Implante o Agente de Telemetria, escolha o link apropriado (x86 ou x64) para salvar o agente .msi arquivo em um local especificado.

  2. Usando seu método preferido, implante o arquivo .msi nos computadores clientes que você deseja monitorar. Certifique-se de corresponder a versão x86 ou x64 do agente com a arquitetura do sistema operacional Windows que está em execução no cliente, não com a arquitetura do cliente do Office.

    Para instalações locais do cliente, é necessário executar o arquivo .msi como um administrador. É possível implantar o pacote MSI silenciosamente usando o parâmetro /quiet com o MSI. Consulte a ajuda sobre MSI para obter o conjunto completo de parâmetros disponíveis.

    Para implantações em larga escala, você pode implantar o Agente de Telemetria usando Microsoft Configuration Manager.

Habilitando e configurando o agente

Para habilitar e configurar o agente, você pode editar o registro em cada computador cliente monitorado em ambientes pequenos ou de teste. Para ambientes de produção que contêm centenas ou milhares de computadores cliente, é possível usar os modelos administrativos da Política de Grupo. Duas configurações, AgentInitWait e AgentRandomDelay, são configuráveis apenas no registro.

Use o registro para habilitar e configurar o agente

A maneira mais fácil de atualizar o registro em um único cliente é executar um arquivo .reg que define os valores do registro que permitem que o agente colete e carregue dados. Você pode criar esse arquivo .reg copiando um dos exemplos a seguir para um arquivo de texto, atualizando os campos necessários, salvando o arquivo como agent.reg e executando-o de um prompt de comando elevado. No arquivo .reg, verifique se você especifica o caminho UNC da pasta compartilhada para a qual o agente carrega os dados. Opcionalmente, você pode atualizar os <campos TAG> para que possa identificar facilmente os dados coletados em sua organização, como por departamento, local ou grupo de implantação.

O exemplo a seguir define as configurações padrão necessárias para habilitar o agente. AgentInitWait e AgentRandomDelay são definidos com seus valores padrão, apropriados para implantações de produção.

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

O código no exemplo a seguir permite que o Painel de Telemetria do Office comece a carregar dados imediatamente definindo AgentInitWait e AgentRandomDelay como seus menores valores. Use este exemplo somente em implantações de teste.

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

Você pode distribuir atualizações de registro para vários computadores cliente colocando um arquivo .reg em uma pasta compartilhada e instruindo os usuários a executar o arquivo ou adicionar um comando ao script de logon dos usuários para importar automaticamente o arquivo .reg quando os usuários fizerem logon. Use a sintaxe no exemplo a seguir para iniciar o arquivo .reg a partir de um script de logon:

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

Para obter mais informações sobre como usar arquivos .reg, consulte Como adicionar, modificar ou excluir subchaves e valores do registro usando um arquivo de entradas de registro (.reg).

As tabelas a seguir descrevem cada valor de registro.

Observação

Se você não for um administrador, precisará editar o registro em HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\OSM. Essas alterações podem ser substituídas por configurações de política localizadas em HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM.

Configurações do registro do agente em HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM

Value name Tipo Descrição e dados do valor Obrigatório ou opcional
enablelogging
REG_DWORD
Habilita o registro em log de runtime e a verificação estática. Isso permite que o agente colete dados.

Valor:

1 = Habilitar o registro em log e agente
0 = Desabilitar o registro em log e agente
Padrão = 0 (Desabilitar o registro em log & agente)
Obrigatório
enableupload
REG_DWORD
Ativa o recurso de carregamento de dados no agente para que o agente possa carregar periodicamente dados na pasta compartilhada especificada no CommonFileShare.

Valor:

0 = Não carregar
1 = Carregar
Padrão = 0 (Não carregar)
Obrigatório
commonfileshare
REG_SZ
Especifica o caminho UNC da pasta compartilhada para armazenar dados.

Valor:

\\server\share
Obrigatório
tag1
tag2
tag3
tag4
REG_SZ
Adiciona marcas personalizadas aos dados enviados pelo agente. Se você habilitar essa configuração de política, as marcas personalizadas especificadas serão mostradas no Painel de Telemetria do Office, onde você pode filtrar os dados coletados pelo nome da marca. É possível substituir tag1, tag2, tag3 e tag4 por cadeias de caracteres personalizadas a fim de categorizar e filtrar os dados coletados (por exemplo, substitua tag1 por um nome de departamento, substitua tag2 pelo local dos usuários etc.).

Valor:

tag1
tag2
tag3
tag4
Opcional
enablefileobfuscation
REG_DWORD
Configura o agente para disfarçar ou ofuscar determinadas propriedades de arquivo relatadas nos dados. Se você habilitar essa configuração de política, o agente ofusca o nome do arquivo, o caminho do arquivo e o título dos documentos do Office antes de carregar dados na pasta compartilhada. Você pode saber mais sobre ofuscação de arquivo e outras configurações de privacidade para o Painel de Telemetria do Office em Gerenciar a privacidade dos dados monitorados pelo Painel de Telemetria do Office.

Valor:

0 = Não obscurecer
1 = Obscurecer
Padrão = 0 (Sem obscurecer)
Opcional
AgentInitWait
REG_DWORD
IMPORTANTE: Para evitar afetar o desempenho da rede ou do cliente, diminua esse valor apenas em ambientes de teste.

Ajusta o tempo que o agente aguarda antes de examinar um cliente e carregar dados na pasta compartilhada. Se esse valor não existir, o tempo de espera padrão será de 10 minutos (600 segundos). Em ambientes de teste, você pode especificar um segundo para remover o atraso para testar o Windows 7 com o Service Pack 1 e clientes anteriores. Recomendamos que você defina isso como pelo menos 60 segundos para computadores que executam o Windows "8".

Valor:

x = Tempo de espera em segundos
Opcional
AgentRandomDelay
REG_DWORD
IMPORTANTE: Para evitar afetar o desempenho da rede ou do cliente, diminua esse valor apenas em ambientes de teste.

Ajuste o atraso aleatório máximo, em minutos. O agente aguarda aleatoriamente entre 0 e AgentRandomDelay minutos, além do valor AgentInitWait , antes de começar a examinar ou carregar dados. Se esse valor não existir, o agente aguarda entre 0 minutos e 240 minutos. Em ambientes de teste, é possível especificar 0 para remover o atraso aleatório para teste.

Valor:

x = Atraso aleatório em minutos
Opcional

Configurações do registro do agente em HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM\preventedapplications

Value name Value type Descrição e dados do valor Obrigatório ou opcional
accesssolution
olksolution
onenotesolution
pptsolution
projectsolution
publishersolution
visiosolution
wdsolution
xlsolution
REG_DWORD
Impede que dados de aplicativos específicos do Office sejam relatados ao Painel de Telemetria do Office. Você pode saber mais sobre essa configuração de registro em Gerenciar a privacidade dos dados monitorados pelo Painel de Telemetria do Office.

Valor:

1 = Impede o relatório
0 = Permite o relatório
Padrão = 0 (Permitir o relatório)
Opcional

Configurações do registro do agente em HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\OSM\preventedsolutiontypes

Value name Value type Descrição e dados do valor Obrigatório ou opcional
Agave
appaddins
comaddins
documentfiles
templatefiles
REG_DWORD
Impede que dados de soluções específicas sejam relatados ao Painel de Telemetria do Office. No entanto, o tipo de solução ainda é reportado. Você pode saber mais sobre essa configuração de registro em Gerenciar a privacidade dos dados monitorados pelo Painel de Telemetria do Office.

Valor:

1 = Impede o relatório
0 = Permite o relatório
Padrão = 0 (Permitir o relatório)
Opcional

Use Política de Grupo para habilitar e configurar o agente

Você também pode usar Política de Grupo para habilitar e configurar agentes. Baixe os arquivos de Modelo Administrativo (ADMX/ADML) para o Office do Centro de Download da Microsoft. As configurações de política listadas na tabela a seguir estão disponíveis no caminho Configuração do Usuário\Políticas\Modelos Administrativos\Painel do Microsoft Office 2016\Telemetria.

Configurações de política do agente

Nome da configuração Descrição Obrigatório ou opcional
Ativar a coleta de dados de telemetria
Ativa os recursos de coleta de dados no Office que são usados pelo Painel de Telemetria do Office e pelo Log de Telemetria do Office. Por padrão, a coleta de dados está desabilitada no Office.
Obrigatório
Ativar o carregamento de dados para o Office Telemetry Agent
Ativa o recurso de carregamento de dados no agente para que o agente possa carregar periodicamente dados em uma pasta compartilhada. Por padrão, o carregamento de dados está desabilitado.
Obrigatório
Especificar o caminho UNC para armazenar os dados de telemetria do Office
Especifica o caminho unc (Convenção de Nomenclatura Uniforme) de uma pasta compartilhada para a qual o agente envia dados.
Obrigatório
Especificar as tags personalizadas para dados de telemetria do Office
Adiciona marcas personalizadas aos dados enviados pelo agente. Se você habilitar essa configuração de política, as marcas personalizadas especificadas serão mostradas no Painel de Telemetria do Office, onde você pode filtrar os dados coletados pelo nome da marca. Você pode especificar qualquer cadeia de caracteres pela qual deseja categorizar e filtrar os dados coletados (por exemplo, nome de departamento, título do usuário, e assim por diante).
Opcional
Ativar as configurações de privacidade no Agente de telemetria do Office
Configura o agente para disfarçar ou ofuscar determinadas propriedades de arquivo relatadas nos dados. Se você habilitar essa configuração de política, o agente ofusca o nome do arquivo, o caminho do arquivo e o título dos documentos do Office antes de carregar dados na pasta compartilhada.

Você pode saber mais sobre ofuscação de arquivo e outras configurações de privacidade para o Painel de Telemetria do Office em Gerenciar a privacidade dos dados monitorados pelo Painel de Telemetria do Office.
Opcional
Aplicativos do Office que serão excluído dos relatórios do agente de telemetria do Office
Impede que dados de aplicativos específicos do Office sejam relatados ao Painel de Telemetria do Office.
Opcional
Soluções do Office que serão excluídas dos relatórios do Agente de telemetria do Office
Impede que dados de soluções específicas do Office sejam relatados ao Painel de Telemetria do Office.
Opcional

Disparando a coleta de dados manualmente

Quando um usuário faz logon em um cliente do Office, o agente aguarda 10 minutos para permitir que outros processos de logon sejam concluídos e aguarda um número aleatório de minutos até 4 horas (ou o atraso máximo definido para o valor do registro AgentRandomDelay) para evitar que os computadores cliente enviem dados para a rede ao mesmo tempo. Após essa verificação inicial, o agente examina e coleta dados a cada 8 horas.

Se você quiser disparar a coleção de dados manualmente e ver os dados carregados imediatamente no Painel de Telemetria do Office, defina os seguintes valores de registro conforme descrito na tabela anterior:

Para computadores que executam o Windows 7 com o Service Pack 1 e anteriores

  • AgentInitWait: 1

  • AgentRandomRelay: 0

Para computadores que executam Windows 8.1 e posterior

Como o logon do usuário é mais rápido em versões Windows 8.1 e posteriores do Microsoft Windows, recomendamos definir AgentInitWait como pelo menos 60 segundos para garantir que a conexão de rede esteja pronta após o logon do usuário.

  • AgentInitWait: 60

  • AgentRandomRelay: 0

Para disparar uma verificação manualmente, use um dos seguintes procedimentos.

Para disparar a verificação e a coleta de dados em clientes Windows

  1. Verifique se o computador está conectado a uma fonte de alimentação ac.

  2. No Agendador de Tarefas no computador cliente, expanda Biblioteca do Agendador de Tarefas, expanda Microsoft e escolha Office.

  3. Clique com o botão direito do mouse em OfficeTelemetryAgentLogOn e escolha Executar.

Perguntas frequentes sobre o Painel de Telemetria do Office

Q: O que acontece se um computador cliente estiver desconectado por algum tempo?

Um: Se um cliente monitorado estiver desconectado ou se a pasta compartilhada estiver temporariamente indisponível, os dados ainda serão coletados localmente no cliente. Quando a conexão é restaurada, o backlog de informações é entregue à pasta compartilhada.

Q: Quantos dados são transferidos durante cada transferência?

Um: A quantidade varia de acordo com o número de arquivos usados e soluções instaladas. Aqui estão as estimativas de quantos dados o agente envia para versões diferentes do Office:

  • Versões anteriores do Office enviam aproximadamente 50 KB para cada upload.

  • O Office 2013 e posteriores enviam aproximadamente 64 KB de dados para cada carregamento.

A quantidade transferida pode ser superior quando o intervalo é definido com um tempo maior do que o padrão ou quando os dados ficam ociosos no computador local por longos períodos de tempo. Observe que o conteúdo real do arquivo não é transferido; somente metadados sobre os arquivos são transferidos.

Q: Qual é o impacto de desempenho da instalação e execução do agente?

Um: O agente é transparente para o usuário e executa tarefas de baixo impacto, como inspecionar conteúdo da MRU e configurações específicas do registro local. O agente não verifica ativamente os arquivos. O agente não leva em consideração o estado de alimentação do monitor e o status da rede a fim de evitar afetar o desempenho do cliente.

Q: Como posso inicializar novamente um agente?

Um: O agente é armazenado localmente no computador cliente em %localappdata%\Microsoft\Office\16.0\Telemetria. É possível excluir o conteúdo desta pasta para reinicializar o computador e iniciar uma descoberta atualizada. Observe que esse é um local de dados de acordo com o usuário.

Q: Com que frequência os dados são enviados para a pasta compartilhada?

Um: Os dados são transferidos do cliente para a pasta compartilhada quando os usuários fazem logon e a cada 8 horas enquanto o usuário está conectado. É possível ajustar esse intervalo no Agendador de Tarefas.

Q: Qual é o formato dos dados coletados?

Um: Os dados coletados são armazenados e transferidos em formato binário para otimizar os requisitos de armazenamento e transferência de dados.

Q: Se eu alterar os rótulos personalizados depois de implantar os agentes, quando os novos rótulos serão atualizados no banco de dados?

Um: Somente os arquivos que estão na lista Mais Recentemente Usados terão seus rótulos atualizados no banco de dados. Isso ocorrerá na próxima vez que o agente enviar dados de uso. Para arquivos que não estão na lista Mais Recentemente Usado, eles continuarão a mostrar os rótulos antigos no banco de dados até que o usuário abra o arquivo e o agente carregue dados de uso.

Solucionando problemas com implantações do Painel de Telemetria do Office

A tabela a seguir descreve alguns sintomas que você pode encontrar depois de implantar o Painel de Telemetria do Office e seus componentes.

Solucionando problemas com implantações do Painel de Telemetria do Office

Problema Descrição Resolução
Falha no assistente de configurações do Processador de Telemetria do Office
O assistente falha com a mensagem "O assistente de configurações do Processador de Telemetria só pode ser executado em computadores ingressados em um domínio. Junte o computador a um domínio e execute o assistente novamente."
Os computadores que executam o processador, a pasta compartilhada e o banco de dados SQL devem ser unidos a um domínio para que as configurações de segurança apropriadas possam ser configuradas. Verifique se o computador ou os computadores estão em domínios confiáveis.

Você pode instalar esses componentes em um único computador de grupo de trabalho ou computador ingressado no domínio usando o script descrito na postagem do blog Configurar rapidamente o Painel de Telemetria do Office em um grupo de trabalho ou computador ingressado no domínio.
Falha no assistente de configurações do Processador de Telemetria do Office
O processador está usando a instância de SQL Server errada.
Se houver duas ou mais instâncias de SQL Server, verifique se você aponta para a instância de SQL Server correta usando o formato Servername\SQLServerinstance durante a instalação do processador.
O Painel de Telemetria do Office não mostra dados
O agente não está carregando dados e o processo de Msoia.exe não está em execução no Gerenciador de Tarefas.
Verifique o caminho e o valor do registro dos valores de registro CommonFileShare, EnableLogging e EnableUpload. Estes são descritos em Habilitar e configurar o agente, anteriormente neste artigo.
O Painel de Telemetria do Office não mostra dados
O agente não está verificando nem carregando dados. O processo Msoia.exe é executado no Gerenciador de Tarefas por um longo período.
Por padrão, o agente tem um temporizador de espera inicial e um recurso de randomização para evitar carregar grandes quantidades de dados ao mesmo tempo que outros agentes e afetar a largura de banda de rede. Atualize os valores do registro AgentInitWait e AgentRandomDelay a fim de remover esse atraso em ambientes de teste. Caso contrário, o processo de carregamento poderá ser atrasado por até 4 horas e 10 minutos. Esses valores de registro são descritos em Habilitar e configurar o agente, anteriormente neste artigo. É possível aprender a disparar a verificação e o carregamento em Disparando a coleta de dados manualmente.
O Painel de Telemetria do Office não mostra dados
O agente não carrega dados. O processo Msoia.exe é executado no Gerenciador de Tarefas por um longo período.
Verifique a conexão de rede entre o agente e a pasta compartilhada.

Verifique se o computador faz parte de um domínio. A pasta compartilhada é configurada a fim de permitir acesso somente a usuários autenticados dentro do domínio.

O agente continua a tentar o carregamento de dados após a falha do carregamento. Ao usar os valores de registro padrão, o agente continua a executar como um processo no Gerenciador de Tarefas por até 4 horas e 10 minutos (max). Para ajustar os valores do registro, consulte Habilitar e configurar o agente, anteriormente neste artigo. É possível aprender a disparar a verificação e o carregamento em Disparando a coleta de dados manualmente.
O Painel de Telemetria do Office não mostra dados
A tarefa do agente não parece estar funcionando.
Verifique as informações na coluna Resultado da Última Execução no Agendador de Tarefas. Se a operação for bem-sucedida, ela mostrará o código de retorno 0. Se o agente não puder carregar dados na pasta compartilhada, a mensagem "O nome da rede não pode ser encontrado" será exibida na coluna Resultado da Última Execução . Esse é o único erro que o agente registra na coluna Resultado da Última Execução . Se outros erros forem listados, eles serão causados por outros motivos ou a tarefa agendada não foi executada.
O Painel de Telemetria do Office não mostra dados
O processador não está funcionando. Há muitas pastas e arquivos na pasta compartilhada.
Verifique a conexão de rede entre o processador e a pasta compartilhada. O processador foi configurado pelo assistente de configurações do Processador de Telemetria do Office ? As permissões na pasta compartilhada podem variar, dependendo do local do processador e do banco de dados. Execute o assistente de configurações do Processador de Telemetria do Office novamente a partir do atalho na área de trabalho.
O Painel de Telemetria do Office não mostra dados
O processador está funcionando, mas há muitas pastas e arquivos na pasta Falha na pasta compartilhada.
O processador processa os arquivos na pasta compartilhada para o banco de dados uma vez por minuto. Se o processador não processar os arquivos três vezes, ele moverá os arquivos com falha para a pasta Falha. Consulte o log do processador (%windows%\ServiceProfiles\NetworkService\AppData\Local\Temp\dperrorlog.txt) para obter mais informações.
O Painel de Telemetria do Office não mostra dados
O processador não está funcionando devido a SQL Server configurações de autenticação.
Verifique o tipo de autenticação para obter SQL Server. O Painel de Telemetria do Office não dá suporte à autenticação SQL. É necessário usar autenticação do Windows.
O Painel de Telemetria do Office não mostra dados
O processador não está funcionando devido a problemas de firewall entre o processador e o banco de dados.
Se houver um firewall entre o Painel de Telemetria do Office e o banco de dados, marcar se a porta SQL está habilitada na configuração de firewall. A porta padrão para SQL Server é 1433. Consulte Configurar um Firewall do Windows para Acesso ao Mecanismo de Banco de Dados para obter mais informações.
O Painel de Telemetria do Office não mostra dados
O processador não está funcionando devido a problemas de firewall entre o processador, o banco de dados e o SQL Express.
Se houver um firewall entre o Painel de Telemetria do Office e o banco de dados, marcar se a porta SQL está habilitada na configuração de firewall. A porta padrão do SQL Express não é um valor fixo. Verifique o número da porta no SQL Configuration Manager e adicione a porta à configuração de firewall. Consulte Configurar um Firewall do Windows para Acesso ao Mecanismo de Banco de Dados para obter mais informações.
O Painel de Telemetria do Office não mostra dados
O processador não está funcionando.
Consulte o log do processador (%windows%\ServiceProfiles\NetworkService\AppData\Local\Temp\dperrorlog.txt) para obter mais informações.
O Painel de Telemetria do Office não pode se conectar ao banco de dados
O Painel de Telemetria do Office mostra uma mensagem de erro que afirma que ele não pode se conectar ao banco de dados devido a SQL Server permissões.
Verifique a função de permissão do Painel de Telemetria do Office. Adicione o usuário à função td_readonly usando OSQL, SQLCMD, Enterprise Manager ou a Ferramenta de Administração do Painel de Telemetria (Tdadm). Consulte Banco de Dados usado pelo Painel de Telemetria do Office anteriormente neste artigo para obter mais informações.
O Painel de Telemetria do Office não pode se conectar ao banco de dados
O Painel de Telemetria do Office mostra uma mensagem de erro que afirma que não pode se conectar ao banco de dados.
Se houver duas ou mais instâncias de SQL Server, verifique se a caixa de diálogo Configurações de conexão de dados no Painel de Telemetria do Office usará a instância de SQL Server correta no formato Servername\SQLServerinstance.
O Painel de Telemetria do Office não pode se conectar ao banco de dados
O Painel de Telemetria do Office mostra uma mensagem de erro que afirma que não pode se conectar ao banco de dados.
Se o SQL Server for SQL Express, verifique se o SQL Server nome da instância está correto. O nome da instância padrão do SQL Express difere de SQL Server, por exemplo: Servername\SQLExpress.
O Painel de Telemetria do Office não pode se conectar ao banco de dados
O Painel de Telemetria do Office mostra uma mensagem de erro que afirma que não pode se conectar ao banco de dados.
Se a ordenação padrão SQL Server for sensível a casos (por exemplo, a versão japonesa do SQL Server for sensível a casos por padrão), verifique se você inseriu um nome de banco de dados com confidencialidade de caso na caixa de diálogo Configurações de conexão de dados no Painel de Telemetria do Office.