Configurer Distributed Replay
Les détails de configuration de Microsoft SQL Server Distributed Replay Utility 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
Fichier de configuration du client
Fichier de configuration de prétraitement
Fichier de configuration de relecture
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 :
<controller installation path>\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 |
Requis |
|---|---|---|---|---|
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 :
<client installation path>\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 |
Requis |
|---|---|---|---|---|
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 ResultDirectory et WorkingDirectory 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 preprocess (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 :
<administration tool installation path>\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. Ces paramètres sont les suivants :
Paramètre |
Élément XML |
Description |
Valeurs autorisées |
Requis |
|---|---|---|---|---|
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.
|
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 utilisez le paramètre de l'outil d'administration -c 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 :
<administration tool installation path>\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 <OutputOptions> et <ReplayOptions> 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 |
Requis |
|---|---|---|---|---|
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é en utilisant le paramètre -s target server 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. |
Oui | Non |
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 |
Requis |
|---|---|---|---|---|
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>
Voir aussi
Référence
Options de ligne de commande de l'outil d'administration (Distributed Replay Utility)
Concepts
Autres ressources
Forum de SQL Server Distributed Replay
Utilisation de Distributed Replay pour le test de charge de SQL Server – Deuxième partie
Utilisation de Distributed Replay pour le test de charge de SQL Server – Première partie