pmlogrewrite - Online en la nube

PROGRAMA:

NOMBRE

pmlogreescribir - reescribir archivos de Performance Co-Pilot

SINOPSIS

$ PCP_BINADM_DIR / pmlogrewrite [-Cdiqsvw ] [-c config] iniciar sesión [fuera de línea]

DESCRIPCIÓN

pmlogreescribir lee un registro de archivo de Performance Co-Pilot (PCP) identificado por iniciar sesión y
crea un registro de archivo PCP fuera de línea. Bajo uso normal, el -c La opción se utilizará para
designar un archivo o archivos de configuración que contengan especificaciones (consulte el REESCRIBIR
REGLAS SINTAXIS sección siguiente) que describen cómo los datos y metadatos de iniciar sesión debiera ser
transformado para producir fuera de línea.

Los usos típicos de pmlogreescribir sería dar cabida a la evolución de Performance
Agentes de dominio de métricas (PMDA) donde los nombres, metadatos y semántica de las métricas y sus
Los dominios de instancia asociados pueden cambiar con el tiempo, por ejemplo, promoviendo el tipo de métrica de
un entero de 32 bits a un entero de 64 bits, o cambiar el nombre de un grupo de métricas. Referirse a EJEMPLOS
sección para algunos casos de uso adicionales.

pmlogreescribir es más útil donde PMDA cambia, o errores en el entorno de producción,
dan como resultado archivos que no se pueden combinar con pmlogextracto(1). Al preprocesar el
archivos con pmlogreescribir los archivos resultantes pueden fusionarse con
pmlogextracto(1).

La entrada iniciar sesión debe ser un registro de archivo de PCP creado por registrador de horas(1), o posiblemente uno de los
herramientas que leen y crean archivos PCP, p. ej. pmlogextracto(1) y pmlogreducir(1).

Si no es correcto -c se especifica la opción, entonces el comportamiento predeterminado simplemente crea fuera de línea como una copia de
iniciar sesión. Esto es un poco más complicado que gato(1), ya que cada archivo de PCP se compone de
varios archivos físicos.

Aunque pmlogreescribir se puede utilizar para reparar algunos problemas de coherencia de datos en archivos de PCP,
También hay una clase de tareas de reparación que no pueden ser manejadas por pmlogreescribir y
etiquetapmlog(1) puede ser una herramienta útil en estos casos.

COMANDO LÍNEA OPCIONES

Las opciones de la línea de comando para pmlogreescribir son los siguientes:

-C Analice las reglas de reescritura y salga. fuera de línea no se crea. Cuándo -C está especificado,
esto también establece -v y -w para que todas las advertencias y mensajes detallados se muestren como
config se analiza.

-c config
If config es un archivo o enlace simbólico, lea y analice las reglas de reescritura desde allí.
If config es un directorio, luego todos los archivos o enlaces simbólicos en ese directorio
(excluyendo los que comienzan con un punto ``. '') se utilizará para proporcionar la
reescritura de reglas. Múltiple -c se permiten opciones.

-d Modo desesperado. Normalmente, si ocurre un error fatal, todo rastro del
archivo PCP escrito fuera de línea es removido. Con el -d opción, la parcialmente creada
fuera de línea el registro de archivo no se elimina.

-i En lugar de crear fuera de línea, iniciar sesión se reescribe en su lugar cuando el -i opción es
usado. Se crea un nuevo archivo utilizando nombres de archivo temporales y luego se le cambia el nombre a
iniciar sesión de tal manera que si se encuentran errores (no advertencias), iniciar sesión
permanece inalterado.

-q Modo rápido, donde si no hay acciones de reescritura que realizar (ninguna de las
datos globales, dominios de instancia o métricas de iniciar sesión será cambiado), entonces
pmlogreescribir saldrá (con estado 0, por lo que es correcto) inmediatamente después de analizar el
archivo (s) de configuración y fuera de línea no se crea.

-s Cuando se cambian las `` unidades '' de una métrica, si la dimensión en términos de espacio,
el tiempo y el recuento no se modifican, entonces el factor de escala se cambia, por ejemplo, BYTE a
KBYTE, o MSEC-1 a USEC-1, o el compuesto MBYTE.SEC-1 a KBYTE.USEC-1. El
La motivación puede ser (a) que los metadatos originales estaban equivocados, pero los valores en iniciar sesión
son correctos, o (b) los metadatos están cambiando, por lo que los valores también deben cambiar.
El valor por defecto pmlogreescribir el comportamiento coincide con el caso (a). Si se aplica el caso (b), utilice
el -s opción y los valores de todas las métricas con un cambio de factor de escala en cada
el resultado será reescalado. Para un control más preciso sobre el cambio de escala de valor, consulte la
RESCALA opción para el BODEGAS cláusula de la regla de reescritura métrica descrita a continuación.

-v Aumente la verbosidad de la salida de diagnóstico.

-w Emite advertencias. Normalmente pmlogreescribir permanece en silencio ante cualquier advertencia que no sea
fatal y se espera que para un archivo en particular, algunos (o de hecho, todos) de
es posible que no se apliquen las especificaciones de reescritura. Por ejemplo, los cambios en un PMDA pueden ser
capturado en un conjunto de reglas de reescritura, pero un solo archivo puede no contener todos los
las métricas modificadas ni todos los dominios de instancia y / o instancias modificados.
Debido a que estos casos son esperados, no previenen pmlogreescribir ejecutando, y
reglas que no se aplican a iniciar sesión se ignoran silenciosamente de forma predeterminada. Del mismo modo, algunos
La reescritura de las reglas puede no implicar cambios porque los metadatos en iniciar sesión ya coincide
la intención de la regla de reescritura de corregir los datos de una versión anterior de un PMDA.
La -w flag obliga a emitir advertencias para todos estos casos.

El argumento fuera de línea se requiere en todos los casos, excepto cuando -i está especificado.

REESCRIBIR REGLAS SINTAXIS

Un archivo de configuración contiene cero o más reglas de reescritura como se define a continuación.

Las palabras clave y los caracteres especiales de puntuación se muestran a continuación en negrita cursiva fuente y son
no distingue entre mayúsculas y minúsculas, así que METRICA, métrico y Métrico son todos equivalentes en la reescritura de reglas.

El carácter `` # '' introduce un comentario y el resto de la línea se ignora.
De lo contrario, la entrada es un formato relativamente libre con espacios en blanco opcionales (espacios, tabulaciones o
nuevas líneas) entre elementos léxicos en las reglas.

A global La regla de reescritura tiene la forma:

GLOBAL { especificación global ... }

dónde especificación global es cero o más de las siguientes cláusulas:

HOSTNAME -> hostname

Modifica los registros de etiqueta en el fuera de línea Archivo PCP, de modo que las métricas
parece haber sido recopilado del anfitrión hostname.

Captura de -> delta

Tanto los valores de métrica como los metadatos del dominio de instancia en un archivo PCP llevan
marcas de tiempo. Esta cláusula obliga a que todas las marcas de tiempo se ajusten por delta, donde el
delta es un signo opcional `` + '' (el predeterminado) o `` - '', un número opcional de
horas seguidas de dos puntos ``: '', un número opcional de minutos seguidos de dos puntos
``: '', un número de segundos, una fracción opcional de segundos después de un punto
``. ''. El ejemplo más simple sería `` 30 '' para aumentar las marcas de tiempo en 30
segundos. Un ejemplo más complejo sería `` -23: 59: 59.999 '' para mover las marcas de tiempo
hacia atrás en un milisegundo menos de un día.

TZ -> "zona horaria"

Modifica los registros de etiqueta en el fuera de línea Archivo PCP, de modo que las métricas
parecen haber sido recopilados de un host con una zona horaria local de zona horaria.
zona horaria debe estar entre comillas y debe ajustarse a la zona horaria válida
reglas de sintaxis para la plataforma local.

An Indom La regla de reescritura modifica un dominio de instancia y tiene la forma:

INDOM dominio.de serie { indomspec ... }

dónde dominio y de serie identificar uno o más dominios de instancia existentes de iniciar sesión -
típicamente dominio sería un número entero en el rango de 1 a 510 y de serie sería un entero
en el rango de 0 a 4194304.

Como caso especial de serie podría ser un asterisco `` * '', lo que significa que la regla se aplica a todos los
dominio de instancia con un número de dominio de dominio.

Si un dominio de instancia designado no está en iniciar sesión la regla no tiene efecto.

La indomspec es cero o más de las siguientes cláusulas:

NOMBRE "viejo nombre" -> "nuevo nombre"

La instancia identificada por el nombre de la instancia externa viejo nombre se renombra a
nuevo nombre. Ambos viejo nombre y nuevo nombre debe ir entre comillas.

Como caso especial, el nuevo nombre puede ser la palabra clave BORRAR (sin comillas) y
entonces la instancia viejo nombre será eliminado de fuera de línea que lo quita de la
metadatos del dominio de instancia y elimina todos los valores de esta instancia para todos los
métricas asociadas.

Si los nombres de las instancias contienen espacios incrustados, se debe tener especial cuidado.
tomado con respecto a la regla de nomenclatura de instancias de PCP que trata los
parte del nombre de la instancia como la parte única del nombre a los efectos de
hacer coincidir y garantizar la unicidad dentro de un dominio de instancia, consulte
instancia pmda(3) para una discusión sobre este tema.

Como ilustración, considere el dominio de instancia hipotético para una métrica que
contiene 2 instancias con los siguientes nombres:
rojo
puerca urk

Entonces algunos posibles NOMBRE las cláusulas pueden ser:

"eek" -> "amarillo como una flor"
Aceptable, viejo nombre "eek" coincide con la instancia "eek urk".

"rojo" -> "eek"
Error, nuevo nombre "eek" coincide con la instancia "eek urk" existente.

"eek urk" -> "rojo de otro tono"
Error, nuevo nombre "rojo de otro tono" coincide con la instancia "roja" existente.

INDOM -> nuevo dominio.nueva serie

Modifica los metadatos del dominio de instancia y todas las métricas asociadas con el
dominio de instancia. Como caso especial, nueva serie podría ser un asterisco `` * '' que
significa uso de serie del Indom regla de reescritura, aunque esto es más útil cuando
de serie también es un asterisco. Así por ejemplo:
indom 29. * {indom -> 109. *}
moverá todos los dominios de instancia del dominio 29 al dominio 109.

INDOM -> DUPLICAR nuevo dominio.nueva serie

Un caso especial de lo anterior INDOM cláusula donde el dominio de instancia es un
copia duplicada del dominio.de serie dominio de instancia del Indom reescribir la regla,
y luego las reglas de mapeo se aplican a la copia nuevo dominio.nueva serie ejemplo
dominio. Esto es útil cuando un PMDA está dividido y el mismo dominio de instancia necesita
ser replicado para dominio dominio y dominio nuevo dominio. Entonces, por ejemplo, si el
métrica foo.uno y foo.dos están ambos definidos en el dominio de instancia 12.34, y
foo.dos se mueve a otro PMDA usando el dominio 27, luego la siguiente reescritura
las reglas se pueden utilizar:
indom 12.34 {indom -> duplicar 27.34}
métrico foo.two {indom -> 27.34 pmid -> 27. *. *}

INST viejo -> nueva identificación

La instancia identificada por el identificador de instancia interno viejo se renumera a
nueva identificación. Ambos viejo y nueva identificación son números enteros en el rango de 0 a 231-1.

Como caso especial, nueva identificación puede ser la palabra clave BORRAR y luego la instancia viejo
será eliminado de fuera de línea que lo elimina de los metadatos del dominio de la instancia
y elimina todos los valores de esta instancia para todas las métricas asociadas.

A métrico La regla de reescritura tiene la forma:

METRICA métrico { especificación métrica ... }

dónde métrico identifica una o más métricas existentes de iniciar sesión usando una métrica
nombre, o la codificación interna para el PMID de una métrica como dominio.grupo.ít. En lo ultimo
caso, típicamente dominio sería un número entero en el rango de 1 a 510, grupo sería un
entero en el rango de 0 a 4095, y ít sería un número entero en el rango de 0 a 1023.

Como casos especiales ít podría ser un asterisco `` * '', lo que significa que la regla se aplica a todos los
métrica con un número de dominio de dominio y un grupo de grupo o grupo podría ser
un asterisco que significa que la regla se aplica a cada métrica con un número de dominio de dominio
y un número de artículo de ít, o ambos grupo y ít podrían ser asteriscos y se aplica la regla
a cada métrica con un número de dominio de dominio.

Si una métrica designada no está en iniciar sesión la regla no tiene efecto.

La especificación métrica es cero o más de las siguientes cláusulas:

BORRAR

La métrica se elimina por completo de fuera de línea, tanto los metadatos como todos los valores en
los resultados se borran.

INDOM -> nuevo dominio.nueva serie [ recoger ]

Modifica los metadatos para cambiar el dominio de la instancia para esta métrica. El nuevo
el dominio de instancia debe existir en fuera de línea.

La opción recoger La cláusula se puede utilizar para seleccionar un valor de entrada, o calcular un
valor agregado de las instancias en un resultado de entrada, o asignar un valor interno
identificador de instancia a un único valor de salida. Si no recoger se especifica la cláusula, la
El comportamiento predeterminado es copiar todos los valores de entrada de cada resultado de entrada a una salida.
resultado, sin embargo, si el dominio de instancia de entrada es singular (indom PM_INDOM_NULL)
entonces al valor de una salida se le debe asignar un identificador de instancia interno, que
es 0 por defecto, a menos que sea anulado por un INST or NOMBRE cláusula como se define a continuación.

Las opciones para recoger son los siguientes:

SALIDA PRIMERO
elija el valor de la primera instancia de cada resultado de entrada

SALIDA ÚLTIMO elija el valor de la última instancia de cada resultado de entrada

SALIDA INST instido
elija el valor de la instancia con el identificador de instancia interno
instido de cada resultado; la secuencia de reescritura de las reglas asegura la
SALIDA el procesamiento ocurre antes de que el identificador de instancia se renumere de
cualquier asociado Indom regla, entonces instido debe ser uno de los internos
identificadores de instancia que aparecen en iniciar sesión

SALIDA NOMBRE "nombre "
elige el valor de la instancia con nombre para su instancia externa
nombre de cada resultado; la secuencia de reescritura de las reglas asegura la
SALIDA el procesamiento ocurre antes del cambio de nombre de la instancia desde cualquier asociado
Indom regla, entonces nombre debe ser uno de los nombres de instancias externas que
aparece en iniciar sesión

SALIDA MIN elija el valor más pequeño en cada resultado (el tipo de métrica debe ser numérico
y la instancia de salida será 0 para un dominio de instancia no singular)

SALIDA MAX Elija el valor más grande en cada resultado (el tipo de métrica debe ser numérico
y la instancia de salida será 0 para un dominio de instancia no singular)

SALIDA SUM elija la suma de todos los valores en cada resultado (el tipo de métrica debe ser
la instancia numérica y de salida será 0 para una instancia no singular
dominio)

SALIDA AVG elija el promedio de todos los valores en cada resultado (el tipo de métrica debe ser
la instancia numérica y de salida será 0 para una instancia no singular
dominio)

Si el dominio de la instancia de entrada es singular (indom PM_INDOM_NULL) entonces independiente de
cualquier recoger especificaciones, hay como máximo un valor en cada resultado de entrada y, por lo tanto,
PRIMERO, ÚLTIMO, MIN, MAX, SUM y AVG son todos equivalentes y la instancia de salida
el identificador será 0.

En general, es un error especificar una acción de reescritura para los mismos metadatos o
valores de resultado más de una vez, por ejemplo, más de uno INDOM cláusula para lo mismo
dominio de instancia. La única excepción es la posible interacción entre los INDOM
cláusulas en el Indom y métrico reglas. Por ejemplo, la métrica muestra.bin is
definido sobre el dominio de instancia 29.2 en iniciar sesión y lo siguiente es aceptable
(aunque redundante):
indom 29. * {indom -> 109. *}
metric sample.bin {indom -> 109.2}
Sin embargo, lo siguiente es un error, porque el dominio de instancia para muestra.bin tiene
dos definiciones contradictorias:
indom 29. * {indom -> 109. *}
metric sample.bin {indom -> 123.2}

INDOM -> NULL[ recoger ]

La métrica (que debe haberse definido previamente en un dominio de instancia) es
siendo modificado para ser una métrica singular. Esto implica un cambio de metadatos y
contraer todos los resultados de esta métrica para que varios valores se conviertan en un valor.

La opción recoger parte de la cláusula define cómo el valor único para cada resultado
debe calcularse y sigue las mismas reglas que se describen para los valores no NULL
INDOM caso anterior.

En ausencia de recoger, el valor predeterminado es SALIDA PRIMERO.

NOMBRE -> nuevo nombre

Cambia el nombre de la métrica en los metadatos del archivo PCP que respalda el rendimiento.
Espacio de nombres de métricas (PMNS). nuevo nombre no debe coincidir con ningún nombre existente en el
PMNS del archivo y debe seguir las reglas sintácticas para nombres de métricas válidas como
esbozado en pmns(5).

PMID -> nuevo dominio.nuevo clúster.nuevo artículo

Modifica los metadatos y los resultados para volver a numerar el PMID de la métrica. Tan especial
casos, nuevo clúster podría ser un asterisco `` * '' que significa uso grupo del
métrico reescribir la regla y / o ít podría ser un asterisco que significa uso ít Desde
el métrico regla de reescritura. Esto es más útil cuando grupo y/o ít También es
Un asterisco. Así por ejemplo:
métrica 30. *. * {pmid -> 123. *. *}
moverá todas las métricas del dominio 30 al dominio 123.

SEM -> noticias

Cambia la semántica de la métrica. noticias debe ser la parte XXX del nombre de
uno de los PM_SEM_XXX macros definidas en o pmBuscarDesc(3), p. Ej.
CONTADOR para PM_TYPE_COUNTER.

No se realiza ninguna reescritura de valores de datos como resultado de la SEM cláusula, por lo que la
La utilidad se limita a los casos en los que se ha utilizado una versión del PMDA asociado.
exportando semántica incorrecta para la métrica. pmlogreducir(1) puede proporcionar una
alternativa en los casos en que se desee volver a calcular los valores de los resultados.

TIPO -> nuevo tipo

Cambiar el tipo de métrica que altera los metadatos y puede cambiar la
codificación de valores en resultados. nuevo tipo debe ser la parte XXX del nombre de uno
del PM_TYPE_XXX macros definidas en o pmBuscarDesc(3), p. Ej. FLOAT
para PM_TYPE_FLOAT.

La conversión de tipo solo se admite en los casos en los que el tipo de métrica antiguo y nuevo es
numérico, entonces PM_TYPE_STRING, PM_TYPE_AGGREGATE y PM_TYPE_EVENT no están permitidos.
Incluso para los casos numéricos, algunas conversiones pueden producir errores en tiempo de ejecución, p. Ej.
desbordamiento de enteros o intentar reescribir un valor negativo en un tipo sin signo.

BODEGAS -> nuevas unidades [ RESCALA ]

nuevas unidades son seis valores separados por comas. Los primeros 3 valores describen la
dimensión de la métrica a lo largo de las dimensiones de espacio, tiempo y recuento; estos son
valores enteros, generalmente 0, 1 o -1. Los 3 valores restantes describen la escala de
los valores de la métrica en las dimensiones de espacio, tiempo y recuento. Escala espacial
los valores deben ser 0 (si la dimensión del espacio es 0), de lo contrario, la parte XXX del nombre de
uno de los PM_SPACE_XXX macros, p. ej. KBITE para PM_TYPE_KBYTE. Valores de escala de tiempo
debe ser 0 (si la dimensión de tiempo es 0), de lo contrario, la parte XXX del nombre de uno de
el PM_TIME_XXX macros, p. ej. SEG para PM_TIME_SEC. Los valores de la escala de conteo deben ser 0
(si la dimensión de tiempo es 0), de lo contrario ONE para PM_COUNT_ONE.

La PM_SPACE_XXX, PM_TIME_XXX y PM_COUNT_XXX las macros se definen en
or pmBuscarDesc(3).

Cuando se cambia la escala (pero la dimensión no se modifica), la palabra clave opcional
RESCALA se puede utilizar para elegir el cambio de escala de valor según el -s opción de línea de comando,
pero aplicado solo a esta métrica.

Al cambiar el número de dominio para una métrica o un dominio de instancia, el nuevo número de dominio
normalmente coincidirá con el número de dominio de un PMDA existente. Si este no es el caso, entonces
el nuevo número de dominio no debe elegirse al azar; consultar $ PCP_VAR_DIR / pmns / stdpmid
para números de dominio que ya están asignados a PMDA.

EJEMPLOS

Para promover los valores de las métricas de IOPS por disco a 64 bits para permitir la agregación en un
un período de tiempo prolongado para la planificación de la capacidad, o porque el PMDA ha cambiado para exportar 64 bits
contadores y queremos convertir archivos antiguos para que puedan procesarse junto con los nuevos
archivos.
metric disk.dev.read {tipo -> U64}
metric disk.dev.write {tipo -> U64}
metric disk.dev.total {tipo -> U64}

Las instancias asociadas con la métrica de promedio de carga kernel.toda.carga podría ser renombrado y
renumerado por las reglas siguientes.
# para Linux PMDA, se define la métrica kernel.all.load
# sobre el dominio de instancia 60.2
Indom 60.2 {
inst 1 -> 60 iname "1 minuto" -> "60 segundos"
inst 5 -> 300 iname "5 minuto" -> "300 segundos"
inst 15 -> 900 iname "15 minuto" -> "900 segundos"
}

Si decidimos dividir las métricas `` proc '' del PMDA de Linux, esto implicará
cambiar el número de dominio para el PMID de estas métricas y la instancia asociada
dominios. Las siguientes reglas volverían a escribir un archivo antiguo para que coincida con los cambios posteriores al PMDA
división.
# todas las métricas de proc de Linux están en 7 clústeres
métrica 60.8. * {pmid -> 123. *. *}
métrica 60.9. * {pmid -> 123. *. *}
métrica 60.13. * {pmid -> 123. *. *}
métrica 60.24. * {pmid -> 123. *. *}
métrica 60.31. * {pmid -> 123. *. *}
métrica 60.32. * {pmid -> 123. *. *}
métrica 60.51. * {pmid -> 123. *. *}
# solo un dominio de instancia para métricas de proceso de Linux
indom 60.9 {indom -> 123.0}

Use pmlogrewrite en línea usando los servicios de onworks.net