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