Mesures d'appels personnalisées (avant-première publique)
Vous pouvez ajouter des métriques d'appel personnalisées (valeurs numériques) aux appels de votre application grâce à une instrumentation manuelle à l'aide des SDK d' Instana s spécifiques à chaque langage. En utilisant ces indicateurs d'appels dans la vue d'analyse Unbounded, vous pouvez filtrer les appels selon des critères numériques (inférieur ou supérieur à) et également représenter graphiquement les agrégats de ces valeurs au fil du temps.
Objectif et exemples d'utilisation
Grâce aux indicateurs d'appel personnalisés, vous pouvez analyser les données chiffrées relatives aux appels qu' Instana e ne collecte pas par défaut. Ils peuvent être utilisés pour des mesures techniques, telles que la taille des données ou les délais, ou même pour des mesures commerciales, telles que la valeur totale des articles dans un panier d'achat. Les valeurs doivent être des nombres entiers, vous devez donc utiliser une échelle appropriée.
Les métriques d'appel personnalisées étendent le support existant pour annoter les appels dans le code instrumenté avec des étiquettes d'appel personnalisées, qui permettent de filtrer et de catégoriser les appels selon des valeurs de chaîne définies par l'utilisateur. Comme les mesures personnalisées sont des valeurs numériques, vous pouvez non seulement les utiliser pour le filtrage et le regroupement, mais vous pouvez également agréger les chiffres sur des groupes d'appels.
Les tâches suivantes présentent quelques exemples d'utilisation des métriques d'appels dans la vue analytique Unbounded :
- Annoter les appels avec la taille de certaines données traitées, puis filtrer sur cette taille pour voir les appels où elle dépasse un certain seuil.
- Utilisez les mêmes annotations sur la taille des données pour voir comment la taille maximale des données dans les appels évolue dans le temps.
- Suivez les durées au sein d'un appel si vous souhaitez connaître une phase de traitement spécifique, en plus de la latence globale de l'appel enregistrée par défaut par Instana.
- Suivez l'accès à un certain cache par les appels, en représentant un accès au cache par "
100et une absence de cache par "0, puis utilisez l'agrégation moyenne pour obtenir un graphique du pourcentage d'accès au cache pour les appels au fil du temps.
Envoi de métriques d'appel personnalisées à Instana
Pour envoyer des métriques d'appel personnalisées à Instana, procédez comme suit :
- Annotez les appels d'application dans votre code avec les mêmes méthodes SDK de traçage que celles utilisées pour annoter les appels avec des données clé-valeur de type chaîne pour les balises d'appel.
- Si vous souhaitez que l'annotation soit stockée sous la forme d'une métrique d'appel numérique plutôt que sous la forme d'une balise d'appel de type chaîne, utilisez le préfixe "
metrics.pour la clé. - Assurez-vous que la valeur peut être analysée comme un entier. Selon le langage et le SDK, transmettez les entiers directement ou convertissez-les en chaînes de caractères afin qu'ils correspondent aux définitions de l' API.
Avec le SDK de traçage d' Java, vous pouvez annoter un appel avec des métriques d'appel personnalisées, comme le montre l'exemple suivant :
SpanSupport.annotate("metrics.processingTime", String.valueOf(1234));
Analyse des données d'appel personnalisées
Vous pouvez utiliser les métriques d'appels pour les tâches suivantes :
Filtrage des appels à l'aide de métriques d'appels
Pour filtrer les appels à l'aide des métriques d'appel, effectuez les étapes suivantes dans la vue analytique Unbounded :
- Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Analytics ».
- Sur la page Analytics, cliquez sur la flèche du fil d'Ariane Applications, puis sélectionnez Appels.
- Cliquez sur Ajouter un filtre.
- Sélectionnez Appels > Mesures d'appel personnalisées, puis indiquez une clé de mesure, une valeur et un opérateur de comparaison pour le filtre.
processingtime > 1000 a » (en minuscules t) ne correspondra pas à l'appel illustré par l'annotation du SDK d'exemple dans l 'exemple précédent, qui utilise « a processingTime » comme clé.Vous pouvez également utiliser les indicateurs d'appel dans les conditions de filtrage des perspectives d'application, comme pour tout autre filtre appliqué aux appels.
Regroupement des appels à l'aide de métriques d'appels
Vous pouvez utiliser les métriques d'appels comme champ de regroupement dans la vue analytique Unbounded. Étant donné que les requêtes portant sur un trop grand nombre de groupes peuvent entraîner des performances médiocres, vous ne devriez utiliser une métrique d'appel pour le regroupement que si vous savez que l'éventail des valeurs possibles envoyées par votre application se limite à quelques centaines de valeurs différentes au maximum.
Affichage de graphiques pour les mesures d'appel personnalisées
Vous pouvez également afficher des graphiques pour les mesures d'appel personnalisées dans les analyses Unbounded pour les appels. Pour afficher des graphiques, procédez comme suit :
- Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Analytics ».
- Sur la page Analytics, cliquez sur la flèche du fil d'Ariane Applications, puis sélectionnez Appels.
- Dans le widget Graphique, sélectionnez les mesures d'appel personnalisées dans la liste, puis entrez une clé de mesure et l'agrégation à utiliser pour combiner les mesures dans chaque intervalle de temps.
Remarque sur la performance
Tout comme pour les annotations de type chaîne clé-valeur, limitez le nombre de clés utilisées (à quelques centaines au maximum) et n'incluez pas d'éléments susceptibles de changer fréquemment, tels que les identifiants de processus, dans les chaînes de clés. L'utilisation excessive de touches différentes peut dégrader les performances.
Limitations connues
Les aspects suivants de la mesure des appels ne sont pas entièrement pris en charge :
- Les indicateurs d'appels ne peuvent pas être utilisés dans les tableaux de bord personnalisés. Vous ne pouvez représenter les métriques d'appel que dans la vue analytique Unbounded.
- Les graphiques des mesures d'appels dans la vue Unbounded Analytics n'affichent pas correctement les nombres négatifs. L'axe des ordonnées commence toujours à 0, comme pour toutes les autres mesures prédéfinies.