pmlogextract - En ligne dans le Cloud

PROGRAMME:

Nom

pmlogextrait - réduire, extraire, concaténer et fusionner les archives Performance Co-Pilot

SYNOPSIS

pmlogextrait [-dfwz] [-c fichier de configuration] [-S Heure de début] [-s échantillons] [-T heure de fin] [-v
échantillons vol.] [-Z fuseau horaire] contribution [...] sortie

DESCRIPTION

pmlogextrait lit un ou plusieurs journaux d'archives Performance Co-Pilot (PCP) identifiés par contribution
et crée un journal d'archives PCP fusionné et/ou réduit temporellement sortie. La nature de
la fusion est contrôlée par le nombre de journaux d'archives d'entrée, tandis que la nature des données
La réduction est contrôlée par les arguments de la ligne de commande. Les entrées doivent être des archives PCP.
journaux créés par pmlogger(1) avec des données de performance collectées auprès du même hôte, mais
généralement sur des périodes de temps différentes et éventuellement (bien que pas habituellement) avec des
les mesures de performance sont enregistrées.

Si un seul contribution est spécifié, le comportement par défaut copie simplement le PCP d'entrée
journal d'archives, dans le journal d'archives PCP de sortie. Lorsque deux ou plusieurs journaux d'archives PCP sont
spécifié comme contribution, les journaux sont fusionnés (ou concaténés) et écrits dans sortie.

Dans le journal d'archive de sortie, un enregistrement « marque » sera inséré à un moment juste après la fin
de chacun des journaux d'archives d'entrée pour indiquer une éventuelle discontinuité temporelle entre
la fin d'un journal d'archives d'entrée et le début du journal d'archives d'entrée suivant. Voir le
MARK RECORDS section ci-dessous pour plus d'informations. Il n'y a pas d'enregistrement « marque » après le
fin de dernier (par ordre temporel) des journaux d'archives d'entrée.

COMMAND LINE OPTIONS

Les options de ligne de commande pour pmlogextrait sont les suivants:

-c fichier de configuration
Extraire uniquement les métriques spécifiées dans fichier de configuration du contribution Journal(s) d'archives PCP.
Le manuel de formation fichier de configuration syntaxe acceptée par pmlogextrait est expliqué plus en détail dans le
Configuration Fichier Syntaxe .

-d Mode désespéré. Normalement, si une erreur fatale se produit, toute trace de l'erreur partiellement
archives PCP écrites sortie est supprimé. Avec le -d option, la sortie journal d'archives
n'est pas supprimé.

-f Pour la plupart des utilisations courantes, tous les journaux d'archives d'entrée auront été collectés dans le
même fuseau horaire. Mais si ce n'est pas le cas, pmlogextrait doit choisir l'un des
les fuseaux horaires des journaux d'archives d'entrée à utiliser comme fuseau horaire pour la sortie
journal d'archives. Par défaut, le fuseau horaire utilisé est celui du dernier journal d'archive d'entrée.
Le manuel de formation -f l'option force le fuseau horaire à partir du premier journal d'archive d'entrée à utiliser.

-S Heure de début
Définissez le début d'une fenêtre temporelle pour restreindre les échantillons récupérés ou spécifiez un
alignement « naturel » des temps d'échantillonnage de sortie ; se référer à PCPIntro(1). Voir aussi
le -w option.

-s échantillons
L'argument échantillons définit le nombre d'échantillons à écrire sortie. Si
échantillons est 0 ou -s n'est pas spécifié, pmlogextrait échantillonnera jusqu'à la fin de la
Journal d'archives PCP, ou la fin de la fenêtre temporelle telle que spécifiée par -T, selon ce qui vient
premier. le -s l'option remplacera l' -T option si elle survient plus tôt.

-T heure de fin
Définir la fin d'une fenêtre temporelle pour restreindre les échantillons récupérés ou
spécifier un alignement « naturel » des temps d'échantillonnage de sortie ; se référer à PCPIntro (1).
Voir aussi -w option.

-v échantillons vol.
Le manuel de formation sortie Le journal d'archives est potentiellement un ensemble de données multivolumes, et le -v option
les causes pmlogextrait pour démarrer un nouveau volume après échantillons vol. les enregistrements de journaux ont été
écrit dans le journal d'archive.

Indépendant de tout -v option, chaque volume d'une archive est limité à pas plus de
2^31 octets, donc pmlogextrait créera automatiquement un nouveau volume pour l'archive
avant que cette limite ne soit atteinte.

-w Où -S et -T spécifier une fenêtre de temps dans la même journée, le -w le drapeau causera
les données dans la fenêtre temporelle à extraire, pour chaque jour dans le journal d'archives.
Par exemple, les options -w -S @11: 00 -T @15: 00 préciser que pmlogextrait devrait
inclure les enregistrements des journaux d'archives uniquement pour les périodes de 11 h à 3 h chaque jour.
Quand -w Est utilisé, le sortie le journal d'archives contiendra des enregistrements « marqués » pour indiquer
la discontinuité temporelle entre la fin d'une fenêtre temporelle et le début de la
suivant.

-Z fuseau horaire
Utilisez le fuseau horaire lors de l'affichage de la date et de l'heure. Fuseau horaire est au format du
variable d'environnement TZ comme décrit dans environ (7).

-z Utiliser le fuseau horaire local de l'hôte à partir des journaux d'archives d'entrée. La valeur par défaut est
utiliser initialement le fuseau horaire de l'hôte local.

CONFIGURATION DOSSIER SYNTAXE

Le manuel de formation fichier de configuration contient des métriques intéressantes - uniquement les métriques (ou instances) mentionnées
explicitement ou implicitement dans le fichier de configuration seront inclus dans le sortie archiver.
Chaque spécification doit commencer sur une nouvelle ligne et peut s'étendre sur plusieurs lignes.
fichier de configuration. Des instances peuvent également être spécifiées, mais elles sont facultatives. Le format
pour chaque spécification est

métrique [[instance[,instance...]]]

où métrique peut être un nom de feuille ou de non-feuille dans l'espace de noms des métriques de performance (PMNS,
sur le lien pmn(5)). Si une métrique fait référence à un nœud non-feuille dans le PMNS, pmlogextrait vont
descendre récursivement le PMNS et inclure toutes les métriques correspondant à la feuille descendante
nœuds.

Les instances sont facultatives et peuvent être spécifiées sous la forme d'une liste d'un ou plusieurs espaces (ou virgules)
noms, nombres ou chaînes séparés (entre guillemets simples ou doubles). Éléments dans
la liste qui contient des nombres est supposée être des identifiants d'instance internes - voir
pmGetInDom(3) pour plus d'informations. Si aucun exemple n'est donné, tous cas de la
les métriques associées seront extraites.

Tout espace blanc supplémentaire est ignoré et les commentaires peuvent être ajoutés avec un préfixe « # ».

CONFIGURATION DOSSIER EXEMPLE

Ceci est un exemple de validité fichier de configuration:

#
# fichier de configuration pour pmlogextract
#

noyau.all.cpu
kernel.percpu.cpu.sys ["cpu0","cpu1"]
disk.dev ["dks0d1"]

MARK RECORDS

Lorsque plusieurs journaux d'archives d'entrée contribuent aux données de performances de l'archive de sortie
journal, puis des enregistrements « marque » sont insérés pour indiquer une éventuelle discontinuité dans le
données de performance.

Un enregistrement « mark » contient un horodatage et aucune donnée de performance et est utilisé pour indiquer
qu'il y a une période dans le journal d'archives PCP où nous ne connaissons pas les valeurs de tout
indicateurs de performance, car il n'y avait pas pmlogger(1) collecter des données de performance pendant
cette période. Étant donné que ces périodes sont souvent associées au redémarrage d'un service ou
pmcd(1) ou un système, il peut y avoir un doute considérable quant à la continuité des performances
données sur cette période.

La logique derrière le marquage des enregistrements peut être illustrée par un exemple. Prenons-en un.
journal d'archives d'entrée qui commence à 00h10 et se termine à 09h15 le même jour, et un autre
journal d'archives d'entrée qui commence à 09h20 le même jour et se termine à 00h10 le jour suivant
matin. Ce serait un cas très courant pour les archives gérées et mises en rotation par
pmlogger_checkde Géographie (1) et avec la pmlogger_daily (1).

Le journal d'archive de sortie contiendrait :
00:10.000 premier enregistrement du premier journal d'archives d'entrée
...
09:15.000 dernier enregistrement du premier journal d'archives d'entrée
09:15.001
09:20.000 premier enregistrement du deuxième journal d'archives d'entrée
...
01:10.000 dernier enregistrement du deuxième journal d'archives d'entrée

La période pendant laquelle les données de performance sont manquantes commence juste après 09h15 et se termine
juste avant 09:20. Lorsque le journal d'archives de sortie est traité avec l'un des rapports PCP
outils, l'enregistrement « marque » est utilisé pour indiquer une période de données manquantes. Par exemple, dans
l'archive ci-dessus, si l'on rapportait le taux d'E/S moyen à des intervalles de 30 minutes,
aligné sur l'heure, il y aurait alors des données pour les intervalles se terminant à 09h00 et 10h00
mais aucune donnée n'est rapportée pour l'intervalle se terminant à 09h30 car cela couvre un enregistrement « mark ».

La présence d'enregistrements « marque » dans un journal d'archives PCP peut être établie à l'aide
pmdumplog(1) où un horodatage et l'annotation est utilisé pour indiquer une « marque »
record.

METADATA Chèques

Quand plus d'un contribution l'archive est spécifiée, pmlogextrait effectue un certain nombre de vérifications pour
s'assurer que les métadonnées sont cohérentes pour les mesures apparaissant dans plusieurs des contribution
archives. Ces vérifications comprennent :

* le type de données métriques est le même
* la sémantique métrique est la même
* les unités métriques sont les mêmes
* la métrique est soit toujours singulière, soit a toujours le même domaine d'instance
* les métriques portant le même nom ont le même PMID
* les métriques avec le même PMID ont le même nom

Si l’un de ces contrôles échoue, pmlogextrait signale les détails et abandonne sans créer
le sortie archiver.

Pour résoudre ces problèmes sémantiques, utilisez pmlogrewrite(1) pour traduire le contribution archives dans
archives équivalentes avec des métadonnées cohérentes avant utilisation pmlogextrait.

Utilisez pmlogextract en ligne avec les services onworks.net