Création ou extension de familles de mesures

Si une famille de mesures prêtes à l'emploi ne répond pas à vos besoins de surveillance, étendez une famille existante ou créez une famille personnalisée. Si une famille de mesures existante répond en partie à vos besoins, étendez-la. Si vous avez besoin d’un nouvel élément, créez une famille de mesures personnalisée. Pour consulter un exemple, reportez-vous à la section .
capm360
HID_Create_or_Extend_Metric_Families
Si une famille de mesures prêtes à l'emploi ne répond pas à vos besoins de surveillance, étendez une famille existante ou créez une famille personnalisée. Si une famille de mesures existante répond en partie à vos besoins, étendez-la. Si vous avez besoin d’un nouvel élément, créez une famille de mesures personnalisée. Pour obtenir un exemple, consultez la section Ajout d’une nouvelle mesure à une famille de mesures existante.
Les procédures suivantes permettent de créer, d'étendre ou de mettre à jour des familles de mesures :
Pour éviter toute perte de données, veillez à sauvegarder le répertoire de certification à chaque fois que vous étendez, créez ou mettez à jour une famille de mesures
.
Création d'un modèle XML de famille de mesures personnalisée
Pour créer une famille de mesures, utilisez une famille de mesures existante pour créer un modèle XML. Dans le cas d'une extension, obtenez le fichier XML de la famille de mesures cible.
Conseil : Pour récupérer le nom de la famille de mesures dans l'interface utilisateur, accédez à la page Familles de mesures. Cliquez sur la flèche vers le bas dans une colonne quelconque, passez le curseur de la souris sur
Colonnes
, puis cliquez sur
Nom interne
.
Procédez comme suit :
  1. Configurez un client REST avec une connexion au serveur Data Aggregator.
  2. Entrez l'URL suivante pour récupérer le modèle de famille de mesures :
    • Nouvelle famille de mesures :
      http://
      nom_hôte_da
      :8581/typecatalog/metricfamilies/
      mf_name
    • Extension :
      http://
      da_hostname
      : 8581/TypeCatalog/metricfamilies/
      mf_name
      mf_name
      spécifie le nom de la famille de mesures du modèle.
  3. Sélectionnez GET dans l'onglet Méthode, puis exécutez la méthode.
    Le client REST renvoie les informations XML pour la famille de mesures.
    Utilisez le fichier XML en tant que modèle pour créer la famille de mesures personnalisée ou étendue.
Modification du fichier XML d'une famille de mesures
Pour appliquer les modifications nécessaires à la famille de mesures, modifiez le fichier XML. Pour des informations complètes sur la structure XML, reportez-vous à la section structure XML de famille de mesures.
Important : Si l'attribut Units n'est pas défini dans le fichier XML, les unités sont désignées au moyen de l'étiquette Units dans les rapports.
Remarque : Lorsque vous étendez une famille de mesures, incluez uniquement les nœuds XML qui doivent être modifiés.
Importation d'une famille de mesures
Sélectionnez l'une des options suivantes pour importer une famille de mesures :
3
Utilisation d'un client REST pour l'importation d'une famille de mesures
Pour importer une famille de mesures, vous pouvez utiliser un client REST.
Procédez comme suit :
  1. Spécifiez l'une des URL suivantes :
    • Famille de mesures personnalisée :
      http://
      da_hostname
      : 8581/TypeCatalog/metricfamilies/
    • Famille de mesures étendue :
      http://
      nom_hôte_da
      :8581/typecatalog/metricfamilies/extension/
      mf_name
  2. Sous l'onglet
    Méthode
    , sélectionnez
    POST
    pour créer une nouvelle famille de mesures personnalisée, ou
    PUT
    pour mettre à jour ou étendre une famille de mesures.
  3. Dans les paramètres de
    corps
    , sélectionnez application/xml comme Body Content-type.
    Si vous ne définissez pas le type de contenu, une erreur 415 est renvoyée
    .
  4. Copiez le fichier XML de la famille de mesures dans l'onglet
    Corps
    .
    Exécutez la méthode.
    Votre famille de mesures personnalisée est importée. En l'absence d'erreur, le champ Status de la section HTTP Response affiche le résultat suivant :
    HTTP/1.1 200 OK
Importation d'une famille de mesures dans l'interface utilisateur
Pour importer une famille de mesures, vous pouvez utiliser l'interface utilisateur.
Procédez comme suit :
  1. Dans le menu
    Configuration de la surveillance
    d'une source de données du Data Aggregator, cliquez sur
    Familles de mesures
    .
    Remarque : Vous pouvez utiliser la fonction Rechercher d'un volet pour localiser des informations spécifiques associées à ce volet. Vous pouvez aussi naviguer entre les pages d'un volet à l'aide des flèches.
  2. Cliquez sur
    Importer
    .
    L'option Importer prend en charge les fichiers ZIP. Par exemple, vous pouvez importer le fichier ZIP téléchargé pour une certification à partir de la page de support Certifications à la demande (en anglais).
  3. Cliquez sur
    Parcourir
    et sélectionnez le fichier de famille de mesures.
  4. Cliquez sur
    Ouvrir
    , puis sur
    Importer
    .
    Votre famille de mesures est importée.
Mise à jour des propriétés de famille de mesures
Pour modifier les attributs, tels que le nom d’affichage, mettez à jour les propriétés de la famille de mesures.
Procédez comme suit :
  1. Spécifiez l’URL suivante :
    • Famille de mesures étendue :
      http://
      nom_hôte_da
      :8581/typecatalog/metricfamilies/extension/
      mf_name
  2. Sous l’onglet
    Méthode
    , sélectionnez
    PUT
    pour mettre à jour ou étendre une famille de mesures.
  3. Dans les paramètres
    Corps
    , sélectionnez
    application/properties
    comme
    Body Content-type
    .
  4. Spécifiez les mises à jour avec une ligne par propriété sous l’onglet
    Corps
    tel qu’illustré dans le modèle et l’exemple suivant.
    Modèle :
    Les variables
    metricfamilyname
    et
    attributename
    dans l’exemple suivant doivent respecter la casse et sont spécifiées en minuscules. La casse de ces variables diffèrent de la casse de leurs valeurs dans le fichier XML. Par exemple,
    NormalizedPortInfo
    dans le fichier XML est
    normalizedportinfo
    et
    PctDiscardsIn
    dans le fichier XML est
    pctdiscardsin
    .
    im.ca.com.normalizer.
    metricfamilyname
    .displayname=DisplayName
    im.ca.com.normalizer.
    metricfamilyname
    .documentation=Documentation text
    im.ca.com.normalizer.
    metricfamilyname
    .attribute.
    attributename
    .attributedisplayname=AttributeDisplayName
    im.ca.com.normalizer.
    metricfamilyname
    .attribute.
    attributename
    .documentation=Documentation text
    Exemple :
    im.ca.com.normalizer.normalizedportinfo.displayname=Interface
    im.ca.com.normalizer.normalizedportinfo.documentation=Defines the identification information, configuration information, and polled metrics for interfaces.
    im.ca.com.normalizer.normalizedportinfo.attribute.pctdiscardsin.attributedisplayname=Percent Discards In
    im.ca.com.normalizer.normalizedportinfo.attribute.pctdiscardsin.documentation=The percentage of the frames (packets) received by the interface that were discarded.
  5. Exécutez la méthode.
Déclenchement de la nouvelle détection
Une fois que vous avez étendu une famille de mesures, les modifications sont appliquées pendant la nuit au cours de la nouvelle détection automatique. Si les modifications ne s'appliquent pas automatiquement, déclenchez manuellement la mise à jour :
Important : Pour éviter tout impact majeur sur les performances, ne déclenchez pas de nouvelle détection pendant les heures de bureau.
Procédez comme suit :
  1. Accédez à la source de données du
    Data Aggregator
    .
  2. Cliquez sur
    Configuration de la surveillance
    ,
    Familles de mesures
    .
  3. Sélectionnez la famille de mesures.
  4. Cliquez sur
    Mettre à jour la famille de mesures
    .
    Data Aggregator détecte à nouveau les composants sur toutes les unités qui prennent en charge la famille de mesures sélectionnée.
Vérification des résultats d'une famille de mesures
Pour vous assurer du bon déroulement des opérations, vérifiez les résultats de l'importation.
Procédez comme suit :
  1. Connectez-vous à l'interface utilisateur, puis accédez à la source de données du Data Aggregator.
  2. Cliquez sur Configuration de la surveillance, Familles de mesures.
  3. Vérifiez que la famille de mesures figure dans la liste et que l'heure de la dernière modification a été mise à jour.