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.

2438

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.

2428

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 » :

1320

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
1414

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é 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 dans :

Setting > Console > 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 :

http://www.wisper.io/wp-content/uploads/2017/07/requete-predefini.gif

Bien entendu, vous devez adapter la ligne :

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

Comme vous pouvez le constater, la requête 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 24 h ou plus. Vous pouvez bien entendu ajouter autant de lignes que vous le souhaitez. Une fois le fichier modifié, vous devrez redémarrer 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.

1246

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.

TermesTypeDescription
cpu.cpuCount number Nombre de CPU
cpu.cpuSpeed number Vitesse du CPU en MHz
cpu.loadAverage1 number Charge moyen du système depuis 1 minute
cpu.loadAverage5 number Charge moyen du système depuis 5 minutes
cpu.loadAverage15 number Charge moyen du système depuis 15 minutes
cpu.uptimenumberUptime du poste en secondes
disk.free numberEspace disque libre en %
disk.freeSize numberEspace disque libre en nombre de Octets
disk.readByteRate numberTaux de lecture disque en Octets par seconde
disk.totalSize numberCapacité totale du disque du poste en Octets
disk.usage numberUtilisation disque en %
disk.usedSize numberUtilisation disque en nombre de Octets
disk.writeByteRate numberTaux d'écriture disque en Octets par seconde
ip string IP ceBox® / Optimizer
machineTypestring Type de la machine : ceBox® | optimizer
memory.freenumberMémoire vive libre en %
memory.freeSize numberMémoire vive libre en Octets
memory.totalSize numberMémoire vive totale en Octets
memory.usage numberUtilisation de la mémoire vive en %
memory.usedSize numberUtilisation de la mémoire vive en Octets
name string Nom de la ceBox®
network.byteInRate numberTaux d'entrées réseaux en Octets par seconde
network.byteOutRate numberTaux de sorties réseaux en Octets par seconde
network.dropInRate numberTaux de paquets en entrée perdus par seconde
network.dropOutRate numberTaux de paquets en sortie perdus par seconde
network.errorInRate numberTaux d'erreurs en entrée par seconde
network.errorOutRate numberTaux d'erreurs en sortie par seconde
network.packetInRate, numberTaux de paquets en entrée par seconde
network.packetOutRate numberTaux de paquets en sortie par seconde
operatingSystemRelease stringVersion ceBox® OS (par exemple : 1.0.32)
optimizerUuid stringUUID de l'Optimizer
uuidstringUUID de la ceBox®
statusstringStatut de la ceBox® (online | offline)
virtualMachine.cpu.cpuCount numberNombre de CPU de la machine virtuelle
virtualMachine.cpu.cpuUsage numberUtilisation du CPU de la machine virtuelle en %
virtualMachine.disk.writeByte numberTaux d'écriture disque en Octets par seconde de la VM
virtualMachine.disk.readByteRate numberTaux de lecture disque en Octets par seconde de la VM
virtualMachine.name stringNom de la machine virtuelle
virtualMachine.network.receivedByteRate numberTaux d'entrées réseaux en Octets par seconde de la VM
virtualMachine.network.receivedDropRate numberTaux de paquets en entrée perdus par seconde de la VM
virtualMachine.network.receivedErrorRate numberTaux d'erreurs en entrée par seconde de la VM
virtualMachine.network.receivedPacketRate numberTaux de paquets en entrée par seconde de la VM
virtualMachine.network.transmittedByteRate numberTaux de sorties réseaux en Octets par seconde de la VM
virtualMachine.network.transmittedDropRate numberTaux de paquets en sortie perdus par seconde de la VM
virtualMachine.network.transmittedErrorRate numberTaux d'erreurs en sortie par seconde de la VM
virtualMachine.network.transmittedPacketRate numberTaux de paquets en sortie par seconde de la VM
virtualMachine.uuid stringUUID de la machine virtuelle

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