Jointure de deux groupes d'attributs

Créez un groupe d'attributs à partir de deux autres groupes d'attributs.

Pourquoi et quand exécuter cette tâche

La jointure de groupes d'attributs est particulièrement utile lorsque l'agent collecte des données de deux types de sources de données différents. Par exemple, l'agent peut collecter les données WMI et PerfMon, ou SNMP et les sources de données de script. Chaque ensemble d'attributs peut s'avérer plus utile lorsqu'il est utilisé conjointement dans une seule vue Tivoli Enterprise Portal.

Par exemple, supposons que vos groupes d'attributs soient définis comme suit :

First_Attribute_Group
	index integer
	trafficRate	integer
	errorCount	integer

Second_Attribute_Group
	index2	integer
	name string
	traffic string

Une des définitions vous fournit des compteurs (comme Perfmon) et l'autre des informations d'identification. Aucun groupe d'attributs ne vous est utile seul. Toutefois, si vous combinez les deux groupes d'attributs à l'aide de l'index pour que les lignes appropriées de chaque groupe concordent, vous disposez alors d'un groupe d'attributs plus puissant. Vous pouvez utiliser le groupe d'attributs combinés pour afficher en même temps le nom, le type et les métriques.

Ce même mécanisme permet d'ajouter des balises aux informations collectées via des groupes d'attributs normaux. Les informations peuvent ensuite être corrélées plus aisément dans un système d'événements en cas de détection d'un incident. Par exemple, une société souhaite gérer tous ses serveurs en collectant des données communes et en utilisant des situations courantes pour surveiller l'état de santé des serveurs. Elle souhaite également être en mesure d'identifier les serveurs à l'aide d'informations supplémentaires indiquant quelle application est en cours d'exécution sur un serveur particulier. D'autre part, la société souhaite contrôler les valeurs utilisées sur chaque serveur, mais ne veut pas créer des agents différents pour chaque application. Pour cela, elle peut créer un groupe d'attributs supplémentaire dans son agent unique, en procédant comme suit :

Application_Information
	application_type 	integer
	application_name	string
	application_group	string

Ce groupe d'attributs est défini sous la forme d'un groupe d'attributs de script qui collecte ses valeurs à partir de la configuration d'agent. Vous pouvez indiquer des valeurs différentes pour chaque instance d'agent et utiliser un seul agent pour gérer tous ses systèmes. Ce groupe d'attributs est ensuite joint à tous les groupes d'attributs source sur lesquels ces informations d'application peuvent être requises. Les informations sont ensuite disponibles dans Tivoli Enterprise Portal, dans les situations, dans les événements et dans les données entreposées.

Lors de la jointure de deux groupes d'attributs, un troisième groupe est créé. Ce groupe d'attributs contient tous les attributs contenus dans les groupes d'attributs source.

Les résultats d'une opération de jointure varient selon le nombre de lignes pris en charge par chaque groupe d'attributs source. Si les deux groupes d'attributs sont définis pour ne renvoyer qu'une seule ligne de données, le groupe d'attributs joint qui en résulte comporte une seule ligne de données. Cette ligne contient tous les attributs des deux groupes d'attributs source.

Tableau 1. Groupe d'attributs source 1 (ligne unique)
Attribut1	Attribut2	Attribut3
16	texte	35

Tableau 2. Groupe d'attributs source 2 (ligne unique)
Attribut4	Attribut5	Attribut6	Attribut7
5001	données supplémentaires	56	35

Tableau 3. Jointure résultante
Attribut1	Attribut2	Attribut3	Attribut4	Attribut5	Attribut6	Attribut7
16	texte	35	5001	données supplémentaires	56	35

Supposons qu'un groupe d'attributs source soit défini pour ne renvoyer qu'une seule ligne (ligne unique), alors que l'autre peut en renvoyer plusieurs (multiligne). Le groupe d'attributs joint qui en résulte contient le même nombre de lignes que le groupe d'attributs source multiligne. Les données du groupe d'attributs à ligne unique s'ajoutent à chaque ligne du groupe d'attributs multiligne.

Tableau 4. Groupe d'attributs source 1 (ligne unique)
Attribut1	Attribut2	Attribut3
16	texte	35

Tableau 5. Groupe d'attributs source 2 (plusieurs lignes)
Attribut4	Attribut5	Attribut6	Attribut7
user1	path1	56	35
user2	path2	27	54
user3	path3	44	32

Tableau 6. Jointure résultante
Attribut1	Attribut2	Attribut3	Attribut4	Attribut5	Attribut6	Attribut7
16	texte	35	user1	path1	56	35
16	texte	35	user2	path2	27	54
16	texte	35	user3	path3	44	32

Enfin, supposons que les deux groupes d'attributs source soient définis pour renvoyer plusieurs lignes. Vous devez identifier un attribut de chaque groupe d'attributs source sur lequel effectuer la jointure. Le groupe d'attributs résultant contient des lignes de données où la valeur de l'attribut du premier groupe d'attributs correspond à la valeur de l'attribut du deuxième groupe.

Tableau 7. Groupe d'attributs source 1 (plusieurs lignes)
Attribut1	Attribut2	Attribut3
16	texte	35
27	texte supplémentaire	54
39	une autre chaîne	66

Tableau 8. Groupe d'attributs source 2 (plusieurs lignes)
Attribut4	Attribut5	Attribut6	Attribut7
user1	path1	56	35
user2	path2	27	54
user3	path3	44	32

Tableau 9. Jointure résultante (jointure sur Attribut3 et Attribut7)
Attribut1	Attribut2	Attribut3	Attribut4	Attribut5	Attribut6	Attribut7
16	texte	35	user1	path1	56	35
27	texte supplémentaire	54	user2	path2	27	54

Agent Builder permet également de joindre des groupes d'attributs utilisateur au groupe d'attributs Disponibilité, si des filtres de disponibilité sont définis dans votre agent. Pour plus d'informations sur les données contenues dans le groupe d'attributs Disponibilité, voir (Noeud de disponibilité).

Vous pouvez créer ce type de groupe d'attributs en appelant le menu de l'arborescence des sources de données en cliquant à l'aide du bouton droit, puis en sélectionnant Joindre des groupes d'attributs.

Procédure

Sur la page Définition de la source de données, cliquez avec le bouton droit de la souris sur l'un des groupes d'attributs à joindre, puis sélectionnez Joindre des groupes d'attributs.
Cette option n'est visible que s'il y a au moins deux groupes d'attributs définis. Un filtre de disponibilité défini compte comme un groupe d'attributs défini.
La page Informations sur le groupe d'attributs s'ouvre.
Figure 1. Page Informations sur le groupe d'attributsFenêtre Informations sur le groupe d'attributs
Dans la zone Informations de jointure, sélectionnez les deux groupes d'attributs à joindre. Effectuez votre choix parmi les groupes disponibles dans les listes Groupe d'attributs Un et Groupe d'attributs Deux.
Pour chaque groupe d'attributs, l'option Génère une ligne de données unique ou l'option Peut générer plusieurs lignes de données est sélectionnée. Cette sélection est verrouillée et dépend de la définition initiale des groupes d'attributs source.
Remarque : Les restrictions suivantes s'appliquent aux jointures de groupes d'attributs :
- Vous ne pouvez pas joindre un groupe d'attributs appartenant à un type de sous-noeud à un groupe d'attributs d'un autre type de sous-noeud.
- Vous ne pouvez joindre un groupe d'attributs d'événement qu'à un groupe d'attributs à ligne unique, non basé sur des événements.
1. Vous devez sélectionner, pour chaque attribut, l'attribut sur lequel effectuer la jointure dans Peut générer plusieurs lignes de données,, sous Attribut sur lequel effectuer la jointure.
Les zones Nom du groupe d'attributs et Aide sont renseignées à l'aide des informations relatives aux groupes d'attributs sélectionnés. Si vous le souhaitez, vous pouvez les modifier.
Cliquez sur OK.

Résultats

Le groupe d'attributs joint que vous avez créé est ajouté à la zone Informations sur le groupe d'attributs de la page Définition de la source de données