Fichier ou répertoire de surveillance

Modifier en ligne

Une fois l'agent Instana installé, le capteur permettant de surveiller les fichiers ou les répertoires est automatiquement déployé et installé. Vous pouvez consulter les événements liés à un fichier ou à un répertoire spécifique dans l'interface utilisateur d' Instana.

Systèmes d'exploitation pris en charge

Modifier en ligne

Les systèmes d'exploitation suivants sont pris en charge pour la surveillance des fichiers ou des répertoires :

  • Linux
  • Mac OS ou OS X
  • Windows
  • Solaris Sparc
  • AIX

Configuration

Modifier en ligne

Instana génère des événements pour les fichiers ou répertoires surveillés en fonction des paramètres de configuration de l'ordinateur local.

Pour obtenir les événements d'un fichier ou d'un répertoire spécifique dans l'interface utilisateur d' Instana, vous devez créer un moniteur avec des conditions et définir un intervalle d'événements en configurant les champs suivants dans le fichier de <agent_install_dir>/etc/instana/configuration.yamlconfiguration de l'agent.

Remarque : pour activer le filemonitoring capteur, configurez enabled: true le configuration.yaml fichier et indiquez au moins deux moniteurs valides.

Intervalle entre les événements

Modifier en ligne

L'exemple suivant montre la configuration de l'intervalle d'événement :

com.instana.plugin.filemonitoring:
  enabled: true
  file_events:
    - event_intervals:
        - interval_1: 30 # sec
        - interval_2: 90 # sec
        - interval_3: 50 # sec
        - interval_4: 70 # sec
Remarque : vous pouvez définir jusqu'à quatre intervalles d'événement (en secondes) à la fois.

Moniteurs et conditions

Modifier en ligne

L'exemple suivant montre une configuration pour la mise en place d'un moniteur avec une condition. La configuration ajoute une règle de surveillance des fichiers pour surveiller le nombre de fichiers dans un dossier. La condition de déclenchement d'un événement est définie de telle sorte que lorsque le nombre de fichiers dans le dossier atteint 3, un événement est déclenché.

com.instana.plugin.filemonitoring:
  enabled: true
  file_events:
    - event_intervals:
        - interval_1: 30 # sec
        - interval_2: 90 # sec
        - interval_3: 50 # sec
        - interval_4: 70 # sec
    - path: '<path of the file or folder>' #eg for file: '/Users/username/Downloads/agent.log' #eg for directory: '/Users/username/Downloads/'
      conditions:
        - 'FILE_COUNT = <file count>'                                             #eg: 3
      name: '<name should be unique for each monitor>'                            #eg: 'Compare-filecount'
      interval: '<interval variable as described in the event_interval section >' #eg: 'interval_1'
      severity: '<WARNING or CRITICAL>'                                           #eg: 'WARNING'

Si nécessaire, vous pouvez créer plusieurs moniteurs avec plusieurs conditions. Pour plus d'informations sur les attributs détaillés des moniteurs et des conditions, voir Statistiques configurables pour les moniteurs et Statistiques configurables pour les conditions.

Les événements sont générés sur la base des moniteurs et des conditions spécifiés dans le fichier de l'agent configuration.yaml. Les types de relations suivants déclenchent des événements :

  • ET : un événement se déclenche lorsque plus d'une condition existe dans un moniteur et que tous les seuils de condition sont atteints.
  • OU : un événement se déclenche lorsque plusieurs moniteurs existent pour un fichier ou un chemin d'accès à un répertoire et que n'importe quel ensemble de conditions dans l'un des moniteurs est rempli.
Remarque : la relation « ET » s'applique au sein d'un même moniteur, tandis que la relation « OU » s'applique entre des moniteurs partageant le même chemin.

L'exemple suivant montre la relation AND entre les conditions :

com.instana.plugin.filemonitoring:
  enabled: true
  file_events:
    - event_intervals:
        - interval_1: 30 # sec
        - interval_2: 90 # sec
        - interval_3: 50 # sec
        - interval_4: 70 # sec
    - path: '/Users/username/Downloads/agent.log' # file path
      conditions:
        - 'SIZE >= 3000'                    # file size in bytes
        - 'LAST_MODIFIED_TIME < 2D:10H:30M' # last modified Day:Hour:Minute duration
      name: 'filesize-filelastmodifiedtime' # name should be unique for each monitor
      interval: 'interval_1'                # interval variable as described in the event_interval section
      severity: 'WARNING'                   # WARNING or CRITICAL

L'exemple suivant montre la relation OR entre les moniteurs :

com.instana.plugin.filemonitoring:
  enabled: true
  file_events:
    - event_intervals:
        - interval_1: 30 # sec
        - interval_2: 90 # sec
        - interval_3: 50 # sec
        - interval_4: 70 # sec
    - path: '/Users/username/Downloads/agent.log' # file path
      conditions:
        - 'SIZE >= 3000'                    # file size in bytes
        - 'LAST_MODIFIED_TIME < 2D:10H:30M' # last modified Day:Hour:Minute duration
      name: 'filesizedatemodified'          # name should be unique for each monitor
      interval: 'interval_1'                # interval variable as described in the event_interval section
      severity: 'WARNING'                   # WARNING or CRITICAL
    - path: '/Users/username/Downloads/agent.log' # file path
      conditions:
        - 'CHECKSUM != <Specify SHA-512 Checksum value>' # Use SHA-512 algorithm for generating checksum
      name: 'filechecksum'                  # name should be unique for each monitor
      interval: 'interval_2'                # interval variable as described in the event_interval section
      severity: 'WARNING'                   # WARNING or CRITICAL
  checksum_file_size: 100                  # for checking checksum please mention the file size (in MB) limit
Remarque : pour surveiller une somme de contrôle, vous devez définir une limite pour le checksum_file_size paramètre. Si vous ne définissez pas de limite pour ce checksum_file_size paramètre, la valeur par défaut est de 10 Mo. Il est recommandé d'utiliser un fichier plus petit pour la surveillance de la somme de contrôle.

Statistiques configurables pour les moniteurs

Modifier en ligne

Le tableau suivant présente les statistiques des moniteurs :

Statistiques Description
path Chemin d'accès au fichier ou au répertoire. Lorsque vous spécifiez des chemins d'accès aux répertoires, ceux-ci doivent se terminer par /. Par exemple, le chemin d'accès : /Users/Instana/scripts/. Ici, scripts est un répertoire.
conditions Conditions qui déclenchent des événements.
name Un nom unique pour chaque moniteur.
interval Tout intervalle spécifié dans le event_intervals.
severity WARNING ou CRITICAL

Statistiques configurables pour les conditions

Modifier en ligne

Le tableau suivant présente les statistiques relatives aux conditions :

Statistiques Description
SIZE L'attribut SIZE définit les événements qui sont déclenchés en fonction de la taille spécifiée d'un fichier. La taille doit être exprimée en octets.
FILE_COUNT L'attribut FILE_COUNT définit le nombre de fichiers existant dans le chemin d'accès au répertoire spécifié.
LAST_MODIFIED_TIME L'attribut LAST_MODIFIED_TIME définit l'heure de la dernière modification d'un fichier dans le chemin d'accès au répertoire spécifié.
CHECKSUM L'attribut CHECKSUM vérifie la somme de contrôle d'un fichier qui existe dans le chemin d'accès au répertoire spécifié. Pour créer le CHECKSUM, vous devez utiliser SHA-512 comme algorithme de hachage préféré.

Vous pouvez utiliser l'un des opérateurs suivants avec les attributs de statistiques configurables dans la condition :

Opérateurs
>
>=
<
<=
=
!=
IN

L'exemple suivant illustre l'utilisation de l'opérateur IN 

com.instana.plugin.filemonitoring:
  enabled: true
  file_events:
    - event_intervals:
        - interval_1: 30 # sec
        - interval_2: 90 # sec
        - interval_3: 50 # sec
        - interval_4: 70 # sec
    - path: 'agent.log'     # file that needs to be searched
      conditions:
        - 'agent.log IN (/Users/username/Instana/agent-installer/instana-agent/data/log/,/Users/username/Downloads/)'     #specify Directory paths for searching the agent.log file
      name: 'agent.log in folders'          # name should be unique for each monitor
      interval: 'interval_1'                # interval variable as described in the event_interval section
      severity: 'WARNING'                   # WARNING or CRITICAL
Remarque : pour vérifier un fichier situé dans un chemin d'accès, vous pouvez utiliser IN l'opérateur. L'opérateur IN ne déclenche une alerte que si le fichier spécifié se trouve dans le chemin d'accès au répertoire. Vous pouvez indiquer le chemin d'accès au répertoire au (path1,path2,..) format.

Affichage d'événements

Modifier en ligne

Pour consulter les événements, sélectionnez « Événements » dans le menu de navigation de l'interface utilisateur d' Instana. Vous pouvez voir tous les événements sur le tableau de bord des événements.