# Manuel &applet; &manrevision;

## Introduction

Cette application permet de surveiller les changements pouvant se produire sur une page Web ou bien une machine accessible via le réseau.

### Onglet principal

Onglet principal

Elle peut-être utilisée pour:

- Détecter des modifications sur une page Web par l'intermédiaire de la date de modification de l'en-tête ou d'un simple changement de taille.

- Rechercher la présence d'une chaîne dans une page.

- Contrôler la charge du serveur par l'intermédiaire du temps de chargement d'une page.

- Tester du code HTTP présent dans l'en-tête de la réponse renvoyée par le serveur.

- Détecter un changement de serveur Web sur l'hôte distant (nouvelle version ou nouveau logiciel).

- Tester des ports TCP sur un serveur.

## Utilisation

1. Gestion des icônes du panel

2. Ajout d'un Espion

3. Suppression d'un Espion

4. Edition d'un Espion

Pour pouvoir utiliser `gospy-applet` il faut en premier lieu ajouter des Espions.

### Gestion des icônes du panel

Vous pouvez contrôler l'affichage ou non de l'icône de l'applet ainsi que des icônes des Espions sur le panel via les préférence de l'applet.

#### Icônes du panel GNOME

Icônes du panel GNOME

Lorsque vous avez choisi d'afficher les icônes des Espions sur le panel GNOME il est possible en passant la souris sur chacun d'eux d'afficher les informations le concernant dans un tootip.

Pour accéder aux résultats de recherches, pour visualiser en ligne (dans le cas d'une page Web), ou pour éditer les propriétés d'un Espion à partir du panel, cliquez sur l'icône voulue avec le bouton gauche de la souris. Un menu contextuel s'affichera.

### Ajout d'un Espion

Pour ajouter un nouvel Espion vous pouvez:

- Double-cliquer sur l'icône de l'applet puis cliquer sur le bouton "Ajouter" dans l'onglet principal.

- Sélectionner "Nouvelle source" depuis le menu contextuel de l'applet.

Cela ouvrira un Assistant qui vous permettra de faire l'ajout en toute simplicité.

Après la page de présentation de l'Assistant il vous est proposé de sélectionner le type d'Espion voulu et de saisir un libellé qui lui sera associé. Ce libellé vous permettra par la suite de l'identifier facilement dans la liste de vos Espions.

#### Premier écran

Premier écran de l'Assistant

#### Ajout d'un Espion de type "Serveur"

Si vous avez sélectionné "Surveillance d'un serveur" vous arrivez sur une seconde page qui vous permet d'entrer l'adresse du serveur à surveiller.

Ensuite vous avez le choix parmis les options suivantes:

- Vérifier un changement d'IP.

  Cette option sera désactivée si vous avez saisi une adresse IP au lieu d'un nom de domaine.

- Vérifier les mises à jour du serveur Web.

  Cette option n'est utile qu'à partir du moment ou vous êtes certain qu'un serveur Web tourne sur le serveur indiqué plus haut. Vous serez prévenu lors d'un changement de version ou nom.

- Tester des ports TCP sur le serveur.

  Cette option vous permet d'entrer plusieurs ports séparés par une virgule (par exemple: 22,110) ou bien une plage de ports (par exemple: 80-443). Vous définissez alors à quel moment une alerte doit être déclenchée: lorsque ces ports sont ouverts, ou bien lorsqu'ils sont fermés.

##### Deuxième écran

Deuxième écran de l'Assistant

L'écran suivant vous permet de choisir la fréquence des vérifications. Par défaut `gospy-applet` déclenchera un processus de test toutes les 30 minutes. Il est conseillé d'indiquer une fréquence différente pour chaque Espion.

##### Dernière page de l'Assistant

Dernière page de l'Assistant

#### Ajout d'un Espion de type "Page Web"

Si vous avez sélectionné "Surveillance d'une page Web" vous arrivez sur une seconde page qui vous permet de saisir l'URL de la page à surveiller.

##### Deuxième écran

Deuxième écran de l'Assistant

Si la page saisie nécessite une authentification, cliquez sur l'expandeur "Authentification" et renseignez le login et le mot de passe.

Les paramètres saisis seront stockés en clair sur votre disque. Bien que le répertoire de `gospy-applet` ne soit accessible qu'à votre utilisateur cela peut représenter un risque.

##### Autentification

Formulaire pour l'authentification

Ensuite vous avez le choix entre les options suivantes:

Date de mise à jour

- Cette option détecte un changement dans le champ "last-modified" de l'en-tête HTTP renvoyé par le serveur.

  Il ne sert généralement à rien de cocher cette option si la page à surveiller est générée dynamiquement. En effet le champ concerné est suceptible d'être modifié par le serveur même lorsque la page n'a pas effectivement été modifiée.

Changement de taille

- Cochez cette option si vous voulez être alerté dès que la taille de la page change.

Alerte quand la taille est...

- Après avoir coché cette option, définissez l'opérateur de comparaison (égale/différente/inférieure/supérieure) puis la taille de référence. Vous serez prévenu dès que le résultat obtenu correspondra à vos choix.

Changement de status

- Cochez cette option si vous voulez être alerté dès que le statut HTTP (code de réponse renvoyé par le serveur. ex: 200, 404 etc.) de la page change.

Alerte quand le statut est...

- Après avoir coché cette option, définissez l'opérateur de comparaison (égal/différent/inférieur/supérieur) puis le statut de référence. Vous serez prévenu dès que le résultat obtenu correspondra à vos choix.

Alerte quand le load est...

- Après avoir coché cette option, définissez l'opérateur de comparaison (égal/différent/inférieur/supérieur) puis le nombre de secondes devant servir de référence. Vous serez prévenu dès que le résultat obtenu correspondra à vos choix.

  Le "load" correspond au temps de chargement de la page complète. Il peut donc dépendre également de l'emcombrement de votre propre réseau.

Recherche de contenu

- Après avoir coché cette option, saisissez la chaîne à rechercher (la recherche ne tient pas compte des majuscules/minuscules). Vous serez prévenu dès que la chaîne indiquée sera trouvée dans la page.

L'écran suivant vous permet de choisir la fréquence des vérifications. Par défaut `gospy-applet` déclenchera un processus de test toutes les 30 minutes. Il est conseillé d'indiquer une fréquence différente pour chaque Espion.

### Suppression d'un Espion

Pour supprimer un Espion vous devez éditer les préférences en cliquant sur l'élément "Préférences" dans le menu contextuel de l'applet ou en double-cliquant sur l'icône de l'applet.

Sélectionnez ensuite l'élément à modifier dans la liste des Espions de l'onglet principal puis cliquez sur le bouton "Enlever". Vous pouvez également utiliser le menu contextuel qui apparait lorsque vous cliquez sur un élément de la liste avec le bouton droit de la souris.

### Edition d'un Espion

1. Onglet "Général"

2. Onglet "Surveillance"

3. Onglet "Résultats"

Pour éditer un Espion vous pouvez soit passer directement par les icônes du panel (si vous avez configurer les bonnes options dans les Préférences), soit editer les préférences en cliquant sur l'élément "Préférences" dans le menu contextuel de l'applet ou en double-cliquant sur son icône.

Si vous passez par le panel, il vous suffit de cliquer avec le bouton gauche de la souris sur l'icône de l'Espion que vous voulez éditer, puis de sélectionner "Editer les propriétés" dans le menu contextuel.

#### Onglet "Général"

Vous pouvez modifier une partie des éléments définis lors de la création de votre Espion. Il est possible de modifier le libellé associé, la cible, ainsi que les paramètres d'authentification pour les Espions de type "Page Web" et la fréquence d'exécution.

##### Onglet "Général"

Premier onglet

Un Espion peut avoir deux états:

Activé

- Lorsque l'Espion est dans l'état "Activé" il fonctionne normalement. Il s'agit de l'état par défaut.

Désactivé

- Mettez l'Espion dans cet état lorsque vous ne voulez plus qu'il surveille activement la page web ou le serveur. Cela permet de ne pas le supprimer.

#### Onglet "Surveillance"

Cet onglet reprend exactement les options de surveillance proposées par l'Assistant lors de l'ajout de votre Espion.

##### Onglet "Surveillance"

Deuxième onglet

#### Onglet "Résultats"

Cet onglet vous permet de visualiser l'historique des alertes générées par `gospy-applet`.

##### Onglet "Résultats"

Troisième onglet

Il se compose de deux partie.

##### La partie "Changements"

La partie "Changements" permet de visualiser le résultat des Espions pour lesquels vous avez choisi de surveiller des changements (modification de le taille, modification du statut HTTP etc.). Il est possible de visualiser un différentiel pour certains changements, comme une modification de taille ou de date de dernière modification.

##### La partie "Alertes"

La partie "Alertes" permet de visualiser le résultat des Espions pour lesquels vous avez choisi de surveiller la venue d'un état donné (temps de chargement, erreur de connexion etc.).

## Icônes et codes couleurs

`gospy-applet` utilise un certain nombre d'icônes et de couleurs pour signifier à tout moment ce qu'elle est en train de faire.

### Les icônes

#### Icône pour les Espions de type "Serveur"

Icône pour les Espions de type "Serveur"

#### Icône pour les Espions de type "Web Page"

Icône pour les Espions de type "Web Page"

#### Icône d'état "Activé" (lorsque l'Espion est activé)

Icône d'état "Activé" (lorsque l'Espion est activé)

#### Icône d'état "Désactivé" (lorsque l'Espion est désactivé)

Icône d'état "Désactivé" (lorsque l'Espion est désactivé) Icône d'état "Désactivé" (lorsque l'Espion est désactivé) Icône d'état "Désactivé" (lorsque l'Espion est désactivé)

#### Icône d'état "Au repos" (lorsque l'Espion ne travaille pas)

Icône d'état "Au repos" (lorsque l'Espion ne travaille pas)

#### Icône d'état "En cours" (lorsque l'Espion travaille)

Icône d'état "En cours" (lorsque l'Espion travaille)

#### Icône principale (rien ne se passe)

Icône principal (rien ne se passe)

#### Icône principale "travail en cours" (au moins un des Espions travaille)

Icône principal "travail en cours" (au moins un des Espions travaille)

#### Icône principale avec changement (au moins une alerte a été déclenchée pour un Espion)

Icône principale avec changement (au moins une alerte a été déclenchée pour un Espion)

#### Icône Espion en cours (l'Espion est en train de travailler)

Icône Espion en cours (l'Espion est en train de travailler) Icône Espion en cours (l'Espion est en train de travailler)

#### Icône Espion changement détecté (l'Espion a détecté un changement)

Icône d'état "Changement" (lorsqu'un évènement a eu lieu) Icône Espion changement détecté (l'Espion a détecté un changement) Icône Espion en cours (l'Espion est en train de travailler)

## Préférences

Pour accéder aux préférences de `gospy-applet`, cliquez 2 fois sur l'applet ou sélectionnez "Préférences" dans le menu contextuel. Ensuite, cliquez sur l'onglet "Affichage". Vous pouvez agir sur les paramètres suivants:

### Onglet des préférences de l'affichage

Onglet des préférences de l'affichage

Afficher l'icône principale

- Cochez cette option si vous voulez que l'icône principale de l'applet apparaisse sur le panel GNOME.

Afficher les icônes des Espions

- Cochez cette option si vous voulez que les icônes de vos Espions apparaisse sur le panel GNOME.

Afficher les tooltips pour les icônes du panel

- Cochez cette option si vous voulez que les tooltips soient affichés pour les icônes des Espions sur le panel GNOME.

Couleur de fond

- Vous permet de spécifier une couleur de fond pour l'applet.