Compartir a través de

Configuración de proveedores para el servicio de registro centralizado en Lync Server 2013

  • Artículo

 

Última modificación del tema: 2014-03-19

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 los componentes de rol del servidor de Lync Server en el modelo de seguimiento de Lync Server. El proveedor define los componentes de un Lync Server 2013 que se rastreará, el tipo de mensajes (por ejemplo, fatal, error o advertencia) que se van a recopilar y las marcas (por ejemplo, TF_Connection o TF_Diag). Los proveedores son los componentes trazables en cada rol de servidor de Lync 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 Lync Server, debe ser miembro del CsAdministrator o de los grupos de seguridad de control de acceso basado en roles (RBAC) de 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 de RBAC personalizados que haya creado usted mismo), ejecute el siguiente comando desde el Shell de administración de Lync Server o el símbolo del Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Lync Server 2013 cmdlet"}

Por ejemplo:

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

El resto de este tema se centra en cómo definir proveedores, modificar un proveedor y lo que 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\Microsoft Lync Server 2013\CLSAgent. O bien, puede usar el Shell de administración de Lync Server para ejecutar comandos de Windows PowerShell. La distinción importante es que cuando se utiliza CLSController.exe en la línea de comandos hay una selección finita de escenarios disponibles en los que los proveedores ya están definidos y no son modificables, pero se puede definir el nivel de registro. 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 una serie de escenarios que ya están definidos para usted. Los escenarios proporcionados cubren la gran 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 aquí se encuentra información sobre la creación de proveedores para familiarizarse con la forma en que los escenarios usan los elementos del proveedor para recopilar información de seguimiento, no se proporcionan detalles sobre los propios proveedores en este momento.

Introducido en Información general del servicio de registro centralizado en Lync Server 2013, 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 e información al registro del proveedor definido.

    • Fatal Recopila solo los mensajes de seguimiento que indican un error para el proveedor definido.

    • Error Recopila solo los mensajes de seguimiento que indican un error para el proveedor definido, además de los mensajes fatales.

    • Advertencia Recopila solo los mensajes de seguimiento que indican una advertencia para el proveedor definido, además de mensajes mortales y de error.

    • 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 e informació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

  1. Inicie el Shell de administración de Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync Server.

  2. 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

  1. Inicie el Shell de administración de Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync Server.

  2. 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"

El nivel –recopila mensajes fatales, de error, de advertencia e información. Las marcas utilizadas son todas las definidas para el proveedor de Lyss e incluyen TF_Connection, TF_Diag y TF_Protocol.

Una vez definida la $LyssProvider de variables, 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

  1. Inicie el Shell de administración de Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync Server.

  2. 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.

Advertencia

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

  1. Inicie el Shell de administración de Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync Server.

  2. 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 por completo un proveedor es reemplazarlo por un proveedor redefinido del 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}

  3. 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"

    Advertencia

    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.