IBM Tivoli Composite Application Manager for Microsoft Applications, version 6.3.1

Variables d'environnement local

Vous pouvez modifier le comportement de l'agent Microsoft SQL Server en configurant des variables d'environnement local.

Variables permettant de vérifier la disponibilité du service SQL Server

Pour vérifier la disponibilité du service SQL Server, ajoutez les variables d'environnement suivantes :

COLL_MSSQL_RETRY_INTERVAL : cette variable définit l'intervalle entre deux tentatives (en minutes) de vérification du statut du service SQL Server. Si la valeur est inférieure ou égale à zéro, la variable utilise la valeur par défaut 1 minute.
COLL_MSSQL_RETRY_CNT : cette variable définit le nombre de tentatives effectuées par l'agent SQL Server pour vérifier si le service SQL Server est démarré ou non. Si le service SQL Server n'a pas démarré après le nombre de tentatives indiqué dans cette variable, le collecteur cesse de fonctionner. Si la valeur de la variable est inférieure ou égale à zéro, la variable utilise la valeur par défaut de 3.

Variables permettant de contrôler le fichier journal des erreurs de SQL Server

Pour surveiller le groupe d'attributs Détails des événements d'erreur MS SQL, ajoutez les variables d'environnement suivantes :

COLL_ERRORLOG_STARTUP_MAX_TIME : cette variable indique l'intervalle de temps (T) consacré à la collecte des erreurs avant le démarrage de l'agent. La valeur par défaut est 0 minute. Cette variable peut prendre les valeurs suivantes :
T = 0

L'agent démarre la surveillance du fichier journal des erreurs, dès qu'il démarre ou qu'il est redémarré. Il ne lit pas les erreurs qui ont été consignées dans le fichier journal antérieurement à son démarrage.

T = 1
L'agent surveille le fichier journal des erreurs sur la base des valeurs suivantes qui ont été définies pour la variable COLL_ERRORLOG_STARTUP_MAX_EVENT_ROW, qui est ici représentée par R.
- Si R < 0, l'agent démarre la surveillance du fichier journal des erreurs dès qu'il démarre ou qu'il est redémarré.
- Si R = 1, l'agent surveille toutes les erreurs consignées dans le fichier journal.
- Si R > 1 et que l'agent est installé pour la première fois, l'agent surveille le fichier journal jusqu'à ce que R erreurs soient surveillées. Si R > 1 et que l'agent est redémarré, l'agent surveille les R erreurs précédemment non prises en compte.
T > 1
L'agent surveille toutes les erreurs précédentes qui ont été consignées jusqu'à T minutes dès qu'il démarre ou qu'il est redémarré. La surveillance de l'agent dépend également des valeurs suivantes définies pour la variable COLL_ERRORLOG_STARTUP_MAX_EVENT_ROW :
- Si R ≤ 0, l'agent démarre la surveillance du fichier journal des erreurs dès qu'il démarre ou qu'il est redémarré.
- Si R = 1, l'agent surveille toutes les erreurs consignées dans le fichier journal jusqu'à T minutes.
- Si R > 1, l'agent surveille R erreurs au maximum, consignées ces T dernières minutes.
COLL_ERRORLOG_STARTUP_MAX_EVENT_ROW : Cette variable indique le nombre maximal d'erreurs à traiter au démarrage de l'agent. La valeur par défaut est 0. Cette variable peut prendre les valeurs suivantes :
R = 0

L'agent démarre la surveillance du fichier journal des erreurs dès qu'il démarre ou redémarre. Il ne lit pas les erreurs qui ont été créées dans le fichier journal antérieurement à son démarrage.

R = 1

L'agent surveille les erreurs qui ont été consignées au cours des T dernières minutes dès qu'il démarre ou qu'il est redémarré.

R > 1

L'agent surveille R erreurs qui ont été consignées au cours des T dernières minutes.
COLL_ERRORLOG_MAX_EVENT_ROW : Cette variable détermine le nombre de lignes d'erreurs à afficher dans Tivoli Enterprise Portal. La valeur par défaut est 50. Cette variable peut prendre les valeurs suivantes :
X = 0

L'agent n'affiche pas les journaux des erreurs dans Tivoli Enterprise Portal.

X > 0

L'agent affiche X lignes d'erreurs dans Tivoli Enterprise Portal.

Variable pour le délai d'expiration de la requête

Pour définir le délai d'expiration des requêtes dans l'agent SQL Server, utilisez la variable QUERY_TIMEOUT. Cette variable d'environnement définit la durée maximale (en secondes) durant laquelle l'agent SQL Server attend de recevoir une réponse à une requête envoyée au serveur SQL. La valeur de cette variable doit être inférieure à 45 secondes. Toutefois, si vous définissez la valeur de cette variable sur 0 secondes, l'agent SQL Server attend indéfiniment de recevoir une réponse de SQL Server. Si l'agent SQL Server accède à un grand nombre de bases de données verrouillées, affectez une valeur de 10 à 20 secondes à cette variable. Si la requête n'est pas traitée dans le délai d'exécution imparti, l'agent SQL Server ignorera la requête expirée et passera à la requête suivante dans la file d'attente. L'agent n'affiche pas de données pour la requête expirée dans Tivoli Enterprise Portal.

Variable permettant d'afficher les informations relatives aux travaux activés

Pour afficher les informations relatives aux travaux activés dans le groupe d'attributs relatifs aux détails des travaux MS SQL, utilisez la variable d'environnementCOLL_JOB_DISABLED. Si vous définissez la valeur de cette variable sur 1, l'agent Microsoft SQL Server n'affiche aucune information sur les travaux désactivés. Si vous ne spécifiez pas cette variable, vous pouvez afficher des informations sur les travaux activés et désactivés.

Variable permettant de limiter les lignes dans le groupe d'attributs Détail des groupes de fichiers MS SQL

Pour limiter le nombre de lignes extraites par le service de collecte pour le groupe d'attributs Détail des groupes de fichiers MS SQL, utilisez la variable d'environnement COLL_KOQFGRPD_MAX_ROW. Cette variable d'environnement définit le nombre maximal de lignes extraites par le service de collecte pour le groupe d'attributs Détail des groupes de fichiers. Si vous n'indiquez pas de valeur pour cette variable, le service de collecteur extrait 10 000 lignes pour le groupe d'attributs Détails du groupe de fichiers. Utilisez cette variable d'environnement pour modifier le nombre maximal par défaut de lignes dans le fichier koqcoll.ctl. Procédez comme suit pour modifier la limite par défaut :

Indiquez le nombre maximal de lignes pour KOQFGRPD dans le fichier koqcoll.ctl.
Ajoutez la variable d'environnement COLL_KOQFGRPD_MAX_ROW et vérifiez que la valeur de cette variable est identique à la valeur que vous avez spécifiée dans le fichier koqcoll.ctl.

Si la valeur du fichier koqcoll.ctl est inférieure à la valeur spécifiée dans la variable d'environnement COLL_KOQFGRPD_MAX_ROW, la valeur du fichier koqcoll.ctl correspond à la valeur du nombre maximal de lignes.

Si la valeur du fichier koqcoll.ctl est supérieure à la valeur spécifiée dans la variable d'environnement COLL_KOQFGRPD_MAX_ROW, la valeur de la variable d'environnement COLL_KOQFGRPD_MAX_ROW correspond à la valeur du nombre maximal de lignes.

Variables permettant d'étendre la collecte du groupe d'attributs Détail des groupes de fichiers MS SQL

Utilisez la variable COLL_DBD_FRENAME_RETRY_CNT pour indiquer le nombre de tentatives de déplacement du fichier %COLL_HOME%_tmp_%COLL_VERSION%_%COLL_SERVERID%_%COLL_SERVERID%__FGRP_TEMP vers le fichier %COLL_HOME%_tmp_%COLL_VERSION%_%COLL_SERVERID%_%COLL_SERVERID%__FGRP_PREV à effectuer.

Si vous n'indiquez pas de valeur pour cette variable, l'agent Microsoft SQL Server effectue 3 tentatives de déplacement du fichier.

Variable permettant de limiter les lignes dans le groupe d'attributs Détail des unités MS SQL

Pour limiter le nombre de lignes extraites par le service de collecte pour le groupe d'attributs Détail des unités MS SQL, utilisez la variable d'environnement COLL_KOQDEVD_MAX_ROW. Cette variable d'environnement définit le nombre maximal de lignes extraites par le service de collecte pour le groupe d'attributs Détail des unités. Si vous n'indiquez pas de valeur pour cette variable, le service de collecteur extrait 10 000 lignes pour le groupe d'attributs Détails des unités. Utilisez cette variable d'environnement pour modifier le nombre maximal par défaut de lignes dans le fichier koqcoll.ctl. Procédez comme suit pour modifier la limite par défaut :

Indiquez le nombre maximal de lignes pour KOQDEVD dans le fichier koqcoll.ctl.
Ajoutez la variable d'environnement COLL_KOQDEVD_MAX_ROW et vérifiez que la valeur de cette variable est identique à celle indiquée dans le fichier koqcoll.ctl.

Si la valeur du fichier koqcoll.ctl est inférieure à la valeur spécifiée dans la variable d'environnement COLL_KOQDEVD_MAX_ROW, la valeur du fichier koqcoll.ctl correspond à la valeur du nombre maximal de lignes.

Si la valeur du fichier koqcoll.ctl est supérieure à la valeur spécifiée dans la variable d'environnement COLL_KOQDEVD_MAX_ROW, la valeur de la variable d'environnement COLL_KOQDEVD_MAX_ROW correspond à la valeur du nombre maximal de lignes.

Variables permettant d'étendre la collecte du groupe d'attributs Détail des unités MS SQL

Pour améliorer la collecte du groupe d'attributs Détails des unités MS SQL, ajoutez les variables d'environnement suivantes :

COLL_KOQDEVD_INTERVAL : cette variable d'environnement vous permet de spécifier un intervalle de temps (en minutes) entre deux collectes consécutives du groupe d'attributs Détails des unités MS SQL.
Remarque : Par défaut, la collecte de données pour le groupe d'attributs Détails des unités est fonction de la demande. Utilisez la variable COLL_KOQDEVD_INTERVAL pour démarrer une collecte basée sur des unités d'exécution pour le groupe d'attributs Détails des unités, ainsi que pour définir les intervalles de temps entre deux collectes basées sur des unités d'exécution.
COLL_DBD_FRENAME_RETRY_CNT : utilisez cette variable d'environnement pour indiquer le nombre de tentatives qui peuvent être effectuées pour déplacer le fichier %COLL_HOME%_tmp_%COLL_VERSION%_%COLL_SERVERID%_%COLL_SERVERID%__DEVD_TEMP vers le fichier %COLL_HOME%_tmp_%COLL_VERSION%_%COLL_SERVERID%_%COLL_SERVERID%__DEVD_PREV.

Si vous n'indiquez pas de valeur pour cette variable, l'agent Microsoft SQL Server effectue 1 tentative de déplacement du fichier.

Variables permettant d'étendre la collecte du groupe d'attributs Détail de base de données de fichiers MS SQL

Pour améliorer la collecte du groupe d'attributs Détails de base de données MS SQL, utilisez les variables d'environnement suivants :

COLL_KOQDBD_INTERVAL : cette variable d'environnement vous permet de spécifier un intervalle de temps (en minutes) entre deux collectes consécutives du groupe d'attributs Détails de la base de données MS SQL. Si vous n'indiquez pas de valeur pour cette variable, l'agent Microsoft SQL Server définit l'intervalle de temps pour la collecte des détails de base de données basée sur des unités d'exécution à 3 minutes.
COLL_DBD_FRENAME_RETRY_CNT : utilisez cette variable d'environnement pour indiquer le nombre de tentatives qui peuvent être effectuées pour déplacer le fichier %COLL_HOME%_tmp_%COLL_VERSION%_%COLL_SERVERID%_%COLL_SERVERID%__DBD_TEMP vers le fichier %COLL_HOME%_tmp_%COLL_VERSION%_%COLL_SERVERID%_%COLL_SERVERID%__DBD_PREV.

Si vous n'indiquez pas de valeur pour cette variable, l'agent Microsoft SQL Server effectue 1 tentative de déplacement du fichier.

Variables permettant d'étendre la collecte du groupe d'attributs Détail de base de données MS SQL

Pour améliorer la collecte du groupe d'attributs Détails d'audit MS SQL, utilisez les variables d'environnement suivantes :

COLL_AUDIT_TYPE : utilisez cette variable pour activer ou désactiver la surveillance de journaux spécifiques. [AL][FL][SL] correspond à la valeur par défaut de la variable. Par défaut, l'agent surveille les trois types de journaux qui comprennent les journaux d'application, les fichiers de contrôle et les journaux de sécurité. La valeur de la variable comprend un code à deux caractères pour chaque type de journal :
- [AL] pour les journaux d'application
- [FL] pour les fichiers de contrôle
- [SL] pour les journaux de sécurité
Vous pouvez modifier la valeur de la variable afin de désactiver la surveillance du type de journal spécifique. Par exemple, si vous indiquez [AL][SL] comme valeur de la variable, les fichiers de contrôle ne sont pas surveillés. Si aucune valeur n'est associée à la variable, les détails de l'audit ne sont pas surveillés.
COLL_AUDIT_DURATION : utilisez cette variable pour signaler les événements d'audit qui se sont produits lors de l'intervalle indiqué dans cette variable. Par exemple, si vous affectez la valeur 7 à cette variable, les événements d'audit que se sont produit au cours des 7 dernières heures sont signalés par le groupe d'attributs Détails de l'audit. La valeur par défaut de la variable COLL_AUDIT_DURATION est 24.
COLL_AUDIT_COLLECTION_INTERVAL: la collecte basée sur des unités d'exécution du groupe d'attributs Détails de l'audit fournit des spécifications relatives à toutes les bases de données présentes dans l'instance de serveur SQL. Utilisez cette variable pour définir l'intervalle de cette collecte basée sur des unités d'exécution. Par exemple, si vous attribuez la valeur 7 à cette variable, un nouvel ensemble de spécifications de base de données est extrait de l'instance SQL Server toutes les 7 heures. La valeur par défaut de la variable COLL_AUDIT_COLLECTION_INTERVAL est 24.

Variable permettant d'étendre la collecte du groupe d'attributs Détails des processus MS SQL

Pour améliorer la collecte du groupe d'attributs Détails des processus MS SQL, utilisez la variable COLL_PROC_BLOCK_INTERVAL avec les valeurs suivantes :

Si COLL_PROC_BLOCK_INTERVAL = 0, la collecte pour les attributs Durée du processus de blocage et Durée de ressource de blocage est désactivée.
Si COLL_PROC_BLOCK_INTERVAL = x, l'intervalle entre deux collectes de données consécutives est de x minutes.

Si la variable COLL_PROC_BLOCK_INTERVAL n'est pas définie dans le répertoire CANDLE_HOME, l'intervalle entre deux collectes de données consécutives est de 3 minutes.

Variable permettant l'exclusion d'objets verrouillés de la collecte de données

Si les requêtes envoyées pour les espaces de travail Détails de base de données, Détails des groupes de fichiers, Fonction miroir de la base de données et Détails des unités mettent du temps pour être exécutées, utilisez la variable COLL_DBCC_NO_LOCK pour exécuter une requête avec la valeur WITH (NOLOCK). Cette variable permet à la requête de ne pas attendre dans la file d'attente lorsqu'un objet sur lequel elle s'exécute est verrouillé.

Variable de définition des critères de tri pour les lignes renvoyées par le groupe d'attributs Détails de la table

Les lignes renvoyées par le groupe d'attributs Détails de la table sont triées par ordre décroissant en fonction de la valeur de la variable COLL_TBLD_SORTBY. La valeur par défaut de la variable COLL_TBLD_SORTBY est FRAG (pourcentage de fragmentation). Les valeurs admises sont ROWS (nombre de lignes dans une table), SPACE (espace utilisé par la table) et OPTSAGE (date des statistiques de l'optimiseur de la table).

Variable permettant d'étendre la collecte des groupes d'attributs Détails des incidents MS SQL et Récapitulatif des incidents MS SQL

COLL_ALERT_SEV : cette variable vous permet de définir le niveau de gravité des messages d'erreur affichés dans les groupes d'attributs Détails des incidents et Récapitulatif des incidents. Les messages d'erreur dont le niveau de gravité est supérieur ou égal à la valeur indiquée dans cette variable s'affichent dans les groupes d'attributs Détails des incidents et Récapitulatif des incidents. Par exemple, si vous affectez la valeur 10 à cette variable, les messages d'erreur dont le niveau de gravité vaut 10 ou plus s'affichent dans les groupes d'attributs Détails des incidents et Récapitulatif des incidents. Si vous n'affectez aucune valeur à cette variable, les messages d'erreur dont le niveau de gravité est supérieur ou égal à 17 s'affichent dans les groupes d'attributs Détails des incidents et Récapitulatif des incidents.
COLL_SINCE_ERRORLOG_RECY : utilisez cette variable pour surveiller uniquement les erreurs dont le niveau de gravité est élevé dans le fichier ERRORLOG. Si vous n'affectez aucune valeur à cette variable, sa valeur sera 0. Cela signifie que lors de la collecte de données, le groupe d'attributs Récapitulatif des incidents prend également en compte les erreurs lues dans le fichier ERRORLOG précédent dont le niveau de gravité est élevé. Pour surveiller uniquement les erreurs dont le niveau de gravité est élevé dans le fichier ERRORLOG en cours, définissez cette variable en indiquant la valeur 1.

Variables de définition de l'intervalle du délai d'attente

Pour définir l'intervalle du délai d'attente pour l'agent Microsoft SQL Server, vous pouvez utiliser les variables d'environnement suivantes :

WAIT_TIMEOUT : utilisez cette variable pour définir le délai d'attente de l'agent Microsoft SQL Server. Si un groupe d'attributs nécessite plus de 45 secondes pour collecter des données, l'agent peut être mis en attente, ou bien certaines situations peuvent se déclencher de manière incorrecte. Vérifiez dans le journal si certains groupes d'attributs nécessitent plus de 45 secondes pour collecter les données, et utilisez la variable WAIT_TIMEOUT pour augmenter le temps d'attente entre le processus de l'agent et celui du collecteur.
COLL_DB_TIMEOUT : utilisez cette variable pour définir le délai d'attente (en secondes) de n'importe quelle demande, comme l'exécution d'une requête sur une connexion de serveur SQL existante à effectuer avant de revenir à l'application. Si vous indiquez la valeur 0, il n'y a pas de délai d'attente. Si vous n'indiquez pas de valeur pour cette variable, l'agent attend 15 secondes avant de revenir à l'application.

Variables permettant de définir les propriétés des fichiers journaux du collecteur

Pour définir les propriétés des fichiers journaux du collecteur, vous pouvez utiliser les variables d'environnement suivantes :

COLL_WRAPLINES : cette variable permet d'indiquer le nombre maximal de lignes dans le fichier col.out. La valeur par défaut de cette variable est 90000 lignes (2 Mo environ).
COLL_NUMOUTBAK : cette variable permet d'indiquer le nombre de copies de sauvegarde des fichiers journaux du collecteur à créer. Par défaut, cinq copies de sauvegarde du fichier journal du collecteur sont créées. Le fichier de sauvegarde s'appelle *.out. Lorsque ce fichier de sauvegarde atteint sa taille maximale, il est renommé *.ou1 et les derniers journaux sont placés dans le fichier *.out. Ainsi, pour cinq fichiers de sauvegarde, les journaux les plus anciens sont disponibles dans le fichier *.ou5 et les journaux les plus récents sont disponibles dans le fichier *.out.
Vous pouvez créer plus de cinq copies de sauvegarde des fichiers journaux du collecteur en indiquant l'une des valeurs suivantes dans la variable COLL_NUMOUTBAK :
- Pour moins de dix fichiers de sauvegarde, indiquez le nombre de fichiers de sauvegarde que vous souhaitez créer dans la variable COLL_NUMOUTBAK. Par exemple, si vous indiquez 9 dans la variable COLL_NUMOUTBAK, neuf fichiers de sauvegarde sont créés.
- Si le nombre de fichiers de sauvegarde est supérieur à 9 et inférieur à 1000, indiquez le nombre de fichiers de sauvegarde précédé par un tiret dans la variable COLL_NUMOUTBAK. Par exemple, si vous indiquez -352 dans la variable COLL_NUMOUTBAK, 352 fichiers de sauvegarde sont créés.
COLL_DEBUG : cette variable vous permet d'activer le traçage complet du collecteur en affectant la valeur dddddddddd (10 fois "d") à cette variable.

Variable de suppression des fichiers temporaires

COLL_TMPFILE_DEL_INTERVAL : cette variable permet d'indiquer l'intervalle (en minutes) au-delà duquel les fichiers temporaires KOQ_<horodatage> doivent être supprimés. Si vous n'indiquez pas de valeur pour cette variable, la valeur de la variable est 0, ce qui signifie que les fichiers temporaires doivent être supprimés immédiatement.

Commentaires en retour