Analyse de répertoire surveillance par défaut des vérifications et des politiques

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 9 minutes de lecture

    • Le fournit Agent Client Collector les vérifications et politiques par défaut suivantes pour la surveillance de Directory Scan.

    Tableau 1. Windows Événements de système d’exploitation : politique étendue
    Type Vérification Description Utilisation et exemple d'utilisation Sortie
    Événement check-directory-file-count
    Vérifie le nombre de fichiers présents dans un répertoire donné et le compare aux seuils d’avertissement et critiques fournis. Renvoie un événement CRITIQUE, AVERTISSEMENT ou OK en fonction des seuils Critique et Avertissement.
    Remarque :
    • Compte le nombre de fichiers dans le répertoire, sans inclure les fichiers dans les sous-répertoires.
    • L’agent a besoin d’autorisations de lecture et d’exécution sur le répertoire surveillé.

    check-directory-file-count.rb (options)

    -d, --dir Chemin d’accès absolu au répertoire pour compter les fichiers (obligatoire)

    -w, --warning Seuil d’avertissement (obligatoire)

    -c, --critique Seuil critique (obligatoire)

    -H, include_hidden_files Définir actif sur vrai pour inclure les fichiers masqués lors du comptage ( faux par défaut)

    Exemple d’utilisation :

    check-directory-file-count.rb -d /chemin/vers/répertoire -w 50 -c 100

    DirectoryFileCount CRITICAL : <chemin d’accès au répertoire> contient 165 fichiers.
    Événement check-directory-integrity
    Compare l’heure de la dernière modification du répertoire à l’heure actuelle pour déterminer si des mises à jour ont eu lieu dans un intervalle de temps défini. Sur la base de cette comparaison, la vérification renvoie un événement CRITIQUE ou OK.
    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le répertoire surveillé.

    commonchecks check-directory-integrity (options)

    -d, --dirpath DIRPATH : Chemin absolu vers le répertoire à vérifier (obligatoire).

    -i, --interval INTERVAL : intervalle de temps, en secondes, pour vérifier les mises à jour récentes (obligatoire). La valeur par défaut peut être définie sur 180 secondes.

    Exemple d’utilisation :

    commonchecks check-directory-update -d /chemin/vers/répertoire -i 180

    		 Vérifications courantes CRITIQUE : Intégrité du répertoire : CHANGEMENTS DÉTECTÉS pour <chemin d’accès au fichier> au cours des 180 dernières secondes (Dernière modification : Wed, 04 Dec 2024 12:18:55 EST).
    Événement check-file-age

    Évalue l’âge d’un fichier spécifié en comparant son heure de dernière modification à l’heure actuelle. Déclenche une alerte si le fichier dépasse les seuils d’âge critique ou d’avertissement définis.

    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le fichier surveillé.
    		 commonchecks check-file-age (options)

    -f, --filepath FILEPATH : Chemin d’accès absolu au fichier à vérifier (obligatoire).

    -c, --critical CRITICAL : seuil d’âge critique en minutes pour le fichier (requis).

    -w, --warning AVERTISSEMENT : seuil d’âge de l’avertissement en minutes pour le fichier (requis).

    Exemple d’utilisation :commonchecks check-file-age -f /chemin/vers/file.txt -c 120 -w 60

    		 Vérifications courantes OK : fichier <chemin d’accès au fichier> âge : 30 minutes.
    Événement check-file-response-time
    Compare le temps nécessaire pour lire un fichier spécifié et le compare aux seuils critiques et d’avertissement. Sur la base de cette comparaison, la vérification renvoie un événement CRITIQUE ou OK.
    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le fichier surveillé.
    		 commonchecks check-file-response-time (options)

    -f, --filepath FILEPATH : Chemin d’accès absolu au fichier à vérifier (obligatoire).

    -c, --critical CRITIQUE : seuil critique en secondes pour le délai de réponse du fichier (requis).

    -w, --warning AVERTISSEMENT : seuil d’avertissement en secondes pour le temps de réponse du fichier (requis).

    -t, --timeout TIMEOUT : Temps maximum autorisé pour lire le contenu du fichier, spécifié en secondes. La valeur du délai d’expiration doit être supérieure à la valeur du seuil critique.

    Exemple d’utilisation :commonchecks check-file-response-time -f /var/log/servicenow/agent-client-collector/acc.log -c 10 -w 5 -t 20

    		 Vérifications courantes OK : délai de réponse en lecture de fichier : 0,0020 seconde pour le file_name : /var/log/servicenow/agent-client-collector/acc.log.
    Événement taille fichier de vérification

    Mesure la taille d’un fichier (la quantité réelle de données qu’il contient) et la compare à des seuils spécifiés. Renvoie un événement CRITIQUE, AVERTISSEMENT ou OK en fonction de la comparaison de la taille du fichier et des seuils.

    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le fichier surveillé.
    		 CommonChecks check-file-size (options)

    -f, --filepath FILEPATH Chemin d’accès absolu au fichier requis (obligatoire).

    -c, --critique CRITIQUE. Seuil critique en kilo-octets. Fournir sous forme de nombre sans unités (par exemple, 1 000 pour 1 000 Ko) (obligatoire)

    -w, --avertissement AVERTISSEMENT. Seuil d’avertissement en kilo-octets. Fournir sous forme de nombre sans unités (par exemple, 500 pour 500 Ko) (obligatoire)

    Exemple d’utilisation :commonchecks check-file-size -f C :\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

    		 Vérifications courantes OK : pour le fichier <chemin d’accès au fichier> taille : 4,72 Ko est dans les limites des seuils
    Événement vérifier l’espace fichier

    Mesure la taille d’un fichier sur un disque par rapport à des seuils spécifiés, en renvoyant un événement CRITIQUE, AVERTISSEMENT ou OK en fonction des seuils.

    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le fichier surveillé.
    		 commonchecks check-file-space (options)

    -f, --filepath FILEPATH : Chemin d’accès absolu au fichier pertinent (obligatoire).

    -c, --critical CRITICAL : seuil critique en kilo-octets. Fourni sous forme de nombre sans unités (par exemple, 1 000 pour 1 000 Ko) (obligatoire)

    -w, --warning AVERTISSEMENT : Seuil d’avertissement en kilo-octets. Fourni sous forme de nombre sans unités (par exemple, 500 pour 500 Ko) (obligatoire)

    -b, --blocksize BLOCKSIZE : taille du bloc en octets (par défaut = 4096) (obligatoire)

    Exemple d’utilisation :

    commonchecks check-file-space -f C :\ProgramData\ServiceNow\agent-client-collector\config\acc.yml    		 Vérifications courantes OK : fichier <chemin d’accès au fichier> espace : 8,00 Ko est dans le seuil
    Événement os.windows.check-directory-space Vérifie l’espace disque occupé par le contenu d’un répertoire. Renvoie un événement CRITIQUE, AVERTISSEMENT ou OK, en fonction de la comparaison avec les seuils de gravité de l’événement critique et d’avertissement donnés.
    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le répertoire surveillé.
    		 winchecks check-dir-space (options)

    -d, --dirpath DIRPATH : Chemin absolu vers le répertoire en cours de vérification (obligatoire).

    -c, --critical CRITICAL : seuil d’espace disque critique en kilo-octets (requis).

    -w, --warning AVERTISSEMENT : Avertissement Seuil d’espace disque en kilo-octets (obligatoire).

    -t, --timeout TIMEOUT : Temps maximum autorisé pour le calcul de la taille du répertoire, spécifié en secondes (requis).

    Exemple d’utilisation :winchecks check-dir-space -d /chemin/vers/répertoire -c 1000 -w 500 -t 120

    		 Vérifications Windows OK : répertoire <chemin d’accès au fichier> espace : 369,25 Ko se trouve dans les limites des seuils
    Tableau 2. Linux Événements de système d’exploitation : politique étendue
    Type Vérification Description Utilisation et exemple d'utilisation Sortie
    Événement check-directory-file-count
    Vérifie le nombre de fichiers présents dans un répertoire donné et le compare aux seuils d’avertissement et critiques fournis. Renvoie un événement CRITIQUE, AVERTISSEMENT ou OK en fonction des seuils Critique et Avertissement.
    Remarque :
    • Compte le nombre de fichiers dans le répertoire, sans inclure les fichiers dans les sous-répertoires.
    • L’agent a besoin d’autorisations de lecture et d’exécution sur le répertoire surveillé.

    check-directory-file-count.rb (options)

    -d, --dir Chemin d’accès absolu au répertoire pour compter les fichiers (obligatoire)

    -w, --warning Seuil d’avertissement (obligatoire)

    -c, --critique Seuil critique (obligatoire)

    -H, include_hidden_files Définir actif sur vrai pour inclure les fichiers masqués lors du comptage ( faux par défaut)

    Exemple d’utilisation :

    check-directory-file-count.rb -d /chemin/vers/répertoire -w 50 -c 100

    DirectoryFileCount CRITICAL : <chemin d’accès au répertoire> contient 165 fichiers.
    Événement check-directory-integrity
    Compare l’heure de la dernière modification du répertoire à l’heure actuelle pour déterminer si des mises à jour ont eu lieu dans un intervalle de temps défini. Sur la base de cette comparaison, la vérification renvoie un événement CRITIQUE ou OK.
    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le répertoire surveillé.

    commonchecks check-directory-integrity (options)

    -d, --dirpath DIRPATH : Chemin absolu vers le répertoire à vérifier (obligatoire).

    -i, --interval INTERVAL : intervalle de temps, en secondes, pour vérifier les mises à jour récentes (obligatoire). La valeur par défaut peut être définie sur 180 secondes.

    Exemple d’utilisation :

    commonchecks check-directory-update -d /chemin/vers/répertoire -i 180

    		 Vérifications courantes CRITIQUE : Intégrité du répertoire : CHANGEMENTS DÉTECTÉS pour <chemin d’accès au fichier> au cours des 180 dernières secondes (Dernière modification : Wed, 04 Dec 2024 12:18:55 EST).
    Événement check-file-age

    Évalue l’âge d’un fichier spécifié en comparant son heure de dernière modification à l’heure actuelle. Déclenche une alerte si le fichier dépasse les seuils d’âge critique ou d’avertissement définis.

    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le fichier surveillé.
    		 commonchecks check-file-age (options)

    -f, --filepath FILEPATH : Chemin d’accès absolu au fichier à vérifier (obligatoire).

    -c, --critical CRITICAL : seuil d’âge critique en minutes pour le fichier (requis).

    -w, --warning AVERTISSEMENT : seuil d’âge de l’avertissement en minutes pour le fichier (requis).

    Exemple d’utilisation :commonchecks check-file-age -f /chemin/vers/file.txt -c 120 -w 60

    		 Vérifications courantes OK : fichier <chemin d’accès au fichier> âge : 30 minutes.
    Événement check-file-response-time
    Compare le temps nécessaire pour lire un fichier spécifié et le compare aux seuils critiques et d’avertissement. Sur la base de cette comparaison, la vérification renvoie un événement CRITIQUE ou OK.
    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le fichier surveillé.
    		 commonchecks check-file-response-time (options)

    -f, --filepath FILEPATH : Chemin d’accès absolu au fichier à vérifier (obligatoire).

    -c, --critical CRITIQUE : seuil critique en secondes pour le délai de réponse du fichier (requis).

    -w, --warning AVERTISSEMENT : seuil d’avertissement en secondes pour le temps de réponse du fichier (requis).

    -t, --timeout TIMEOUT : Temps maximum autorisé pour lire le contenu du fichier, spécifié en secondes. La valeur du délai d’expiration doit être supérieure à la valeur du seuil critique.

    Exemple d’utilisation :commonchecks check-file-response-time -f /var/log/servicenow/agent-client-collector/acc.log -c 10 -w 5 -t 20

    		 Vérifications courantes OK : délai de réponse en lecture de fichier : 0,0020 seconde pour le file_name : /var/log/servicenow/agent-client-collector/acc.log.
    Événement taille fichier de vérification

    Mesure la taille d’un fichier (la quantité réelle de données qu’il contient) et la compare à des seuils spécifiés. Renvoie un événement CRITIQUE, AVERTISSEMENT ou OK en fonction de la comparaison de la taille du fichier et des seuils.

    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le fichier surveillé.
    		 CommonChecks check-file-size (options)

    -f, --filepath FILEPATH Chemin d’accès absolu au fichier requis (obligatoire).

    -c, --critique CRITIQUE. Seuil critique en kilo-octets. Fournir sous forme de nombre sans unités (par exemple, 1 000 pour 1 000 Ko) (obligatoire)

    -w, --avertissement AVERTISSEMENT. Seuil d’avertissement en kilo-octets. Fournir sous forme de nombre sans unités (par exemple, 500 pour 500 Ko) (obligatoire)

    Exemple d’utilisation :commonchecks check-file-size -f C :\ProgramData\ServiceNow\agent-client-collector\config\acc.yml

    		 Vérifications courantes OK : pour le fichier <chemin d’accès au fichier> taille : 4,72 Ko est dans les limites des seuils
    Événement vérifier l’espace fichier

    Mesure la taille d’un fichier sur un disque par rapport à des seuils spécifiés, en renvoyant un événement CRITIQUE, AVERTISSEMENT ou OK en fonction des seuils.

    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le fichier surveillé.
    		 commonchecks check-file-space (options)

    -f, --filepath FILEPATH : Chemin d’accès absolu au fichier pertinent (obligatoire).

    -c, --critical CRITICAL : seuil critique en kilo-octets. Fourni sous forme de nombre sans unités (par exemple, 1 000 pour 1 000 Ko) (obligatoire)

    -w, --warning AVERTISSEMENT : Seuil d’avertissement en kilo-octets. Fourni sous forme de nombre sans unités (par exemple, 500 pour 500 Ko) (obligatoire)

    -b, --blocksize BLOCKSIZE : taille du bloc en octets (par défaut = 4096) (obligatoire)

    Exemple d’utilisation :

    commonchecks check-file-space -f C :\ProgramData\ServiceNow\agent-client-collector\config\acc.yml    		 Vérifications courantes OK : fichier <chemin d’accès au fichier> espace : 8,00 Ko est dans le seuil
    Événement os.linux.check-directory-size Vérifie l’espace alloué au répertoire d’un disque et le compare aux seuils critiques et d’avertissement spécifiés.
    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le répertoire surveillé.
    		 linuxchecks check-directory-size (options)

    -d, --dirpath DIRPATH : Chemin absolu vers le répertoire en cours de vérification (obligatoire).

    -c, --critical CRITICAL : seuil d’espace disque critique en kilo-octets (requis).

    -w, --warning AVERTISSEMENT : Avertissement Seuil d’espace disque en kilo-octets (obligatoire).

    -t, --timeout TIMEOUT : Temps maximum autorisé pour le calcul de la taille du répertoire, spécifié en secondes (requis).

    Exemple d’utilisation :linuxchecks check-directory-size -d chemin/vers/répertoire -c 100 -w 50 -t 30

    		 Vérifications Linux CRITIQUE : Répertoire <chemin d’accès au fichier> Taille : 500,00 Ko dépasse le seuil critique de 10,00 Ko
    Événement os.linux.check-directory-space Vérifie l’espace disque occupé par le contenu du répertoire. Renvoie un événement CRITIQUE, AVERTISSEMENT ou OK en fonction de la comparaison avec les seuils critique et avertissement.
    Remarque :
    L’agent a besoin d’autorisations de lecture et d’exécution sur le répertoire surveillé.
    		 linuxchecks check-directory-space (options)

    -d, --dirpath DIRPATH : Chemin absolu vers le répertoire en cours de vérification (obligatoire).

    -c, --critical CRITICAL : seuil d’espace disque critique en kilo-octets (requis).

    -w, --warning AVERTISSEMENT : Avertissement Seuil d’espace disque en kilo-octets (obligatoire).

    -t, --timeout TIMEOUT : Temps maximum autorisé pour le calcul de la taille du répertoire, spécifié en secondes (requis).

    Exemple d’utilisation :linuxchecks check-directory-space -d /chemin/vers/répertoire -c 10 -w 5 -t 30

    		 Vérifications Linux CRITIQUE : Répertoire <chemin d’accès au fichier> Espace : 374,00 Ko dépasse le seuil critique de 10,00 Ko