Filtrage avec Dynamic Focus

L'exemple suivant vous aide à comprendre le concept de Dynamic Focus.

Prenez en compte la représentation graphique d'une application segmentée qui s'exécute sur deux hôtes avec quatre conteneurs chacun. Une machine virtuelle Java ( JVM ) s'exécute dans chaque conteneur, et chacun des deux hôtes exécute deux instances Tomcat et deux instances d' Elasticsearch, qui fournissent un service par hôte. Une version simplifiée du modèle de graphique dynamique ressemble au diagramme suivant:

La fonction de filtrage réduit les noeuds du graphique en fonction d'une requête de recherche.

Une requête pour entity.type:tomcat correspond à toutes les instances Tomcat du graphique. Cela signifie que les conteneurs avec des entités Elasticsearch et les services correspondants ne sont plus visibles lorsque vous affichez votre infrastructure, votre application et les traces dans les vues standard.

Tout graphique, changement, problème ou incident dans « Instana » ne peut être appréhendé que dans le contexte du graphe réduit.

Un autre exemple de requête consiste à rechercher toutes les machines virtuelles Java 1.8, telles que entity.jvm.version:1.8.*

Dans ce cas, le graphique se présente comme suit:

Dynamic Focus est un outil puissant qui permet de rechercher et de cibler l'attention de l'utilisateur sur des entités uniques, ou des groupes d'entités, dans le graphique qui correspondent à certains critères.

Instana comporte également des éléments qui ne font pas partie du graphe dynamique, mais qui s'y rapportent, tels que des événements (comme un changement), des problèmes ou des incidents. Un incident peut concerner des services pour lesquels Instana a détecté des valeurs aberrantes au niveau des indicateurs de performance clés (KPI) et peut également concerner des entités présentant des problèmes tels qu'une charge CPU élevée.

En utilisant la fonction de recherche de Dynamic Focus, vous pouvez interroger et filtrer des incidents tels que event.state:open event.type:incident. La recherche filtre tous les incidents actifs dans la période sélectionnée. Dans cet exemple, on suppose qu'un seul incident actif est disponible lorsqu'une dégradation d'un service Elasticsearch entraîne une dégradation ultérieure d'un service Tomcat.

L'incident qui correspond ayant des références aux deux services, la requête filtre uniquement les entités appropriées.

Si vous recherchez un service, seuls les incidents contenant ce service sont affichés.

Instana utilise la syntaxe de requête Lucene pour construire des requêtes complexes à partir des termes associés aux composants de l'application et des opérateurs booléens. Une grande variété de types de requête sont pris en charge, comme les recherches de texte libre, le filtrage des balises, les requêtes de nombre d'UC, etc. La barre de recherche aide l'utilisateur à générer des requêtes en mettant automatiquement en évidence les termes individuels valides du reste de la chaîne. En outre, vous pouvez éviter les pièges de syntaxe de chaîne courants, tels que la confusion de la requête de texte libre and avec l'opérateur booléen AND.

La forme que prennent les requêtes Lucene varie en fonction de l'implémentation. En « Instana », toutes les requêtes partent d'un champ, passent par un modificateur de champ, puis par un quantificateur. Les deux valeurs du champ sont séparées par un point, tandis que le quantificateur est mis en évidence par deux points. Par exemple, si vous souhaitez filtrer toutes les instances Tomcat de votre application, utilisez la requête entity.type: tomcat dans la barre de recherche. Instana masque tout ce qui s'affiche à l'écran, à l'exception des entités de type « tomcat »

La requête entity.type:tomcat n'est qu'une seule phrase de requête. Pour générer des filtres flexibles et complexes qui vous montrent exactement ce dont vous avez besoin, chaînez différentes phrases de requête avec des opérateurs booléens, tels que AND, ORet NOT. Voir l'exemple suivant :

L'opérateur AND est l'opérateur de liaison par défaut. Par conséquent, si aucun opérateur booléen n'est utilisé entre deux termes, l'opérateur AND est utilisé.

Par exemple, entity.type:tomcat event.state:open est équivalent à entity.type:tomcat AND event.state:open. L'utilisation de AND l'opérateur lorsqu'aucun opérateur booléen n'est utilisé s'écarte de la norme Lucene, qui utilise OR par défaut.

entity.kubernetes.namespace:my-namespace AND NOT (entity.kubernetes.pod.name:my-name AND event.text:"ContainersNotReady")
 

entity.kubernetes.namespace:my-namespace AND NOT entity.kubernetes.pod.name:my-name AND NOT event.text:"ContainersNotReady"
 

La barre de recherche Dynamic Focus prend en charge la saisie semi-automatique des zones de recherche et met en évidence les termes de la requête Lucene lors de la saisie. Lors de la saisie des termes de la requête, la barre de recherche propose des champs de recherche qui correspondent à la saisie actuelle. Si vous ne disposez pas d'une commande de syntaxe Lucene, vous pouvez obtenir une aide automatique. Toutes les propositions de requête qui apparaissent dans une liste déroulante comme suit la barre de recherche. Si la proposition requise est dans la vue, cliquez ou accédez à celle-ci à l'aide des touches fléchées.

La fonction de recherche de Instana est instantanée, ce qui signifie que les résultats s'affichent dès que vous saisissez vos critères de recherche. Vous pouvez également enregistrer, éditer et supprimer des filtres pour accélérer votre flux de travaux.

Utilisation de caractères génériques (*) entre guillemets ("") ne génère pas de résultats attendus.

Aucune correspondance n'est renvoyée car le symbole * est évalué en tant que caractère et non en tant que caractère générique dans ce cas. Selon la spécification Lucene, les recherches avec caractères génériques uniques et multiples dans les requêtes de phrase ne sont pas prises en charge. Une requête de phrase est un groupe de mots entourés de guillemets, tels que event.text:"something bad happened".

L'utilisation du caractère générique (*) dans entity.service.name les requêtes ne donne pas les résultats escomptés.

La requête n'a renvoyé aucun résultat, car le symbole astérisque (*) est considéré comme un caractère et non comme un caractère générique. La entity.service.name requête utilise en interne l'opérateur « contains » pour rechercher les services correspondants. Par exemple, cette entity.service.name:proxy requête renvoie tous les services dont le nom contient le mot « proxy ».

Je reçois des nombres de résultats de recherche qui semblent incohérents.

Parfois, le nombre de résultats peut être source de confusion. Par exemple, lorsque vous effectuez une recherche dans la mappe d'infrastructure, les recherches dans les vues peuvent correspondre à plus d'entités que celles qui sont visibles dans les vues, telles que les services, qui ne sont pas visibles dans la mappe d'infrastructure.

Quelles sont les zones dans lesquelles la recherche est effectuée lorsque je ne spécifie aucune zone dans la requête de recherche?

Lorsque vous ne spécifiez aucune zone dans une requête de recherche, Dynamic Focus cible le contexte en cours pour fournir des résultats significatifs. Cela signifie qu'il effectue des recherches dans les zones d'entité lorsque vous êtes dans la vue de mappe d'infrastructure et qu'il effectue des recherches dans les données d'événement lorsque vous êtes dans la vue d'événement.

Quelle est la différence entre entity.selfType et entity.type ?

La recherche avec entity.selfType limite les résultats de la recherche à l'entité recherchée. La recherche avec entity.type inclut tous les enfants de l'entité recherchée. Par exemple, lorsque vous effectuez une recherche avec entity.selfType:host, la mappe d'infrastructure affiche uniquement les entités hôte et toutes les entités parent, telles que la zone. Mais lorsque vous effectuez une recherche avec entity.type:host, les résultats de la recherche incluent ce qui s'exécute sur l'hôte, comme les serveurs Web et les bases de données. Toutefois, entity.type et entity.selfType génèrent les mêmes résultats pour les types d'entité des perspectives d'application. Par exemple, lorsque vous utilisez la requête entity.type:endpoint dans la vue des événements, la liste contient uniquement les événements détectés sur les entités de noeud final.