Configure Distributed Replay

  • Article

S’applique à : SQL Server 2016 (13.x), SQL Server 2017 (14.x) et SQL Server 2019 (15.x)

Important

SQL Server Distributed Replay n’est pas disponible avec SQL Server 2022 (16.x).

Les détails de configuration de Microsoft SQL Server Distributed Replay sont spécifiés dans les fichiers XML qui se trouvent sur Distributed Replay Controller, sur les clients et à l’emplacement où l’outil d’administration est installé. Il s'agit des fichiers suivants :

Fichier de configuration du contrôleur : DReplayController.config

Lorsque le service Distributed Replay Controller SQL Server démarre, il charge le niveau de journalisation à partir du fichier de configuration du contrôleur, DReplayController.config. Ce fichier se trouve dans le dossier où vous avez installé le service Distributed Replay Controller :

<chemin d’installation du contrôleur>\DReplayController.config

Le niveau de journalisation spécifié par le fichier de configuration du contrôleur inclut les éléments suivants :

Paramètre Élément XML Description Valeurs autorisées Obligatoire
Niveau de journalisation <LoggingLevel> Spécifie le niveau de journalisation pour le service contrôleur. INFORMATION | WARNING | CRITICAL Non. Par défaut, la valeur est CRITICAL.

Exemple

Cet exemple montre un fichier de configuration du contrôleur qui a été modifié pour supprimer les entrées du journal INFORMATION et WARNING .

<?xml version='1.0'?> 
<Options> 
<LoggingLevel>CRITICAL</LoggingLevel> 
</Options>

Fichier de configuration client : DReplayClient.config

Lorsque le service SQL Server Distributed Replay Client démarre, il charge des paramètres de configuration à partir du fichier de configuration client, DReplayClient.config. Ce fichier se trouve sur chaque client, dans le dossier où vous avez installé le service Distributed Replay Client :

<chemin d’installation du client>\DReplayClient.config

Les paramètres spécifiés par le fichier de configuration client incluent les éléments suivants :

Paramètre Élément XML Description Valeurs autorisées Obligatoire
Contrôleur <Controller> Spécifie le nom de l'ordinateur du contrôleur. Le client tentera de s'inscrire auprès de l'environnement Distributed Replay en contactant le contrôleur. Vous pouvez utiliser «localhost» ou «.» pour désigner l'ordinateur local. Non. Par défaut, le client tente de s'inscrire auprès de l'instance du contrôleur qui s'exécute localement («.»), s'il existe.
Répertoire de travail du client <WorkingDirectory> Correspond au chemin d'accès local sur le client où les fichiers de distribution sont enregistrés.

Les fichiers de ce répertoire sont écrasés lors de la prochaine relecture.		 Nom du répertoire complet, en commençant par une lettre de lecteur. Non. Si aucune valeur n'est spécifiée, les fichiers de distribution seront enregistrés dans le même emplacement que le fichier de configuration client par défaut. Si une valeur est spécifiée et que ce dossier n'existe pas sur le client, le service client ne démarrera pas.
Répertoire des résultats du client <ResultDirectory> Correspond au chemin d'accès local sur le client où est enregistré le fichier de trace de résultats de l'activité de relecture (pour le client).

Les fichiers de ce répertoire sont écrasés lors de la prochaine relecture.		 Nom du répertoire complet, en commençant par une lettre de lecteur. Non. Si aucune valeur n'est spécifiée, le fichier de trace de résultats sera enregistré dans le même emplacement que le fichier de configuration client par défaut. Si une valeur est spécifiée et que ce dossier n'existe pas sur le client, le service client ne démarrera pas.
Niveau de journalisation <LoggingLevel> Correspond au niveau de journalisation pour le service client. INFORMATION | WARNING | CRITICAL Non. Par défaut, la valeur est CRITICAL.

Exemple

Cet exemple montre un fichier de configuration client qui a été modifié pour spécifier que le service contrôleur s'exécute sur un autre ordinateur, un ordinateur nommé Controller1. Les éléments WorkingDirectory et ResultDirectory ont été configurés pour utiliser les dossiers c:\ClientWorkingDir et c:\ResultTraceDir, respectivement. La valeur par défaut du niveau de journalisation a été modifiée pour supprimer les entrées du journal INFORMATION et WARNING .

<?xml version='1.0'?> 
<Options> 
    <Controller>Controller1</Controller> 
    <WorkingDirectory>c:\ClientWorkingDir</WorkingDirectory> 
    <ResultDirectory>c:\ResultTraceDir</ResultDirectory> 
    <LoggingLevel>CRITICAL</LoggingLevel> 
</Options>

Fichier de configuration de prétraitement : DReplay.exe.preprocess.config

Lorsque vous utilisez l'outil d'administration pour initialiser l'étape de prétraitement, l'outil d'administration charge les paramètres de prétraitement à partir du fichier de configuration de prétraitement, DReplay.exe.preprocess.config.

Utilisez le fichier de configuration par défaut ou le paramètre -c de l’outil d’administration pour spécifier l’emplacement d’un fichier de configuration de prétraitement modifié. Pour plus d’informations sur l’utilisation de l’option de prétraitement de l’outil d’administration, consultez Option de prétraitement (outil d’administration Distributed Replay).

Le fichier de configuration de prétraitement par défaut se trouve dans le dossier où vous avez installé l'outil d'administration :

<chemin d’installation de l’outil d’administration>\DReplayAdmin\DReplay.exe.preprocess.config

Les paramètres de configuration de prétraitement sont spécifiés dans les éléments XML qui sont enfants de l'élément <PreprocessModifiers> dans le fichier de configuration de prétraitement. Les paramètres suivants sont inclus :

Paramètre Élément XML Description Valeurs autorisées Obligatoire
Inclure les activités de session système <IncSystemSession> Indique si les activités de session système lors de la capture seront incluses lors de la relecture. Yes | No Non. Par défaut, la valeur est No.
Durée d'inactivité maximale <MaxIdleTime> Limite la durée d'inactivité à un nombre absolu (en secondes). Entier qui est >= -1.

-1 n'indique aucune modification de la valeur d'origine dans le fichier de trace d'origine.

0 indique qu'une activité continue à un instant donné dans le temps.		 Non. Par défaut, la valeur est -1.

Exemple

Fichier de configuration de prétraitement par défaut :

<?xml version='1.0'?> 
<Options> 
    <PreprocessModifiers> 
        <IncSystemSession>No</IncSystemSession> 
        <MaxIdleTime>-1</MaxIdleTime> 
    </PreprocessModifiers> 
</Options>

Fichier de configuration de la relecture : DReplay.exe.replay.config

Lorsque vous utilisez l'outil d'administration pour initialiser l'étape de relecture d'événement, l'outil d'administration charge les paramètres de relecture à partir du fichier de configuration de relecture, DReplay.exe.replay.config.

Utilisez le fichier de configuration par défaut ou le paramètre -c de l’outil d’administration pour spécifier l’emplacement d’un fichier de configuration de relecture modifié. Pour plus d’informations sur l’utilisation de l’option de relecture de l’outil d’administration, consultez Option Replay (outil d’administration Distributed Replay).

Le fichier de configuration de relecture par défaut se trouve dans le dossier où vous avez installé l'outil d'administration :

<chemin d’installation de l’outil d’administration>\DReplayAdmin\DReplay.exe.replay.config

Les paramètres de configuration de la relecture sont spécifiés dans les éléments XML qui sont enfants des éléments <ReplayOptions> et <OutputOptions> du fichier de configuration de relecture.

Élément <ReplayOptions>

Les paramètres spécifiés par le fichier de configuration de relecture dans l'élément <ReplayOptions> incluent les éléments suivants :

Paramètre Élément XML Description Valeurs autorisées Obligatoire
Instance cible de SQL Server (serveur de test) <Server> Spécifie le nom du serveur et de l'instance de SQL Server auxquels la connexion doit être établie. server_name[\instance_name]

Vous ne pouvez pas utiliser «localhost» ou «.» pour représenter l'hôte local.		 Non, si le nom du serveur est déjà spécifié à l’aide du paramètre -sserveur cible avec l’option replay de l’outil d’administration.
Mode de séquencement <SequencingMode> Spécifie le mode utilisé pour la planification d'événement. synchronization | stress Non. Par défaut, la valeur est stress.
Granularité de l'échelle du mode simultané (stress) <StressScaleGranularity> Indique si toutes les connexions sur l'ID du profil de service (SPID) doivent être mises à l'échelle ensemble (SPID) ou indépendamment (connexion) en mode simultané (stress). SPID | Connexion Oui. Par défaut, la valeur est SPID.
Échelle de délai de connexion <ConnectTimeScale> Utilisée pour mettre à l'échelle le délai de connexion en mode simultané (stress). Entier compris entre 1 et 100. Non. Par défaut, la valeur est 100.
Échelle de temps de réflexion <ThinkTimeScale> Est utilisé pour mettre à l'échelle le temps de réflexion en mode simultané (stress). Entier compris entre 0 et 100. Non. Par défaut, la valeur est 100.
Utiliser le regroupement de connexions <UseConnectionPooling> Spécifie si le regroupement de connexions est activé sur chaque client Distributed Replay. Yes | No Oui. Par défaut, la valeur est Yes.
Délai du moniteur d'intégrité <HealthmonInterval> Indique à quelle fréquence exécuter le moniteur d'intégrité (en secondes).

Cette valeur est utilisée uniquement en mode de synchronisation.		 Entier >= 1

(-1 pour désactiver)		 Non. Par défaut, la valeur est 60.
Délai de requête <QueryTimeout> Spécifie la valeur du délai de requête, en secondes. Cette valeur n'est effective que jusqu'à ce que la première ligne soit retournée. Entier >= 1

(-1 pour désactiver)		 Non. Par défaut, la valeur est 3600.
Threads par client <ThreadsPerClient> Spécifie le nombre de threads de relecture à utiliser pour chaque client de relecture. Entier compris entre 1 et 512. Non. Si non spécifié, Distributed Replay utilise une valeur de 255.

Élément <OutputOptions>

Les paramètres spécifiés par le fichier de configuration de relecture dans l'élément <OutputOptions> incluent les éléments suivants :

Paramètre Élément XML Description Valeurs autorisées Obligatoire
Nombre de lignes d'enregistrement <RecordRowCount> Indique si le nombre de lignes doit être enregistré pour chaque jeu de résultats. Yes | No Non. Par défaut, la valeur est Yes.
Jeu de résultats d'enregistrement <RecordResultSet> Indique si le contenu de tous les jeux de résultats doit être enregistré. Yes | No Non. Par défaut, la valeur est No.

Exemple

Fichier de configuration de relecture par défaut :

<?xml version='1.0'?> 
<Options> 
    <ReplayOptions> 
        <Server></Server> 
        <SequencingMode>stress</SequencingMode> 
        <ConnectTimeScale></ConnectTimeScale> 
        <ThinkTimeScale></ThinkTimeScale> 
        <HealthmonInterval>60</HealthmonInterval> 
        <QueryTimeout>3600</QueryTimeout> 
        <ThreadsPerClient></ThreadsPerClient> 
    </ReplayOptions> 
    <OutputOptions> 
        <ResultTrace> 
            <RecordRowCount>Yes</RecordRowCount> 
            <RecordResultSet>No</RecordResultSet> 
        </ResultTrace> 
    </OutputOptions> 
</Options>

Problème possible lors de l’exécution avec le mode de séquencement de synchronisation

Vous pouvez rencontrer un symptôme dans lequel la fonctionnalité de relecture semble « bloquer » ou relire les événements lentement. Ce phénomène peut se produire si la trace en cours de relecture s’appuie sur des données et/ou des événements qui n’existent pas dans la base de données cible restaurée.

Un exemple est une charge de travail capturée qui utilise WAITFOR, par exemple dans l’instruction WAITFOR RECEIVE de Service Broker. Lors de l’utilisation du mode de séquencement de synchronisation, les lots sont relus en série. Si une instruction INSERT se produit sur la base de données source après la sauvegarde de la base de données, mais avant le démarrage de la trace de capture de relecture, l’instruction WAITFOR RECEIVE émise lors de la relecture peut être amenée à attendre pendant toute la durée de l’instruction WAITFOR. Les événements définis pour relecture après l’instruction WAITFOR RECEIVE seront bloqués. Cela peut causer le compteur de l’analyseur de performances des requêtes par lots/s pour la cible de la base de données de relecture à tomber à zéro jusqu’à la fin de l’instruction WAITFOR.

Si vous devez utiliser le mode de synchronisation et que vous souhaitez éviter ce comportement, vous devez effectuer les opérations suivantes :

  1. Suspendez les bases de données que vous utiliserez comme cibles de relecture.

  2. Autoriser l’achèvement de toutes les activités en attente.

  3. Sauvegardez les bases de données et autorisez l’achèvement des sauvegardes.

  4. Démarrez la capture de trace de la relecture distribuée et reprenez la charge de travail normale.

Voir aussi