pmlogrewrite - En ligne dans le cloud

PROGRAMME:

Nom

pmlogrewrite - réécrire les archives de Performance Co-Pilot

SYNOPSIS

$PCP_BINADM_DIR/pmlogrewrite [-Cdiqsvw ] [-c config] se connecter [déconnexion]

DESCRIPTION

pmlogrewrite lit un journal d'archives Performance Co-Pilot (PCP) identifié par se connecter et
crée un journal d'archive PCP déconnexion. Dans des conditions normales d'utilisation, le -c l'option sera utilisée pour
nommer un ou plusieurs fichiers de configuration contenant des spécifications (voir le RÉÉCRITURE
DES RÈGLES SYNTAXE section ci-dessous) qui décrivent comment les données et les métadonnées de se connecter devrait être
transformé pour produire déconnexion.

Les utilisations typiques de pmlogrewrite serait de s'adapter à l'évolution de la Performance
Agents de domaine métrique (PMDA) où les noms, les métadonnées et la sémantique des métriques et leurs
les domaines d'instance associés peuvent changer au fil du temps, par exemple en promouvant le type d'une métrique à partir de
un entier de 32 bits vers un entier de 64 bits, ou renommer un groupe de métriques. Consultez la section EXEMPLES
section pour quelques cas d'utilisation supplémentaires.

pmlogrewrite est particulièrement utile lorsque des modifications PMDA ou des erreurs se produisent dans l'environnement de production,
aboutir à des archives qui ne peuvent pas être combinées avec pmlogextrait(1). En prétraitant le
archives avec pmlogrewrite les archives résultantes peuvent être fusionnées avec
pmlogextrait (1).

L'entrée se connecter doit être un journal d'archive PCP créé par pmlogger(1), ou peut-être l'un des
outils qui lisent et créent des archives PCP, par exemple pmlogextraitde Géographie (1) et avec la pmlogreduce (1).

Sinon -c l'option est spécifiée, le comportement par défaut crée simplement déconnexion comme une copie de
se connecter. C'est un peu plus compliqué que cat(1), car chaque archive PCP est composée de
plusieurs fichiers physiques.

Si pmlogrewrite peut être utilisé pour réparer certains problèmes de cohérence des données dans les archives PCP,
il existe également une classe de tâches de réparation qui ne peuvent pas être traitées par pmlogrewrite et
pmloglabel(1) peut être un outil utile dans ces cas.

COMMAND LINE OPTIONS

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

-C Analysez les règles de réécriture et quittez. déconnexion n'est pas créé. Quand -C est spécifié,
cela définit également -v et -w afin que tous les avertissements et messages détaillés soient affichés comme
config est analysé.

-c config
If config est un fichier ou un lien symbolique, lisez et analysez les règles de réécriture à partir de là.
If config est un répertoire, puis tous les fichiers ou liens symboliques dans ce répertoire
(à l'exclusion de ceux commençant par un point « . ») seront utilisés pour fournir le
réécriture des règles. Multiples -c les options sont autorisées.

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

-i Plutôt que de créer déconnexion, se connecter est réécrit sur place lorsque le -i option est
utilisé. Une nouvelle archive est créée en utilisant des noms de fichiers temporaires, puis renommée en
se connecter de telle manière que si des erreurs (et non des avertissements) sont rencontrées, se connecter
reste inchangé.

-q Mode rapide, où s'il n'y a aucune action de réécriture à effectuer (aucune des
données globales, domaines d'instance ou métriques de se connecter sera modifié), alors
pmlogrewrite quittera (avec le statut 0, donc succès) immédiatement après avoir analysé le
fichier(s) de configuration et déconnexion n'est pas créé.

-s Lorsque les « unités » d’une métrique sont modifiées, si la dimension en termes d’espace,
le temps et le nombre ne sont pas modifiés, alors le facteur d'échelle est modifié, par exemple BYTE à
KBYTE, ou MSEC-1 vers USEC-1, ou le composite MBYTE.SEC-1 vers KBYTE.USEC-1. Le
la motivation peut être (a) que les métadonnées d'origine étaient erronées mais que les valeurs dans se connecter
sont correctes, ou (b) les métadonnées changent, donc les valeurs doivent également changer.
Le défaut pmlogrewrite Le comportement correspond au cas (a). Si le cas (b) s'applique, utiliser
le -s option et les valeurs de toutes les métriques avec un facteur d'échelle changent dans chaque
Le résultat sera redimensionné. Pour un contrôle plus précis de la redimensionnement des valeurs, reportez-vous à la section
REMISE À L'ÉCHELLE option pour le UNITÉS clause de la règle de réécriture métrique décrite ci-dessous.

-v Augmenter la verbosité des résultats de diagnostic.

-w Émettre des avertissements. Normalement pmlogrewrite reste silencieux pour tout avertissement qui n'est pas
fatal et il est prévu que pour une archive particulière, certains (ou même tous)
Les spécifications de réécriture peuvent ne pas s'appliquer. Par exemple, les modifications apportées à un PMDA peuvent être
capturé dans un ensemble de règles de réécriture, mais une seule archive peut ne pas contenir tous les
les métriques modifiées ni tous les domaines et/ou instances d'instance modifiés.
Parce que ces cas sont attendus, ils n’empêchent pas pmlogrewrite exécuter, et
règles qui ne s'appliquent pas à se connecter sont ignorés par défaut. De même, certains
les règles de réécriture peuvent n'impliquer aucun changement car les métadonnées dans se connecter déjà des matchs
l'intention de la règle de réécriture est de corriger les données d'une version précédente d'un PMDA.
Le manuel de formation -w le drapeau oblige à émettre des avertissements pour tous ces cas.

L'argument déconnexion est requis dans tous les cas, sauf lorsque -i est spécifié.

RÉÉCRITURE DES RÈGLES SYNTAXE

Un fichier de configuration contient zéro ou plusieurs règles de réécriture telles que définies ci-dessous.

Les mots-clés et les caractères de ponctuation spéciaux sont indiqués ci-dessous dans gras italique police et sont
insensible à la casse, donc METRIC, métrique et Métrique sont tous équivalents dans les règles de réécriture.

Le caractère « # » introduit un commentaire et le reste de la ligne est ignoré.
Sinon, l'entrée est au format relativement libre avec des espaces blancs facultatifs (espaces, tabulations ou
(sauts de ligne) entre les éléments lexicaux dans les règles.

A de défis la règle de réécriture a la forme :

GLOBAL { spécification globale ... }

où spécification globale est zéro ou plusieurs des clauses suivantes :

HOSTNAME -> nom d'hôte

Modifie les enregistrements d'étiquettes dans le déconnexion Archives PCP, afin que les métriques soient
semblent avoir été collectés auprès de l'hôte nom d'hôte.

-> delta

Les valeurs métriques et les métadonnées du domaine d'instance dans une archive PCP portent
horodatages. Cette clause force l'ajustement de tous les horodatages par delta, Où
delta est un signe facultatif « + » (par défaut) ou « - », un nombre facultatif de
heures suivies de deux points « : », un nombre facultatif de minutes suivi de deux points
``:'', un nombre de secondes, une fraction facultative de secondes suivant un point
« . ». L'exemple le plus simple serait « 30 » pour augmenter les horodatages de 30.
secondes. Un exemple plus complexe serait « -23:59:59.999 » pour déplacer les horodatages.
en arrière d'une milliseconde de moins qu'un jour.

TZ -> "fuseau horaire"

Modifie les enregistrements d'étiquettes dans le déconnexion Archives PCP, afin que les métriques soient
semblent avoir été collectées auprès d'un hôte avec un fuseau horaire local de fuseau horaire.
fuseau horaire doit être placé entre guillemets et doit être conforme au fuseau horaire valide
règles de syntaxe pour la plateforme locale.

An indom la règle de réécriture modifie un domaine d'instance et a la forme :

INDOM domaine.en série { indomspec ... }

où domaine et en série identifier un ou plusieurs domaines d'instance existants à partir de se connecter -
typiquement domaine serait un entier compris entre 1 et 510 et en série serait un entier
dans la plage de 0 à 4194304.

Comme cas particulier en série pourrait être un astérisque « * » qui signifie que la règle s'applique à tous
domaine d'instance avec un numéro de domaine de domaine.

Si un domaine d'instance désigné n'est pas dans se connecter la règle n'a aucun effet.

Le manuel de formation indomspec est zéro ou plusieurs des clauses suivantes :

MON NOM "ancien nom" -> "nouveau nom"

L'instance identifiée par le nom de l'instance externe ancien nom est renommé en
nouveau nom. Tous les deux ancien nom et nouveau nom doit être placé entre guillemets.

Dans un cas particulier, le nouveau nom peut être le mot-clé EFFACER (sans guillemets), et
alors l'instance ancien nom sera radié de déconnexion ce qui le retire de la
métadonnées du domaine d'instance et supprime toutes les valeurs de cette instance pour tous les
métriques associées.

Si les noms d'instance contiennent des espaces intégrés, une attention particulière doit être portée.
pris en ce qui concerne la règle de nommage d'instance PCP qui traite le non-espace de tête
une partie du nom de l'instance comme partie unique du nom aux fins de
correspondant et garantissant l'unicité au sein d'un domaine d'instance, reportez-vous à
Instance pmda(3) pour une discussion de cette question.

À titre d’illustration, considérons le domaine d’instance hypothétique pour une métrique qui
contient 2 instances avec les noms suivants :
rouge
semaine urk

Ensuite, quelques possibilités MON NOM les clauses pourraient être :

"eek" -> "jaune comme une fleur"
Acceptable, ancien nom « eek » correspond à l'instance « eek urk ».

"rouge" -> "eek"
Erreur, nouveau nom « eek » correspond à l'instance « eek urk » existante.

"eek urk" -> "rouge d'une autre teinte"
Erreur, nouveau nom « rouge d'une autre teinte » correspond à l'instance « rouge » existante.

INDOM -> nouveau domaine.actualités

Modifie les métadonnées du domaine d'instance et chaque métrique associée au
domaine d'instance. À titre de cas particulier, actualités pourrait être un astérisque « * » qui
signifie utiliser en série du indom règle de réécriture, bien que cela soit plus utile lorsque
en série est également un astérisque. Par exemple :
indom 29.* { indom -> 109.* }
déplacera tous les domaines d'instance du domaine 29 vers le domaine 109.

INDOM -> DUPLIQUER nouveau domaine.actualités

Un cas particulier du précédent INDOM clause où le domaine d'instance est un
duplicata du domaine.en série domaine d'instance à partir du indom règle de réécriture,
et ensuite toutes les règles de mappage sont appliquées à la copie nouveau domaine.actualités instance
domaine. Ceci est utile lorsqu'un PMDA est divisé et que le même domaine d'instance doit
être répliqué pour le domaine domaine et domaine nouveau domaine. Donc, par exemple, si le
métrique foo.one et foo.two sont tous deux définis sur le domaine d'instance 12.34, et
foo.two est déplacé vers un autre PMDA utilisant le domaine 27, puis la réécriture suivante
des règles pourraient être utilisées :
indom 12.34 { indom -> dupliquer 27.34 }
métrique foo.two { indom -> 27.34 pmid -> 27.*.* }

INST ancien -> nouveau

L'instance identifiée par l'identifiant d'instance interne ancien est renuméroté en
nouveau. Tous les deux ancien et nouveau sont des entiers compris entre 0 et 231-1.

Comme cas particulier, nouveau peut être le mot clé EFFACER et puis l'instance ancien
sera radié de déconnexion ce qui le supprime des métadonnées du domaine d'instance
et supprime toutes les valeurs de cette instance pour toutes les métriques associées.

A métrique la règle de réécriture a la forme :

METRIC métrique { métriquespec ... }

où métrique identifie une ou plusieurs mesures existantes à partir de se connecter en utilisant soit une métrique
nom, ou l'encodage interne du PMID d'une métrique comme domaine.grappe.Articles. Dans ce dernier
cas, généralement domaine serait un entier compris entre 1 et 510, grappe serait un
entier compris entre 0 et 4095, et Articles serait un entier compris entre 0 et 1023.

En tant que cas particuliers Articles pourrait être un astérisque « * » qui signifie que la règle s'applique à tous
métrique avec un numéro de domaine de domaine et un nombre de clusters de grappe, ou grappe pourrait être
un astérisque qui signifie que la règle s'applique à chaque métrique avec un numéro de domaine de domaine
et un numéro d'article de Articles, ou les deux grappe et Articles pourrait être des astérisques, et la règle s'applique
à chaque métrique avec un numéro de domaine de domaine.

Si une métrique désignée n'est pas présente se connecter la règle n'a aucun effet.

Le manuel de formation métriquespec est zéro ou plusieurs des clauses suivantes :

EFFACER

La métrique est complètement supprimée de déconnexion, à la fois les métadonnées et toutes les valeurs dans
les résultats sont effacés.

INDOM -> nouveau domaine.actualités [ en particulier pendant la préparation ]

Modifie les métadonnées pour changer le domaine d'instance de cette métrique. La nouvelle
le domaine d'instance doit exister dans déconnexion.

Le facultatif en particulier pendant la préparation La clause peut être utilisée pour sélectionner une valeur d'entrée ou calculer une
valeur agrégée des instances dans un résultat d'entrée, ou attribuer une valeur interne
identifiant d'instance à une valeur de sortie unique. Si aucun en particulier pendant la préparation clause est spécifiée, la
le comportement par défaut consiste à copier toutes les valeurs d'entrée de chaque résultat d'entrée vers une sortie
résultat, cependant si le domaine d'instance d'entrée est singulier (indom PM_INDOM_NULL)
alors la valeur de sortie doit être affectée à un identifiant d'instance interne, qui
est 0 par défaut, sauf s'il est remplacé par un INST or MON NOM clause telle que définie ci-dessous.

Les choix pour en particulier pendant la préparation sont les suivants:

SORTIE PREMIERE
choisir la valeur de la première instance de chaque résultat d'entrée

SORTIE DERNIER choisir la valeur de la dernière instance de chaque résultat d'entrée

SORTIE INST instid
choisir la valeur de l'instance avec l'identifiant d'instance interne
instid à partir de chaque résultat ; la séquence des règles de réécriture assure la
SORTIE le traitement a lieu avant la renumérotation de l'identifiant d'instance à partir de
tout associé indom règle, donc instid devrait être l'un des internes
identifiants d'instance qui apparaissent dans se connecter

SORTIE MON NOM "prénom"
choisir la valeur de l'instance avec prénom pour son instance externe
nom de chaque résultat ; la séquence des règles de réécriture garantit la
SORTIE le traitement a lieu avant le renommage de l'instance à partir de tout élément associé
indom règle, donc prénom devrait être l'un des noms d'instance externes qui
apparaît dans se connecter

SORTIE MIN choisissez la plus petite valeur dans chaque résultat (le type de métrique doit être numérique)
et l'instance de sortie sera 0 pour un domaine d'instance non singulier)

SORTIE MAX choisissez la plus grande valeur dans chaque résultat (le type de métrique doit être numérique)
et l'instance de sortie sera 0 pour un domaine d'instance non singulier)

SORTIE SUM choisir la somme de toutes les valeurs dans chaque résultat (le type de métrique doit être
l'instance numérique et de sortie sera 0 pour une instance non singulière
domaine)

SORTIE AVG choisir la moyenne de toutes les valeurs dans chaque résultat (le type de métrique doit être
l'instance numérique et de sortie sera 0 pour une instance non singulière
domaine)

Si le domaine d'instance d'entrée est singulier (indom PM_INDOM_NULL) alors indépendamment de
tout en particulier pendant la préparation spécifications, il y a au plus une valeur dans chaque résultat d'entrée et donc
PREMIERE, DERNIER, MIN, MAX, SUM et AVG sont tous équivalents et l'instance de sortie
l'identifiant sera 0.

En général, il s'agit d'une erreur de spécifier une action de réécriture pour les mêmes métadonnées ou
valeurs de résultat plus d'une fois, par exemple plus d'une INDOM clause pour le même
domaine d'instance. La seule exception est l'interaction possible entre le INDOM
clauses dans le indom et métrique règles. Par exemple, la métrique échantillon.bin is
défini sur le domaine d'instance 29.2 dans se connecter et ce qui suit est acceptable
(bien que redondant) :
indom 29.* { indom -> 109.* }
échantillon métrique.bin { indom -> 109.2 }
Cependant, ce qui suit est une erreur, car le domaine d'instance pour échantillon.bin a
deux définitions contradictoires :
indom 29.* { indom -> 109.* }
échantillon métrique.bin { indom -> 123.2 }

INDOM -> NULL[ en particulier pendant la préparation ]

La métrique (qui doit avoir été préalablement définie sur un domaine d'instance) est
être modifiée pour devenir une métrique singulière. Cela implique une modification des métadonnées et
réduire tous les résultats pour cette métrique afin que plusieurs valeurs deviennent une seule valeur.

Le facultatif en particulier pendant la préparation une partie de la clause définit comment la valeur unique pour chaque résultat
doit être calculé et suit les mêmes règles que celles décrites pour le non-NULL
INDOM cas ci-dessus.

En l'absence de en particulier pendant la préparation, la valeur par défaut est SORTIE PREMIERE.

Nom -> nouveau nom

Renomme la métrique dans les métadonnées de l'archive PCP qui prend en charge les performances
Espace de noms de métriques (PMNS). nouveau nom ne doit correspondre à aucun nom existant dans le
PMNS de l'archive et doit suivre les règles syntaxiques pour les noms de métriques valides comme
décrit dans pmn (5).

PMID -> nouveau domaine.nouveau cluster.nouvel article

Modifie les métadonnées et les résultats pour renuméroter le PMID de la métrique.
cas, nouveau cluster pourrait être un astérisque « * » qui signifie utiliser grappe du
métrique règle de réécriture et/ou Articles pourrait être un astérisque qui signifie utiliser Articles grâce au
le métrique règle de réécriture. Ceci est particulièrement utile lorsque grappe et/ou Articles est également
un astérisque. Par exemple :
métrique 30.*.* { pmid -> 123.*.* }
déplacera toutes les métriques du domaine 30 vers le domaine 123.

SEM -> nouvelles

Changer la sémantique de la métrique. nouvelles devrait être la partie XXX du nom de
l'un des PM_SEM_XXX macros définies dans ou pmRechercheDesc(3), par exemple
COMPTEUR pour PM_TYPE_COUNTER.

Aucune réécriture de valeur de données n'est effectuée à la suite de SEM clause, donc le
l'utilité est limitée aux cas où une version du PMDA associé a été
exportation d'une sémantique incorrecte pour la métrique. pmlogreduce(1) peut fournir un
alternative dans les cas où un recalcul des valeurs de résultat est souhaité.

TYPE -> nouveau genre

Modifiez le type de métrique qui modifie les métadonnées et peut modifier le
codage des valeurs dans les résultats. nouveau genre devrait être la partie XXX du nom d'un
du système PM_TYPE_XXX macros définies dans ou pmRechercheDesc(3), par exemple FLOAT
pour PM_TYPE_FLOAT.

La conversion de type n'est prise en charge que dans les cas où l'ancien et le nouveau type de métrique sont
numérique, donc PM_TYPE_STRING, PM_TYPE_AGGREGATE et PM_TYPE_EVENT ne sont pas permis.
Même pour les cas numériques, certaines conversions peuvent produire des erreurs d'exécution, par exemple
dépassement d'entier ou tentative de réécriture d'une valeur négative dans un type non signé.

UNITÉS -> nouvelles unités [ REMISE À L'ÉCHELLE ]

nouvelles unités est composé de six valeurs séparées par des virgules. Les trois premières valeurs décrivent
dimension de la métrique selon les dimensions de l'espace, du temps et du nombre ; ce sont
valeurs entières, généralement 0, 1 ou -1. Les trois valeurs restantes décrivent l'échelle de
les valeurs de la métrique dans les dimensions de l'espace, du temps et du nombre. Échelle spatiale
les valeurs doivent être 0 (si la dimension de l'espace est 0), sinon la partie XXX du nom de
l'un des PM_SPACE_XXX macros, par exemple Ko pour PM_TYPE_KBYTE. Valeurs de l'échelle de temps
devrait être 0 (si la dimension temporelle est 0), sinon la partie XXX du nom de l'un des
le PM_TIME_XXX macros, par exemple SEC pour PM_TIME_SECLes valeurs de l'échelle de comptage doivent être 0
(si la dimension temporelle est 0), sinon ONE pour PM_COUNT_ONE.

Le manuel de formation PM_SPACE_XXX, PM_TIME_XXX et PM_COUNT_XXX les macros sont définies dans
or pmRechercheDesc (3).

Lorsque l'échelle est modifiée (mais que la dimension reste inchangée), le mot-clé facultatif
REMISE À L'ÉCHELLE peut être utilisé pour choisir la mise à l'échelle des valeurs selon le -s option de ligne de commande,
mais appliqué uniquement à cette métrique.

Lors du changement du numéro de domaine d'un domaine de métrique ou d'instance, le nouveau numéro de domaine
correspond généralement à un numéro de domaine PMDA existant. Si ce n'est pas le cas,
le nouveau numéro de domaine ne doit pas être choisi au hasard ; consulter $PCP_VAR_DIR/pmns/stdpmid
pour les numéros de domaine déjà attribués aux PMDA.

EXEMPLES

Pour promouvoir les valeurs des métriques IOPS par disque à 64 bits pour permettre l'agrégation sur une
longue période de planification de la capacité, ou parce que le PMDA est passé à l'exportation 64 bits
compteurs et nous voulons convertir les anciennes archives afin qu'elles puissent être traitées parallèlement aux nouvelles
archives.
disque métrique.dev.read { type -> U64 }
disque métrique.dev.write { type -> U64 }
disque métrique.dev.total { type -> U64 }

Les instances associées à la métrique de charge moyenne noyau.all.load pourrait être renommé et
renuméroté selon les règles ci-dessous.
# pour le PMDA Linux, la métrique kernel.all.load est définie
# sur le domaine d'instance 60.2
indom 60.2 {
inst 1 -> 60 iname "1 minute" -> "60 seconde"
inst 5 -> 300 iname "5 minute" -> "300 seconde"
inst 15 -> 900 iname "15 minute" -> "900 seconde"
}

Si nous décidons de séparer les métriques « proc » du PMDA Linux, cela impliquera
modifier le numéro de domaine pour le PMID de ces métriques et l'instance associée
domaines. Les règles ci-dessous réécriraient une ancienne archive pour tenir compte des modifications apportées après la PMDA.
Divisé.
# toutes les métriques de processus Linux sont dans 7 clusters
métrique 60.8.* { pmid -> 123.*.* }
métrique 60.9.* { pmid -> 123.*.* }
métrique 60.13.* { pmid -> 123.*.* }
métrique 60.24.* { pmid -> 123.*.* }
métrique 60.31.* { pmid -> 123.*.* }
métrique 60.32.* { pmid -> 123.*.* }
métrique 60.51.* { pmid -> 123.*.* }
# un seul domaine d'instance pour les métriques de procédure Linux
indom 60.9 { indom -> 123.0 }

Utilisez pmlogrewrite en ligne avec les services onworks.net