Implantar Gerenciador de Estatísticas do Skype for Business Server

  • Artigo

Resumo: Leia este artigo para saber como implantar o Statistics Manager para Skype for Business Server.

O Gerenciador de Estatísticas do Skype for Business Server é uma poderosa ferramenta que permite exibir o desempenho e a integridade do Skype for Business Server em tempo real. É possível sondar dados de desempenho em centenas de servidores em intervalos de alguns segundos e ver os resultados instantaneamente no site do Gerenciador de Estatísticas.

Antes de tentar instalar o Statistics Manager, certifique-se de estar familiarizado com os requisitos de software, rede e hardware. Para mais informações, confira Plano para Gerenciador de Estatísticas do Skype for Business Server.

Nota

Se você estiver atualizando de uma versão anterior do Gerenciador de Estatísticas, confira Atualizar o Gerenciador de Estatísticas do Skype for Business Server.

Nota

O site do Gerenciador de Estatísticas foi testado e funciona corretamente no Internet Explorer 11+, Microsoft Edge 20.10240+ e Chrome 46+ (versão evergreen atual).

Você pode encontrar o Gerenciador de Estatísticas disponível para download na https://aka.ms/StatsManDownload .

Este tópico inclui as seguintes seções:

Implantar o Gerenciador de Estatísticas

Para implantar o Gerenciador de Estatísticas, siga estas etapas:

  1. Prepare o computador host Ouvinte instalando o sistema de cache na memória Redis e verificando se você instalou os certificados adequados.

  2. Instale o serviço de escuta no computador host.

  3. Instale o site no computador host.

  4. Instale um Agente em cada computador com Skype for Business Server que desejar monitorar.

  5. Importe a topologia para os servidores que você está monitorando.

Nota

O Redis, o serviço de escuta e o site deverão estar todos instalados no mesmo computador host. Certifique-se que o computador host não tem o Skype for Business Server instalado.

Preparar o computador host Ouvinte

Para preparar o computador host, você precisa instalar o sistema de cache redis na memória e garantir que um certificado válido esteja no computador. A Microsoft recomenda que você instale o build estável mais recente do Redis 3.0. A versão 2.0 do Gerenciador de Estatísticas foi testada com o Redis 3.2.100.

  1. Baixe o Redis do seguinte site: https://github.com/MSOpenTech/redis .

    Instaladores não assinados podem ser baixados do https://github.com/MSOpenTech/redis/releases

    Binários assinados estão disponíveis por meio de gerenciadores de pacotes populares: NuGet e Choclatey.

    • Execute o msi fornecido e siga as instruções.

    • Não marcar a caixa para adicionar uma regra de firewall.

  2. O serviço de escuta requer um certificado. A Microsoft recomenda que você tenha um certificado assinado por uma autoridade de certificação confiável.

    Se quiser usar um certificado autoassinado (para fins de teste em um laboratório, por exemplo), veja Criar um certificado autoassinado.

    O Agente usa a verificação de impressão digital de certificado (em vez de verificação em cadeia). Ele não fará a validação completa do certificado porque é possível usar certificados autoassinados.

Instalar o serviço de escuta

Instale o serviço de escuta no computador host executando o StatsManPerfAgentListener.msi e especificando o seguinte:

  1. Examine o Contrato de Licença e, se você concordar, selecione Aceito os termos no contrato de licença e selecione Avançar.

  2. Na próxima página, especifique as seguintes informações:

    • Senha de serviço: Essa senha é usada pelos Agentes remotos para autenticar o serviço ouvinte.

    • Porta de Serviço: Esse número de porta HTTPS é usado pelo Ouvinte para se comunicar com os Agentes. Durante a instalação, essa porta é permitida por meio do firewall local, uma ACL de URL é criada e um certificado SSL está associado a essa porta. O padrão é 8443.

    • Impressão digital do certificado: Esse certificado é usado pelo Ouvinte para criptografar o protocolo HTTPS. O Serviço de Rede deve ter acesso de leitura à chave privada.

      Clique no botão Selecionar... para escolher a impressão digital.

      Você pode encontrar a impressão digital do Certificado usando o Gerenciador de Certificados ou o seguinte comando do PowerShell:

      Get-ChildItem -path cert:\LocalMachine\My

    • Instalar Dir: Esse diretório é onde os binários serão instalados. Você pode alterá-lo do padrão usando o botão Procurar... .

    • AppData Dir: Esse diretório é onde a pasta Logs e outros dados são armazenados. Você pode alterá-lo do padrão. Ele não será excluído na desinstalação.

  3. Selecione Instalar.

Para validar a instalação, execute as etapas a seguir:

  1. Abra um navegador e navegue até https://localhost:<service-port>/healthcheck/

    Por padrão, a porta de serviço é 8443 (a menos que você tenha especificado outra porta).

  2. Para garantir que o Ouvinte tenha sido instalado corretamente, procure o seguinte:

    • Se a página marcar de integridade aparecer, a instalação do Ouvinte foi bem-sucedida.

    • Se o KnownServerCount for 1 ou superior, a conexão com Redis será estabelecida.

    • Após aguardar alguns minutos e depois que pelo menos um Agente tiver sido instalado, verifique se o contador ValuesWritten está aumentando.

Instalar o site

Instale o Site no computador host executando o StatsManWebSite.msi (incluído com Skype for Business Server, Real-Time Statistics Manager (64 bits)):

  1. Leia o Contrato de Licença e, se estiver de acordo, selecione Aceito os termos do Contrato de Licença e clique em Avançar.

  2. Na próxima página, especifique as seguintes informações:

    • Porta de Serviço: Essa porta TCP é onde o site escuta. Você pode alterá-lo posteriormente usando a associação do gerenciador do IIS. Durante a instalação, essa porta é permitida por meio do firewall local.

    • Instalar Dir: Este diretório é onde os binários são instalados. Você pode alterá-lo do padrão usando o botão Procurar... .

    • AppData Dir: Esse diretório é onde a pasta Logs e outros dados serão armazenados. Você pode alterá-lo do padrão. Ele não será excluído na desinstalação.

  3. Clique em Instalar.

Para exibir o Site, abra um navegador e navegue até: http://<localhost:webport/>.

Para exibir apenas informações de integridade, abra um navegador e vá até: http://localhost:<webport>/healthcheck/.

Por padrão, o número da porta da Web é 8080. Você pode alterar a associação de porta do site usando o gerenciador do IIS.

O instalador da Web adiciona um grupo de segurança local, chamado StatsManWebSiteUsers. Você pode adicionar contas a esse grupo de segurança para conceder acesso ao site.

Instalar os Agentes

Instale um Agente em cada Skype for Business Server que você deseja monitorar executando o StatsManPerfAgent.msi:

  1. Leia o Contrato de Licença e, se estiver de acordo, selecione Aceito os termos do Contrato de Licença e clique em Avançar.

  2. Na próxima página, especifique as seguintes informações:

    • Senha de serviço: Essa senha é usada pelo agente remoto para autenticar o serviço Ouvinte.

    • URI de serviço: Essa URL é onde o Ouvinte reside. Use o https://name:port formato.

      Você pode usar um nome NetBIOS ou um FQDN. Você pode usar o nome que também é especificado como o Assunto ou Nomes Alternativos de Assunto do certificado no serviço Ouvinte, mas isso não é um requisito.

    • Impressão digital do serviço: Este SS: o certificado é usado pelo Ouvinte. O Agente usará essa impressão digital para se autenticar com o Ouvinte. Ele não fará a validação completa do certificado porque é possível usar certificados autoassinados.

    • Instalar Dir: Esse diretório é onde os binários serão instalados. Você pode alterá-lo do padrão usando o botão Procurar... .

    • AppData Dir: Este diretório é onde a pasta Logs e o arquivo password.txt criptografado são armazenados. Você pode graças a alterá-lo do padrão. Ele não será excluído na desinstalação.

  3. Selecione Instalar.

Se você estiver instalando um Agente em vários computadores, provavelmente deseja fazer isso no modo autônomo. Por exemplo:

msiexec /l install.log /i StatsManPerfAgent.msi SERVICE_THUMBPRINT=<thumbprint> SERVICE_PASSWORD=<password> SERVICE_URI=https://<hostname>:<servicePort>/[INSTALLDIR=<directory>][DIR_STATSMANAPPDATA=<directory>]

Importar a topologia

Depois que o StatisticsManager for instalado e executado, você precisará importar a topologia do Skype for Business Server para que o Gerenciador de Estatísticas saiba o Site, o Pool e a Função de cada servidor. Para importar a topologia do Skype for Business Server, você usará o Get-CsPool cmdlet para recuperar informações sobre cada grupo em uso na sua organização. Em seguida, importe essas informações para o Gerenciador de Estatísticas.

Para importar a topologia do Skype for Business Server, siga estas etapas:

  1. Em um host que tem o Skype for Business Server PowerShell cmdlets:

    a. Execute o seguinte comando:

    Get-CsPool | Export-Clixml -Path mypoolinfo.xml

    b. Copie o arquivo “mypoolinfo.xml” no servidor que executa o Ouvinte.

  2. No host que executa o Ouvinte:

    a. Execute o PowerShell.

    b. Navegue até o diretório no qual o Ouvinte está instalado. O padrão é:

    cd C:\Program Files\Skype for Business Server StatsMan Listener

  3. Para confirmar quais servidores estão sendo adicionados e atualizados, execute o seguinte comando:

    .\Update-StatsManServerInfo.ps1 -CsPoolFile  <path to mypoolinfo.xml>

O seguinte comando permite ver todas as opções:

Get-Help .\Update-StatsManServerInfo.ps1 -Detailed

Para ver as informações que estão sendo importadas atualmente no seu servidor, execute o seguinte script:

.\Get-StatsManServerInfo.ps1

Se quiser monitorar servidores que não estão em sua topologia do Skype for Business Server--um Exchange Server, por exemplo--você pode fazer uma importação de um único servidor no host que executa o Ouvinte. Para fazer uma importação de um único servidor, siga estas etapas:

  1. Navegue até o diretório no qual o Ouvinte está instalado. O padrão é:

    cd C:\Program Files\Skype for Business Server StatsMan Listener

  2. Execute o seguinte comando:

    .\Update-StatsManServerInfo.ps1 -HostName <hostname> -SiteName <name of site> -PoolName <poolName> -Roles <role1>[,<role2>,<roleN>]

Solução de problemas de implantação

Se um Agente não for iniciado, marcar para os seguintes problemas:

  • O agente está registrado no Gerenciador de Estatísticas?

    1. Certifique-se de seguir as instruções para importar a topologia. Veja Importar a topologia.

    2. Se o Agent estiver em um servidor que não esteja listado na topologia (por exemplo, os nós em um cluster AlwaysOn SQL), você precisará adicionar o Agente manualmente seguindo as instruções em Importar a topologia.

  • O Agente pode contatar o Ouvinte?

    1. Verifique se o serviço de escuta está em execução.

      Se ele não estiver em execução, verifique se o Redis está em execução e tente reiniciar o Ouvinte.

    2. Verifique se a porta está aberta para o serviço de escuta, e se o computador do Agente consegue se comunicar com a porta.

  • Para garantir que o Gerenciador de Estatísticas esteja coletando dados, você pode verificar o arquivo CSV da seguinte maneira.

    O seguinte comando recupera os nomes de armazenamento do contador:

    .\PerfAgentStorageManager.exe -redis=localhost -a=listcounterstoragenames -mode=verbose | findstr /i processor

    O próximo comando recupera os valores dos contadores especificados:

    .\PerfAgentStorageManager.exe -redis=localhost -a=getcountervalues  -counter="\\*\Processor Information\% Processor Time_Mean_Mean\_Total" -file:all-processor.csv

Para obter informações sobre todos os eventos que você talvez veja no log de eventos do aplicativo, consulte Solução de Problemas do Gerenciador de Estatísticas do Skype for Business Server.

Criar um certificado autoassinado

A Microsoft recomenda que você use um certificado assinado por uma autoridade de certificação confiável. No entanto, se você quiser usar um certificado autoassinado para fins de teste, siga as seguintes etapas:

  1. Em um console do PowerShell enquanto estiver conectado como Administrador, execute o seguinte comando:

    New-SelfSignedCertificate -DnsName StatsManListener -CertStoreLocation Cert:\LocalMachine\My

  2. Digite certlm.msc. Isso abrirá o Gerenciador de Certificados do computador local.

  3. Navegue até Pessoale abra Certificados.

  4. Clique com o botão direito do mouse em StatsManListener- > Todas as tarefas- >Gerenciar chaves privadas...

  5. Clique em Adicionar.

  6. Na caixa Inserir os nomes de objeto a serem selecionados, digite o seguinte texto: Serviço de Rede

  7. Clique em OK.

  8. Em Controle Total, desmarque a caixa de seleção Permitir. (Apenas o acesso de leitura é necessário.)

  9. Clique em OK.

Para obter mais informações

Para obter mais informações, confira os seguintes tópicos: