Configurar cenários para o Serviço de Log Centralizado no Skype for Business Server 2015

  • Artigo

Resumo: Saiba como criar, modificar e remover cenários para o Serviço de Log Centralizado no Skype for Business Server 2015.

Os cenários definem o escopo (ou seja, global, site, pool ou computador) e quais provedores usar no Serviço de Log Centralizado. Ao utilizar cenários, você habilita ou desabilita o rastreamento em provedores (por exemplo, S4, SIPStack, mensagens instantâneas e Presença). Ao configurar um cenário, você pode agrupar todos os provedores de uma determinada coleção lógica que aborda uma condição de problema específica. Se você descobrir que um cenário precisa ser modificado para atender às suas necessidades de solução de problemas e registro em log, o Skype for Business Server Ferramentas de Depuração 2015 fornece um módulo Windows PowerShell chamado ClsScenarioEdit.psm1 que contém uma função chamadaEdit-CsClsScenario. O objetivo do módulo é editar as propriedades do cenário nomeado. Exemplos do funcionamento desse módulo são fornecidos neste tópico. Baixe as ferramentas de depuração Skype for Business Server 2015 antes de ir mais longe.

Importante

Seja qual for o escopo (global, site, pool ou computador), é possível executar no máximo dois cenários por vez. Para determinar quais cenários estão em execução no momento, use Windows PowerShell e Get-CsClsScenario. Usando Windows PowerShell e Set-CsClsScenario, você pode alterar dinamicamente quais cenários estão em execução. Você pode modificar quais cenários estão em execução durante uma sessão de registro em log para ajustar ou refinar os dados coletados e de quais provedores.

Para executar as funções do Serviço de Log Centralizado usando o Shell de Gerenciamento Skype for Business Server, você deve ser membro do CsAdministrator ou dos grupos de segurança RBAC (controle de acesso baseado em função) CsServerAdministrator ou uma função RBAC personalizada que contém um desses dois grupos. Para retornar uma lista de todas as funções RBAC às quais esse cmdlet foi atribuído, incluindo todas as funções de RBAC personalizadas que você mesmo criou, execute o seguinte comando do Shell de Gerenciamento Skype for Business Server ou do prompt Windows PowerShell:

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

Por exemplo:

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

O restante deste tópico concentra-se em como definir um cenário, modificar um cenário, determinar quais cenários estão em execução e especificar o que está contido em um cenário para otimizar a solução de problemas. Você pode usar o Shell de Gerenciamento de Skype for Business Server para emitir comandos Windows PowerShell. Ao usar Windows PowerShell, você pode definir novos cenários para uso em suas sessões de log.

Conforme introduzido no Serviço centralizado de log no Skype for Business 2015, os elementos de um cenário são:

  • Provedores Se você estiver familiarizado com o OCSLogger, os provedores são os componentes dos quais você escolhe informar ao OCSLogger de qual mecanismo de rastreamento deve coletar logs. Os provedores são os mesmos componentes e, em muitos casos, têm o mesmo nome que os componentes do OCSLogger. Se você não estiver familiarizado com o OCSLogger, os provedores serão componentes específicos da função de servidor dos quais o Serviço de Log Centralizado pode coletar logs. Para obter detalhes sobre a configuração de provedores, consulte Configurar provedores para o Serviço de Log Centralizado no Skype for Business Server 2015.

  • Identidade O parâmetro -Identidade define o escopo e o nome do cenário. Por exemplo, você pode definir um escopo de "global" e identificar o cenário com "LyssServiceScenario". Ao combinar os dois, você define a Identidade (por exemplo, "global/LyssServiceScenario").

    Opcionalmente, você pode usar os parâmetros -Name e -Parent. Você define o parâmetro Name para identificar exclusivamente o cenário. Se usá-lo, também deverá usar Parent para adicionar o cenário ao escopo global ou site.

    Importante

    Se você usar os parâmetros Nome e Pai, não poderá usar o parâmetro -Identity .

Para criar um novo cenário com o cmdlet New-CsClsScenario

  1. Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.

  2. Para criar um novo cenário para uma sessão de registro em log, use New-CsClsProvider e defina o nome do cenário (ou seja, como ele será identificado exclusivamente). Escolha um tipo de formato de registro em log entre WPP (ou seja, o pré-processador de rastreamento de software do Windows, que é o padrão), EventLog (ou seja, o formato de log de eventos do Windows) ou IISLog (ou seja, o arquivo de formato ASCII baseado no formato de arquivo de log do IIS). Em seguida, defina o nível (conforme definido em Níveis de registro em log, neste tópico) e os sinalizadores (conforme definido em Sinalizadores, neste tópico).

    Para este cenário de exemplo, usaremos LyssProvider como a variável de provedor de exemplo.

    Para criar um cenário usando as opções definidas, digite:

    New-CsClsScenario -Identity <scope>/<unique scenario name> -Provider <provider variable>

    Por exemplo:

    New-CsClsScenario -Identity "site:Redmond/LyssServiceScenario" -Provider $LyssProvider

    O formato alternativo usando -Name e -Parent:

    New-CsClsScenario -Name "LyssServiceScenario" -Parent "site:Redmond" -Provider $LyssProvider

Para criar um novo cenário com vários provedores usando o cmdlet New-CsClsScenario

  1. Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.

  2. Há um limite de dois cenários por escopo. No entanto, não há um limite quanto ao número de provedores. Neste exemplo, vamos supor que criamos três provedores e você deseja atribuir todos eles ao cenário que está definindo. Os nomes das variáveis dos provedores são LyssProvider, ABServerProvider e SIPStackProvider. Para definir e atribuir vários provedores a um cenário, digite o seguinte em um prompt de comando Skype for Business Server Management Shell ou Windows PowerShell:

    New-CsClsScenario -Identity "site:Redmond/CollectDataScenario" -Provider @{Add=$LyssProvider, $ABServerProvider,  $SIPStackProvider}

    Nota

    Como é conhecida em Windows PowerShell, a convenção para criar uma tabela de valores de hash usando @{<variable>=<value1>, <value2>, <value>...} é conhecida como assplatting. Para obter detalhes sobre o splatting no Windows PowerShell, consulte https://go.microsoft.com/fwlink/p/?LinkId=267760.

Para modificar um cenário existente com o cmdlet Set-CsClsScenario

  1. Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.

  2. Há um limite de dois cenários por escopo. Você pode alterar quais cenários estão em execução a qualquer momento, mesmo quando uma sessão de coleta de log está em andamento. Se você redefinir os cenários em execução, a sessão de registro em log atual parará de usar o cenário que foi removido e começará a usar o novo cenário. No entanto, as informações de log que já foram coletadas com o cenário removido permanecerão nos logs coletados. Para definir um novo cenário, faça o seguinte (ou seja, supondo a adição de um provedor já definido chamado "S4Provider"):

    Set-CsClsScenario -Identity <name of scope and scenario defined by New-CsClsScenario> -Provider @{Add=<new provider to add>}

    Por exemplo:

    Set-CsClsScenario -Identity "site:Redmond/LyssServiceScenario" -Provider @{Add=$S4Provider}

    Se você desejar substituir provedores, defina um único provedor ou uma lista separada por vírgulas de provedores para substituir o conjunto atual. Se você desejar substituir apenas um de vários provedores, adicione os provedores atuais junto com os novos provedores para criar um novo conjunto de provedores que contenha os provedores novos e existentes. Para substituir todos os provedores por um novo conjunto, digite o seguinte:

    Set-CsClsScenario -Identity <name of scope and scenario defined by New-CsClsScenario> -Provider @{Replace=<providers to replace existing provider set>}

    Por exemplo, para substituir o conjunto atual de $LyssProvider, $ABServerProvider e $SIPStackProvider por $LyssServiceProvider:

    Set-CsClsScenario -Identity "site:Redmond/LyssServiceScenario" -Provider @{Replace=$LyssServiceProvider}

    Para substituir apenas o provedor $LyssProvider do conjunto atual de $LyssProvider, $ABServerProvider e $SIPStackProvider por $LyssServiceProvider, digite o seguinte:

    Set-CsClsScenario -Identity "site:Redmond/LyssServiceScenario" -Provider @{Replace=$LyssServiceProvider, $ABServerProvider, $SIPStackProvider}

Para remover um cenário existente com o cmdlet Remove-CsClsScenario

  1. Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.

  2. Se você desejar remover um cenário que foi definido anteriormente, digite o seguinte:

    Remove-CsClsScenario -Identity <name of scope and scenario>

    Por exemplo, para remover o cenário definido site:Redmond/LyssServiceScenario:

    Remove-CsClsScenario -Identity "site:Redmond/LyssServiceScenario"

O cmdlet Remove-CsClsScenario remove o cenário especificado, mas os rastreamentos que foram coletados ainda estarão disponíveis nos logs para pesquisa.

Para carregar e descarregar o cmdlet Edit-CsClsScenario usando o módulo ClsScenarioEdit.psm1

  1. Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.

    Importante

    O módulo ClsController.psm1 é fornecido como um download da Web separado. O módulo faz parte das ferramentas de depuração Skype for Business Server 2015. Por padrão, as ferramentas de depuração são instaladas no diretório C:\Program Files\Skype for Business Server 2015\Debugging Tools.

  2. No Windows PowerShell, digite:

    Import-Module "CDBurn\OCO\amd64\Support"

    Ponta

    O carregamento bem-sucedido do módulo retorna você ao prompt de comando Windows PowerShell. Para confirmar se o módulo está carregado e que Edit-CsClsScenario está disponível, digite Get-Help Edit-CsClsScenario. Você deverá ver a sinopse básica da sintaxe de EditCsClsScenario.

  3. Para descarregar os módulos, digite:

    Remove-Module ClsController

    Ponta

    O descarregamento bem-sucedido do módulo retorna você ao prompt de comando Windows PowerShell. Para confirmar se o módulo está descarregado, digite Get-Help Edit-CsClsScenario. Windows PowerShell tentará localizar a ajuda para o cmdlet e falhar.

Para remover um provedor existente de um cenário com o módulo Edit-ClsController

  1. Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.

  2. No Windows PowerShell, digite:

    Import-Module "CDBurn\OCO\amd64\Support"

    Ponta

    O carregamento bem-sucedido do módulo retorna você ao prompt de comando Windows PowerShell. Para confirmar se o módulo está carregado e que Edit-CsClsScenario está disponível, digite Get-Help Edit-CsClsScenario. Você deverá ver a sinopse básica da sintaxe de EditCsClsScenario.

  3. Para remover um provedor do cenário AlwaysOn, digite:

    Edit-CsClsScenario -ScenarioName <string of the scenario to edit> -ProviderName <string of the provider to remove> -Remove

    Por exemplo:

    Edit-CsClsScenario -ScenarioName AlwaysOn -ProviderName ChatServer -Remove

    Os parâmetros ScenarioName e ProviderName são posicionais (ou seja, devem ser definidos na posição esperada na linha de comando). O nome do parâmetro não precisa ser explicitamente definido se o nome do cenário estiver na segunda ou na terceira posição em relação ao nome do cmdlet na primeira posição. Usando essas informações, o comando anterior seria digitado como:

    Edit-CsClsScenario AlwaysOn ChatServer -Remove

    A colocação posicional dos valores de parâmetro se aplica apenas a -Cenário e -Provedor. Todos os outros parâmetros devem ser definidos explicitamente.

Para adicionar um provedor a um cenário com o cmdlet Edit-ClsController

  1. Inicie o Shell de Gerenciamento do Skype for Business Server: clique em Iniciar, em Todos os Programas, em Skype for Business 2015 e em Shell de Gerenciamento do Skype for Business Server.

  2. Para adicionar um provedor ao cenário AlwaysOn, digite:

    Edit-CsClsScenario -ScenarioName <string of the scenario to edit> -ProviderName <string of the provider to add> -Level <string of type level> -Flags <string of type flags>

    Por exemplo:

    Edit-CsClsScenario -ScenarioName AlwaysOn -ProviderName ChatServer -Level Info -Flags TF_COMPONENT

    -Loglevel pode ser do tipo Fatal, Error, Warning, Info, Verbose, Debug ou All. -Sinalizadores podem ser qualquer um dos sinalizadores que o provedor dá suporte, como TF_COMPONENT, TF_DIAG. -Sinalizadores também podem ser de valor ALL

    O exemplo anterior também pode ser digitado com o uso do recurso posicional do cmdlet. Por exemplo, para adicionar o provedor ChatServer ao cenário AlwaysOn, digite:

    Edit-CsClsScenario AlwaysOn ChatServer -Level Info -Flags ALL