Structure XML des familles de mesures

Une famille de mesures utilise une entrée XML pour définir l'ensemble de mesures permettant de collecter et de générer des rapports pour une technologie donnée. Ces mesures sont normalisées afin d'uniformiser la génération de rapports indépendamment du fournisseur (source de données). Les mesures sont nulles lorsque le fournisseur ne fournit aucune valeur. Toutes les vues de rapport basées sur des mesures nulles sont vides.
capm300
HID_Metric_Family_XML_Structure
Une famille de mesures utilise une entrée XML pour définir l'ensemble de mesures permettant de collecter et de générer des rapports pour une technologie donnée. Ces mesures sont normalisées afin d'uniformiser la génération de rapports indépendamment du fournisseur (source de données). Les mesures sont nulles lorsque le fournisseur ne fournit aucune valeur. Toutes les vues de rapport basées sur des mesures nulles sont vides.
Une famille de mesures définit également les attributs capturés lors de la détection, comme le nom de l'élément et l'index. Des règles de détection peuvent également être définies pour rapprocher la mise en correspondance des éléments. Vous incluez une famille de mesures dans un profil de surveillance. L'ensemble de familles de mesures d'un profil de surveillance déterminent les mesures à collecter pour les unités de chaque collection d'unités associée au profil.
Lorsque vous étendez une famille de mesures, ne modifiez aucun attribut ou onglet restreint. 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 :
La famille de mesures fournie en exemple prend en charge la certification de fournisseur pour le circuit virtuel permanent de relais de trame :
Certaines balises sont masquées lorsque vous affichez le fichier XML de familles de mesures 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 xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance namespace="http://im.ca.com/normalizer" xsi:noNamespaceSchemaLocation="IMDBCertificationFacet.xsd">
<Author>Custom</Author>
<Version>1.0</Version>
<FacetType name="frPVCInfo" descriptorClass="com.ca.im.core.datamodel.certs.NormalizedFacetDescriptorImpl">
<Documentation>Frame Relay Permanent Virtual Circuit</Documentation>
<FacetOf namespace="http://im.ca.com/core" name="Item" />
<DisplayName>Frame Relay PVC</DisplayName>
<TableName>FR_PVC_INFO</TableName>
<Protocol>IMDB</Protocol>
<Normalized>true</Normalized>
<ComponentFacets>
<Facet>{http://im.ca.com/inventory}frPVC</Facet>
</ComponentFacets>
<AttributeGroup name="AttributeGroup" external="true" list="true">
<Documentation />
<Attribute name="Indexes" type="ObjectID[]">
<Documentation />
<AttributeDisplayName />
<Polled>false</Polled>
<Baseline>false</Baseline>
<IsDbColumn>false</IsDbColumn>
<Variance>false</Variance>
<StandardDeviation>false</StandardDeviation>
<Minimum>false</Minimum>
<Maximum>false</Maximum>
<WriteOnPoll>false</WriteOnPoll>
<RollupStrategy />
<Percentile>0</Percentile>
</Attribute>
<Attribute name="Names" type="String">
<Documentation>The name of the frame relay circuit</Documentation>
<AttributeDisplayName />
<Polled>false</Polled>
<Baseline>false</Baseline>
<IsDbColumn>false</IsDbColumn>
<Variance>false</Variance>
<StandardDeviation>false</StandardDeviation>
<Minimum>false</Minimum>
<Maximum>false</Maximum>
<WriteOnPoll>false</WriteOnPoll>
<RollupStrategy />
<Percentile>0</Percentile>
</Attribute>
<Attribute name="Description" type="String">
<Documentation>A description for the frame relay circuit</Documentation>
<AttributeDisplayName />
<Polled>false</Polled>
<Baseline>false</Baseline>
<IsDbColumn>false</IsDbColumn>
<Variance>false</Variance>
<StandardDeviation>false</StandardDeviation>
<Minimum>false</Minimum>
<Maximum>false</Maximum>
<WriteOnPoll>false</WriteOnPoll>
<RollupStrategy />
<Percentile>0</Percentile>
</Attribute>
<Attribute name="BECNIn" type="Double">
<Documentation>Backward congestion since the virtual circuit was created</Documentation>
<AttributeDisplayName />
<Polled>true</Polled>
<Baseline>false</Baseline>
<IsDbColumn>true</IsDbColumn>
<Variance>false</Variance>
<StandardDeviation>false</StandardDeviation>
<Minimum>false</Minimum>
<Maximum>false</Maximum>
<WriteOnPoll>false</WriteOnPoll>
<RollupStrategy>Sum</RollupStrategy>
<Percentile>0</Percentile>
</Attribute>
<Attribute name="FECNIn" type="Double">
<Documentation>Forward congestion since the virtual circuit was created</Documentation>
<AttributeDisplayName />
<Polled>true</Polled>
<Baseline>false</Baseline>
<IsDbColumn>true</IsDbColumn>
<Variance>false</Variance>
<StandardDeviation>false</StandardDeviation>
<Minimum>false</Minimum>
<Maximum>false</Maximum>
<WriteOnPoll>false</WriteOnPoll>
<RollupStrategy>Sum</RollupStrategy>
<Percentile>0</Percentile>
</Attribute>
<Attribute name="FramesIn" type="Double">
<Documentation>Frames received since the virtual circuit was created</Documentation>
<AttributeDisplayName />
<Polled>true</Polled>
<Baseline>false</Baseline>
<IsDbColumn>true</IsDbColumn>
<Variance>false</Variance>
<StandardDeviation>false</StandardDeviation>
<Minimum>false</Minimum>
<Maximum>false</Maximum>
<WriteOnPoll>false</WriteOnPoll>
<RollupStrategy>Sum</RollupStrategy>
<Percentile>0</Percentile>
</Attribute>
<Attribute name="FramesOut" type="Double">
<Documentation>Frames sent since the virtual circuit was created</Documentation>
<AttributeDisplayName />
<Polled>true</Polled>
<Baseline>false</Baseline>
<IsDbColumn>true</IsDbColumn>
<Variance>false</Variance>
<StandardDeviation>false</StandardDeviation>
<Minimum>false</Minimum>
<Maximum>false</Maximum>
<WriteOnPoll>false</WriteOnPoll>
<RollupStrategy>Sum</RollupStrategy>
<Percentile>0</Percentile>
</Attribute>
<Attribute name="BytesIn" type="Double">
<Documentation>Bytes received since the virtual circuit was created</Documentation>
<AttributeDisplayName />
<Polled>true</Polled>
<Baseline>false</Baseline>
<IsDbColumn>true</IsDbColumn>
<Variance>false</Variance>
<StandardDeviation>false</StandardDeviation>
<Minimum>false</Minimum>
<Maximum>false</Maximum>
<WriteOnPoll>false</WriteOnPoll>
<RollupStrategy>Sum</RollupStrategy>
<Percentile>0</Percentile>
</Attribute>
<Attribute name="BytesOut" type="Double">
<Documentation>Bytes sent since the virtual circuit was created</Documentation>
<AttributeDisplayName />
<Polled>true</Polled>
<Baseline>false</Baseline>
<IsDbColumn>true</IsDbColumn>
<Variance>false</Variance>
<StandardDeviation>false</StandardDeviation>
<Minimum>false</Minimum>
<Maximum>false</Maximum>
<WriteOnPoll>false</WriteOnPoll>
<RollupStrategy>Sum</RollupStrategy>
<Percentile>0</Percentile>
</Attribute>
</AttributeGroup>
<Attribute name="SourceFacetTypes" cached="true" list="true" persistent="true" type="QName">
<Documentation />
</Attribute>
<Expressions>
<ExpressionGroup destCert="{http://im.ca.com/core}Item">
<Expression destAttr="Name">Names</Expression>
</ExpressionGroup>
<ExpressionGroup destCert="{http://im.ca.com/inventory}DeviceComponent">
<Expression destAttr="IndexList">Indexes</Expression>
</ExpressionGroup>
</Expressions>
</FacetType>
</DataModel>
Propriétés de base
Les propriétés de base de votre famille de mesures personnalisée aident à la distinguer des autres familles de mesures personnalisées que vous avez créées.
Tenez compte des restrictions suivantes lorsque vous déterminez les propriétés de base :
  • Les propriétés FacetType/name, DisplayName et TableName
    doivent être uniques pour chaque famille de mesures.
  • La valeur de la balise Protocol est toujours IMDB.
  • La valeur de la balise Normalized est toujours True.
  • Définissez la propriété FacetType/descriptorClass et toutes les propriétés DataModel
    et FacetOf
    .
La liste suivante décrit en détail les propriétés de mesure de base :
Sauf indication contraire, toutes les entrées dans cette liste peuvent être mises à jour.
  • FacetType/name
    Spécifie le nom de la famille de mesures. Chaque famille de mesures doit être associée à un nom unique qui l'identifie dans le système. Choisissez un nom significatif peu susceptible d'entraîner des conflits avec les noms des futures familles de mesures similaires. Par exemple, définissez un schéma d'attribution de nom qui garantit que les noms de famille de mesures sont uniques.
    Ce nom est uniquement affiché en interne. Pour afficher un nom de famille de mesures dans l'interface utilisateur, utilisez l'élément
    DisplayName
    .
    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 valeur doit être unique dans toutes les familles de mesures.
  • Documentation
    Spécifie la description externe de la famille de mesures. Pour que ces commentaires soient utiles, décrivez le moment et les circonstances de l'ajout ou de la modification de la famille de mesures.
    Valeurs possibles
    : texte brut
    Effet de la mise à jour :
    aucun
    Cette propriété doit apparaître en premier sous
    FacetType/Name
    .
  • FacetOf
    Indique que cette famille de mesures est un élément.
    Valeurs possibles :
    namespace="http://im.ca.com/core" name="Item"
  • DisplayName
    Spécifie le nom de la famille de mesures affiché dans l'interface utilisateur.
    Valeurs possibles
    : texte brut
    Assurez-vous que la propriété DisplayName est unique pour la famille de mesures.
    Effet de la mise à jour :
    remplacement du nom par celui provenant 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
    Cette propriété doit apparaître avant la propriété
    attributeGroup
    .
  • TableName
    Spécifie le nom de la table de base de données utilisée pour stocker les mesures collectées par la famille de mesures.
    Valeurs possibles
    : valeurs alphanumériques en majuscules et trait de soulignement La valeur doit commencer par une lettre. La valeur doit être unique dans toutes les familles de mesures.
    Exemple : PROCESS_STATS
    Effet de la mise à jour :
    stockage des données d'interrogation dans un nouvel ensemble de tables de base de données
    Les anciennes données d'interrogation sont perdues lorsque vous mettez à jour l'élément
    TableName
    et les anciennes vues de rapport sont endommagées.
    Application de la mise à jour
    : immédiate Pour pouvoir créer des vues, un délai de 5 minutes maximum doit s'écouler, au cours duquel
    DX Performance Management
    charge les nouveaux fichiers MIB.
    Actions requises pour l'application des mises à jour
    : vous devez recréer les vues.
  • Protocole
    La valeur de la balise Protocol est toujours IMDB.
  • Normalized
    La valeur de la balise Normalized est toujours True.
  • SupportsDeviceAggregation
    Prend en charge la définition de seuil au niveau de l'unité pour certaines mesures.
    Cet attribut n'est pas pris en charge pour la certification personnalisée ou étendue.
ComponentFacets
La section ComponentsFacets répertorie les facettes créées pendant la détection. La détection identifie les éléments comme des composants d'unité ou crée une relation de hiérarchie entre les éléments.
  • Facet
    Spécifie une facette associée à l'élément de composant pendant la détection de composant.
    Mise à jour possible
    : oui
    Valeurs possibles
    : nom
    QName
    de la facette
    Effet de la mise à jour
    : si la facette de composant est synchronisée avec CA
    NetOps Portal
    , le composant est visible dans CA
    NetOps Portal
    .
    Application de la mise à jour
    : redétection
    Actions requises pour l'application des mises à jour
    : suppression de l'unité et redétection
ItemFacets
ItemFacets est une nouvelle section qui sera probablement modifiée pour prendre en charge des structures de famille de mesures complexes. Son utilisation n'est pas recommandée.
La section
ItemFacets
répertorie les facettes créées pendant la détection qui identifient les éléments comme des unités.
  • Facet
    Spécifie une facette associée à l'élément pendant la détection.
    Mise à jour possible
    : oui
    Valeurs possibles
    : nom
    QName
    de la facette
    Effet de la mise à jour :
    le composant est affiché sur le service REST pour la facette spécifiée. Si la facette de composant est synchronisée avec CA
    NetOps Portal
    , le composant est visible dans CA
    NetOps Portal
    .
    Application de la mise à jour
    : redétection
    Actions requises pour l'application des mises à jour
    : suppression de l'unité et redétection
Exemple :
<ItemFacets>
<Facet>{http://im.ca.com/inventory}Host</Facet>
<Facet>{http://im.ca.com/inventory}Device</Facet>
<Facet>{http://im.ca.com/inventory}ConsolidatedAndDiscoveredMetricFamilyHistory</Facet>
<Facet>{http://im.ca.com/core}Syncable</Facet>
<!-- The IPDomainID attribute will be filled in by discovery -->
<Facet>{http://im.ca.com/core}IPDomainMember</Facet>
</ItemFacets>
AttributeGroup (famille de mesures)
La section AttributeGroup
est une collection d'attributs de détection d'élément et d'attributs de mesures. Les attributs de détection d'élément sont définis pendant la détection (descriptions d'élément, etc.). Les attributs de mesures sont collectés pendant l'interrogation. Les informations suivantes décrivent les éléments utilisés dans la section AttributeGroup
.
Définissez les propriétés AttributeGroup/list et AttributeGroup/external sur True. Ces propriétés indiquent que chaque attribut représente une liste de valeurs obtenue à partir d'une source externe. Personnalisez les éléments XML suivants :
Toutes les entrées dans cette liste peuvent être mises à jour à l'aide de texte brut. La mise à jour n'a aucun impact sur le comportement.
  • AttributeGroup/name
    Indique le nom du groupe d'attributs. Conforme au schéma d'attribution de nom <FacetType/name>Group.
  • Documentation
    (Facultatif) Spécifie la description du groupe d'attributs.
Attributs généraux (famille de mesures)
Les attributs généraux pour toutes les familles de mesures sont les suivants :
Toutes les entrées dans cette liste peuvent être mises à jour. Sauf indication contraire, la mise à jour prend effet immédiatement et aucune action n'est requise pour la déclencher.
  • Attribute/name
    Spécifie le nom unique interne. Pour les mesures, ce nom est également utilisé pour nommer la colonne de base de données.
    Ce nom est uniquement affiché en interne. Pour afficher un nom d'attribut dans l'interface utilisateur, utilisez l'élément AttributeDisplayName
    . Pour modifier la propriété AttributeDisplayName, reportez-vous à la section Création ou extension des familles de mesures et mettez à jour les propriétés des familles de mesures.
    Valeurs possibles :
    valeurs alphanumériques et trait de soulignement.
    Effet de la mise à jour :
    pour les mesures, les valeurs de cet attribut sont stockées dans une nouvelle colonne de base de données correspondant au nom mis à jour. L'utilisateur perd les données historiques collectées pour cette mesure (avec l'ancien nom). Un échec se produit pour les rapports personnalisés qui contiennent cette mesure.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • Attribute/type
    Indique le type de données de l'attribut. Les types de données le plus fréquemment utilisés sont Int, Long String, Double ou ObjectID. La base de données stocke les attributs de mesures en tant que valeurs flottantes. Par conséquent, ces attributs doivent utiliser un type numérique (Double est recommandé). D'autres types sont utilisés pour des attributs d'élément.
    Valeurs possibles
    : Boolean, Int, Long, Double (point flottant), BigInteger, String, DateTime, IPAddress, MACaddress, IPSubnet, OctetString (représentation hexadécimale), ObjectID, ItemID, QName (nom complet)
    Les noms de type ne respectent pas la casse. Par exemple, boolean équivaut à Boolean.
    Effet de la mise à jour :
    aucun pour les mesures. Toutes les mesures sont stockées dans la base de données comme valeurs flottantes. Pour les attributs d'élément, l'unité doit être supprimée et redétectée.
    Application de la mise à jour
    : interrogation suivante pour les mesures. et redétection pour les attributs d'élément.
    Actions requises pour l'application des mises à jour
    : aucune pour les mesures. Pour les attributs d'élément, supprimez l'unité et effectuez une redétection.
  • Documentation
    Affiche la description d'attribut dans l'interface utilisateur. La documentation est également affichée dans des infobulles lorsque vous passez le curseur sur le nom d'attribut.
    Valeurs possibles
    : texte brut
    Effet de la mise à jour :
    affichage de la documentation mise à jour lorsque le curseur est placé sur le nom d'attribut.
    Cette propriété doit être répertoriée en premier sous les propriétés
    Attribute/name
    et
    Attribute/type
    . Cette propriété et la propriété
    AttributeDisplayName
    doivent être répertoriées avant les autres propriétés d'attribut dans le fichier XML.
  • AttributeDisplayName
    Spécifie le nom de l'attribut dans l'interface utilisateur. Pour modifier la propriété AttributeDisplayName, reportez-vous à la section Création ou extension des familles de mesures et mettez à jour les propriétés des familles de mesures.
    Valeurs possibles
    : valeurs alphanumériques, espace et trait de soulignement.
    Effet de la mise à jour :
    la mesure reflète l'élément AttributeDisplayName mis à jour dans les interfaces utilisateur des familles de mesures et les rapports personnalisés.
    Cette propriété et la propriété
    Documentation
    doivent être répertoriées avant les autres propriétés d'attribut dans le fichier XML.
  • AttributeAbbreviation
    Ce paramètre n'est pas pris en charge.
  • Interrogé
    Indique si l'attribut est interrogé. Si cette propriété est définie sur False, elle est accessible uniquement lors de la détection.
    Valeurs possibles
    : true, false
    Effet de la mise à jour :
    si la valeur définie est False, les ID d'objet correspondant à cet attribut ou cette mesure ne sont pas interrogés si aucun(e) autre attribut/mesure interrogé(e) n'utilise cet ID d'objet dans son expression. Si la valeur définie est True, les ID d'objet correspondant à cet attribut/mesure sont interrogés.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • IsDbColumn
    Stocke sa valeur dans la table de base de données. IsDbColumn est utilisé pour des attributs de mesures. Définissez la valeur de l'attribut IsDbColumn sur True lorsque l'élément
    Polled est défini sur True.
    Valeurs possibles
    : true, false
    Effet de la mise à jour :
    si la valeur définie est False, les données pour cet attribut ou cette mesure ne sont pas stockées dans la base de données. Si la valeur définie est True, les données pour cet attribut/mesure sont stockées dans la base de données.
Attributs de détection
Pour la plupart des attributs, seule la valeur récupérée pendant la détection est stockée dans la base de données. Aucun autre traitement ou interrogation, comme l'évaluation d'une référence, n'est effectué.
Les attributs Index et Names doivent exister pour toutes les familles de mesures. L'attribut Descriptions est facultatif.
<Attribute name="Indexes" type="ObjectID[]" />
<Attribute name="Names" type="String" />
<Attribute name="Descriptions" type="String" />
Les familles de mesures prenant en charge l'élément Hierarchy doivent inclure les attributs suivants :
<Attribute name="ItemUniqueIDs" type="String" />
<Attribute name="ParentUniqueIDs" type="String" />
Attributs Polled et Baseline
Les informations suivantes décrivent les éléments d'attribut Polled et Baseline :
Toutes les entrées dans cette liste peuvent être mises à jour.
  • Référence
    Indique si une référence doit être calculée pour cet attribut. Si cet attribut est défini sur True, une définition BaselineList
    correspondante doit exister.
    L'attribut
    Baseline
    requiert que l'attribut
    StandardDeviation
    soit défini sur True.
    Valeurs possibles
    : true, false
    Effet de la mise à jour :
    lorsque la valeur est True, les valeurs de l'attribut Baseline sont calculées.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • Maximum
    Indique si la valeur maximum de cet attribut doit être calculée pendant le cumul et crée une colonne max_ dans la table de base de données. Si RollupStrategy est défini, cet attribut doit également être défini.
    Valeurs possibles
    : true, false
    Effet de la mise à jour :
    lorsque la valeur est True, la valeur maximum est calculée et un champ de génération de rapports est disponible.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • Minimum
    Indique si la valeur minimum de cet attribut doit être calculée pendant le cumul et crée une colonne min_ dans la table de base de données. Si RollupStrategy est défini, cet attribut doit également être défini.
    Valeurs possibles
    : true, false
    Effet de la mise à jour :
    lorsque la valeur est True, la valeur minimum est calculée et un champ de génération de rapports est disponible.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • StandardDeviation
    Indique si l'écart type pour cet attribut doit être calculé pendant le cumul et crée une colonne std_ dans la table de base de données. Si RollupStrategy est défini, cet attribut doit également être défini.
    Valeurs possibles
    : true, false
    Effet de la mise à jour :
    lorsque la valeur est True, la valeur de l'écart type est calculée et un champ de génération de rapports est disponible.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • DeviationFromBaseline
    Cet attribut requiert que l'attribut Baseline soit défini sur true. Il fournit les champs de génération de rapports supplémentaires Référence moyenne et Pourcentage d'écart, qui sont calculés à l'aide des données de référence. Ces champs ne sont pas disponibles pour la génération de vues personnalisées. Aucune modification n'est apportée à la table de base de données.
    Valeurs possibles
    : true, false
    Effet de la mise à jour :
    lorsque la valeur est True, les champs Référence moyenne et Pourcentage d'écart sont disponibles pour le développement de rapport interne.
    Application de la mise à jour
    : immédiate
    Actions requises pour l'application des mises à jour :
    aucune
  • Percentile
    Indique si le 95e centile pour cet attribut doit être calculé pendant le cumul Une colonne pct_ est créée dans la table de base de données. Si RollupStrategy est défini, cet attribut doit également être défini.
    Valeurs possibles :
    0, 95
    Effet de la mise à jour :
    une valeur de 95 fournit un calcul et un champ de génération de rapports du 95e centile. Zéro indique qu'aucun calcul n'est effectué et que le champ de génération de rapports n'est pas disponible.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • Percentile2
    (Facultatif) Spécifie la valeur d'un centile configurable par l'utilisateur.
    Valeurs possibles
    : 0-99
    Effet de la mise à jour
    : une valeur non nulle spécifie le centile à calculer. Zéro indique qu'aucun calcul n'est effectué et que le champ de génération de rapports n'est pas disponible.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • Percentile3
    (Facultatif) Spécifie la valeur d'un centile configurable par l'utilisateur.
    Valeurs possibles
    : 0-99
    Effet de la mise à jour
    : une valeur non nulle spécifie le centile à calculer. Zéro indique qu'aucun calcul n'est effectué et que le champ de génération de rapports n'est pas disponible.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
    Vous ne pouvez pas définir deux centiles sur la même valeur autre que zéro. Vous ne pouvez pas définir Percentile2 ou Percentile3 sur 95.
    Les modifications apportées à
    Percentile2
    et à
    Percentile3
    risquent d'occasionner une discontinuité dans la vue de tendance en fonction de la période.
  • ProjectionPercentile
    (Facultatif) Spécifie le centile pour calculer une prévision de mesure.
    Valeurs possibles
    : 0-99
    Effet de la mise à jour :
    modifie le centile à utiliser pour calculer les prévisions. Zéro indique qu'aucun calcul n'est effectué.
    Les modifications apportées à la propriété
    ProjectionPercentile
    entraînent des prévisions inexactes jusqu'à 90 jours. Lorsque vous modifiez la valeur de
    ProjectionPercentile
    , les valeurs de centile des jours précédant le changement ne sont pas recalculées.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • AggregateToDevice
    Prend en charge la définition de seuil au niveau de l'unité pour certaines mesures.
    Cet attribut n'est pas pris en charge pour la certification personnalisée ou étendue.
  • RollupStrategy
    Spécifie l'opération effectuée à chaque cycle lors du cumul des valeurs interrogées individuellement. Lorsque les attributs Polled
    et IsDbColumn
    sont définis sur true, cet élément est requis.
    Valeurs possibles
    : Sum (somme des compteurs), Avg (moyenne des jauges)
    Effet de la mise à jour :
    la stratégie spécifiée est utilisée pour effectuer les calculs de cumul.
    Application de la mise à jour
    : interrogation suivante
    Actions requises pour l'application des mises à jour :
    aucune
  • Rate
    Fournit le champ de génération de rapports supplémentaire Taux moyen, dont la valeur est calculée en tant que moyenne (valeur de la mesure/durée). Aucune modification n'est apportée à la table de base de données.
    L'attribut Rate est disponible pour la génération de rapports, mais pas pour la surveillance des règles d'événement de profil
    .
    Valeurs possibles
    : true, false
    Effet de la mise à jour :
    fournit le champ Taux moyen pour la génération de rapports.
    Application de la mise à jour
    : immédiate
    Actions requises pour l'application des mises à jour
    : aucune
  • Units
    Spécifie le nom de l'étiquette d'unités utilisée dans les rapports. L'étiquette affichée est traduite selon les paramètres linguistiques du rapport.
    Si cet attribut n'est pas défini, les unités sont identifiées à l'aide de l'étiquette Units dans les rapports.
    Valeurs possibles :
    Percent, Packets, PacketsPerSecond, DiscardedPackets, ErroredPackets, Bits, BitsPerSecond, Bytes, BytesPerSecond, Seconds, Microseconds, Milliseconds, UnixTime, Observations, FramesPerSecond, Frames, RequestsPerSecond, Requests
    Effet de la mise à jour :
    l'étiquette d'unités spécifiée est affichée dans les rapports.
    Application de la mise à jour :
    immédiate.
    Actions requises pour l'application des mises à jour :
    aucune
Exemple d'utilisation des éléments d'attributs Polled et Baseline
<Attribute name="Utilization" type="double">
<AttributeDisplayName>Utilization</AttributeDisplayName>
<IsDbColumn>true</IsDbColumn>
<Baseline>true</Baseline>
<Minimum>true</Minimum>
<Maximum>true</Maximum>
<RollupStrategy>Avg</RollupStrategy>
<StandardDeviation>true</StandardDeviation>
<DeviationFromBaseline>true</DeviationFromBaseline>
<Percentile>95</Percentile>
<Polled>true</Polled>
<Units>Percent</Units>
</Attribute>
Attribut SourceFacetTypes
Un attribut
SourceFacetTypes
est requis pour la détection et doit être défini.
Utilisez les valeurs requises suivantes :
  • Nom : SourceFacetTypes
  • Type : QName
  • Cached : true
  • Persistent : true
  • List : true
Exemple :
<Attribute name="SourceFacetTypes" type="QName" cached="true" persistent="true" list="true" />
Mise à jour possible
: non
Expressions
La section Expressions est composée des balises ExpressionGroup qui sont utilisées pour la détection de composant. Pendant la détection de composant, les valeurs des propriétés d'élément de composant (comme IndexList, Name et Description) sont calculées. Les expressions de certification de fournisseur prenant en charge les expressions de famille de mesures sont utilisées pour ce calcul.
Ne confondez pas la balise ExpressionGroup de la famille de mesures et celle de la certification de fournisseur.
Les balises ExpressionGroup pour les URI DestCert suivants doivent exister :
DestCert
DestAttr
{http://im.ca.com/core}Item
Nom
{http://im.ca.com/core}Item
Description
{http://im.ca.com/inventory} DeviceComponent
IndexList
Toutes les entrées dans cette liste peuvent être mises à jour.
  • ExpressionGroup/name
    (Facultatif) Spécifie le nom du groupe d'expression.
    Valeurs possibles
    : texte brut
    Effet de la mise à jour :
    aucun
  • ExpressionGroup/destCert
    Spécifie la facette de composant qui contient les attributs destAttrs à remplir. Le nom de facette provient généralement de la section ComponentFacets, à l'exception des facettes Item et DeviceComponent.
    Valeurs possibles
    : facettes définies dans la section ComponentFacets, ou la facette Item ou DeviceComponent.
    Effet de la mise à jour :
    modification de l'expression permise destAttr
    Application de la mise à jour
    : lors de la redétection des composants
    Actions requises pour l'application des mises à jour
    : aucune
  • ExpressionGroup/Expression
    Spécifie l'expression pour l'attribut de facette de composant.
    Valeurs possibles
    : toute mesure valide
    Effet de la mise à jour :
    modification de l'expression permise destAttr
    Application de la mise à jour
    : lors de la redétection des composants
    Actions requises pour l'application des mises à jour :
    aucune
  • ExpressionGroup/Expression/destAttr
    Spécifie le nom de l'attribut de facette de composant.
    Valeurs possibles
    : un attribut valide de la facette de composant.
    Effet de la mise à jour :
    modification du nom d'attribut
    Application de la mise à jour
    : lors de la redétection des composants
    Actions requises pour l'application des mises à jour
    : aucune
Hiérarchie
Une hiérarchie, c'est-à-dire une relation parent-enfant, peut être définie entre des éléments de familles de mesures différentes, par exemple : Interface et CBQoS Classmap. Dans les définitions de famille de mesures, l'élément Hierarchy doit être spécifiée dans la famille de mesures enfant avec :
  • Le nom Hierarchy QName dans la section ComponentFacets
  • Les valeurs destAttr des éléments ItemUniqueID et ParentUniqueID dans la section Hierarchy ExpressionGroup
  • Les attributs ItemUniqueIDs et ParentUniqueIDs dans la section AttributeGroup
Les expressions prenant en charge sont définies dans les certifications de fournisseur.
Les balises Hierarchy ExpressionGroup pour les URI DestCert suivants doivent exister :
DestCert
DestAttr
{http://im.ca.com/inventory}Hierarchy
ItemUniqueID
{http://im.ca.com/inventory}Hierarchy
ParentUniqueID
Exemple :
<ComponentFacets>
<Facet>{http://im.ca.com/inventory}QoSClassMap</Facet>
<Facet>{http://im.ca.com/inventory}Hierarchy</Facet>
</ComponentFacets>
<ExpressionGroup name="Hierarchy" destCert="{http://im.ca.com/inventory}Hierarchy">
<Expression destAttr="ItemUniqueID">ItemUniqueIDs</Expression>
<Expression destAttr="ParentUniqueID">ParentUniqueIDs</Expression>
</ExpressionGroup>
<AttributeGroup name="QosCosGroup" list="true" external="true">
<Attribute name="ItemUniqueIDs" type="String" />
<Attribute name="ParentUniqueIDs" type="String" />
...
</AttributeGroup>
BaselineDefinitions
La section BaselineDefinitions
contient les définitions de référence à calculer pour la famille de mesures. Une définition de référence doit être spécifiée pour chaque mesure dans la section AttributeGroup
dont la propriété Baseline
est définie sur true.
Vous pouvez définir deux types de références : référence horaire (requise) et référence quotidienne (facultative). Les références horaires sont utilisées pour le traitement d'événements et pour l'affichage des références dans les rapports. Les références quotidiennes sont utilisées pour l'affichage des références dans les rapports sur des périodes d'un ou plusieurs mois.
Les informations suivantes décrivent les éléments d'attribut Baseline :
  • Nom
    Spécifie le type de définition de référence pour une mesure. Le type est horaire ou quotidien.
    Mise à jour possible
    : non
    Valeurs possibles
    : HourlyBaseline, DailyBaseline
  • ID
    Spécifie une valeur qui n'est plus utilisée. Toutefois, ce champ doit être spécifié sous la forme d'un nombre entier positif et doit être unique pour toutes les définitions de références horaires et quotidiennes de la famille de mesures.
    Mise à jour possible
    : oui
    Valeurs possibles
    : nombre entier unique et positif
    Effet de la mise à jour :
    aucun
  • PerformanceMetric
    Spécifie le nom de la mesure qui respecte la casse pour laquelle la référence est calculée. Définissez les propriétés Polled et Baseline sur true pour l'attribut Metric.
    Mise à jour possible
    : oui
    Valeurs possibles
    : nom de mesure valide (respectant la casse).
    Effet de la mise à jour :
    les calculs de référence sont effectués pour la mesure.
    Application de la mise à jour
    : calcul de référence suivant, horaire ou quotidien
    Actions requises pour l'application des mises à jour :
    aucune
  • Period
    Spécifie le type de calcul de référence, horaire ou quotidien. Spécifiez la valeur 1 Hour pour un nom de référence horaire ou 1 Day pour un nom de référence quotidienne.
    Mise à jour possible
    : oui
    Valeurs possibles
    : 1 Hour, 1 Day
    Effet de la mise à jour :
    les calculs de référence sont effectués toutes les heures ou quotidiennement.
    Application de la mise à jour
    : calcul de référence suivant, horaire ou quotidien
    Actions requises pour l'application des mises à jour
    : aucune
  • ProjectionInterval
    (Facultatif) Spécifie la période de prévision en jours pour la prévision de mesure. Spécifiez cette expression dans DailyBaseline.
    Mise à jour possible
    : oui
    Valeurs possibles :
    0 ou tout nombre entier positif
    Effet de la mise à jour :
    modifie la période pour laquelle le système calcule des valeurs de prévision. Zéro indique qu'aucun calcul n'est effectué.
    Application de la mise à jour :
    au prochain calcul de la référence.
    Actions requises pour l'application des mises à jour :
    PredicitionInterval requiert que ProjectionPercentile soit défini sur une valeur différente de zéro.
  • ProjectionInterval2
    (Facultatif) Définit un deuxième intervalle de prévision. Pour plus d'informations, reportez-vous à la section ProjectionInterval.
  • ProjectionInterval3
    (Facultatif) Définit un troisième intervalle de prévision. Pour plus d'informations, reportez-vous à la section ProjectionInterval.
  • Window
    Spécifie une valeur qui n'est plus utilisée. Toutefois, vous devez spécifier la valeur 30 Days pour les références horaires et 90 Days pour les références quotidiennes.
    Mise à jour possible
    : non
    Valeurs possibles
    : 30 Days, 90 Days
  • StartDate, EndDate, DaysOfWeek
    Spécifient d'autres valeurs qui n'ont plus cours, mais qui doivent être spécifiées comme 0 (zéro).
    Mise à jour possible
    : non
    Valeurs possibles
    : 0
ComponentReconciliation
Les informations suivantes définissent la logique de rapprochement de composant utilisée dans la détection de composant. Ces informations déterminent si le système a déjà détecté ce composant. La logique de rapprochement détermine ensuite si un composant existant doit être mis à jour ou si un composant doit être créé.
Il peut y avoir plusieurs algorithmes d'ordre de traitement par famille de mesures. Si une famille de mesures ne définit pas un algorithme de rapprochement, un algorithme par défaut est appliqué avec l'attribut de correspondance Item.Name.
ItemReconciliation
ItemReconciliation est une nouvelle section qui sera probablement modifiée pour prendre en charge des structures de famille de mesures complexes. Son utilisation n'est pas recommandée.
Les informations suivantes définissent la logique de rapprochement d'élément utilisée dans la détection d'élément. La logique détermine si le système a déjà détecté un élément. Selon les résultats de cette opération, un élément existant est mis à jour ou un nouvel élément est créé. Le rapprochement d'élément est similaire au rapprochement de composant. Toutefois, le rapprochement d'éléments est utilisé pour les éléments qui ne sont pas des composants, comme les hôtes virtuels. Les éléments ItemFacets sont ajoutés à tout nouvel élément ou à tout élément correspondant (si les facettes n'existent pas).
Exemple :
<ItemReconciliation>
<SourceAgentScopedReconciliation>
<MatchAlgorithms>
<ExactMatch>
<MatchAttribute name="{http://im.ca.com/inventory}SourceAgentInfo.SourceAgentIndexes" />
</ExactMatch>
</MatchAlgorithms>
</SourceAgentScopedReconciliation>
<GlobalScopedReconciliation matchDevices="true" />
</ItemReconciliation>
  • SourceAgentScopedReconciliation
    Définit les algorithmes de correspondance utilisés pour le rapprochement des éléments.
    Mise à jour possible
    : oui
    Effet de la mise à jour :
    modification de la logique de rapprochement d'élément
    Application de la mise à jour
    : lors de la redétection
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
  • GlobalScopedReconciliation
    Définit les algorithmes de correspondance utilisés lorsque vous ne pouvez pas rapprocher des éléments pour l'agent source. Les algorithmes GlobalScopedReconciliation sont utilisés pour localiser des éléments créés pour d'autres agents, mais qui correspondent aux nouveaux éléments potentiels. Si la propriété matchDevices est définie sur True, l'algorithme système de correspondance par défaut (intégré, non affiché dans le code XML) ComponentReconciliationInfo est utilisé. L'algorithme de correspondance dépend de l'adresse IP principale et du nom d'hôte de l'unité.
    Mise à jour possible
    : oui
    Effet de la mise à jour :
    modification de la logique de rapprochement d'élément
    Application de la mise à jour
    : lors de la redétection
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur.
MatchAlgorithms
Le rapprochement de composants et le rapprochement d'éléments utilisent des algorithmes de correspondance. Deux algorithmes de correspondance sont pris en charge :
  • ExactMatch
    Tous les attributs spécifiés doivent renvoyer une correspondance pour confirmer que l'élément correspond aux nouvelles données.
  • BestOfMatch
    Les utilisateurs doivent spécifier le plus petit nombre d'attributs correspondants à l'aide de la valeur leastMatchCount. Chaque attribut dispose également d'une propriété clé requise. Si la propriété requise est définie sur True, l'attribut doit renvoyer une correspondance pour être considéré comme une correspondance.
L'algorithme comprend une priorité de correspondance utilisée lorsque plusieurs algorithmes sont fournis à une famille de mesures. L'ordre des algorithmes détermine leur priorité. L'algorithme au début de la liste a la priorité la plus élevée. L'algorithme situé en fin de liste la priorité la plus basse.
Chaque algorithme doit avoir un attribut correspondant au minimum. Lorsque les données renvoient des correspondances à plusieurs éléments avec le même algorithme, l'élément obtenant le plus de correspondances est sélectionné. Lorsque plusieurs éléments renvoient le même nombre de correspondances d'attributs, l'un d'entre eux est sélectionné au hasard.
Exemples : Fonctionnement du rapprochement
Deux algorithmes de correspondance sont fournis pour une famille de mesures : alg1 et alg2. L'algorithme alg1 a une priorité plus élevée que alg2. La famille de mesures comprend trois éléments de composant : 1, 2 et 3. La redétection appliquée à la famille de mesures renvoie trois entrées : A, B et C. Les deux algorithmes sont appliqués pour déterminer la nouvelle entrée, l'entrée modifiée et l'entrée inchangée.
Reconciliation Meta Data New Data Existing Components
<ComponentReconciliation> A 1
<MatchAlgorithms> B 2
<MatchAlgorithm1> C 3
<MatchAttribute name="attr1"/>
<MatchAttribute name="attr2"/>
</MatchAlgorithm1>
<MatchAlgorithm2>
<MatchAttribute name="attr1"/>
<MatchAttribute name="attr3"/>
<MatchAttribute name="attr4"/>
</MatchAlgorithm2>
</MatchAlgorithms>
</ComponentReconciliation>
<MatchAlgorithm1> et <MatchAlgorithm2> peuvent être <ExactMatch> ou <BestOfMatch>. L'ordre des deux algorithmes de correspondance indique que MatchAlgorithm1 a une priorité plus élevée que MatchAlgorithm2.
  • Cas numéro 1 : correspondance unique
    L'entrée A correspond à l'élément 1 et l'élément 1 n'a aucune autre correspondance.
    A -----> 1
    Cet exemple représente le cas le plus simple. Cette correspondance étant unique, la correspondance pour l'algorithme alg1 ou alg2 importe peu. L'entrée A correspond à l'élément 1.
    Un bon algorithme de correspondance renvoie plusieurs correspondances uniques.
  • Cas numéro 2 : une entrée a plusieurs correspondances
    L'entrée A correspond à l'élément 1 selon l'algorithme alg1 et correspond également à l'élément 2 selon l'algorithme alg2.
    ---> 1 (alg1) (1 wins)
    /
    A Since alg1 has higher precedence, item 1 wins the match.
    \
    ---> 2 (alg2)
  • Cas numéro 3 : correspondance de plusieurs entrées au même élément avec des algorithmes différents
    L'entrée A correspond à l'élément 1 selon l'algorithme alg1 et l'entrée B correspond également à l'élément 1 selon l'algorithme alg2.
    A ------> 1 (alg1) (A wins)
    B ------> 1 (alg2)
    L'algorithme alg1 ayant une priorité plus élevée, l'entrée A est sélectionnée.
  • Cas numéro 4 : correspondance de plusieurs entrées au même élément avec le même algorithme, mais un nombre d'attributs correspondants différent
    A et B correspondent à 1 selon l'algorithme alg1.
    A ------> 1 (alg1, # of matched attrs: 2) (A wins)
    B ------> 1 (alg1, # of matched attrs: 1)
    L'entrée A ayant plusieurs attributs correspondants, elle est sélectionnée.
    Si le nombre d'attributs correspondants est identique, l'entrée est aléatoirement sélectionnée et un avertissement est renvoyé.
  • Cas numéro 5 : correspondance mixte 1
    alg1
    A ------------------------------------> 1
    / alg2(match attr count: 3)
    B
    \ alg2(match attr count: 2)
    --------------------------------> 2
    L'entrée A correspond à 1, car la correspondance est établie avec un algorithme de priorité plus élevée.
    L'entrée B correspond à 2, car 1 a renvoyé une correspondance à A.
  • Cas numéro 6 : correspondance mixte 2
    ---------> 3
    / alg1
    A ==> A wins 3 because alg1 has a higher matching precedence
    \ alg2
    ---------> 1
    / alg2
    B ==> B wins 2 because alg1 has a higher matching precedence
    \ alg1
    ---------> 2
    / alg2
    C ==> C has no match because 2 is matched to B and 3 is matched to A
    \ alg2
    ---------> 3
    L'entrée C est considérée comme un nouveau composant. 1 est considéré comme un élément non correspondant.
    La qualité de l'algorithme de correspondance est indiquée par le nombre de correspondances à 1 renvoyées (correspondances uniques) : plus leur nombre est élevé, meilleur est l'algorithme.
    Mise à jour possible
    : oui
    Effet de la mise à jour :
    modification de la logique de rapprochement de composant
    Application de la mise à jour
    : lors de la redétection
    Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur
ReconfigDetectionAttr
Cet élément définit un attribut de famille de mesures utilisé pour la détection des modifications. Vous pouvez activer la détection des modifications sur un profil de surveillance. Data Aggregator interroge cet attribut uniquement pour vérifier si l'unité cible a changé, au lieu d'effectuer une redétection complète. Cette fonctionnalité permet d'améliorer les performances et de réduire le trafic réseau.
  • Mise à jour possible
    : oui
  • Valeurs possibles
    : nom complet de l'attribut de famille de mesures. L'indicateur d'attribut de famille de mesures spécifié doit avoir les indicateurs cached, persistent et external définis sur True.
  • Effet de la mise à jour :
    modification de la détection de reconfiguration de composant
  • Application de la mise à jour :
    après la redétection
  • Actions requises pour l'application des mises à jour
    : mise à jour de la famille de mesures ou modification de la priorité de certification de fournisseur
Balises des familles de mesures personnalisées et étendues
L'utilisation des balises suivantes est limitée dans les familles de mesures personnalisées et étendues :
  • Variance
    La valeur de cette balise doit être false.
  • RollupExpression
    Supprimez cette balise ou n'entrez aucune valeur.
  • La valeur de la balise Normalized est toujours True.