Importer un rapport dans KAIROS¶

Quel que soit le format du rapport (AWR, Statspack, nmon, vmstat, sar, ...), la procédure d'import dans KAIROS est la même. Il existe deux méthodes : un import manuel, depuis l'interface web, et un import automatique, via un dossier surveillé.

Méthode 1 — Import manuel (interface web)¶

C'est la méthode à utiliser lorsqu'il n'y a pas de lien direct entre les systèmes de production et KAIROS : le fichier collecté est d'abord rapatrié sur le poste de l'utilisateur (ou tout système ayant accès à l'interface KAIROS), puis déposé manuellement.

Dans l'explorateur, sélectionner le nœud sous lequel les données doivent être importées (nœud de type N ou B — voir Types de nœuds).
Clic droit → Upload.
Dans la fenêtre qui s'ouvre, cliquer sur Add files pour sélectionner un ou plusieurs fichiers (rapport texte, HTML, ou archive zip/tar.gz).
Lancer le transfert. Une barre de progression indique l'avancement.
Une fois l'opération terminée, fermer la fenêtre : les données sont désormais disponibles dans l'arborescence, à l'endroit choisi.

Noms de fichiers avec underscore

Si le nom du fichier importé contient des underscores (_), KAIROS éclate automatiquement ce nom en sous-arborescence sous le nœud où l'upload a été initié. Par exemple, un fichier nommé PRODDB_2024-11-20_AWR.zip créera successivement un nœud PRODDB, puis 2024-11-20, puis AWR.

Méthode 2 — Import automatique (dossier `/autoupload`)¶

Cette méthode est adaptée à l'automatisation (scripts de collecte planifiés par cron, intégration avec un outil de transfert de fichiers, ...).

Principe¶

Le point de montage /autoupload (voir Prérequis d'installation) est surveillé en permanence par un processus dédié, KairosNotifier. Dès qu'un fichier y est déposé et que son écriture est terminée (événement de fermeture du fichier), KairosNotifier déclenche l'import dans KAIROS. Une fois l'import terminé, le fichier est automatiquement supprimé du dossier d'entrée.

Convention de nommage¶

L'emplacement du fichier dans /autoupload détermine le nœud racine du dépôt de données cible : le premier niveau de répertoire sous /autoupload doit correspondre au nom exact d'un dépôt de données KAIROS existant (par exemple kairos_user_examples pour le dépôt personnel d'un utilisateur examples, ou kairos_group_xxxx pour un dépôt de rôle partagé — voir Comptes utilisateurs et rôles).

Seuls les fichiers .zip ou .tgz sont pris en compte par l'import automatique.

Comme pour l'import manuel, le nom du fichier est éclaté en sous-arborescence à partir des underscores :

/autoupload/kairos_user_examples/a_b_c.zip

produira, dans le dépôt kairos_user_examples :

/ (racine)
└── a
    └── b
        └── c   ← nœud bleu (type B), contenant les données importées

Cas d'usage typique : collecte quotidienne planifiée

Un script de collecte AWR (voir Collecte AWR) exécuté chaque nuit par cron peut produire un fichier nommé PRODDB_AWR_YYYY-MM-DD.zip et le déposer directement dans /autoupload/kairos_group_production/. Chaque exécution crée alors automatiquement un nouveau nœud journalier, sans aucune intervention manuelle.

Après l'import : détection automatique du contenu¶

Que l'import soit manuel ou automatique, la suite du traitement est identique : KAIROS analyse le contenu de chaque fichier déposé pour en déterminer le type (AWR, Statspack, nmon, vmstat, sar, ...) et construit les collections de données correspondantes. Aucune indication de format n'est à fournir : voir Vue d'ensemble de la collecte et de l'import pour le détail des formats reconnus.

Une fois l'import terminé, sélectionnez le nœud créé (de type B) : les menus de graphiques correspondant aux données détectées apparaissent automatiquement dans la barre de menus (voir Graphiques et menus disponibles).

Regrouper et automatiser l'agrégation¶

Pour une collecte répétée dans le temps (par exemple, un import quotidien), chaque import apparaît comme un nouveau nœud distinct dans l'arborescence. KAIROS propose un mécanisme de nœud L permettant d'automatiser la production de nœuds agrégés (type A) à chaque nouvel import dans un répertoire donné — utile par exemple pour obtenir automatiquement une vue mensuelle consolidée à partir d'imports quotidiens. Voir Arborescence et types de nœuds pour le détail du mécanisme d'agrégation.