Configurar proveedores para el servicio de registro centralizado en Skype Empresarial Server 2015

Skype for Business Server 2015
 

Última modificación del tema:2015-08-17

Resumen: información sobre cómo configurar los proveedores de escenario para Servicio de registro centralizado en Skype Empresarial Server 2015.

Necesita prestar especial atención a los conceptos y la configuración de proveedores en el Servicio de registro centralizado. Los proveedores se asignan directamente a los componentes del rol de servidor de Skype Empresarial Server en el modelo de seguimiento de Skype Empresarial Server. El proveedor es quien define los componentes de Skype Empresarial Server 2015 de los que se va a realizar un seguimiento, el tipo de mensajes (por ejemplo, error irrecuperable, error o advertencia) que es preciso recopilar y las marcas (TF_Connection o TF_Diag, por ejemplo). Los proveedores son los componentes de los que se realiza un seguimiento en cada rol de servidor de Skype Empresarial Server. Si usa proveedores, necesitará establecer el nivel y el tipo de seguimiento de los componentes (S4, SIPStack, MI y presencia, por ejemplo). El proveedor definido se usa en un escenario para agrupar a todos los proveedores de una colección lógica determinada que abordan un problema concreto.

Para ejecutar las funciones del Servicio de registro centralizado por medio del Shell de administración de Skype Empresarial Server, necesita ser miembro de los grupos de seguridad de control de acceso basado en roles (RBAC) CsAdministrator o CsServerAdministrator, o un rol RBAC personalizado que contenga uno de estos dos grupos. Ejecute el siguiente comando del Shell de administración de Skype Empresarial Server o un símbolo del sistema de Windows PowerShell para obtener una lista de todos los roles de control de acceso basado en roles a los que este cmdlet se ha asignado (incluidos los roles RBAC personalizados que haya creado usted mismo):

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

Por ejemplo:

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

El resto de este tema se centra en cómo definir y modificar proveedores y qué contiene una definición de proveedor para optimizar la solución de problemas. Existen dos maneras de emitir comandos del Servicio de registro centralizado: por medio de CLSController.exe (que está de forma predeterminada en el directorio C:\Archivos de programa\Archivos comunes\Skype Empresarial Server 2015\CLSAgent) o por medio del Shell de administración de Skype Empresarial Server para emitir comandos de Windows PowerShell. Si usa Windows PowerShell, podrá definir nuevos proveedores para usarlos en las sesiones de registro y dispondrá de control total al crearlos, al definir qué recopilan y en qué ámbito recopilan los datos.

importantImportante:
Tal y como se ha mencionado, los proveedores son tremendamente importantes, pero más importantes aún son los escenarios, ya que contienen toda la información necesaria para definir y ejecutar el seguimiento en los componentes que los proveedores representan. Si consideramos un escenario como un conjunto de proveedores, sería comparable (de forma muy vaga) a ejecutar un archivo por lotes que contiene cientos de comandos para recopilar una gran cantidad de información frente a emitir cientos de comandos de una sola vez en la línea de comandos.
En lugar de indagar profundamente en los detalles de los proveedores, el Servicio de registro centralizado proporciona una serie de escenarios ya definidos que abarcan la inmensa mayoría de los posibles problemas que pueden surgir. En casos excepciones, es posible que necesite crear y definir proveedores y asignarlos a los escenarios. Recomendamos enormemente familiarizarse con cada uno de los escenarios antes de investigar si necesita crear proveedores y escenarios. Aquí no encontrará información detallada sobre los proveedores en sí, sino información sobre cómo crear proveedores para hacerse una idea de cómo los escenarios usan los elementos de proveedor para recopilar datos de seguimiento.

Los elementos clave (descritos en Servicio de registro centralizado en Skype Empresarial 2015) a la hora de definir un proveedor para usarlo en un escenario son los siguientes:

  • Proveedores Si conoce OCSLogger, los proveedores son los componentes que elige para indicar a OCSLogger de qué motor de seguimiento tiene que recopilar registros. Los proveedores son los mismos componentes (y, muchas veces, con los mismos nombres) que los de OCSLogger. Si no conoce OCSLogger, los proveedores son componentes específicos de un rol de servidor del que el Servicio de registro centralizado puede recopilar registros. En el caso del Servicio de registro centralizado, CLSAgent es la parte de la arquitectura del Servicio de registro centralizado que efectúa el seguimiento de los componentes definidos en la configuración de los proveedores.

  • Niveles de registro OCSLogger ofrecía la posibilidad de escoger una serie de niveles de detalle de los datos recopilados. Esta característica forma parte integral del Servicio de registro centralizado y de los escenarios, y se define por medio del parámetro Type . Puede elegir entre las siguientes opciones:

    • All Recopila mensajes de seguimiento del tipo error irrecuperable, error, advertencia, detallado, depuración e información en el registro para el proveedor definido.

    • Fatal Recopila solo los mensajes de seguimiento definidos como "errores irrecuperables".

    • Error Recopila solo los mensajes de seguimiento definidos como "error" o "error irrecuperable".

    • Warning Recopila solo los mensajes de seguimiento del tipo "advertencia", "error" y "error irrecuperable".

    • Info Recopila solo los mensajes de seguimiento que brinden un mensaje informativo para el proveedor definido, además de los mensajes de error irrecuperable, de error y advertencia.

    • Verbose Recopila todos los mensajes de seguimiento de tipo error, error irrecuperable, advertencia y detallado para el proveedor definido.

    • Debug Es, básicamente, un equivalente de "All", ya que recopila los seguimientos del tipo error, error irrecuperable, advertencia, información, detallado y depuración para el proveedor definido.

  • Flags OCSLogger ofrecía la posibilidad de elegir marcas para cada proveedor que definían el tipo de información que se podía recuperar de los archivos de seguimiento. Se pueden elegir las siguientes marcas según el proveedor:

    • TF_Connection Proporciona entradas de registro relativas a la conexión. Estos registros incluyen información sobre las conexiones establecidas con un componente en particular. También puede incluir información de la red relevante (esto es, relacionada con los componentes sin el concepto de una conexión).

    • TF_Security Proporciona todos los eventos o las entradas de registro relacionados con la seguridad. Por ejemplo, para SipStack existen eventos de seguridad, como error de validación de dominio y errores de autenticación o autorización de clientes.

    • TF_Diag Proporciona eventos de diagnóstico que pueden servir para diagnosticar o solucionar problemas con el componente. Por el ejemplo, para SipStack, estos son errores de certificado, o errores o advertencias de DNS.

    • TF_Protocol Proporciona mensajes de protocolo, como mensajes de SIP y del paquete de códecs de comunidad combinado.

    • TF_Component Permite crear registros de los componentes especificados como parte de los proveedores.

    • All Define todas las marcas disponibles en relación con el proveedor.

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio , Todos los programas , Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server .

  2. Escriba lo siguiente si desea revisar la configuración de los proveedores existentes:

    Get-CsClsScenario -Identity 
        <scope and scenario name>
       
    

    Por ejemplo, escriba lo siguiente para revisar la información sobre el operador de las conferencias globales:

    Get-CsClsScenario -Identity "global/CAA"
    

    El comando hace que se muestre una lista de proveedores con sus marcas, configuración y componentes asociados. En caso de que no baste con la información que aparece, o la lista sea demasiado extensa para el formato de lista de Windows PowerShell predeterminado, puede mostrar más información al definir un método de salida distinto. Para ello, escriba lo siguiente:

    Get-CsClsScenario -Identity "global/CAA" | Select-Object -ExpandProperty Provider
    

    La salida de este comando muestra a cada proveedor en un formato de cinco líneas; en cada una de ellas se indica el nombre del proveedor, el tipo de registro, el nivel de registro, las marcas, el GUID y el rol.

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio , Todos los programas , Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server .

  2. Un proveedor de escenario consta de un componente sobre el que realizar el seguimiento, las marcas que se van a usar y el nivel de detalle al que se van a recopilar los datos. Esto se logra escribiendo lo siguiente:

    $
        <variableName>
       = New-CsClsProvider -Name 
        <provider component>
       -Type 
        <log type>
       -Level 
        <log level detail type>
       -Flags 
        <provider trace log flags>
      
    

    Por ejemplo, una definición de proveedor de seguimiento en la que se define qué recopilar y con qué nivel de detalle del proveedor Lyss sería así:

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Info" -Flags "All"
    

–Level recopila los mensajes de error, error irrecuperable, advertencia y de información. Las marcas utilizadas son todas las que se han definido en relación con el proveedor Lyss e incluyen TF_Connection, TF_Diag y TF_Protocol.

Después de definir la variable $LyssProvider, puede usarla con el cmdlet New-CsClsScenario para recopilar los seguimientos del proveedor Lyss. Escriba lo siguiente para crear y asignar el proveedor a un nuevo escenario:

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

Donde $LyssProvider es la variable que contiene el escenario definido creado con New-CsClsProvider .

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio , Todos los programas , Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server .

  2. Escriba lo siguiente para actualizar o cambiar la configuración de un proveedor existente:

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Debug" -Flags "TF_Connection, TF_Diag"
    

    Después, escriba lo siguiente para actualizar el escenario al que se va a asignar el proveedor:

    Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider $LyssProvider
    

El resultado final del comando es que el escenario site:Redmond/RedmondLyssInfo tendrá las marcas actualizadas y el nivel del proveedor que tenga asignado. Puede ver el nuevo escenario con Get-CsClsScenario. Para más detalles, consulte Get-CsClsScenario.

warningAdvertencia:
New-ClsCsProvider no realiza comprobaciones para saber si las marcas son válidas, de modo que asegúrese de escribirlas bien (por ejemplo, TF_DIAG o TF_CONNECTION). Si están mal escritas, el proveedor no devolverá la información de registro prevista.

Escriba lo siguiente si quiere agregar más proveedores a este escenario:

Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Add=$ABSProvider, $CASProvider, S4Provider}

Donde cada proveedor definido con la directiva Add ya se ha definido a través del proceso de New-CsClsProvider .

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio , Todos los programas , Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server .

  2. Los cmdlets aquí suministrados permiten crear proveedores y actualizar los ya existentes. Para quitar un proveedor, es preciso usar la directiva Replace del parámetro Provider de Set-CsClsScenario . La única forma de quitar un proveedor por completo consiste en reemplazarlo por un proveedor predefinido que tenga el mismo nombre y usar la directiva Update. Por ejemplo, nuestro proveedor LyssProvider tiene definido un tipo de registro WPP, un nivel establecido en Debug y las marcas TF_CONNECTION y TF_DIAG. Necesitará cambiar las marcas a "All". Escriba lo siguiente para cambiar el proveedor:

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Debug" -Flags "All"
    
    Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Replace=$LyssProvider}
    
  3. Escriba lo siguiente si quiere quitar por completo un escenario y sus proveedores asociados:

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

    Por ejemplo:

    Remove-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo"
    
    warningAdvertencia:
    El cmdlet Remove-CsClsScenario no pide confirmación. El escenario se elimina junto con los proveedores que tenga asignados. Puede crear el escenario de nuevo si vuelve a ejecutar los comandos que usó para crearlo. No existe ningún procedimiento para recuperar escenarios o proveedores.

Cuando se quita un escenario con el cmdlet Remove-CsClsScenario , se quita por completo del ámbito. Para usar los escenarios que creó y los proveedores que formaban parte de ellos, necesitará crear proveedores y asignarlos a un nuevo escenario.

 
Mostrar: