Sheet2pcp - En ligne dans le Cloud

PROGRAMME:

Nom

feuille2pcp - importer des données de feuille de calcul et créer une archive PCP

SYNOPSIS

feuille2pcp [-h hôte] [-Z fuseau horaire] dans le fichier fichier de carte fichier de sortie

DESCRIPTION

feuille2pcp est destiné à lire une feuille de calcul de données (dans le fichier) traduisez cela en un
Archive Performance Co-Pilot (PCP) avec le nom de base fichier de sortie.

La feuille de calcul d'entrée peut être dans l'un des formats courants, à condition que le Perl approprié
modules ont été installés (voir le MISES EN GARDE rubrique ci-dessous). La feuille de calcul doit être
normalisé de sorte que chaque ligne contienne des données pour le même intervalle de temps, et l'un des
colonnes contient la date et l'heure des données de chaque ligne.

L'archive PCP résultante peut être utilisée avec tous les outils clients PCP pour représenter graphiquement des sous-ensembles de
les données à l'aide graphique pm(1), effectuer la réduction des données et le reporting, filtrer avec le PCP
moteur d'inférence pmie(1), etc...

Notre fichier de carte contrôle le processus d'importation et définit le mappage des données à partir de la feuille de calcul
colonnes sur le modèle de données PCP. Le fichier est écrit en XML et conforme à la syntaxe
défini dans le CARTOGRAPHIE CONFIGURATION section ci-dessous.

Une série de fichiers physiques sera créée avec le préfixe fichier de sortie. Ceux-ci sont fichier de sortie.0
(les données de performance), fichier de sortie.meta (les métadonnées qui décrivent les données de performance)
et fichier de sortie.indice (un index temporel pour améliorer l'efficacité des opérations de relecture pour le
archiver). Si l'un de ces fichiers existe déjà, alors feuille2pcp sera pas les écraser
et se terminera avec un message d'erreur.

Notre -h l'option est une alternative à la nom d'hôte attribut de la élément dans fichier de carte
décrit ci-dessous. Si les deux sont spécifiés, la valeur de fichier de carte est utilisé.

Notre -Z l'option est une alternative à la fuseau horaire attribut de la élément dans fichier de carte
décrit ci-dessous. Si les deux sont spécifiés, la valeur de fichier de carte est utilisé.

feuille2pcp est un script Perl qui utilise le wrapper PCP::LogImport Perl autour du PCP
libpcp_import bibliothèque, et en tant que tel pourrait être utilisé comme exemple pour développer de nouveaux outils pour
importer d'autres types de données de performances et créer des archives PCP.

CARTOGRAPHIE CONFIGURATION

Notre fichier de carte contient des spécifications au format XML standard.

L'ensemble de la spécification est enveloppé dans un élément. le feuille Étiquette
prend en charge les attributs facultatifs suivants :

titre Spécifie le nombre de lignes d'en-tête à ignorer au début de la feuille de calcul
avant de traiter les données. Exemple : rubrique=1.

nom d'hôte Définissez le nom d'hôte source dans l'archive PCP (la valeur par défaut est d'utiliser le nom d'hôte
de l'hôte local). Exemple : hostname=some.where.com.

fuseau horaire Définissez le fuseau horaire source dans l'archive PCP (la valeur par défaut est d'utiliser UTC). Les
le fuseau horaire doit avoir le format +HHMM (pour les heures et les minutes à l'est de l'UTC) ou -HHMM
(pour les heures et les minutes à l'ouest d'UTC). A noter en particulier que ni le
infozone (alias Olson), par exemple Europe/Paris, ni le Posix TZ format, par exemple
EST+5 est autorisé. Exemple : fuseau horaire=+1100.

datefmt Le format de la date importée de la feuille de calcul peut être spécifié comme un
concaténation de valeurs qui spécifient l'ordre de l'année (Y), mois (M) et
journée (D) champs dans une date. Les variantes prises en charge sont JMA (le défaut), MDY et
YMD. Exemple : datefmt=AMJ.

A l'élément contient une ou plusieurs spécifications métriques de la forme
nom de la métriqueL’ métrique La balise prend en charge les attributs facultatifs suivants :

pmd L'identifiant des métriques de performance (PMID), spécifié sous la forme de 3 chiffres séparés par un
points (.) pour régler le domaine, grappe et Articles champs du PMID, voir PMNS(5)
pour plus de détails sur les PMID. S'il est omis, le PMID sera automatiquement attribué
by pmiAjouteMetrique(3). La valeur PM_ID_NULL peut être utilisé pour nommer explicitement le
comportement par défaut. Exemples : pmid=60.0.2, pmid=PM_ID_NULL.

indom Chaque métrique peut avoir une ou plusieurs valeurs. Si une métrique toujours a une valeur, il
est singulier et le domaine d'instance doit être défini sur PM_INDOM_NULL. Autrement
indom doit être spécifié comme 2 nombres séparés par un point (.) pour définir le
domaine et ordinal champs du domaine d'instance, voir le __pmInDom_int typedef
in . Exemples : indom=PM_INDOM_NULL, indom=60.3, indom=PMI_DOMAIN.4.
Plusieurs métriques peuvent partager le même domaine d'instance lorsque les métriques ont
valeurs définies sur des ensembles d'instances similaires, par exemple toutes les métriques pour chaque
interface réseau. C'est une pratique courante pour les domaine le champ soit le même
pour pmd et de la indom; si la pmd l'attribut est manquant, alors le domaine
champ pour le indom devrait être le domaine réservé PMI_DOMAINE. Si l' indom
l'attribut est omis, le domaine d'instance par défaut pour la métrique est
PM_INDOM_NULL.

unités L'échelle et la dimension des valeurs métriques le long des axes de l'espace, du temps et
le nombre (événements, messages, paquets, etc.) est spécifié avec un tuple 6. Ces
les valeurs sont transmises au pmiUnités(3) fonction pour générer un pmUnités structure.
Reportez-vous à pmRechercheDesc(3) pour une description complète de tous les domaines de ce
structure. La valeur par défaut est de n'attribuer aucune échelle ou dimension à la métrique, c'est-à-dire
unités=0,0,0,0,0,0. Exemples : units=0,1,0,0,PM_TIME_MSEC,0 (millisecondes),
unités=1,-1,0,PM_SPACE_MBYTE,PM_TIME_SEC,0 (Mo/s),
units=0,1,-1,0,PM_TIME_USEC,PM_COUNT_ONE (microsecondes/événement).

type Définit le type de données de la métrique. Faire référence à pmRechercheDesc(3) pour un plein
description des valeurs de type possibles ; la valeur par défaut est PM_TYPE_FLOAT.
Exemples : type=PM_TYPE_32, type=PM_TYPE_U64, type=PM_TYPE_STRING.

sem Définit la sémantique de la métrique. Faire référence à pmRechercheDesc(3) pour un plein
description des valeurs possibles ; la valeur par défaut est PM_SEM_INSTANT. Exemples:
sem=PM_SEM_COUNTER, tapez=PM_SEM_DISCRETE.

Les spécifications restantes définissent les colonnes de données in de commander en utilisant exactement UN
élément, un ou plusieurs métriquespec éléments et un ou
plus éléments.

Notre élément définit la colonne dans laquelle une date et une heure seront trouvées pour se former
l'horodatage dans l'archive PCP pour toutes les données de chaque ligne de l'archive PCP.

Pour le élément, un métriquespec consiste en un nom de métrique (tel que défini dans un précédent
élément), éventuellement suivi d'un nom d'instance entouré d'un carré
parenthèses, par exemple hinv.ncpu , kernel.all.load[1 minute] .

Notre sauter La balise définit la colonne qui doit être ignorée lors de la préparation des données pour le PCP
archiver.

L'ordre du , et éléments correspond à l'ordre des colonnes dans
la feuille de calcul. Si le nombre d'éléments n'est pas le même que le nombre de colonnes a
un avertissement est émis et les éléments ou colonnes supplémentaires ne génèrent aucune valeur de métrique dans le
archive de sortie.

EXEMPLE
Notre fichier de carte

<!-- simple
exemple -->
type="PM_TYPE_U64" sem="PM_SEM_COUNTER"> kernel.percpu.cpu.sys

kernel.percpu.cpu.sys[cpu0] kernel.percpu.cpu.sys[cpu1]


pourrait être utilisé pour une feuille de calcul dans laquelle les premières lignes sont ...

Date;"Statut";"SysTime - 0";"SysTime - 1"; 26/01/2001 14:05:22;"Certains
Busy";0.750;0.133 26/01/2001 14:05:37;"OK";0.150;0.273 26/01/2001 14:05:52;"All
Occupé";0.733;0.653

MISES EN GARDE

Seule la première feuille de dans le fichier sera traité.

Des modules Perl supplémentaires doivent être installés pour les différents formats de feuilles de calcul, bien que
ceux-ci sont vérifiés au moment de l'exécution afin que seuls les modules requis pour les types spécifiques de
les feuilles de calcul que vous souhaitez traiter doivent être installées :

* .csv Les feuilles de calcul au format CSV (valeurs séparées par des virgules) nécessitent Texte::CSV_XS(3h).

*.sxc or *.ods
Les documents OpenOffice nécessitent Tableur::LireSXC(3hXNUMX), ce qui nécessite à son tour
Archiver::Zip(3h).

* .xls Les documents Microsoft Office classiques nécessitent Tableur::AnalyserExcel(3h), qui en
tour nécessite OLE ::Stockage_Lite(3h).

*.xlsx
Les documents Microsoft OpenXML nécessitent Tableur::XLSX(3h). feuille2pcp ne collecte
semblent fonctionner avec les documents OpenXML enregistrés à partir d'OpenOffice.

PCP ENVIRONNEMENT

Variables d'environnement avec le préfixe PCP_ servent à paramétrer le fichier et le répertoire
noms utilisés par PCP. A chaque installation, le fichier /etc/pcp.conf contient les valeurs locales
pour ces variables. Les $PCP_CONF La variable peut être utilisée pour spécifier une alternative
fichier de configuration, comme décrit dans pcp.conf (5).

Utilisez sheet2pcp en ligne en utilisant les services onworks.net