Configuration des fournisseurs pour le service de journalisation centralisée dans Lync Server 2013Configuring providers for Centralized Logging Service in Lync Server 2013

 

Dernière modification de la rubrique : 2014-03-19Topic Last Modified: 2014-03-19

Les concepts et la configuration des fournisseurs dans le service de journalisation centralisée sont les plus importants à comprendre.The concepts and configuration of providers in Centralized Logging Service is one of the most important to grasp. Les fournisseurs mappent directement vers les composants de rôle serveur Lync Server dans le modèle de suivi Lync Server.The providers map directly to Lync Server server role components in the Lync Server tracing model. Le fournisseur définit les composants d’un Lync Server 2013 qui seront suivis, le type de messages (par exemple, fatal, erreur ou avertissement) à collecter, ainsi que les indicateurs (par exemple, TF _ Connection ou TF _ diag).The provider defines the components of a Lync Server 2013 that will be traced, the type of messages (for example, fatal, error, or warning) to collect, and the flags (for example, TF_Connection or TF_Diag). Les fournisseurs sont les composants traçables dans chaque rôle serveur Lync Server.Providers are the traceable components in each Lync Server server role. À l’aide de fournisseurs, vous définissez le niveau et le type de suivi sur les composants (par exemple, S4, SIPStack, Messagerie instantanée et Présence).By using providers, you define the level and type of tracing on components (for example, S4, SIPStack, IM and Presence). Le fournisseur défini est utilisé dans un scénario pour regrouper tous les fournisseurs d’une collection logique donnée qui répondent à une condition de problème spécifique.The defined provider is used in a scenario to group all of the providers for a given logical collection that address a specific problem condition.

Pour exécuter les fonctions du service de journalisation centralisée à l’aide de Lync Server Management Shell, vous devez être membre des groupes de sécurité CsAdministrator ou RBAC (contrôle d’accès basé sur un rôle CsServerAdministrator), ou d’un rôle RBAC personnalisé qui contient l’un de ces deux groupes.To run the Centralized Logging Service functions using the Lync Server Management Shell, you must be a member of either the CsAdministrator or the CsServerAdministrator role-based access control (RBAC) security groups, or a custom RBAC role that contains either of these two groups. Pour renvoyer la liste de tous les rôles RBAC (contrôle d’accès basé sur un rôle) auxquels cette applet de commande a été affectée (y compris les rôles RBAC personnalisés que vous avez créés vous-même), exécutez la commande suivante à partir de Lync Server Management Shell ou de l’invite Windows PowerShell :To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Lync Server Management Shell or the Windows PowerShell prompt:

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

Par exemple :For example:

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

Le reste de cette rubrique porte sur la définition des fournisseurs, la modification d’un fournisseur et ce que contient une définition de fournisseur afin d’optimiser le dépannage.The remainder of this topic focuses on how to define providers, modify a provider and what a provider definition contains to optimize your troubleshooting. Il existe deux façons d’émettre des commandes de service de journalisation centralisée.There are two ways to issue Centralized Logging Service commands. Vous pouvez utiliser le CLSController.exe qui se trouve, par défaut, dans le répertoire C : \ Program Files \ Common Files \ Microsoft Lync Server 2013 \ CLSAgent.You can use the CLSController.exe that is located, by default, in the directory C:\Program Files\Common Files\Microsoft Lync Server 2013\CLSAgent. Vous pouvez utiliser Lync Server Management Shell pour émettre des commandes Windows PowerShell.Or, you can use the Lync Server Management Shell to issue Windows PowerShell commands. Il est important de noter que lorsque vous utilisez CLSController.exe à la ligne de commande, la sélection de scénarios disponibles dans lesquels les fournisseurs sont déjà définis est limitée et non modifiable ; toutefois, vous pouvez définir le niveau de journalisation.The important distinction is that when you use CLSController.exe at the command line there is a finite selection of scenarios available in which the providers are already defined and are not changeable, but you can define the log level. À l’aide de Windows PowerShell, vous pouvez définir de nouveaux fournisseurs à utiliser dans vos sessions de journalisation et disposer d’un contrôle total sur leur création, leur collecte et leur niveau de collecte des données.By using Windows PowerShell, you can define new providers for use in your logging sessions, and have complete control over their creation, what they collect, and at what level they collect data.

Important

Comme nous l’avons précédemment mentionné, les fournisseurs sont très puissants. Cependant, les scénarios le sont davantage, et ce du fait qu’ils contiennent toutes les informations nécessaires pour définir et exécuter le suivi sur les composants que les fournisseurs représentent. Les scénarios étant une collection de fournisseurs, une certaine analogie peut être établie entre, d’une part, l’exécution d’un fichier de commandes qui contient des centaines de commandes destinées à collecter une grande quantité d’informations et, d’autre part, l’émission de centaines de commandes, une à la fois, à la ligne de commande.As mentioned, providers are very powerful. However, scenarios are more powerful because they contain the embodiment of all information needed to set and execute tracing on the components that the providers represent. With scenarios being a collection of providers, this could be loosely compared to running a batch file containing hundreds of commands to collect a lot of information versus issuing hundreds of commands, one at a time, at the command line.
Au lieu de vous demander d’approfondir les détails des fournisseurs, le service de journalisation centralisée fournit un certain nombre de scénarios qui sont déjà définis pour vous.Instead of requiring you to dig deeply into the details of providers, the Centralized Logging Service provides a number of scenarios that are already defined for you. Les scénarios fournis couvrent la grande majorité des problèmes que vous êtes susceptible de rencontrer.The provided scenarios cover the vast majority of possible issues that you will encounter. Dans de rares cas, vous devrez créer et définir des fournisseurs et les affecter à des scénarios.In rare cases, you may need to create and define providers and assign them to scenarios. Nous vous recommandons fortement de vous familiariser avec chacun des scénarios fournis avant d’étudier la nécessité de créer de nouveaux scénarios et de nouveaux fournisseurs.We strongly recommend that you become familiar with each of the scenarios provided before you investigate the need to create new providers and scenarios. Bien que des informations sur la création de fournisseurs sont données ici pour vous familiariser avec la façon dont les scénarios utilisent les éléments des fournisseurs pour collecter des informations de suivi, aucun détail sur les fournisseurs eux-mêmes n’est fourni pour le moment.While information about creating providers is found here to familiarize you with how the scenarios use the provider elements to collect trace information, details on the providers themselves are not provided at this time.

Introduits dans Overview of the Centralized Logging Service in Lync Server 2013, les éléments clés de la définition d’un fournisseur à utiliser dans un scénario sont les suivants :Introduced in Overview of the Centralized Logging Service in Lync Server 2013, the key elements of defining a provider for use in a scenario are:

  • Fournisseurs     Si vous êtes familiarisé avec OCSLogger, les fournisseurs sont les composants que vous choisissez pour indiquer OCSLogger ce que le moteur de suivi doit collecter dans les journaux.Providers   If you are familiar with OCSLogger, providers are the components that you choose to tell OCSLogger what the tracing engine should collect logs from. Les fournisseurs sont les mêmes composants et, dans de nombreux cas, ont le même nom que les composants dans OCSLogger.The providers are the same components, and in many cases have the same name as the components in OCSLogger. Si vous n’êtes pas familiarisé avec OCSLogger, les fournisseurs sont des composants spécifiques au rôle serveur, dont le service de journalisation centralisée peut collecter des journaux.If you are not familiar with OCSLogger, providers are server-role specific components that the Centralized Logging Service can collect logs from. Dans le cas du service de journalisation centralisée, le CLSAgent est la partie architecturale du service de journalisation centralisée qui effectue le suivi des composants que vous définissez dans la configuration des fournisseurs.In the case of the Centralized Logging Service, the CLSAgent is the architectural part of the Centralized Logging Service that is doing the tracing of the components that you define in the providers configuration.

  • Niveaux de journalisation Logging levels     OCSLogger a fourni la possibilité de choisir un certain nombre de niveaux de détail pour les données collectées.Logging levels   OCSLogger provided the option to choose a number of levels of detail for the data collected. Cette fonctionnalité fait partie intégrante du service de journalisation centralisée et des scénarios, et est définie par le paramètre type .This feature is an integral part of the Centralized Logging Service and scenarios, and is defined by the Type parameter. Vous pouvez choisir l'une des options suivantes :You can choose from the following:

    • Tous les     Collecte les messages de suivi de type fatal, Error, Warning et info dans le journal pour le fournisseur défini.All   Collects trace messages of type fatal, error, warning, and info to the log for the defined provider.

    • Irrécupérable     Collecte uniquement les messages de suivi qui indiquent un échec pour le fournisseur défini.Fatal   Collects only the trace messages that indicate a failure for the defined provider.

    • Erreur     Collecte uniquement les messages de suivi qui indiquent une erreur pour le fournisseur défini, ainsi que les messages irrécupérables.Error   Collects only the trace messages that indicate an error for the defined provider, plus fatal messages.

    • Avertissement     Collecte uniquement les messages de suivi qui indiquent un avertissement pour le fournisseur défini, ainsi que les messages d’erreur et d’erreur irrécupérable.Warning   Collects only the trace messages that indicate a warning for the defined provider, plus fatal and error messages.

    • Info     Collecte uniquement les messages de suivi qui indiquent un message d’information pour le fournisseur défini, ainsi que les messages d’erreur et d’avertissement fatals.Info   Collects only the trace messages that indicate an informational message for the defined provider, plus fatal, error, and warning messages.

    • Commentaires     Collecte tous les messages de suivi de type fatal, Error, Warning et info pour le fournisseur défini.Verbose   Collects all trace messages of type fatal, error, warning and info for the defined provider.

  • Indicateurs     OCSLogger a fourni l’option permettant de choisir des indicateurs pour chaque fournisseur qui a défini le type d’informations que vous pouvez récupérer dans les fichiers de suivi.Flags   OCSLogger provided the option to choose flags for each provider that defined what type of information you could retrieve from the trace files. Vous pouvez choisir les indicateurs suivants selon le fournisseur :You can chose the following flags, based on the provider:

    • Tf _ Connection     fournit des entrées de journal liées à la connexion.TF_Connection   Provides connection-related log entries. Ces journaux incluent des informations sur les connexions établies depuis et vers un composant particulier.These logs include information about connections established to and from a particular component. Ils peuvent également comprendre des informations importantes au niveau du réseau (c’est-à-dire, pour les composants sans le concept d’une connexion).This may also include significant network-level information (that is, for components without the concept of a connection).

    • Tf _ La sécurité     fournit tous les événements/entrées du journal liés à la sécurité.TF_Security   Provides all events/log entries related to security. Par exemple, pour SipStack, il s’agit d’événements de sécurité tels que les échecs de validation de domaine et les échecs d’authentification ou d’autorisation du client.For example, for SipStack, these are security events such as domain validation failure, and client authentication/authorization failures.

    • Tf _ Diag     fournit des événements de diagnostic que vous pouvez utiliser pour diagnostiquer ou dépanner le composant.TF_Diag   Provides diagnostics events that you can use to diagnose or troubleshoot the component. Par exemple, pour SipStack, il s’agit d’échecs de certificat ou d’avertissements/erreurs DNS.For example, for SipStack, these are certificate failures, or DNS warnings/errors.

    • Tf _ Protocole     fournit des messages de protocole, tels que SIP et les messages du Pack de codecs communautaires combinés.TF_Protocol   Provides protocol messages such as SIP and Combined Community Codec Pack messages.

    • Tf _ Le composant     active la journalisation sur les composants spécifiés dans le cadre des fournisseurs.TF_Component   Enables logging on the components specified as part of the providers.

    • Tous les     Définit tous les indicateurs disponibles pour le fournisseur.All   Sets all available flags available for the provider.

Pour consulter les informations sur les fournisseurs de scénarios de service de journalisation centralisée existantsTo review information about existing Centralized Logging Service scenario providers

  1. Démarrez Lync Server Management Shell : cliquez sur **Démarrer **, **Tous les programmes **, **Microsoft Lync Server 2013 **, puis sur Lync Server Management Shell.Start the Lync Server Management Shell: Click Start, click All Programs, click Microsoft Lync Server 2013, and then click Lync Server Management Shell.

  2. Pour examiner la configuration de fournisseurs existants, tapez ce qui suit :To review the configuration of existing providers, type the following:

    Get-CsClsScenario -Identity <scope and scenario name> 
    

    Par exemple, pour examiner des informations sur l’Intendant Conférence global, tapez :For example, to review information about the global conferencing attendant, type:

    Get-CsClsScenario -Identity "global/CAA"
    

    La commande affiche une liste de fournisseurs avec les indicateurs, paramètres et composants associés.The command displays a list of providers with the associated flags, settings, and components. Si les informations affichées ne sont pas suffisantes ou si la liste est trop longue pour le format de liste Windows PowerShell par défaut, vous pouvez afficher des informations supplémentaires en définissant une autre méthode de sortie.If the information displayed is not enough or the list is too long for the default Windows PowerShell list format, you can display additional information by defining a different output method. Pour cela, tapez :To do this, type:

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

    La sortie de cette commande affiche chaque fournisseur sur cinq lignes avec le nom du fournisseur, le type de journalisation, le niveau d’enregistrement, les indicateurs, le GUID et le rôle sur une ligne distincte.The output of this command displays each provider displayed in a five line format with the provider name, type of logging, logging level, flags, GUID, and role, each one on a separate line.

Pour définir un nouveau fournisseur de scénario de service de journalisation centraliséeTo define a new Centralized Logging Service scenario provider

  1. Démarrez Lync Server Management Shell : cliquez sur **Démarrer **, **Tous les programmes **, **Microsoft Lync Server 2013 **, puis sur Lync Server Management Shell.Start the Lync Server Management Shell: Click Start, click All Programs, click Microsoft Lync Server 2013, and then click Lync Server Management Shell.

  2. Un fournisseur de scénario se compose d’un composant à suivre, d’indicateurs à utiliser et d’un niveau de détail à collecter. Pour cela, tapez :A scenario provider consists of a component to trace, flags to use, and a level of detail to collect. You do this by typing:

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

    Par exemple, une définition de fournisseur de suivi qui définit ce qu’il faut collecter à partir du fournisseur Lyss et à quel niveau de détail ressemble à ceci :For example, a trace provider definition that defines what to collect and to what level of detail from the Lyss provider looks like the following:

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

–Level collecte les messages Fatal, Error, Warning et Info.The –Level collects fatal, error, warning, and information messages. Les indicateurs utilisés sont tous ceux définis pour le fournisseur Lyss, et incluent la _ connexion TF, TF _ diag et TF _ Protocol.The flags used are all of those defined for the Lyss provider, and include TF_Connection, TF_Diag and TF_Protocol.

Après avoir défini la variable $LyssProvider, vous pouvez l’utiliser avec la nouvelle applet de commande New-CsClsScenario pour collecter des suivis à partir du fournisseur Lyss.After the variable $LyssProvider is defined, you can use it with the New-CsClsScenario cmdlet to collect traces from the Lyss provider. Pour terminer la création du fournisseur et son affectation à un nouveau scénario, tapez :To complete the creation and assignment of the provider to a new scenario, type:

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

Où $LyssProvider est la variable qui contient le scénario défini créé avec New-CsClsProvider.Where $LyssProvider is the variable containing the defined scenario created with New-CsClsProvider.

Pour modifier un fournisseur de scénario de service de journalisation centralisé existantTo change an existing Centralized Logging Service scenario provider

  1. Démarrez Lync Server Management Shell : cliquez sur **Démarrer **, **Tous les programmes **, **Microsoft Lync Server 2013 **, puis sur Lync Server Management Shell.Start the Lync Server Management Shell: Click Start, click All Programs, click Microsoft Lync Server 2013, and then click Lync Server Management Shell.

  2. Pour mettre à jour ou modifier la configuration d’un fournisseur existant, tapez :To update or change the configuration of an existing provider, type:

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

    Vous pouvez ensuite mettre à jour le scénario pour affecter le fournisseur en tapant ce qui suit :You then update the scenario to assign the provider by typing the following:

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

À l’issue de l’exécution de la commande, des indicateurs et un niveau mis à jour pour le fournisseur sont affectés au scénario site:Redmond/RedmondLyssInfo.The end result of the command is that the scenario site:Redmond/RedmondLyssInfo will have updated flags and level for the provider assigned to it. Vous pouvez examiner le nouveau scénario en utilisant Get-CsClsScenario.You can view the new scenario by using Get-CsClsScenario. Pour plus d’informations, voir Get-CsClsScenario.For details, see Get-CsClsScenario.

Avertissement

New-ClsCsProvider ne vérifie pas si les indicateurs sont valides.New-ClsCsProvider does not check to determine whether the flags are valid. Assurez-vous que les indicateurs (par exemple, TF_DIAG ou TF_CONNECTION) sont correctement épelés.Make sure that the spelling of the flags (for example, TF_DIAG or TF_CONNECTION) is spelled correctly. Si ce n’est pas le cas, le fournisseur ne peut pas retourner les informations du journal attendues.If the flags are not spelled correctly, the provider cannot return the expected log information.

Si vous souhaitez ajouter des fournisseurs supplémentaires à ce scénario, tapez ce qui suit :If you want to add additional providers to this scenario, type the following:

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

Où chaque fournisseur défini avec la directive Add a déjà été défini à l’aide du processus New-CsClsProvider.Where each provider defined with the Add directive has already been defined using the New-CsClsProvider process.

Pour supprimer un fournisseur de scénarioTo remove a scenario provider

  1. Démarrez Lync Server Management Shell : cliquez sur **Démarrer **, **Tous les programmes **, **Microsoft Lync Server 2013 **, puis sur Lync Server Management Shell.Start the Lync Server Management Shell: Click Start, click All Programs, click Microsoft Lync Server 2013, and then click Lync Server Management Shell.

  2. Les applets de commande fournies vous permettent de mettre à jour des fournisseurs existants et de créer de nouveaux fournisseurs.The cmdlets provided allow you to update existing providers and create new providers. Pour supprimer un fournisseur, vous devez utiliser la directive Replace pour le paramètre Provider pour Set-CsClsScenario.To remove a provider, you must use the Replace directive for the Provider parameter to Set-CsClsScenario. La seule façon de supprimer complètement un fournisseur est de le remplacer par un fournisseur redéfini du même nom et d’utiliser la directive Update.The only way to completely remove a provider is to replace it with a redefined provider of the same name and use the Update directive. Par exemple, notre fournisseur LyssProvider est défini avec WPP comme type de journal, niveau défini sur déboguer et ensemble d’indicateurs sont _ connexion TF et TF _ diag.For example, our provider LyssProvider is defined with WPP as the log type, level set to Debug, and flags set are TF_CONNECTION and TF_DIAG. Vous devez affecter aux indicateurs la valeur « All ».You need to change the flags to “All”. Pour modifier le fournisseur, tapez ce qui suit :To change the provider, type the following:

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

     

    Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Replace=$LyssProvider}
    
  3. Si vous souhaitez supprimer complètement un scénario et les fournisseurs associés à celui-ci, tapez ce qui suit :If you want to completely remove a scenario and the providers associated with it, type the following:

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

    Par exemple :For example:

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

    Avertissement

    L’applet de commande Remove-CsClsScenario ne vous demande pas confirmation.The cmdlet Remove-CsClsScenario does not prompt you for confirmation. Le scénario est supprimé, ainsi que les fournisseurs affectés à celui-ci.The scenario is deleted, along with the providers that were assigned to it. Vous pouvez recréer le scénario en réexécutant les commandes que vous avez utilisées pour le créer initialement.You can recreate the scenario by re-running the commands used to create it initially. Il n’existe aucune procédure pour récupérer des scénarios ou des fournisseurs supprimés.There is no procedure to recover removed scenarios or providers.

Lorsque vous supprimez un scénario à l’aide de l’applet de commande Remove-CsClsScenario, vous supprimez complètement le scénario de l’étendue.When you remove a scenario by using the Remove-CsClsScenario cmdlet, you completely remove the scenario from the scope. Pour utiliser les scénarios que vous avez créés et les fournisseurs qui faisaient partie du scénario, vous devez créer de nouveaux fournisseurs et les affecter à un nouveau scénario.To use the scenarios that you created and the providers that were a part of the scenario, you create new providers and assign them to a new scenario.