Enrichissement d'intervalle

À propos de l'enrichissement d'intervalle

Permettre aux utilisateurs d'enrichir les intervalles avec des attributs personnalisés ou de modifier, de combiner ou de supprimer des données d'attributs existants.
Les opérations d'enrichissement sont définies au moyen de règles d'intervalle qui contiennent une ou plusieurs actions à appliquer dans un ordre particulier sur un intervalle donné.
Il existe deux types de règles d'intervalle : Personnalisé et Fourni par Oracle.
L'enrichissement de l'intervalle est configuré au niveau du domaine APM.

Exemples d'enrichissement d'intervalle :

Suppression des renseignements personnels identifiables (PII) des intervalles.
Combinez les données de plusieurs attributs en un seul.
Extraire les données à partir d'un attribut. Par exemple, un chemin partiel à partir d'une URL plus longue.
Appliquer des fonctions mathématiques aux données. Par exemple, convertissez une unité de secondes en millisecondes.
Mapper une valeur d'attribut à une nouvelle valeur. Par exemple, mappez la valeur '1' à la couleur 'bleu', valeur '2' à la couleur 'rouge'.
Répartir les valeurs numériques en intervalles. Par exemple, un intervalle de valeurs de température mappé dans des seaux 'froid', 'chaud' et 'chaud'.

Sujets :

Utilisation de l'enrichissement d'intervalle

L'enrichissement d'intervalle est configuré au moyen de règles d'intervalle qui fonctionnent sur un intervalle et sont utilisées pour modifier les attributs de l'intervalle. La boîte à outils Règles d'intervalle fournit une variété d'actions pouvant être effectuées dans le cadre d'une règle.

Les règles d'intervalle sont gérées au sein des groupes. Un groupe est un ensemble de règles appliquées dans un ordre particulier. Chaque règle peut appliquer une ou plusieurs actions sur un intervalle et la sortie de chaque règle peut être utilisée comme entrée pour les règles de suivi. Les groupes de règles nécessitent un filtre d'intervalle utilisé pour sélectionner les intervalles auxquels appliquer les règles.

Plusieurs groupes peuvent être définis. Cela est utile lorsque vous devez tenir à jour différents types de règles pour différents types d'intervalles car il crée des entités logiques avec des fonctionnalités conçues pour un usage spécifique. Cela réduit la complexité globale de votre jeu de règles.

Si plusieurs groupes ont des filtres d'intervalle qui correspondent au même intervalle, ils appliqueront tous leurs règles à cet intervalle. L'ordre dans lequel cela est effectué est déterminé par l'ordre alphabétique des noms de groupe. Gardez cela à l'esprit lorsque vous nommez ou renommez vos groupes. Oracle recommande d'utiliser un préfixe numérique pour éviter que les noms de groupe ne soient triés par ordre alphabétique. Par exemple, "1. Supprimer les données d'emplacement", "2. Convertir les unités de longueur ".

Gardez à l'esprit que lorsque plusieurs groupes fonctionnent sur le même intervalle, cela signifie que chaque groupe fonctionne sur une version de l'intervalle qui peut avoir été modifiée par un groupe précédent de la chaîne. Cela peut être utile, car vous pouvez écrire des règles dans des groupes de suivi qui s'appuient sur des modifications créées par des groupes précédents. En revanche, elle peut également entraîner l'échec des règles de suivi si un attribut sur lequel repose une règle, est supprimé ou modifié par un groupe précédent.

Note

Ce qui précède n'est important que lorsqu'un intervalle correspond à plus d'un groupe.

Si vos groupes ont clairement des filtres disjoints, un intervalle sera toujours modifié par un seul groupe et les considérations ci-dessus ne seront plus pertinentes.

Attributs dans les événements d'intervalle

Les intervalles peuvent contenir une liste d'événements également appelés messages de journal. Ils sont généralement utilisés pour stocker des informations sur les moments importants pendant l'exécution de l'intervalle. Par exemple, si un intervalle décrit une interrogation de base de données, des événements peuvent être générés pour marquer le moment où la connexion a été ouverte, le moment où la demande d'interrogation a été réellement soumise et le moment où la réponse a été reçue.

Un événement est identifié par name, timestamp et un jeu de attributes (paires clé-valeur) qui fournissent un contexte supplémentaire pour les informations enregistrées.

Toutes les actions de règle d'intervalle décrites ci-dessous, qui nécessitent un attribut en entrée ou en sortie, peuvent également être appliquées aux attributs d'événements individuels. Comme les attributs d'événement sont indépendants des attributs d'intervalle standard, vous devez utiliser la syntaxe event reference suivante pour identifier l'attribut d'événement approprié :

event['NameOfEvent']:'NameOfAttribute'.

Note

Les attributs d'événement ne peuvent pas être utilisés en tant que filtres d'intervalle.

Créer et gérer des règles d'intervalle

Vous pouvez créer et gérer des règles d'intervalle en fonction de vos besoins en matière de production de rapports.

Pour créer des règles d'intervalle pour un domaine APM donné, procédez de la façon suivante :

Allez à la page domaines APM et cliquez sur le domaine APM souhaité.

La page Détails du domaine est affichée.
Allez à Ressources, en bas à gauche, et cliquez sur Enrichissement d'intervalle.

Le volet Enrichissement d'intervalle s'affiche.
Cliquez sur Créer un groupe pour créer un nouveau groupe de règles d'intervalle.
Le volet Créer un groupe de règles d'intervalle s'affiche.
- Entrez le nom du nouveau groupe.
- Sélectionnez un filtre d'intervalle à utiliser avec ce groupe.
- Facultativement, fournissez une description du nouveau groupe.
- Cliquez sur Suivant pour passer au volet Actions de règle pour commencer à ajouter des règles d'intervalle au nouveau groupe en fonction du type de règle d'intervalle : Règle d'intervalle personnalisée ou Règle d'intervalle fournie par Oracle.
- Entrez le nom de la règle.
- Facultativement, sélectionnez un filtre d'intervalle de règles pour restreindre davantage la portée de l'opération de la règle.
  
  Note
  
  Les filtres d'intervalle sont créés séparément. Pour plus de détails, voir Filtres d'intervalle.
- Facultativement, fournissez une description de la règle.
- Sélectionnez un type de règle d'intervalle.
  - Si vous sélectionnez Règle d'intervalle fournie par Oracle, une liste de règles vous est proposée.
    
    Les règles ont déjà été créées par Oracle pour aider les utilisateurs. La liste comprend les éléments suivants :
    Ajoute l'adresse IP du client à un intervalle.
    Elle ajoute l'adresse IP du client à un intervalle en tant qu'attribut nommé ClientIP.
    
    Suite EBS.
    Il fournit le modèle E-Business Suite.
    
    Conversion d'attribution de nom OpenTelemetry à APM.
    Il convertit les noms d'attribut d'intervalle de la convention d'attribution de nom OpenTelemetry à la convention d'attribution de nom APM. Pour plus d'informations sur l'utilisation de OpenTelemetry avec APM, voir Configurer les sources de données OpenTelemetry.
    Cliquez sur une règle dans la liste pour l'ajouter au groupe.
    
    Note
    
    Vous ne pouvez pas configurer d'actions car elles sont gérées à l'interne par la règle elle-même. De plus, vous ne pouvez pas voir les actions pour une règle fournie par Oracle.
  - Si vous choisissez de créer une règle d'intervalle personnalisée, vous devez définir une ou plusieurs actions pour celle-ci. (Une règle contient toujours au moins une action).
    Avant de choisir une action, vous devez sélectionner une cible d'action et un type d'action.
    
    La cible de l'action spécifie la partie de l'intervalle sur lequel l'action fonctionne. Deux cibles sont disponibles :
    
    Entité : Ciblez l'ensemble de l'intervalle.
    
    Attribut : Ciblez un seul attribut.
    
    Le type d'action indique le type. Il est principalement utilisé pour regrouper des actions logiquement. Par exemple, chaîne ou numérique.
    
    Sélectionnez maintenant l'action appropriée dans la liste déroulante Actions disponibles.
    Étant donné que les actions ont différents contextes, la fenêtre change en conséquence pour chaque type d'action. Pour plus de détails sur les actions, voir Utilisation des actions.
    Pour plus d'informations sur les actions disponibles pour Cible de l'action et Type d'action, voir Actions disponibles.
    Utilisez le bouton Ajouter une action pour ajouter d'autres actions à la règle.
    
    Utilisez le menu d'actions à entreprendre en haut à droite de chaque action pour la déplacer vers le haut ou vers le bas dans l'ordre des règles ou pour supprimer une action.

Utilisation des actions

Les actions dont la cible est Attribut exigent toujours que vous indiquiez le nom de l'attribut dont la valeur sera utilisée comme entrée pour l'action. La fenêtre de configuration de chaque action fait référence à Input Attribute.

Certaines actions nécessitent également que vous indiquiez le nom d'un attribut dans lequel stocker le résultat de l'opération. Cela est appelé Output Attribute. Si l'attribut existe dans l'intervalle, toute valeur qu'il contient à ce moment-là sera remplacée par le résultat de l'action. S'il n'existe pas encore, il sera ajouté à l'intervalle avec la nouvelle valeur. Vous pouvez utiliser ce mécanisme pour remplacer la valeur de n'importe quel attribut de l'intervalle (même l'attribut d'entrée) par le résultat de l'opération de l'action.

Vous pouvez ainsi alimenter les résultats de toute action en une action de suivi (ou même une règle dans le même groupe de règles).

Vous pouvez également l'utiliser pour stocker des valeurs dans des attributs temporaires qui peuvent être utilisés par des règles ou des actions de suivi, mais sans avoir à les conserver dans le résultat final. Veillez simplement à supprimer les attributs temporaires en tant que dernière étape à l'aide de l'action Supprimer l'attribut.

Note

Une action Bloquer rejette l'intervalle et vous ne pouvez pas l'utiliser plus tard, même à partir d'un autre groupe de règles.

Actions disponibles

Cible	Type d'action	Actions disponibles
Entité	Transfert Actions qui contrôlent si la totalité de l'intervalle est passée ou bloquée. Les intervalles bloqués sont rejetés du pipeline de traitement. Les intervalles rejetés ne seront plus traités par APM, ne seront stockés nulle part et ne seront pas disponibles pour consultation plus tard dans d'autres outils ou tableaux de bord APM.	Bloquer : Bloque cet intervalle sans condition. Aucune action et règle de suivi ne lui sera appliquée et l'intervalle ne sera plus disponible dans les outils et produits APM OCI. Échantillon : Les intervalles d'échantillons (acceptent) sont basés sur un pourcentage d'échantillon. Par exemple, un pourcentage d'échantillon de 25 % acceptera (en général) 25 % de tous les intervalles et bloquera le reste. Les intervalles bloqués ici sont traités comme des intervalles bloqués par l'action Bloquer.
Attribut	Chaîne Actions permettant diverses opérations sur la valeur d'un attribut qui est une chaîne. Par exemple, modifier la casse, remplacer une valeur ou extraire une partie de la chaîne.	Ajouter : Ajoute une chaîne statique à la valeur d'un attribut à l'aide d'une chaîne de séparation facultative. Concaténer : Concatène deux valeurs d'attribut. Vous pouvez fournir une chaîne de séparation facultative sur laquelle les valeurs seront jointes. Le résultat est retourné en tant que nouvel attribut. Extraire : Extrait une partie de la valeur d'un attribut en fonction d'une expression rationnelle. Le résultat est retourné en tant que nouvel attribut. L'expression rationnelle doit contenir un opérateur de groupe de capture qui identifie la partie de la chaîne à capturer. Si l'expression rationnelle ne correspond pas ou qu'il n'y a pas de groupe de saisie, l'action ne produira aucune sortie. Vous pouvez éventuellement fournir une valeur de secours, qui sera utilisée comme sortie de l'action si l'extraction elle-même n'a produit aucun résultat. Casse minuscule : Convertit la valeur d'un attribut en minuscules. Rechercher et remplacer : Remplace une ou plusieurs parties de la valeur d'un attribut à l'aide d'une expression rationnelle. La chaîne modifiée est retournée en tant que nouvel attribut. L'expression rationnelle peut contenir un groupe de saisie. Sans groupe de capture, le contenu complet de ce qui correspond à l'expression sera remplacé. Lorsqu'un groupe Capture est présent, seul le contenu capturé par le groupe est remplacé. L'occurrence de correspondance facultative peut être utilisée si seule une occurrence spécifique d'une correspondance doit être remplacée. Si ce paramètre n'est pas défini ou réglé à 0, toutes les occurrences correspondantes seront remplacées. Il s'agit du comportement par défaut. Supprimer : Trie tous les espaces de début et de fin de la valeur d'un attribut. Majuscules : Convertit la valeur d'un attribut en majuscules.
Attribut	Numérique Actions permettant diverses opérations mathématiques sur les valeurs d'attribut (à condition qu'il s'agisse de nombres). Les actions numériques prennent en charge à la fois les nombres réels et les nombres représentés en tant que chaînes dans la valeur d'attribut, c'est-à-dire que les deux suivants sont équivalents : " montant " : 2,5 " montant " : " 2,5 " Les actions numériques peuvent prendre comme entrée soit une chaîne représentant le nom d'un attribut dont la valeur doit être utilisée dans l'opération, soit un nombre qui sera utilisé directement dans le calcul. Toutes les actions numériques ont une option dans laquelle vous pouvez appliquer un arrondissement à la valeur de sortie. L'arrondissement peut être l'un des suivants : Arrondissement : Arrondit le nombre au nombre entier supérieur ou inférieur le plus proche. Fractionnement : Arrondit le nombre au nombre entier inférieur le plus proche. Câble : Arrondit le nombre au nombre entier supérieur le plus proche. Aucun arrondissement : Option par défaut.	Absolute : Retourne la valeur absolue de la valeur d'entrée. Ajouter : Additionne deux valeurs. Sépartir : Mappe une valeur d'attribut numérique dans les noms de seau. Si la valeur d'attribut se situe dans l'intervalle d'un seau, le nom du seau est retourné. Si aucun seau ne correspond, une valeur de secours est retournée. Diviser : Divise la première par la deuxième valeur. Si la deuxième valeur est 0, le résultat sera 0. Maximum : Retourne le maximum des deux valeurs. Minimum : Retourne le minimum des deux valeurs. Multiplier : Multiplie les deux valeurs. Néger : Négocie (modifie le signe) de la valeur. Soustraire : Soustrait le deuxième du premier attribut.
Attribut	Générique Les actions génériques fournissent des opérations au niveau de l'attribut, telles que la suppression d'un attribut de l'intervalle.	Mapper la valeur de l'attribut : Prend la valeur d'un attribut et le mappe à une nouvelle valeur. Supprimer l'attribut : Supprime l'attribut de l'intervalle. Si l'attribut est une référence de nom d'événement, `event['EventName']`, l'ensemble de l'événement d'intervalle sera supprimé. Renommer un attribut : Renomme l'attribut. Définir l'attribut : Définit un attribut à une valeur statique. Si l'attribut n'existe pas, il est ajouté, sinon la nouvelle valeur lui est affectée, en remplaçant la valeur existante.

Exemples de configuration d'actions

La présente section donne des exemples des étapes de configuration requises pour certaines actions individuelles.

Exemple d'étalement :
Cette action utilise un mini-éditeur pour configurer un certain nombre de seaux et leurs valeurs de seuil. Vous pouvez utiliser le contrôle sur la droite pour créer, mettre à jour et supprimer des seaux.

Les tranches sont automatiquement ordonnées en fonction de leurs valeurs de seuil. Une valeur de secours est utilisée lorsqu'une valeur est trop grande pour le dernier seau. L'image suivante présente un exemple avec cinq seaux et une valeur de secours :
Exemple de mappage :
Cette action utilise un mini-éditeur pour configurer la carte des paires valeur d'entrée/sortie. Les deux valeurs peuvent être des nombres ou des chaînes. Utilisez le contrôle de droite pour créer, mettre à jour et/ou supprimer un mappage.
Le bouton Exporter vous permet de télécharger tous les mappages vers un fichier (au format CSV) sur votre ordinateur.
Le bouton Importer vous permet d'alimenter les mappages à partir d'un fichier CSV sur votre ordinateur. Cela est particulièrement utile si vous avez un grand nombre de mappages.

Validation des règles d'enrichissement d'intervalle

Les configurations d'enrichissement d'intervalle peuvent être complexes à écrire et il peut parfois être difficile de savoir à l'avance si une règle ou un groupe de règles fonctionnera comme prévu. Pour ce faire, l'éditeur de configuration d'enrichissement d'intervalle fournit une option permettant de tester une règle ou un groupe de règles sur un exemple d'intervalle avant de l'enregistrer.

Pour utiliser l'option de test, procédez comme suit :

Sélectionnez un groupe, puis cliquez sur Modifier pour ouvrir le panneau Modifier le groupe de règles d'intervalle. Une autre façon consiste à créer un groupe et à afficher le panneau Modifier.
Cliquez jusqu'à l'étape Configurer les actions de règle.
Cliquez sur Tester pour tester l'ensemble du groupe de règles. Sinon, pour tester une règle individuelle, sélectionnez-la et cliquez sur Tester la règle.
Note

La règle de test n'est pas disponible lorsque le groupe de règles ne contient qu'une seule règle.
Le panneau Tester le groupe de règles d'intervalle s'affiche.
Les règles à tester seront affichées avec une case à cocher à côté d'elles. Vous pouvez les activer ou les désactiver selon vos besoins.
Entrez un exemple d'intervalle dans la zone de texte Exemple d'intervalle.
Cliquez sur Tester l'intervalle pour effectuer un test des règles sélectionnées sur l'intervalle indiqué.

Figure 9-1 Validation de la règle d'enrichissement d'intervalle

Validation de règle d'enrichissement d'intervalle

L'exécution du test indique si l'intervalle correspond ou non aux filtres d'intervalle configurés.

Si les filtres correspondent, les règles seront appliquées à l'intervalle et les différences résultantes (le cas échéant) seront affichées dans le tableau ci-dessous. Tous les attributs ajoutés à la suite de la règle seront mis en surbrillance en vert. Les attributs supprimés seront mis en surbrillance en rouge. Les attributs modifiés seront mis en surbrillance en jaune.

Explorateur de trace : Pour obtenir des exemples précis d'intervalles à partir de votre trafic, cliquez sur Explorateur de trace situé en haut à droite pour ouvrir l'explorateur de trace et voir les intervalles réels qui ont été traités. Vous pouvez sélectionner un intervalle, ouvrir le menu contextuel à droite (trois points verticaux) et cliquer sur Copier les données de l'intervalle racine.

Une fenêtre contextuelle s'affiche avec le contenu de l'intervalle. Vous pouvez copier les données d'intervalle et les utiliser lors des tests.

Une autre option consiste à coller vos propres intervalles ou à les entrer manuellement, à condition qu'ils soient conformes au format d'intervalle indiqué par l'explorateur de trace.

Alias de propriété d'intervalle

Note

Peu de propriétés d'intervalle réelles sont référencées par un nom différent lorsqu'elles sont utilisées dans les fonctions Enrichissement d'intervalle ou Filtres d'intervalle. En dehors de la différence visuelle, cela n'a aucune incidence sur la façon dont vous configurez vos règles et filtres. Par exemple, vous devez toujours utiliser l'alias pour faire référence à la propriété indiquée.

Voici les propriétés qui ont actuellement un alias :

Propriété d'intervalle	Alias d'enrichissement d'intervalle	Commentaires
`td-micros`	`SpanDuration`	`td-micros` est en microsecondes, alors que `SpanDuration` est en millisecondes. La conversion d'unité de temps est appliquée automatiquement par l'enrichissement d'intervalle et les filtres d'intervalle.
`name`	`OperationName`	Le nom de l'intervalle représente l'opération effectuée
`ts-micros`	`StartTime`	`ts-micros` est en microsecondes, alors que `StartTime` est en millisecondes. La conversion d'unité de temps est appliquée automatiquement par l'enrichissement d'intervalle et les filtres d'intervalle.
`id`	`SpanId`
`parent-id`	`ParentId`
`trace-id`	`TraceId`

Documentation sur Oracle Cloud Infrastructure

Enrichissement d'intervalle