Agent OsQuery
Fonction | Interroger des hôtes à l'aide d'osquery. Ce plugin nécessite que l'exécutable osqueryi soit installé sur l'hôte supervisé. osqueryi est exécuté via le SKOOR Agent, qui doit également être installé et actif sur la machine interrogée. Le démon osqueryd n'a pas besoin d'être exécuté pour que ces requêtes fonctionnent. |
|---|---|
Alarme | Dépend des valeurs de retour configurées dans les paramètres du job. |
osquery est un outil open source créé par Facebook permettant d'interroger diverses informations sur l'état des machines. Cela inclut notamment :
Les processus en cours d'exécution
Les modules du noyau chargés
Les comptes utilisateurs actifs
Les connexions réseau actives
et bien plus encore. osquery expose un système d'exploitation sous la forme d'une base de données relationnelle haute performance et permet de l'interroger à l'aide d'instructions SQL.
osquery est actuellement disponible pour les systèmes d'exploitation suivants :
Linux
Windows
OS X
FreeBSD
Il peut être installé en suivant les instructions de la page de téléchargement d'osquery : https://osquery.io/downloads/. Vous pouvez également simplement copier le binaire osqueryi dans /usr/bin.
L'exécution manuelle de requêtes sur l'hôte sur lequel osqueryi est installé est simple. Exécutez simplement la commande osqueryi pour accéder à l'outil de requête interactif, puis saisissez la requête suivie d'un point-virgule :
$ osqueryi Using a virtual database. Need help, type '.help' osquery> select value as string_value1 from cpuid where feature="product_name"; +------------------------------------------+ | string_value1 | +------------------------------------------+ | Dual-Core AMD Opteron(tm) Processor 1218 | +------------------------------------------+ osquery> .quit
Vous trouverez plus d'informations sur osquery ici : https://osquery.readthedocs.io/en/stable/.
Détails d'Agent OsQuery
Paramètres d'Agent OsQuery
Paramètre | Description |
|---|---|
Query | La requête à exécuter sur la base de données osquery sur l'hôte local (collecteur SKOOR) ou distant. |
La liste déroulante Tags permet de saisir des variables prédéfinies dans les champs ci-dessus, par exemple $NAME$ pour le nom du job.
La section d'exemples ci-dessous répertorie quelques-unes des requêtes utilisables. La sortie renvoyée par la requête doit être mappée vers Return values et String values dans le bon ordre.
Il est également possible d'influencer l'ordre des valeurs et des chaînes renvoyées en adaptant la requête afin de fournir les noms de valeurs et de chaînes attendus ; par exemple, la requête suivante mappera la valeur memory_free sur la première Return value et memory_total sur la deuxième Return value :
select memory_total as return_value2, memory_free as return_value1 from memory_info
La requête suivante renvoie deux String values dans un ordre spécifique :
select feature as string_value1, value as string_value2 from cpuid limit 1
Toutefois, les Return values et String values doivent toujours être configurées dans la section Job parameters du job pour apparaître dans la section Values du job.
Valeurs et limites d'alarme d'Agent OsQuery
Valeur / Limite d'alarme | Description |
|---|---|
<Generic> | Dépend des valeurs de retour configurées dans les paramètres du job. |
Code d'erreur | Code d'erreur générique du job (voir la section Codes d'erreur des jobs) |
Exemples d'Agent OsQuery
Exemple 1 - Interroger le modèle de processeur
Requête | select value as string_value1 from cpuid where feature="product_name" |
|---|
Cela nécessite de configurer la String value suivante :
Sortie 1
Exemple 2 - Interroger la mémoire totale et la mémoire libre
Requête | select memory_total, memory_free from memory_info |
|---|
Cela nécessite de configurer les 2 Return values suivantes :
Unit contient le nom de la Return value, une Unit et un diviseur, car osquery renvoie les valeurs en octets :
Sortie 2
Exemples de requêtes supplémentaires
Requête | Description | Exemple de sortie |
|---|---|---|
select username,description,directory from users where username like '%eranger' | Lire les informations utilisateur | |
select weekday, day, month, year, unix_time from time | Lire l'heure système | |
select count(pid) as total, name from processes group by name order by total desc limit 10 | Renvoyer le nombre et le nom des 10 processus les plus actifs | |
select * from uptime | Renvoyer la durée de fonctionnement du système |









