Création d'une métrique personnalisée

Outre l'analyse des métriques de protocole intégrées dans le système ExtraHop, vous pouvez créer vos propres métriques personnalisées pour collecter des informations spécifiques sur votre environnement. La création d'une métrique personnalisée nécessite deux étapes : la spécification des paramètres métriques dans le catalogue de métriques et la création d'un déclencheur pour découvrir, collecter et stocker des données métriques personnalisées. Dans cette rubrique, vous allez apprendre à créer une métrique personnalisée à partir du catalogue de métriques.

1. Connectez-vous au système ExtraHop via https://<extrahop-hostname-or-IP-address>.
2. Cliquez sur l'icône Paramètres système puis cliquez sur Catalogue métrique.
3. Cliquez sur le menu de commandes et sélectionnez Créer une métrique manuellement.
4. Dans le Paramètres section, procédez comme suit pour créer le code qui sera référencé par un déclencheur :
   1. Dans le champ Métrique, saisissez un nom unique pour votre métrique. La méthode de déclencheur qui collecte les données pour votre métrique personnalisée doit faire référence au nom exact de la métrique que vous spécifiez dans le champ Métrique. Évitez les espaces entre les mots en saisissant des traits de soulignement. Lorsque vous définissez le nom d'une métrique détaillée, spécifiez la clé de détail dans le nom en ajoutant le nom de la métrique avec .by_<key_name_without_spaces>, où <key_name_without_spaces> est le nom métrique clé.
      Par exemple, une métrique personnalisée qui collecte le nombre maximum de réponses HTTP par client peut être spécifiée comme max_http_responses.by_client.
   2. Dans le champ Type de source, sélectionnez une source, ou une classe, dans le menu déroulant à partir de laquelle vous souhaitez récupérer les données. Pour plus d'informations sur ces classes, voir Classes à usage général dans la référence de l'API Trigger.
   3. Dans le champ Type de métrique, sélectionnez une option dans le menu déroulant qui indique comment les données seront stockées et affichées dans le système ExtraHop. La sélection du type de métrique apparaît dans les déclencheurs dans le nom de la méthode, par exemple metricAddCount ou metricAddDataset. Pour plus d'informations, voir Types de données ExtraHop dans la référence de l'API Trigger.
   4. Dans le champ Type, sélectionnez l'une des options suivantes :
   • Sélectionnez Métrique de base. Une métrique de base ou de niveau supérieur inclut les types de métriques, le nombre et l'ensemble de données. La sélection Type apparaît dans les déclencheurs dans le nom de la méthode, par exemple metricAddDataset.
   • Sélectionnez Métrique détaillée. Une métrique détaillée se compose de paires clé-valeur, où la clé est une chaîne ou une adresse IP et la valeur est un type de métrique de niveau supérieur tel qu'une métrique de comptage ou d'ensemble de données. La sélection Type apparaît dans les déclencheurs dans le nom de la méthode, par exemple metricAddDetailDataset.

   Important :

   Les sélections effectuées dans la section Paramètres ne peuvent pas être modifiées une fois que vous avez créé la métrique personnalisée.

5. Dans la section Affichage, procédez comme suit pour spécifier les informations métriques qui peuvent être recherchées par les utilisateurs dans le système ExtraHop :
   1. Dans le champ Nom, saisissez un nom d'affichage convivial pour votre métrique qui s'affiche dans les résultats de recherche et les graphiques du système ExtraHop. Vous pouvez inclure des espaces dans le nom d'affichage.
   2. Facultatif : Dans le champ Unités, sélectionnez une option dans le menu déroulant si vous connaissez l'unité de mesure à afficher dans un graphique pour vos données métriques.
   3. Facultatif : Dans le champ Description, saisissez les informations qui s'affichent avec les résultats de recherche pour votre métrique dans le système ExtraHop. La description de la métrique de base personnalisée est automatiquement affichée pour la métrique détaillée dans les résultats de recherche.
   4. Facultatif : (Pour les mesures détaillées uniquement) Dans le champ Étiquette de clé, saisissez un nom d'affichage pour le jeu de clés de votre métrique. Par exemple, vous pouvez créer le libellé de la clé, Agent utilisateur, pour une métrique personnalisée qui collecte les demandes par agent utilisateur HTTP. Les étiquettes des clés n'ont pas besoin d'être uniques.
6. Facultatif : Dans la section Relations détaillées, effectuez l'une des étapes suivantes si vous souhaitez associer une métrique de base personnalisée à une métrique détaillée personnalisée :
   • (Pour les mesures de base) Dans le champ Mesures détaillées, cliquez sur le champ et recherchez une métrique personnalisée que vous souhaitez que les utilisateurs consultent en effectuant une recherche vers le bas à partir de la métrique personnalisée. Vous pouvez laisser ce champ vide si vous ne souhaitez pas fournir de données détaillées pour votre métrique personnalisée.
   • (Pour les mesures détaillées) Dans le champ Métrique de base, sélectionnez une métrique de niveau supérieur dans le menu déroulant que vous souhaitez associer à votre métrique détaillée personnalisée. Vous pouvez laisser ce champ vide si vous ne souhaitez pas associer de mesures supplémentaires à votre métrique personnalisée.
7. Facultatif : Dans la section Relations entre les enregistrements, cliquez sur le menu déroulant TYPE D'ENREGISTREMENT, cliquez sur un ou plusieurs types d'enregistrement, puis cliquez en dehors de la liste. Vous pouvez éventuellement filtrer les résultats de la requête lorsque vous explorez les enregistrements de la métrique personnalisée à l'aide des champs suivants.
   1. Facultatif : Dans la section FILTRE DE SOURCE, cochez la case à côté de la source pour cette métrique personnalisée. Ce filtre demande automatiquement la source à partir de laquelle vous effectuez une exploration vers le bas. Par exemple, si vous cochez une case à côté de Serveur, lorsque vous recherchez des enregistrements pour cette métrique personnalisée à partir d'un serveur Web nommé example-web-sea, un filtre est automatiquement ajouté à votre requête et ne renvoie les résultats que pour les transactions où example-web-sea agit en tant que serveur.
   2. Facultatif : Dans la section FILTRES SUPPLÉMENTAIRES, vous pouvez créer des filtres avancés qui recherchent des enregistrements en fonction des critères spécifiés, ou entrez un expression régulière (regex) pour filtrer les enregistrements pour des mesures détaillées personnalisées.

   Remarque :

   Pour plus d'informations, voir Activer les requêtes d'enregistrement pour les métriques personnalisées.

8. Lorsque vous êtes satisfait des paramètres, cliquez sur Créez. Vos paramètres métriques personnalisés sont ajoutés au système ExtraHop. Les paramètres de l'API REST pour votre métrique apparaissent dans le catalogue des métriques. Vous pouvez désormais rechercher votre métrique et l'ajouter aux graphiques.

   Important :

   Vous devez créer un déclencheur pour découvrir, collecter et stocker des données métriques personnalisées.