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

Artículo
07/21/2023

Resumen: Obtenga información sobre cómo configurar proveedores de escenarios para el servicio de registro centralizado en Skype Empresarial Server 2015.

Los conceptos y la configuración de los proveedores en el servicio de registro centralizado es uno de los más importantes a entender. Los proveedores se asignan directamente a Skype Empresarial Server componentes de rol de servidor en el modelo de seguimiento de Skype Empresarial Server. El proveedor define los componentes de un Skype Empresarial Server 2015 que se sigue, el tipo de mensajes (por ejemplo, fatal, error o advertencia) que se recopilan y las marcas (por ejemplo, TF_Connection o TF_Diag). Los proveedores son los componentes trazables en cada rol de servidor 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 mediante el Shell de administración de Skype Empresarial Server, debe ser miembro de los grupos de seguridad de control de acceso basado en roles (RBAC) de CsAdministrator o CsServerAdministrator, o bien un rol RBAC personalizado que contenga cualquiera de estos dos grupos. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles RBAC personalizados que esté creando usted mismo), ejecute el siguiente comando desde el Shell de administración de Skype Empresarial Server o el símbolo del sistema de Windows PowerShell:

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 artículo se centra en cómo definir proveedores, modificar un proveedor y qué contiene una definición de proveedor para optimizar la solución de problemas. Hay dos formas de emitir comandos del servicio de registro centralizado. Puede usar la CLSController.exe que se encuentra, de forma predeterminada, en el directorio C:\Archivos de programa\Archivos comunes\Skype Empresarial Server 2015\CLSAgent. O bien, puede usar el Shell de administración de Skype Empresarial Server para ejecutar comandos de Windows PowerShell. Al usar Windows PowerShell, puede definir nuevos proveedores para su uso en sus sesiones de registro y tener un control completo sobre su creación, lo que recopilan y en qué nivel recopilan datos.

Importante

Como se mencionó, los proveedores son muy potentes. Sin embargo, los escenarios son más eficaces porque contienen la realización de toda la información necesaria para establecer y ejecutar el seguimiento de los componentes que representan los proveedores. Dado que los escenarios son una colección de proveedores, esto podría compararse holgadamente con la ejecución de un archivo por lotes que contiene cientos de comandos para recopilar una gran cantidad de información frente a la emisión de cientos de comandos, uno a la vez, en la línea de comandos.

En lugar de requerir que a profundizar en los detalles de los proveedores, el servicio de registro centralizado proporciona muchos escenarios que ya están definidos para usted. Los escenarios proporcionados cubren la mayoría de los posibles problemas que se pueden encontrar. En raras ocasiones, es posible que deba crear y definir proveedores y asignarlos a escenarios. Le recomendamos encarecidamente que se familiarice con cada uno de los escenarios proporcionados antes de investigar la necesidad de crear nuevos proveedores y escenarios. Aunque la información sobre la creación de proveedores se encuentra aquí para familiarizarse con cómo los escenarios usan los elementos del proveedor para recopilar, rastrear información, los detalles sobre los propios proveedores no se proporcionan en este momento.

Introducido en el servicio de registro centralizado en Skype Empresarial 2015, los elementos clave de definir un proveedor para su uso en un escenario son:

Proveedores Si está familiarizado con OCSLogger, los proveedores son los componentes que usted decide decirle a OCSLogger de qué el motor de seguimiento debe recopilar los registros de. Los proveedores son los mismos componentes y en muchos casos tienen los mismos nombres que los componentes de OCSLogger. Si no está familiarizado con OCSLogger, los proveedores son componentes específicos del rol de servidor de los que el servicio de registro centralizado puede recopilar registros. En el caso del servicio de registro centralizado, el CLSAgent es la parte arquitectónica del servicio de registro centralizado que realiza el seguimiento de los componentes que define en la configuración de proveedores.
Niveles de registro OCSLogger proporciona la opción de elegir una serie de niveles de detalle para los datos recopilados. Esta característica es una parte integral del servicio de registro centralizado y los escenarios, y se define mediante el parámetro Type . Puede elegir entre las siguientes opciones:
- Todo Recopila los mensajes de seguimiento de tipo fatal, error, advertencia, información detallada y de depuración al registro del proveedor definido.
- Fatal Recopila solo los mensajes de seguimiento definidos como "Fatal".
- Error Recopila solo los mensajes de seguimiento definidos como "Error" o "Fatal".
- Advertencia Recopila solo los mensajes de seguimiento de los tipos "Advertencia", "Error" y "Fatal".
- Información Recopila solo los mensajes de seguimiento que indican un mensaje informativo para el proveedor definido, además de mensajes fatales, de error y de advertencia.
- Detallado Recopila todos los mensajes de seguimiento de tipo fatal, error, advertencia y detallado para el proveedor definido.
- Depurar esto es básicamente un equivalente de "Todos": recopila seguimientos de tipo Fatal, Error, Advertencia, Información, Detallado y Depuración para el proveedor definido.
Banderas OCSLogger proporciona la opción de elegir marcas para cada proveedor que define qué tipo de información se puede recuperar de los archivos de seguimiento. Puede elegir las siguientes marcas, en función del proveedor:
- TF_Connection Proporciona entradas de registro relacionadas con la conexión. Estos registros incluyen información sobre las conexiones establecidas hacia y desde un componente determinado. Esto también puede incluir información importante a nivel de red (es decir, para componentes sin el concepto de conexión).
- TF_Security Proporciona todas las entradas de registro o eventos relacionadas con la seguridad. Por ejemplo, para SipStack, estos son eventos de seguridad como un error de validación de dominio y errores de autenticación/autorización de cliente.
- TF_Diag Proporciona eventos de diagnóstico que puede usar para diagnosticar o solucionar problemas del componente. Por ejemplo, para SipStack, se trata de errores de certificado o advertencias y errores de DNS.
- TF_Protocol Proporciona mensajes de protocolo, como SIP y mensajes del paquete de códecs de la comunidad combinada.
- TF_Component Habilita el registro en los componentes especificados como parte de los proveedores.
- Todo Establece todas las marcas disponibles para el proveedor.

Para revisar la información sobre los proveedores de escenarios de servicio de registro centralizado existente

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.
Para revisar la configuración de proveedores existentes, escriba lo siguiente:
```
Get-CsClsScenario -Identity <scope and scenario name>
```
Por ejemplo, para revisar la información sobre el operador global de conferencias, escriba:
```
Get-CsClsScenario -Identity "global/CAA"
```
El comando muestra una lista de proveedores con las marcas, la configuración y los componentes asociados. Si la información que se muestra no es suficiente o la lista es demasiado larga para el formato predeterminado de Windows PowerShell lista, puede mostrar información adicional definiendo un método de salida diferente. Para ello, escriba lo siguiente:
```
Get-CsClsScenario -Identity "global/CAA" | Select-Object -ExpandProperty Provider
```
La salida de este comando muestra cada proveedor en un formato de cinco líneas con el nombre del proveedor, el tipo de registro, el nivel de registro, las marcas, el GUID y el rol, cada uno en una línea independiente.

Para definir un nuevo proveedor de escenarios de servicio de registro centralizado

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.
Un proveedor de escenarios consiste en un componente a rastrear, marcas para usar y un nivel de detalle para recopilar. Para ello, escriba:
```
$<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 que define qué recopilar y qué nivel de detalle del proveedor de Lyss es similar a la siguiente:
```
$LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Info" -Flags "All"
```

-Level recopila mensajes fatales, de error, de advertencia e información. Las marcas usadas son todas las definidas para el proveedor de 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 seguimientos del proveedor de Lyss. Para completar la creación y asignación del proveedor a un nuevo escenario, escriba:

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

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

Para cambiar un proveedor de escenarios de servicio de registro centralizado existente

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.

Para actualizar o cambiar la configuración de un proveedor existente, escriba:

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

A continuación, actualice el escenario para asignar el proveedor escribiendo lo siguiente:

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

El resultado final del comando es que el escenario site:Redmond/RedmondLyssInfo tendrá marcas y niveles actualizados para el proveedor asignado. Puede ver el nuevo escenario usando Get-CsClsScenario. Para obtener más información, consulte Get-CsClsScenario.

Precaución

New-ClsCsProvider no comprueba si las marcas son válidas. Asegúrese de que la ortografía de las marcas (por ejemplo, TF_DIAG o TF_CONNECTION) esté escrita correctamente. Si las marcas no están escritas correctamente, el proveedor no puede devolver la información de registro esperada.

Si desea agregar proveedores adicionales a este escenario, escriba lo siguiente:

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

Donde cada proveedor definido con el Add directiva ya se ha definido mediante el New-CsClsProvider proceso.

Para quitar un proveedor de escenarios

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.
Los cmdlets proporcionados le permiten actualizar proveedores existentes y crear nuevos proveedores. Para quitar un proveedor, debe usar la directiva Replace para el parámetro Provider en Set-CsClsScenario. La única manera de quitar un proveedor por completo es reemplazarlo por un proveedor redefinido con el mismo nombre y usar la directiva Update. Por ejemplo, nuestro proveedor LyssProvider se define con WPP como el tipo de registro, nivel establecido en Debug, y marcas establecidas son TF_CONNECTION y TF_DIAG. Debe cambiar las marcas a "Todo". Para cambiar el proveedor, escriba lo siguiente:
```
$LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Debug" -Flags "All"
```
```
Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Replace=$LyssProvider}
```
Si desea quitar por completo un escenario y los proveedores asociados a él, escriba lo siguiente:
```
Remove-CsClsScenario -Identity <scope and name of scenario>
```
Por ejemplo:
```
Remove-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo"
```
Precaución

El cmdlet Remove-CsClsScenario no le pide confirmación. El escenario se elimina, junto con los proveedores que se le asignaron. Puede volver a crear el escenario si vuelve a ejecutar los comandos utilizados para crearlo inicialmente. No hay ningún procedimiento para recuperar los escenarios o proveedores eliminados.

Al quitar un escenario mediante el cmdlet Remove-CsClsScenario , el escenario se quita por completo del ámbito. Para usar los escenarios que creó y los proveedores que formaban parte del escenario, debe crear nuevos proveedores y asignarlos a un nuevo escenario.

Vea también