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.

24382438

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.

24282428

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

13201320

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
14141414

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.

12461246

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.

Termes

Type

Description

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.uptime

number

Uptime du poste en secondes

disk.free

number

Espace disque libre en %

disk.freeSize

number

Espace disque libre en nombre de Octets

disk.readByteRate

number

Taux de lecture disque en Octets par seconde

disk.totalSize

number

Capacité totale du disque du poste en Octets

disk.usage

number

Utilisation disque en %

disk.usedSize

number

Utilisation disque en nombre de Octets

disk.writeByteRate

number

Taux d'écriture disque en Octets par seconde

ip

string

IP ceBox® / Optimizer

machineType

string

Type de la machine : ceBox® | optimizer

memory.free

number

Mémoire vive libre en %

memory.freeSize

number

Mémoire vive libre en Octets

memory.totalSize

number

Mémoire vive totale en Octets

memory.usage

number

Utilisation de la mémoire vive en %

memory.usedSize

number

Utilisation de la mémoire vive en Octets

name

string

Nom de la ceBox®

network.byteInRate

number

Taux d'entrées réseaux en Octets par seconde

network.byteOutRate

number

Taux de sorties réseaux en Octets par seconde

network.dropInRate

number

Taux de paquets en entrée perdus par seconde

network.dropOutRate

number

Taux de paquets en sortie perdus par seconde

network.errorInRate

number

Taux d'erreurs en entrée par seconde

network.errorOutRate

number

Taux d'erreurs en sortie par seconde

network.packetInRate,

number

Taux de paquets en entrée par seconde

network.packetOutRate

number

Taux de paquets en sortie par seconde

operatingSystemRelease

string

Version ceBox® OS (par exemple : 1.0.32)

optimizerUuid

string

UUID de l'Optimizer

uuid

string

UUID de la ceBox®

status

string

Statut de la ceBox® (online | offline)

virtualMachine.cpu.cpuCount

number

Nombre de CPU de la machine virtuelle

virtualMachine.cpu.cpuUsage

number

Utilisation du CPU de la machine virtuelle en %

virtualMachine.disk.writeByte

number

Taux d'écriture disque en Octets par seconde de la VM

virtualMachine.disk.readByteRate

number

Taux de lecture disque en Octets par seconde de la VM

virtualMachine.name

string

Nom de la machine virtuelle

virtualMachine.network.receivedByteRate

number

Taux d'entrées réseaux en Octets par seconde de la VM

virtualMachine.network.receivedDropRate

number

Taux de paquets en entrée perdus par seconde de la VM

virtualMachine.network.receivedErrorRate

number

Taux d'erreurs en entrée par seconde de la VM

virtualMachine.network.receivedPacketRate

number

Taux de paquets en entrée par seconde de la VM

virtualMachine.network.transmittedByteRate

number

Taux de sorties réseaux en Octets par seconde de la VM

virtualMachine.network.transmittedDropRate

number

Taux de paquets en sortie perdus par seconde de la VM

virtualMachine.network.transmittedErrorRate

number

Taux d'erreurs en sortie par seconde de la VM

virtualMachine.network.transmittedPacketRate

number

Taux de paquets en sortie par seconde de la VM

virtualMachine.uuid

string

UUID 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

Did this page help you?