Este es el comando pmlogextract que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
pmlogextracto - reducir, extraer, concatenar y fusionar archivos de Performance Co-Pilot
SINOPSIS
pmlogextracto [-dfwz] [-c archivo de configuración] [-S hora de inicio] [-s cualquier] [-T hora de finalización] [-v
volmuestras] [-Z zona horaria] Las opciones de entrada [...] salida
DESCRIPCIÓN
pmlogextracto lee uno o más registros de archivo de Performance Co-Pilot (PCP) identificados por Las opciones de entrada
y crea un registro de archivo PCP temporalmente fusionado y / o reducido salida. La naturaleza de
la fusión está controlada por el número de registros de archivo de entrada, mientras que la naturaleza de los datos
la reducción está controlada por los argumentos de la línea de comandos. Las entradas deben ser archivos PCP
registros creados por registrador de horas(1) con datos de rendimiento recopilados de la mismo anfitrión, pero
generalmente en diferentes períodos de tiempo y posiblemente (aunque no generalmente) con diferentes
métricas de rendimiento que se registran.
Si solo uno Las opciones de entrada se especifica, entonces el comportamiento predeterminado simplemente copia el PCP de entrada
registro de archivo, en el registro de archivo PCP de salida. Cuando dos o más registros de archivo de PCP están
especificado como Las opciones de entrada, los registros se fusionan (o concatenan) y se escriben en salida.
En el registro de archivo de salida se insertará un registro de `` marca '' a la vez justo después del final
de cada uno de los registros del archivo de entrada para indicar una posible discontinuidad temporal entre
el final de un registro de archivo de entrada y el inicio del siguiente registro de archivo de entrada. Ver el
MARCA EXPEDIENTES sección siguiente para obtener más información. No hay registro de `` marca '' después de la
fin del pasado (en orden temporal) de los registros del archivo de entrada.
COMANDO LÍNEA OPCIONES
Las opciones de la línea de comando para pmlogextracto son los siguientes:
-c archivo de configuración
Extraiga solo las métricas especificadas en archivo de configuración de la Las opciones de entrada Registro (s) de archivo de PCP.
El sistema archivo de configuración sintaxis aceptada por pmlogextracto se explica con más detalle en el
Configuration Archive Sintaxis .
-d Modo desesperado. Normalmente, si ocurre un error fatal, todo rastro del
archivo PCP escrito salida es removido. Con el -d opción, la salida registro de archivo
no se elimina.
-f Para los usos más comunes, todos los registros del archivo de entrada se habrán recopilado en el
misma zona horaria. Pero si este no es el caso, entonces pmlogextracto debe elegir uno de
las zonas horarias de los registros del archivo de entrada que se utilizarán como zona horaria para la salida
registro de archivo. El valor predeterminado es usar la zona horaria del pasado registro de archivo de entrada.
El sistema -f La opción fuerza la zona horaria de la first registro de archivo de entrada que se utilizará.
-S hora de inicio
Definir el inicio de una ventana de tiempo para restringir las muestras recuperadas o especificar un
alineación `` natural '' de los tiempos de muestreo de salida; Referirse a PCPIntroducción(1). Ver también
de la forma más -w .
-s cualquier
El argumento cualquier define el número de muestras que se escribirán salida. Si
cualquier es 0 o -s no está especificado, pmlogextracto muestreará hasta el final de la
Registro de archivo de PCP, o el final de la ventana de tiempo especificado por -T, lo que venga
primero. los -s opción anulará la -T opción si ocurre antes.
-T hora de finalización
Definir la terminación de una ventana de tiempo para restringir las muestras recuperadas o
especificar una alineación `` natural '' de los tiempos de muestreo de salida; Referirse a PCPIntroducción(1).
Vea también el -w .
-v volmuestras
El sistema salida El registro de archivo es potencialmente un conjunto de datos de varios volúmenes, y el -v opción
causas pmlogextracto para comenzar un nuevo volumen después volmuestras los registros de registro se han
escrito en el registro de archivo.
Independiente de cualquier -v opción, cada volumen de un archivo está limitado a no más de
2 ^ 31 bytes, entonces pmlogextracto creará automáticamente un nuevo volumen para el archivo
antes de que se alcance este límite.
-w Dónde -S y -T especificar una ventana de tiempo dentro del mismo día, el -w la bandera causará
los datos dentro de la ventana de tiempo que se extraerán, para cada día en el registro de archivo.
Por ejemplo, las opciones -w -S @ 11: 00 -T @ 15: 00 especificar eso pmlogextracto should
Incluya los registros de archivo solo para los períodos de 11 a. m. a 3 p. m. de cada día.
Cuándo -w Se utiliza, el salida El registro de archivo contendrá registros de `` marca '' para indicar
la discontinuidad temporal entre el final de una ventana de tiempo y el comienzo de la
siguiente.
-Z zona horaria
Usa zona horaria al mostrar la fecha y la hora. Zona horaria tiene el formato de
Variable ambiental TZ como se describe en entorno(7).
-z Utilice la zona horaria local del host de los registros del archivo de entrada. El valor predeterminado es
utilice inicialmente la zona horaria del host local.
CONFIGURACIÓN ARCHIVO SINTAXIS
El sistema archivo de configuración contiene métricas de interés: solo las métricas (o instancias) mencionadas
explícita o implícitamente en el archivo de configuración se incluirá en el salida archivo.
Cada especificación debe comenzar en una nueva línea y puede abarcar varias líneas en el
archivo de configuración. También se pueden especificar instancias, pero son opcionales. El formato
para cada especificación es
métrica [[instancia [, instancia ...]]]
donde métrico puede ser un nombre de hoja o no hoja en el espacio de nombres de métricas de rendimiento (PMNS,
ver pmns(5)). Si una métrica se refiere a un nodo no hoja en el PMNS, pmlogextracto will
descender recursivamente el PMNS e incluir todas las métricas correspondientes a la hoja descendente
nodos
Las instancias son opcionales y se pueden especificar como una lista de uno o más espacios (o comas)
nombres separados, números o cadenas (entre comillas simples o dobles). Elementos en
se supone que la lista que son números son identificadores de instancia internos; consulte
pmGetInDom(3) para obtener más información. Si no se dan instancias, entonces all instancias de la
Se extraerán las métricas asociadas.
Cualquier espacio en blanco adicional se ignora y se pueden agregar comentarios con un prefijo '#'.
CONFIGURACIÓN ARCHIVO EJEMPLO
Este es un ejemplo de un archivo de configuración:
#
# archivo de configuración para pmlogextract
#
núcleo.toda.cpu
kernel.percpu.cpu.sys ["cpu0", "cpu1"]
disk.dev ["dks0d1"]
MARCA EXPEDIENTES
Cuando más de un registro de archivo de entrada aporta datos de rendimiento al archivo de salida
log, luego se insertan registros de `` marca '' para indicar una posible discontinuidad en el
datos de rendimiento.
Un registro de `` marca '' contiene una marca de tiempo y no datos de rendimiento y se usa para indicar
que hay un período de tiempo en el registro de archivo de PCP en el que no conocemos los valores de any
métricas de rendimiento, porque no había registrador de horas(1) recopilar datos de rendimiento durante
este periodo. Dado que estos períodos a menudo se asocian con el reinicio de un servicio o
pmcd(1) o un sistema, puede haber dudas considerables en cuanto a la continuidad del desempeño
datos a lo largo de este período de tiempo.
La justificación detrás de los registros de `` calificación '' se puede demostrar con un ejemplo. Considere uno
registro de archivo de entrada que comienza a las 00:10 y termina a las 09:15 del mismo día, y otro
registro de archivo de entrada que comienza a las 09:20 del mismo día y termina a las 00:10 del siguiente
Mañana. Sería un caso muy común de archivos gestionados y rotados por
pmlogger_check(1) y pmlogger_daily(1).
El registro de archivo de salida contendría:
00: 10.000 primer registro del primer registro de archivo de entrada
...
09: 15.000 último registro del primer registro de archivo de entrada
09: 15.001
09: 20.000 primer registro del segundo registro de archivo de entrada
...
01: 10.000 último registro del segundo registro de archivo de entrada
El período de tiempo en el que faltan los datos de rendimiento comienza justo después de las 09:15 y finaliza
justo antes de las 09:20. Cuando el registro de archivo de salida se procesa con cualquiera de los informes de PCP
herramientas, el registro de `` marca '' se utiliza para indicar un período de datos faltantes. Por ejemplo en
el archivo anterior, si uno informaba la tasa de E / S promedio a intervalos de 30 minutos,
alineado en la hora, entonces habría datos para los intervalos que terminan a las 09:00 y 10:00
pero no se informan datos para el intervalo que finaliza a las 09:30 ya que abarca un registro de `` marca ''.
La presencia de registros de `` marca '' en un registro de archivo de PCP se puede establecer utilizando
pmdumplog(1) donde una marca de tiempo y la anotación se utiliza para indicar una `` marca ''
registro.
METADATOS CHEQUES
Cuando mas de uno Las opciones de entrada se especifica el archivo, pmlogextracto realiza una serie de comprobaciones para
asegurarse de que los metadatos sean coherentes para las métricas que aparecen en más de uno de los Las opciones de entrada
archivo. Estos controles incluyen:
* el tipo de datos métrico es el mismo
* la semántica métrica es la misma
* las unidades métricas son las mismas
* la métrica es siempre singular o siempre tiene el mismo dominio de instancia
* las métricas con el mismo nombre tienen el mismo PMID
* las métricas con el mismo PMID tienen el mismo nombre
Si alguna de estas comprobaciones falla, pmlogextracto informa los detalles y aborta sin crear
de la forma más salida archivo.
Para abordar estos problemas semánticos, utilice pmlogreescribir(1) para traducir el Las opciones de entrada archivos en
archivos equivalentes con metdadata consistente antes de usar pmlogextracto.
Use pmlogextract en línea usando los servicios de onworks.net