pmmgr - Online en la nube

PROGRAMA:

NOMBRE

pmmgr - administrador de demonios pcp

SINOPSIS

pmmgr [-v] [-c directorio de configuración] [-p intervalo de votación] [-l archivo de registro]

DESCRIPCIÓN

pmmgr gestiona una colección de demonios PCP para un conjunto de hosts locales y remotos descubiertos
ejecutando Performance Metrics Collection Daemon (PMCD), de acuerdo con cero o más
directorios de configuración. Mantiene un juego de registrador de horas y/o pmie demonios
en ejecución, y sus archivos / registros fusionados / rotados. Suplanta a los mayores pmlogger_ * y
pmie_ * comprobar / scripts de shell de gestión diaria.

pmmgr es en gran parte autoconfigurable y persevera a pesar de la mayoría de los errores de tiempo de ejecución. pmmgr se ejecuta
en primer plano hasta que se interrumpe. Cuando se le indique, detendrá sus demonios en ejecución.
antes de salir

Una descripción de las opciones de la línea de comandos específicas de pmmgr manera:

-c directorio agrega un directorio de configuración dado a pmmgr. pmmgr puede supervisar
múltiples configuraciones diferentes al mismo tiempo. Los errores en la configuración pueden
se anotará el error estándar, pero pmmgr completará la información faltante con una función
valores predeterminados. El directorio predeterminado es $ PCP_SYSCONF_DIR / pmmgr

-p intervalo de votación establece el intervalo de sondeo de descubrimiento de host en el número dado de
segundos. El valor predeterminado es 60. Se reiniciarán los demonios de un host de destino en particular.
no con más frecuencia que este intervalo.

-l archivo de registro redirige la salida estándar y el error al archivo de registro dado, que se crea
de nuevo

-v agrega un seguimiento más detallado a la salida estándar.

CONFIGURACIÓN

A pmmgr La configuración identifica qué hosts deben ser monitoreados, qué demonios deben ser
mantenidos para ellos, y con qué opciones deben ejecutarse esos demonios. pmmgr usa un
pequeña cantidad de archivos en un directorio de configuración, en lugar de líneas en un archivo de texto. los
Los archivos individuales contienen cero o más líneas de texto de configuración 100% puro, y no
comentarios. (Si lo desea, se puede comentar una configuración con cualquier otro archivo, como
un archivo README de formato libre).

OBJETIVO SELECCIÓN
Este conjunto de archivos de configuración identifica dónde pmmgr debe buscar instancias de pmcd,
cómo identificarlos de forma única y dónde se deben guardar los estados, como los archivos de registro, para cada uno.
Idealmente, se calcula una cadena de identificación de host persistente y única para cada objetivo pmcd potencial
a partir de valores métricos especificados. Este ID de host también se utiliza como nombre de subdirectorio para
localizar datos del demonio.

métricas de hostid
Este archivo contiene una o más líneas de especificaciones métricas en el formato
aceptado por pmParseMetricSpec. Las métricas sin especificadores de instancia significan todo
instancias de esa métrica. Estos se utilizan para generar el único cadena de ID de host para
cada servidor pmcd que descubre pmmgr. Tras el descubrimiento, todas las métricas / instancias
nombrados se consultan, los valores de cadena se obtienen y se normalizan / concatenan en un solo
cadena imprimible con guiones. El valor predeterminado es la métrica única pmcd.nombre de host, cual
es suficiente si todos los hosts descubiertos tienen hostname(2). Si no lo hacen
debe agregar otras especificaciones métricas de pcp para diferenciarlas en su sitio. los
Cuanto más agregue, más larga será la cadena de ID de host, pero es más probable que
se evita la duplicación.

Sin embargo, puede ser deseable que un ID de host también sea persistente, de modo que si el
el host de destino se desconecta y luego regresa, el nuevo ID de host coincide con el anterior
uno, porque entonces se pueden unir historias antiguas y nuevas. Esto argumenta en contra de usar
métricas cuyos valores varían de un arranque a otro.

Algunas métricas candidatas a considerar: red.interfaz.hw_addr,
network.interface.inet_addr ["eth0"], red.interfaz.ipv6_addr,
kernel.uname.nodename

directorio de registro
Este archivo contiene la ruta de un directorio debajo del cual el identificador por host
pmmgr debe crear los subdirectorios. Si no es un camino completo, es
implícitamente relativo al directorio de configuración en sí. El valor predeterminado es
$ PCP_LOG_DIR / pmmgr /.

host-objetivo
Este archivo contiene una o más líneas que contienen especificaciones de host pmcd, como
descrito en el PCPintro(1) página de manual. Cada intervalo de sondeo, pmmgr intentará
hacer un breve pmNuevoContexto conexión con el anfitrión para comprobar la vivacidad. No es un
problema si se enumera más de una especificación para el mismo host, porque el
El procesamiento de ID de host elimina los duplicados y elige una especificación arbitraria
entre ellos. El valor predeterminado es apuntar a pmcd local:.

descubrimiento de destino
Este archivo contiene una o más líneas que contienen especificaciones para el
pmDescubrirServicios Llamada PMAPI, cada una de las cuales puede mapear en un conjunto fluctuante de
servidores pmcd locales o remotos. Cada intervalo de sondeo, pmmgr intentará volver a ejecutar
descubrimiento con todas las especificaciones dadas. Nuevamente, no es un problema si más
de una especificación coincide con el mismo pmcd real: una ruta de acceso confirmada es
seleccionado arbitrariamente. Lo predeterminado es hacer no descubrimiento. Considere incluir
avahi, tiempo de espera = 5 confiar en los autoanuncios de pmcd en la red local (buscando
hasta cinco segundos cada vez).

contenedores-sub-objetivo
Si este archivo existe, pmmgr escaneará cada host que se encuentre para ejecutar
contenedores. Para cada contenedor en ejecución, creará subobjetivos independientes para
ejecutando instancias pmlogger. La cadena de ID de host para estos subobjetivos es la del host.
cadena de identificación de host, seguida de un guión doble, luego el contenedor único completo
cadena de nombre de instancia. (Temporalmente, no se intentan instancias pmie para estos
sub-objetivos, debido al error de PCP PR1105.)

log-subdirectorio-gc
Este archivo puede contener una especificación de intervalo de tiempo según el PCPintro página del hombre
Se presume que todos los subdirectorios del directorio log contienen datos para pmmgr-
servidores monitoreados. Aquellos que no han sido tocados (en el stat / mtime sentido) en
al menos ese tiempo, y no asociado con un objetivo actualmente monitoreado, son
eliminado por completo. Este valor debe ser más largo que el intervalo más largo que pmmgr
normalmente recrea archivos (por ejemplo, debido a reinicios de pmmgr, y pmlogmerge
intervalos). El valor predeterminado es 90days.

PMLOGGER CONFIGURACIÓN
Este grupo de opciones de configuración controla un registrador de horas demonio para cada host. Esto puede
incluyen la generación de su configuración y la gestión de sus archivos.

registrador de horas
Si y solo si este archivo existe, pmmgr mantendrá un registrador de horas demonio para cada
anfitrión objetivo. Este archivo contiene una línea de opciones adicionales separadas por espacios
para el demonio pmie. (pmmgr ya agrega -h, -f, -r, -l y quizás -c.) El
por defecto es mantener no registrador de horas (y ninguna otra configuración en esta sección es
procesado).

pmlogconf
Si y solo si este archivo existe, pmmgr se ejecutará pmlogconf generar un
archivo de configuración para cada pmcd de destino. El archivo contiene una línea de espacio
opciones adicionales separadas para el programa pmlogconf. pmlogconf's generado
El archivo de salida se almacenará en el subdirectorio log-directory / hostid. (pmmgr
ya agrega -c, -r y -h.) El valor predeterminado es no pmlogconf, entonces, en cambio, el
El archivo pmlogger anterior probablemente debería contener una opción -c, para especificar un
configuración de pmlogger.

ARCHIVO LOG ADMINISTRACIÓN
Las configuraciones predeterminadas de pmlogger pueden recopilar decenas de megabytes de datos por día (posiblemente
dividido en varios archivos), por host de destino. Si su espacio en disco es menos que infinito,
o la división de archivos es difícil de manejar, esto debe gestionarse. En el caso predeterminado, no administrado,
el administrador del sistema es responsable de gestionar el individuo archivo-* archivos de
los subdirectorios de registro por host. pmmgr ofrece varias otras opciones, cada una
que representan diferentes compensaciones de rendimiento / usabilidad.

ARCHIVO LOG ADMINISTRACIÓN - pmlogmerge
Este estilo de gestión de registros de archivos crea regularmente un único archivo combinado de archivos anteriores.
archivos para cada host de destino, de hecho, eliminando los datos antiguos y agregando los nuevos. A
archivo único combinado puede ser relativamente grande (el valor predeterminado es de aproximadamente 100-400 MB por
host) y coloca una carga de E / S correspondiente en el almacenamiento, pero es más conveniente para un
análisis a largo plazo. Una vez que se reinicia pmlogger, siempre crea un nuevo archivo, por lo que
en el estado estacionario, habrá un archivo combinado de historia reciente, y un archivo actual
archivo en el que se escribe pmlogger.

pmlogmerge
Si este archivo existe, pmmgr se ejecutará pmlogextracto fusionarse periódicamente
archivos de registro preexistentes para cada pmcd de destino en uno solo grande. Entonces el
Los archivos de registro preexistentes se eliminan (incluidos los anteriores fusionados). Esta
El archivo de configuración puede contener una especificación de intervalo de tiempo según el PCPintro
página de manual, que representa el período después del cual pmlogger debe ser temporalmente
se detuvo y los archivos se fusionaron. Representa la cantidad máxima de tiempo que el
archivo combinado Retrasos el tiempo presente. El valor predeterminado es 24 horas.

pmlogmerge-granular
Si este archivo existe, pmmgr fusionará solo un subconjunto de archivos de registro preexistentes
en el nuevo, en lugar de todos ellos, para aproximar un granular, alineado
conjunto de archivos combinados. El subconjunto elegido corresponde al tiempo anterior
intervalo especificado por el pmlogmerge archivo de control. El valor predeterminado es no granularidad.

pmlogmerge-reescribir
Si este archivo existe, pmmgr se ejecutará pmlogreescribir -i (más cualquier otra opción listada
en este archivo) en cada archivo de entrada antes de fusionarlo. Esto naturalmente requerirá
más E / S de disco. El valor predeterminado es no reescritura.

pmlogmerge-retener
pmmgr reduce / elimina cualquier archivo de resolución original después de un período de tiempo
especificado por este archivo, medido por el archivo mtime. El período también será
pasado a pmlogextract como parámetro negativo a -S. El valor predeterminado es 14days. Para
almacenar archivos indefinidamente, configúrelo en una gran cantidad como "99999weeks".

pmlogreducir
Si este archivo existe, antes de eliminar los archivos que caducan más allá del
pmlogmerge-retener período, se procesan con pmlogreducir para crear reducido
archivos (llamado reducido-*). Si el archivo contiene opciones separadas por espacios, son
pasó a pmlogreduce. (De forma predeterminada, pmlog reduce las muestras a 600 segundos
intervalo.)

pmlogreducir-retener
Si este archivo existe, entonces los archivos reducidos (identificados por el reducido-* patrón)
se eliminan después de un período de tiempo especificado por este archivo, medido desde el archivo
mtime. Dado que es probable que este tiempo sea el de la ejecución pmlogreduce, la retención total
el tiempo será aproximadamente el tiempo pmlog de fusión-retención más el pmlogreduce-retenga
tiempo. El valor predeterminado es 90days. Para almacenar archivos reducidos indefinidamente, establezca esto en
una gran cantidad como "99999weeks".

PMIE CONFIGURACIÓN
Este grupo de opciones de configuración controla un pmie demonio para cada host. Esto puede
incluir la generación de una configuración personalizada.

pmie Si y solo si este archivo existe, pmmgr mantendrá un pmie demonio para cada
pmcd dirigido. Este archivo contiene una línea de opciones adicionales separadas por espacios
para el demonio pmie. (pmmgr ya agrega -h, -f, -l y quizás -c.) El valor predeterminado
es mantener no pmie (y no se procesa ninguna otra configuración en esta sección).

pmieconf
Si y solo si este archivo existe, pmmgr se ejecutará pmieconf generar un
archivo de configuración para cada pmcd de destino. El archivo contiene una línea de espacio
opciones adicionales separadas para el programa pmieconf. Salida generada de pmieconf
El archivo se almacenará en el subdirectorio log-directory / hostid. (pmmgr ya
agrega -F, -c y -f.) El valor predeterminado es no pmieconf, así que, en cambio, el archivo pmie de arriba
probablemente debería contener una opción -c, para especificar una configuración de pmie fija.

Utilice pmmgr en línea utilizando los servicios de onworks.net