Structure XML de la certification de fournisseur

Une certification de fournisseur utilise une entrée XML pour mapper les données d'unité et de fournisseur vers des mesures de performance ainsi que les données de configuration définies dans une famille de mesures. Le mappage de ces données à partir de diverses sources vers les valeurs de famille de mesures normalisées permet à Data Aggregator de générer un rapport relatif à ces données, quel que soit le fournisseur d'unité.
capm370
HID_Vendor_Cert_XML_Structure
Une certification de fournisseur utilise une entrée XML pour mapper les données d'unité et de fournisseur vers des mesures de performance ainsi que les données de configuration définies dans une famille de mesures. Le mappage de ces données à partir de diverses sources vers les valeurs de famille de mesures normalisées permet à Data Aggregator de générer un rapport relatif à ces données, quel que soit le fournisseur d'unité.
Lorsque vous étendez une certification de fournisseur, ne modifiez pas les attributs, ni les balises restreintes. Pour plus d'informations, consultez la section Balises XML restreintes.
Vous devez répertorier des propriétés dans le fichier XML dans un ordre particulier. Les propriétés incluses dans l'exemple XML et répertoriées dans les descriptions suivantes sont présentées dans l'ordre recommandé.
2
Exemple :
Dans cet exemple, le code XML de la certification de fournisseur personnalisée prend en charge le circuit virtuel permanent de relais de trame (Frame-Relay PVC). L'exemple de famille de mesures personnalisées frPVCInfo, est incluse dans la section ExpressionGroup :
Certaines balises sont masquées lorsque vous affichez le fichier XML de certifications de fournisseur dans un navigateur. C'est pourquoi vous devez copier et coller ce fichier uniquement à partir d'un client REST.
<?xml version="1.0" encoding="UTF-8" ?>
<!-- Auto-generated by the type catalog local manager.-->
<DataModel namespace="http://im.ca.com/certifications/snmp" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="SNMPCertificationFacet.xsd">
<Author>Custom</Author>
<Version>1.0</Version>
<FacetType name="frPVCInfoCustom" descriptorClass="com.ca.im.core.datamodel.certs.CertificationFacetDescriptorImpl">
<Documentation>Frame Relay PVC Vendor Certification</Documentation>
<FacetOf namespace="http://im.ca.com/core" name="Item" />
<DisplayName>Frame Relay PVC Certification</DisplayName>
<MIB>RFC1315-MIB</MIB>
<Protocol>SNMP</Protocol>
<AttributeGroup name="AttributeGroup" external="true" list="true">
<Documentation />
<Attribute name="INDEX" type="ObjectID">
<Documentation />
<Source>1.3.6.1.2.1.10.32.2.1.4</Source>
<IsIndex>true</IsIndex>
<IsKey>false</IsKey>
<NeedsDelta>false</NeedsDelta>
</Attribute>
<Attribute name="frCircuitReceivedBECNs" type="Long">
<Documentation />
<Source>1.3.6.1.2.1.10.32.2.1.5</Source>
<IsIndex>false</IsIndex>
<IsKey>true</IsKey>
<NeedsDelta>true</NeedsDelta>
</Attribute>
<Attribute name="frCircuitSentFrames" type="Long">
<Documentation />
<Source>1.3.6.1.2.1.10.32.2.1.6</Source>
<IsIndex>false</IsIndex>
<IsKey>true</IsKey>
<NeedsDelta>true</NeedsDelta>
</Attribute>
<Attribute name="frCircuitSentOctets" type="Long">
<Documentation />
<Source>1.3.6.1.2.1.10.32.2.1.6</Source>
<IsIndex>false</IsIndex>
<IsKey>true</IsKey>
<NeedsDelta>true</NeedsDelta>
</Attribute>
<Attribute name="frCircuitReceivedFrames" type="Long">
<Documentation />
<Source>1.3.6.1.2.1.10.32.2.1.8</Source>
<IsIndex>false</IsIndex>
<IsKey>true</IsKey>
<NeedsDelta>true</NeedsDelta>
</Attribute>
<Attribute name="frCircuitReceivedOctets" type="Long">
<Documentation />
<Source>1.3.6.1.2.1.10.32.2.1.9</Source>
<IsIndex>false</IsIndex>
<IsKey>true</IsKey>
<NeedsDelta>true</NeedsDelta>
</Attribute>
</AttributeGroup>
<Expressions>
<ExpressionGroup destCert="{http://im.ca.com/normalizer}
frPVCInfo
" name="frPVCInfoDS">
<Expression destAttr="Indexes">INDEX</Expression>
<Expression destAttr="Names">"Frame Relay " + INDEX</Expression>
<Expression destAttr="FECNIn">frCircuitReceivedFECNs</Expression>
<Expression destAttr="BECNIn">frCircuitReceivedBECNs</Expression>
<Expression destAttr="FramesIn">frCircuitReceivedFrames</Expression>
<Expression destAttr="FramesOut">frCircuitSentFrames</Expression>
<Expression destAttr="BytesIn">frCircuitReceivedOctets</Expression>
<Expression destAttr="BytesOut">frCircuitSentOctets</Expression>
</ExpressionGroup>
</Expressions>
</FacetType>
</DataModel>
Propriétés de base
Les propriétés de base de votre certification de fournisseur personnalisée permettent de la distinguer des autres certifications de fournisseur personnalisées que vous avez créées. Ces propriétés indiquent également à partir de quel fournisseur de base de données d'informations de gestion sont collectées les données de mesures.
Tenez compte des restrictions suivantes lorsque vous déterminez les propriétés de base :
  • Les propriétés FacetType/name et FacetType/DisplayName doivent être uniques pour chaque certification de fournisseur.
  • La balise Protocol est SNMP ou EMS.
    • /typecatalog/certifications/snmp
      prend en charge uniquement les certifications SNMP. Seule la valeur SNMP est prise en charge.
    • /typecatalog/certifications/camm
      prend en charge uniquement les certifications CAMM. Seule la valeur EMS est prise en charge.
  • Définissez la propriété FacetType/descriptorClass et toutes les propriétés DataModel et FacetOf, comme dans l'exemple de code XML précédent.
La liste suivante détaille les propriétés de certification de fournisseur de base :
  • FacetType/name
    Identifie de façon univoque une certification de fournisseur.
    Recommandation :
    conforme à <MibName><TableName>Mib.
    Mise à jour possible
    : non
    Valeurs possibles :
    valeurs alphanumériques et trait de soulignement. Les points et les traits d'union ne sont pas permis.
    La section FacetType indique une certification de fournisseur particulière. Le même document XML peut contenir plusieurs sections FacetType lorsque ces certifications de fournisseur contiennent différents aspects de l'unité de fournisseur, comme les statistiques TCP et UDP d'une implémentation MIB-2.
    La section FacetType contient certaines propriétés de base. Par exemple, cette section contient le nom de la MIB du fournisseur, suivi par une ou plusieurs sections AttributeGroup. Ces sections AttributeGroup définissent les attributs que la certification utilise à partir de la MIB. Plusieurs sections ExpressionGroup mappent les attributs des sections AttributeGroup vers les mesures spécifiées dans une famille de mesures.
    Tous les éléments ci-dessous peuvent être mis à jour et prennent en charge le format texte brut.
  • FacetType/Documentation
    Décrit l'objet certifié par la certification de fournisseur.
    Recommandation
    : incluez les informations sur le fournisseur, le nom de la base de données d'informations de gestion et le nom de la table.
    Effet de la mise à jour :
    aucun
    Cette propriété doit apparaître en premier sous
    FacetType/Name
    .
  • FacetType/DisplayName
    Spécifie le nom de la certification de fournisseur tel qu'il est affiché dans
    NetOps Portal
    .
    Recommandation
    : commencez par le nom de fournisseur et incluez les informations de MIB et de fonctionnalité.
    Effet de la mise à jour
    : changement du nom dans l'interface d'administration.
    Application de la mise à jour
    : immédiate
    Actions requises pour l'application des mises à jour
    : actualisation de l'interface utilisateur
    Assurez-vous que la propriété DisplayName est unique pour la certification de fournisseur.
  • FacetType/MIB
    Spécifie le nom de la MIB, que la clause DEFINITIONS définit dans le fichier ASN.1.
    Recommandation :
    conforme à <MibName>.
    Effet de la mise à jour :
    remplacement par la colonne Nom de MIB SNMP dans l'onglet Certification de fournisseur de l'interface d'administration.
    Application de la mise à jour
    : immédiate
    Actions requises pour l'application des mises à jour
    : actualisation de l'interface utilisateur
  • FacetType/Protocol
    La balise Protocol est SNMP ou EMS.
    • /typecatalog/certifications/snmp
      prend en charge uniquement les certifications SNMP. Seule la valeur SNMP est prise en charge.
    • /typecatalog/certifications/camm
      prend en charge uniquement les certifications CAMM. Seule la valeur EMS est prise en charge.
AttributeGroup
L'exemple suivant illustre la section AttributeGroup de votre certification de fournisseur personnalisée. Cette section identifie les attributs (ID d'objet de variable) d'une table particulière dans la base de données MIB de fournisseur, qui sont utilisés pour mapper les données d'unité brutes. Ces données sont mappées vers les mesures de performances et les données de configuration définies dans une famille de mesures.
Définissez la propriété AttributeGroup/list et les propriétés AttributeGroup/external sur true, comme dans l'exemple de code XML précédent. Ces propriétés indiquent que chaque attribut représente une liste de valeurs obtenue à partir d'une source externe (une table de MIB). Les informations suivantes résument les éléments XML à personnaliser.
Tous les éléments ci-dessous peuvent être mis à jour et prennent en charge le format texte brut. La mise à jour n'a pas d'incidence sur les performances.
  • AttributeGroup/name
    Indique le nom du groupe d'attributs.
    Recommandation :
    conforme à <FacetType/name>Group.
  • Documentation
    (Facultatif) Spécifie la description du groupe d'attributs.
    Cette propriété doit apparaître en premier sous
    AttributeGroup/Name
    .
  • UseIndex
    Spécifie le nom de l'attribut à utiliser comme index pour le groupe d'attributs afin d'unir plusieurs tables de MIB.
    Lors de l'utilisation de la prise en charge des tables à MIB multiples, l'ordre AttributeGroup doit correspondre à l'ordre IndexTagList.
    Recommandation
    : définissez la valeur de la propriété AttributeGroup/name.
Les attributs utilisés pour calculer les index et les noms doivent être répertoriés en premier dans la liste des attributs.
Attributs généraux
Les attributs généraux pour toutes les certifications de fournisseur sont les suivants :
Sauf indication contraire, la mise à jour prend effet immédiatement et aucune action n'est requise pour la déclencher. Toutes les entrées dans cette liste peuvent être mises à jour.
  • Attribute/name
    Indique le nom de l'attribut.
    Recommandation
    : spécifiez le nom de variable de MIB, que la clause OBJECT-TYPE définit dans le fichier ASN.1.
    Valeurs possibles :
    valeurs alphanumériques et trait de soulignement. Les points et les traits d'union ne sont pas permis.
    Conséquences de la mise à jour
    : la mise à jour s'applique à toutes les expressions qui référencent cet attribut.
  • Attribute/type
    Spécifie le type de données de l'attribut.
    Recommandation
    : utilisez le type d'attribut qui correspond le mieux au type de variable que la clause SYNTAX définit dans le fichier ASN.1.
    Valeurs possibles
    : Boolean, Int, Long, Double, BigInteger, String, DateTime, IPAddress, MACaddress, IPSubnet, OctetString, ObjectID
    Effet de la mise à jour
    : conversion des données SNMP interrogées vers ce type.
    Application de la mise à jour
    : interrogation suivante
  • Documentation
    (Facultatif) Spécifie la description de l'attribut, qui documente la sémantique (comme l'unité) de la variable de MIB.
    Recommandation
    : utilisez les descriptions extraites du fichier ASN.1 de la MIB.
    Valeurs possibles
    : texte brut
    Effet de la mise à jour :
    aucun
    Cette propriété doit être répertoriée en premier sous les propriétés
    Attribute/name
    et
    Attribute/type
    .
  • IsKey
    (Facultatif) Utilise un indicateur pour indiquer si la variable de MIB sert de clé pour déterminer la prise en charge d'une table. Lorsque vous spécifiez plusieurs champs en tant que clés, l'ensemble des champs sont considérés conjointement comme une clé composée.
    Vous ne pouvez pas utiliser
    IsKey
    et
    VCSupportExpression
    dans la même certification de fournisseur. Les certifications de fournisseur qui contiennent à la fois
    IsKey
    et
    VCSupportExpression
    ne détectent aucun composant.
    Valeur par défaut :
    false
    Recommandation
    : définissez la valeur True s'il s'agit d'un objet MIB clé pour la détection des composants. Si le contenu des attributs MIB est nécessaire pour déterminer la prise en charge, utilisez
    VCSupportExpression
    à la place.
    Valeurs possibles
    : true, false
    Effet de la mise à jour
    : les composants peuvent être associés à une nouvelle certification de fournisseur
    Application de la mise à jour
    : après la redétection des composants
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
  • IsIndex
    (Facultatif) Utilise un indicateur pour indiquer si la variable est un index de la table de MIB.
    Valeur par défaut :
    false
    Recommandation
    : définissez la valeur sur True pour un attribut d'index.
    Valeurs possibles
    : true, false
    Effet de la mise à jour
    : l'indexation des composants peut être modifiée.
    Application de la mise à jour
    : après la redétection des composants
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
  • NeedsDelta
    (Facultatif) Utilise un indicateur pour indiquer qu'un différentiel (stockage de la différence entre l'interrogation actuelle et la dernière interrogation des compteurs) doit être effectué pour la variable de MIB.
    Valeur par défaut :
    false
    Recommandation
    : définissez la valeur sur True si la variable est définie en tant que Counter, Counter32, Counter64 ou TimeTicks dans la MIB.
    Valeurs possibles
    : true, false
    Effet de la mise à jour
    : modification des données interrogées.
    Application de la mise à jour
    : interrogation suivante
    Cet attribut peut uniquement être utilisé lors de l'interrogation. Il ne peut pas être utilisé lors des phases de détection. Par exemple, il ne peut pas être utilisé dans le nom ou la description.
  • Source
    Spécifie l'ID d'objet de l'attribut.
    Recommandation
    : spécifiez l'ID d'objet complet de la variable de MIB que la clause OBJECT-TYPE définit.
    Valeurs possibles
    : nombres séparés par un point. Par exemple : 1.3.6.1.4.1...
    Effet de la mise à jour
    : interrogation des données à partir de l'ID d'objet spécifié.
    Application de la mise à jour
    : interrogation suivante
    Par défaut, l'attribut
    Source
    indique un OID à interroger à partir de l'unité. Ce comportement par défaut est défini à l'aide de
    src='polled'
    . Vous pouvez définir l'attribut
    src='mvel'
    pour qu'il traite une expression MVEL à l'aide de n'importe quel attribut interrogé et non d'un OID. Par exemple, vous pouvez utiliser le paramètre
    src='mvel'
    pour combiner deux OID de 32 bits dans un compteur 64 bits unique. Vous pouvez également utiliser le paramètre
    src='mvel'
    pour interroger un compteur qui n'est pas stocké en tant que type numérique.
    Exemple :
    l'exemple suivant utilise le paramètre
    src='mvel'
    pour combiner deux identificateurs d'objet de 32 bits dans un compteur 64 bits unique :
    <Attribute name="memberbitsout" type="Long">
    <NeedsDelta>true</NeedsDelta>
    <Source
    src='mvel'
    >snmpCounter64(memberbitsoutHi32,memberbitsoutLo32)</Source>
    </Attribute>
    Le paramètre
    src='mvel'
    peut uniquement être utilisé lors de l'interrogation. Il ne peut pas être utilisé lors des phases de détection. Par exemple, il ne peut pas être utilisé dans le nom ou la description.
  • Version
    Version de la certification de fournisseur. Mettre à jour cet attribut lorsque vous mettez à jour la certification. Vous ne pouvez pas diminuer la valeur de version.
    Valeurs possibles
    : point flottant ou nombre décimal. Exemple : 1.0 ou 1.01
  • Author
    Créateur de la certification de fournisseur.
    Valeur par défaut :
    Personnalisé
    Valeurs possibles
    : toute chaîne alphanumérique.
    Effet de la mise à jour
    : l'attribut Author est mis à jour.
  • UsesDynamicIndex
    (Facultatif) Permet d'utiliser les valeurs d'ID d'objet dynamique pour l'interrogation des accords sur les niveaux de service IP.
    Valeur par défaut :
    False
    Valeurs possibles
    :
    true, false
  • IsDynamicDiscoveryAttribute
    (Facultatif) Indique si l'attribut doit ou non être utilisé pour détecter l'index dynamique.
    Si cet attribut n'est pas spécifié, le Data Collector choisit le premier ID d'objet dynamique qu'il rencontre dans le groupe d'attributs. L'unité peut ne pas prendre en charge l'OID choisi par le Data Collector, ce qui peut provoquer l'échec de l'interrogation.
La liste d'attributs spécifie l'ensemble des données qu'une famille de mesures collecte lorsqu'elle est prise en charge par la certification de fournisseur. En général, ces données peuvent être réparties en deux catégories :
  • Les données de configuration du composant d'unité (comme le nom ou les index) qui sont collectées uniquement lors de la détection.
  • Les données de performances qui sont collectées à chaque cycle d'interrogation.
Attributs de données de configuration
Un attribut de nom INDEX et de type ObjectID est mappé vers l'attribut Indexes de la famille de mesures cible. Vous pouvez définir la valeur de la balise Source sur un ID d'objet de variable. Toutefois, vous utilisez généralement l'une des variables répertoriées dans la clause INDEX de la table. Par exemple, considérez ifIndex dans la table des interfaces de MIB-2. Cette variable sert d'index pour les autres variables dans la même table de MIB. De plus, la balise IsIndex (et en général la balise IsKey) de l'attribut est définie sur true.
Dans cet exemple, les attributs comme ifDesc ou ifType fournissent un complément d'informations concernant la configuration d'une interface. Par conséquent, ces attributs sont utiles pour les attributs Names et Description de la famille de mesures cible.
Attributs de données de performances
Ces attributs fournissent les données brutes pour les mesures de performances dans la famille de mesures cible. Tenez compte des remarques suivantes :
  • Vous pouvez directement mapper l'un de ces attributs vers une mesure de performances de famille de mesures.
  • Vous pouvez également utiliser l'attribut dans une expression avec d'autres attributs pour calculer une valeur pour la mesure.
IndexTagList
Pour interroger des attributs à partir de plusieurs tables de MIB, un groupe d'attributs est requis par la table de MIB contenant ces attributs. La liste de balise d'index fournit un mécanisme pour associer deux groupes d'attributs (ou tables de MIB) avec des index différents. Les groupes sont associés de telle manière qu'un élément (ligne) d'une table est associé à un élément correspondant dans une deuxième table.
Les critères ci-dessous s'appliquent à tous les éléments.
  • Toutes les entrées dans cette liste peuvent être mises à jour.
  • La mise à jour modifie l'indexation.
  • La mise à jour prend effet après la redétection des composants.
  • Pour que les mises à jour prennent effet, mettez à jour la famille de mesures ou modifiez la priorité de certification de fournisseur.
  • PrimaryTag
    Référence le groupe d'attributs principal (c'est-à-dire, le groupe qui définit un attribut d'index avec le type ObjectID). La valeur de cet élément doit correspondre à la balise UseIndex du groupe d'attributs pour le groupe principal.
    Valeurs possibles
    : balise UseIndex du groupe d'attributs correspondant au groupe d'attributs principal.
  • IndexTag
    Définit la méthode permettant d'associer des lignes du groupe principal (ou de la table de MIB) à des lignes du groupe secondaire. Cet élément associe les lignes en spécifiant les attributs des deux groupes qui doivent correspondre.
  • IndexTag/Name
    Référence le groupe secondaire (ou la table de MIB). La valeur de cet élément doit correspondre à la balise UseIndex du groupe d'attributs secondaire que vous essayez d'associer au groupe principal.
    Valeurs possibles
    : balise UseIndex du groupe d'attributs secondaire
  • IndexTag/PrimaryKeyExpression
    Spécifie une expression MVEL contenant les attributs du groupe d'attributs principal ou un groupe d'attributs correspondant à l'un des éléments IndexTag défini préalablement. La valeur calculée est mise en correspondance avec l'élément ThisTagKeyExpression. Si une correspondance est renvoyée, les lignes des deux groupes d'attributs (ou des tables de MIB) sont associées. Vous pouvez alors utiliser ces attributs ensemble dans une section Expression accompagnant un élément destAttr (ou une mesure).
    Valeurs possibles
    : expression MVEL valide
  • IndexTag/ThisTagKeyExpression
    Spécifie une expression MVEL contenant des attributs du groupe d'attributs secondaire. La valeur calculée est mise en correspondance avec l'élément PrimaryKeyExpression. Si une correspondance est renvoyée, les lignes des deux groupes (ou des tables de MIB) sont associées. Vous pouvez alors utiliser ces attributs ensemble dans une section Expression accompagnant un élément destAttr (ou une mesure).
    Valeurs possibles
    : expression MVEL valide
ExpressionGroup
L'élément ExpressionGroup mappe des attributs de la manière suivante :
  • A partir de l'élément AttributeGroup (qui définit la méthode pour obtenir une mesure à partir d'une MIB SNMP).
  • Vers les mesures spécifiées dans une famille de mesures (qui définit la méthode de stockage d'un attribut dans la base de données).
Les propriétés
Filter,
VariableGroup, VCSupportExpression, Expression
et
SetExpression
doivent être répertoriées dans cet ordre dans le fichier XML.
Vous pouvez stocker une valeur de MIB dans la base de données, telle qu'elle est reçue à partir de l'unité ou après plusieurs opérations de normalisation. Par exemple, les opérations de normalisation incluent la division ou la multiplication par 1024 pour effectuer la conversion en kilo-octets.
Sauf indication contraire, la mise à jour prend effet immédiatement et aucune action n'est requise pour la déclencher. Toutes les entrées dans cette liste peuvent être mises à jour.
  • ExpressionGroup/destCert
    Spécifie la famille de mesures qui contient les attributs destAttrs à remplir.
    Valeurs possibles
    : toute famille de mesures valide
    Effet de la mise à jour
    : modification de l'expression permise destAttr
  • ExpressionGroup/name
    (Facultatif) Spécifie le nom du groupe d'expression.
    Valeurs possibles
    : texte brut
    Effet de la mise à jour
    : aucun
  • ExpressionGroup/Filter
    (Facultatif) Spécifie les composants détectés. Utilisez le filtre pour limiter le nombre de composants gérés.
    Le filtre de groupe d'expressions n'exclut
    pas
    les composants spécifiés. Il sélectionne les composants spécifiés et exclut ceux qui ne correspondent pas aux critères.
    Valeurs possibles
    : expression MVEL booléenne composée à l'aide d'attributs disponibles
    Effet de la mise à jour
    : modification des composants détectés.
    Application de la mise à jour
    : après la redétection des composants
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
  • VariableGroup
    Définit les variables utilisées dans ExpressionGroup.
    Dans VariableGroup, les variables sont traitées dans l'ordre indiqué.
    Valeurs possibles
    : valeurs calculées pour la certification de fournisseur.
    Effet de la mise à jour
    : modification des composants détectés.
    Application de la mise à jour
    : après la redétection des composants
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
    Les certifications de fournisseur Juniper et Cisco/Standard High Speed Interface incluent la variable UtilizationMaxPercent. Cette variable définit le pourcentage auquel les données doivent être omises pour la mesure d'utilisation. Les données omises conservent l'intégrité des données de cumul de l'interface et engendrent un écart au niveau des vues et des rapports.
  • VCSupportExpression
    (Facultatif) Extrait et calcule les valeurs d'attribut MIB afin de déterminer si le circuit virtuel est pris en charge.
    Vous ne pouvez pas utiliser
    IsKey
    et
    VCSupportExpression
    dans la même certification de fournisseur. Les certifications de fournisseur qui contiennent à la fois
    IsKey
    et
    VCSupportExpression
    ne détectent aucun composant.
    Valeurs possibles
    : expression MVEL booléenne composée à l'aide d'attributs disponibles
    Effet de la mise à jour
    : modification des composants détectés.
    Application de la mise à jour
    : après la redétection des composants
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
  • Expression
    Convertit les valeurs d'attribut de certification de fournisseur en valeurs d'attribut normalisées.
    Valeurs possibles
    : valeur d'attribut normalisée
  • SetExpression
    Convertit des valeurs d'attribut normalisées en valeurs d'attribut de certification de fournisseur.
    Valeurs possibles
    : valeur d'attribut de certification de fournisseur
    Effet de la mise à jour
    : modification des composants détectés.
    Application de la mise à jour
    : après la redétection des composants
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
Exemples de filtres ExpressionGroup
Les filtres limitent les composants d'unité détectés et interrogés par une certification de fournisseur. La détection se produit uniquement si tous les critères du filtre sont remplis. Si l'un des attributs spécifiés dans les critères de filtrage ne peut pas être évalué pour un composant, le composant est détecté, dans la mesure où certains critères n'ont pas pu être évalués. La raison la plus fréquente pour laquelle un attribut ne peut pas être évalué est l'absence de valeur pour cet attribut.
Exemple 1 :
<Filter>(ifType!=24) &amp;&amp; (ifType!=1)</Filter>
DX Performance Management
n'interroge pas le composant d'unité lorsque la valeur ifType est définie sur 1 ou sur 24. Les interfaces sans valeur pour ifType sont détectées et interrogées.
Exemple 2 :
Vous devez utiliser .toString() lors de la comparaison des attributs OctetString, car les éléments OctetString (Chaîne octet) ne sont pas des éléments String (Chaîne).
<Filter> hrStorageType.toString() == "1.3.6.1.2.1.25.2.1.4" &amp;&amp;
hrStorageSize != 0
</Filter>
DX Performance Management
détecte le composant d'unité et l'interroge si le type de stockage est hrStorageFixedDisk (1.3.6.1.2.1.25.2.1.4) et si la taille est définie sur une valeur autre que 0. Toutefois, si un composant n'a aucune valeur pour hrStorageSize, il est détecté. Si ce comportement n'est pas celui recherché, étendez le filtre afin d'utiliser la fonction
isdef
pour vérifier que la valeur de l'attribut est valide.
<Filter> hrStorageType.toString() == "1.3.6.1.2.1.25.2.1.4" &amp;&amp;
isdef (hrStorageSize)
&amp;&amp; hrStorageSize != 0
</Filter>
DX Performance Management
détecte le composant d'unité et l'interroge si son type de stockage est hrStorageFixedDisk et si sa taille est définie sur une valeur autre que 0. Seuls les composants pour lesquels une valeur est spécifiée pour la fonction hrStorageSize sont interrogés.
Exemple 3 :
Vous devez utiliser .toString() lors de la comparaison des attributs OctetString, car les éléments OctetString (Chaîne octet) ne sont pas des éléments String (Chaîne).
<Filter> (rttMonCtrlAdminRttType==9) &amp;&amp;
( !(rttMonCtrlAdminOwner.toString() contains "Network Health") )
</Filter>
DX Performance Management
détecte le composant d'unité et l'interroge si le type rttMonCtrlAdminRttType est 9 et si la chaîne rttMonCtrlAdminOwner.toString ne contient pas l'intégrité du réseau.
Mesures Expression/destAtt
Les informations ci-après décrivent les mesures Expression/destAttr. Vous pouvez mettre à jour toutes les mesures ci-dessous :
Sauf indication contraire, la mise à jour prend effet immédiatement et aucune action n'est requise pour la déclencher.
  • Index
    Spécifie l'utilisation d'attributs de certification de fournisseur de l'attribut ObjectID pour définir l'expression MVEL permettant de fournir la valeur à l'attribut de famille de mesures Indexes.
    Recommandation
    : définissez la valeur sur INDEX.
    Valeurs possibles
    : tous les attributs avec la valeur <IsIndex>true</IsIndex>.
    Effet de la mise à jour
    : l'indexation des composants peut être modifiée.
    Application de la mise à jour
    : après la redétection des composants.
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
  • Noms
    Spécifie l'utilisation d'attributs de certification de fournisseur pour collecter des données de configuration. Ces données de configuration permettent de définir l'expression MVEL pour fournir la valeur de l'attribut Names de la famille de mesures.
    Recommandation
    : incluez toutes les informations nécessaires afin d'identifier une instance de façon univoque.
    Valeurs possibles
    : expression MVEL de chaîne composée à l'aide des attributs disponibles.
    Effet de la mise à jour
    : modification du nom de composant
    Application de la mise à jour
    : après la redétection des composants.
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
  • Descriptions
    (Facultatif) Spécifie l'utilisation d'attributs de certification de fournisseur pour collecter des données de configuration. Ces données de configuration permettent de définir l'expression MVEL pour fournir la valeur de l'attribut Descriptions de la famille de mesures. Seules certaines familles de mesures prennent en charge un attribut Descriptions.
    Recommandation
    : incluez toutes les informations disponibles pour décrire une instance.
    Valeurs possibles
    : expression MVEL de chaîne composée à l'aide des attributs disponibles.
    Effet de la mise à jour
    : modification de la description du composant.
    Application de la mise à jour
    : lors de la redétection des composants
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
  • Other Metrics
    Spécifie l'utilisation d'attributs de certification de fournisseur pour collecter des données de configuration ou de performances. Ces données permettent de définir l'expression MVEL pour fournir la valeur de l'attribut de la famille de mesures.
    Ajout possible
    : oui, si l'attribut destAttr existe dans la famille de mesures.
    Valeurs possibles
    : expression MVEL composée à l'aide d'attributs disponibles pour produire une valeur correspondant au type d'attribut de destination.
    Effet de la mise à jour
    : modification des valeurs interrogées
    Application de la mise à jour
    : interrogation suivante
La famille de mesures affiche des URI (par exemple, {http://im.ca.com/normalizer}
FamilyName
.
AttributeName
), comportant une référence distincte dans ExpressionGroup. La propriété ExpressionGroup/destCert est définie sur l'URI (par exemple, {http://im.ca.com/normalizer}
FamilyName
,
et Expression/destAttr est définie sur
AttributeName
.
Remplacement de vitesse
Les certifications de fournisseur pour les interfaces incluent une variable dans ExpressionGroup qui peut remplacer les valeurs SpeedIn et SpeedOut. Les variables SpeedInOverride et SpeedOutOverride vous permettent de remplacer les valeurs SpeedIn et SpeedOut dans l'interface utilisateur. Exemple d'utilisation des variables de substitution :
<VariableGroup>
<Variable name="SpeedInOverride" providedBy="override"/>
<Variable name="SpeedOutOverride" providedBy="override"/>
<Variable name="RawIfSpeed">ifSpeed</Variable>
<Variable name="CalculatedSpeedIn">
isdef(SpeedInOverride) ? SpeedInOverride : RawIfSpeed
</Variable><Variable name="CalculatedSpeedOut">
isdef(SpeedOutOverride) ? SpeedOutOverride : RawIfSpeed
</Variable>
<Variable name="CalculatedIfInOctets">ifInOctets <= 786432000 ? ifInOctets : null</Variable>
<Variable name="CalculatedIfOutOctets">ifOutOctets <= 786432000 ? ifOutOctets : null</Variable>
</VariableGroup>
HierarchyList
La liste suivant définit le comportement de la hiérarchie.
Les critères ci-dessous s'appliquent à tous les éléments.
  • Toutes les entrées dans cette liste peuvent être mises à jour.
  • La mise à jour modifie la construction de la hiérarchie.
  • La mise à jour prend effet après la redétection des composants.
  • Pour que les mises à jour prennent effet, mettez à jour la famille de mesures ou modifiez la priorité de certification de fournisseur.
  • Hierarchy/ParentFacet
    Spécifie l'élément QName de la facette utilisée pour rechercher les éléments parent de candidat.
    Valeurs possibles
    : toute facette valide
  • Hierarchy/ParentAttribute
    Spécifie l'élément QName de l'attribut utilisé pour identifier l'élément parent spécifique.
    Valeurs possibles
    : tout élément QName d'attribut valide
  • Hierarchy/ChildAttribute
    Spécifie l'élément QName de l'attribut sur l'élément enfant utilisé pour la correspondance à l'attribut ParentAttribute sur l'élément parent.
    Valeurs possibles
    : tout élément QName d'attribut valide