Définition d'indicateurs de chaîne de valeur#

Ajoutez des données d'indicateur à vos chaînes de valeur à l'aide du langage de requête DevOps.

Vous pouvez ajouter des indicateurs de performances à vos chaînes de valeur en appliquant des graphiques à des données intégrées à HCL™ Accelerate. Les données peuvent provenir d'intégrations de plug-in ou d'appels d'API REST provenant de clients externes. Les requêtes DQL (DevOps Query Language) peuvent être définies dans le fichier value\_stream.json joint à une chaîne de valeur ou dans la barre Requête sur la page de la chaîne de valeur. Vous pouvez ajouter des graphiques ou des histogrammes provenant des données à la barre Indicateurs ou à la vue de la liste sur la page Chaînes de valeur.

Remarque : Actuellement, vous pouvez capturer des nombres sur des données de problème provenant de dispositifs de suivi des problèmes tels que Jira.

Pour ajouter des données d'indicateur à une chaîne de valeur, procédez comme suit :

1. Sur la page Chaînes de valeur, cliquez sur , puis sélectionnez Télécharger une mappe de la chaîne de valeur.
2. A l'aide d'un éditeur de texte, ajoutez une définition de metrics au fichier value_stream_name.json. Les propriétés sont définies plus loin dans cette rubrique.
3. Chargez le fichier vers votre chaîne de valeur.

Les propriétés des données d'indicateur sont décrites dans le tableau suivant :

Propriété	Description
name	Nom de requête.
repeatEvery	Définit la fréquence des exécutions de requête.
repeatAt	Option d'heure. Notez qu'elle n'est pas encore utilisée.
metricDefinitionID	La définition d'indicateur servant à recueillir les données.
propriétés	Définit la requête appliquée aux données recueillies. Le champ de propriété peut se composer d'une simple instruction de zone DQL ou d'une matrice d'objets. Lorsqu'elle est définie en tant qu'instruction de champ unique, comme issue.tags ou issue.severity, la requête regroupe, puis compte les valeurs distinctes pour le champ. Lorsqu'elle est définie en tant que matrice d'objets, il est possible d'affecter un nom unique à la requête SQL dans son ensemble.

La chaîne de valeur par défaut donne une définition d'un indicateur. Vous pouvez utiliser l'indicateur Work Item Type comme modèle pour vos indicateurs. Généralement, l'indicateur Work Item Type sert à contenir l'élément de travail ou le type de problème d'un dispositif de suivi des problèmes, comme Jira. Un témoignage, un bogue, une tâche ou un rapport APAR sont des exemples classiques.

 "metrics": [
    {
      "name": "Work Item Type",
      "repeatEvery": "1 minute",
      "repeatAt": null,
      "metricDefinitionId": "WORK_ITEM_TYPE",
      "properties": {
        "query": null,
        "field": "issue.type"
      }
    }
  ],

Exemples#

Dans l'exemple suivant, tous les éléments de travail qui n'ont pas le statut "Fermé" sont regroupés par type, un nombre pour chaque groupe est alors fourni à la collection d'indicateurs.

 "metrics": [
    {
      "name": "Work Item Distribution",
      "repeatEvery": "24 hours",
      "repeatAt": null,
      "metricDefinitionId": "WORK_ITEM_TYPE_COUNT",
      "properties": {
        "query": "issue.status != Closed",
        "field": "issue.type"
      }
    }
  ]

Dans cet exemple, le nombre d'éléments qui correspond à chaque requête dans la matrice est enregistré dans la collection d'indicateurs.

 "metrics": [
    {
      "name": "Work Item Owners",
      "repeatEvery": "24 hours",
      "repeatAt": null,
      "metricDefinitionId": "WORK_ITEM_OWNER",
      "properties": {
        "query": null,
         "field":[
         {
           "name": "My items",     
           "query": "issue.owner = Some Name"
         },
         {
          "name": "Your Items",
          "query": "issue.owner = Amother Name"
         }
        ]
      }
    }
  ]

Sujet parent : Indicateurs de chaîne de valeur