Moteur de recherche de la console ceBox

La console d’administration ceBox comporte une fonctionnalité de recherche. Cette fonctionnalité s’avère très pratique lorsque l’on gère un parc comportant de très nombreuses ceBox. La solution ceBox utilise la bibliothèque Apache Lucene, qui permet d’indexer et de rechercher du texte. Il s’agit donc du moteur de recherche interne à la solution. Nous allons voir la syntaxe des recherches, et les différents champs que vous pouvez rechercher dans votre console.

Comme vous pouvez le constater, le moteur de recherche de la console ceBox se trouve en haut à gauche et permet d'effectuer des recherches sur les ceBox, les machines virtuelles, les WSO et les Masters.

Syntaxe des requêtes dans la console ceBox

Les requêtes sont divisées en Termes et en Opérateurs. Il existe deux types de Termes : les Termes Uniques et les Phrases. Un terme Unique est donc composé d’un seul mot, alors qu’une phrase (String) est composée de plusieurs mots et est entourée de guillemets.

Plusieurs termes peuvent être combinés avec des opérateurs booléens pour former une requête plus complexe.

Vous pouvez rechercher n'importe quel champ en tapant le nom du champ suivi de deux points ":" et ensuite le Terme que vous recherchez. Dans la solution ceBox, les termes peuvent être des nombres ou des textes.

Nous verrons le détail des champs disponibles après, mais voici un exemple d’une requête contenant un opérateur booléen :

memory.totalSize:>=4294967296 AND cpu.cpuCount:>2

Ici nous recherchons les ceBox et WSO ayant 4 Go de mémoire vive ou plus et ayant 2 CPU ou plus.

Pour effectuer une recherche de caractères génériques, utilisez le symbole "*". Par exemple, si nous souhaitons rechercher les ceBox ou WSO ayant un nom commençant par « BC » :

Les opérateurs Booléens

Les opérateurs booléens permettent de combiner les termes par des opérateurs logiques. Le moteur de recherche prend en charge les opérateurs : AND, OR et NOT.

🚧

Attention

Les opérateurs booléens doivent être en MAJUSCULE

OR :

L'opérateur OR est l'opérateur de conjonction par défaut. Cela signifie que s'il n'y a pas d'opérateur booléen entre deux termes, l'opérateur OR est utilisé. L'opérateur OR relie deux termes et trouve un résultat correspondant à l'un des termes.

AND :

L'opérateur AND va trouver les ceBox / WSO où les deux termes sont trouvés. Si par exemple vous recherchez une ceBox utilisant plus de 2 Go de RAM et ayant plus de 2 CPU, votre requête sera :

memory.usage:>90 AND cpu.cpuCount:>2

NOT :

L'opérateur NOT exclut les résultats qui contiennent le terme après NOT. Par exemple, si vous recherchez les ceBox / WSO ayant 4 CPU mais exclure les ceBox Offline, vous utiliserez la requête :

cpu.cpuCount:4 NOT status:offline

Requêtes avancées

Comme vous avez pu le constater, il est possible d'effectuer des requêtes avancées en utilisant "<", ">" et "=". Cette fonctionnalités et très utile si vous recherchez des ceBox ayant des caractéristiques spécifiques ou si vous souhaitez déceler des ceBox ayant une consommation réseau anormale par exemple.

Voici quelques exemples :

cpu.cpuCount:>=2

cpu.loadAverage5:>80

network.byteInRate:>307200

Requêtes pré-enregistrées dans la console

La console d'administration ceBox permet d'enregistrer des requêtes. Cette fonctionnalité vous permet de ne pas avoir à entrer des requêtes répétitives, que vous seriez amené à faire régulièrement. Ces requêtes préenregistrées sont liées à votre profil de console.

Pour mettre en place ces requêtes pré-enregistrées : lancez votre console d'administration ceBox, allez Setting, Console puis Configuration.

Allez tout en bas du fichier, et ajoutez-y cette ligne juste avant les deux dernières accolades "}" :

configuration.searchBy.items[0].query="cpu.uptime:>=86400";
//configuration.searchBy.selection=0; //sélection par défaut

Voici le détail de la procédure :

Bien entendu, vous devez adapter la ligne :

configuration.searchBy.items[0].query="cpu.uptime:>=86400";

Comme vous pouvez le constater, la requêtes doit se trouver après query et entre les guillemets : query="votre requête".

Vous pouvez ajouter autant de requêtes que vous le souhaitez, il faudra simplement agrémenter de 1 chaque "Item" : items[0], items[1], items[2], etc.

Dans cet exemple, nous avons défini la requête "cpu.uptime:>=86400", c'est à dire toutes les ceBox ou WSO démarrés depuis 24h ou plus. Vous pouvez bien entendu ajouté autant de lignes que vous le souhaitez. Une fois le fichier modifié, vous devrez redémarré votre console d'administration ceBox.

Vous retrouverez vos requêtes préenregistrées sur la petite flèche, se trouvant à droite de la case de recherche de la console.

Champs disponibles

Voici la liste des Termes disponibles, que vous pouvez utiliser pour vos recherches dans la console ceBox. Vous avez également leur type (String ou Number).

Il est à noté que les termes de recherches sont sensibles à la casse (par exemple : cpu.processCount) et que vos recherches doivent être faites en minuscule.

Voici quelques exemples :

Permet de voir les ceBox® Onlines sans VM:

machineType:cebox AND status:online AND NOT virtualMachine.name:*

Permet de voir les ceBox® Offline:

offline