Este es el comando PCPIntro 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
PCPIntroducción - introducción al Performance Co-Pilot (PCP)
INTRODUCCIÓN
Performance Co-Pilot (PCP) es un conjunto de herramientas diseñado para monitorear y administrar sistemas
nivel de rendimiento. Estos servicios están distribuidos y escalables para adaptarse a la mayoría
Configuraciones complejas del sistema y problemas de rendimiento.
PCP es compatible con muchas plataformas diferentes, que incluyen (pero no se limitan a) Linux, MacOSX,
Solaris y Windows. De un PCP de alto nivel se puede considerar que contiene dos clases de
utilidad de software:
PPC Colectores
Estas son las partes de PCP que recopilan y extraen datos de rendimiento de varios
fuentes, por ejemplo, el núcleo del sistema operativo.
PPC Monitores
Estas son las partes de PCP que muestran datos recopilados de hosts (o archivos)
que tienen el PPC Coleccionista instalado. Muchas herramientas de monitorización están disponibles como parte
de la versión principal de PCP, mientras que otras herramientas de monitoreo (típicamente gráficas) son
disponible por separado en el paquete PCP GUI.
Esta entrada del manual describe las funciones y opciones de alto nivel comunes a la mayoría de los PCP
utilidades disponibles en todas las plataformas.
Descripción
La arquitectura de PCP se distribuye en el sentido de que cualquier herramienta de PCP puede estar ejecutando
de forma remota. En el host (o hosts) que se están monitoreando, cada dominio de métricas de desempeño,
ya sea el kernel, una capa de servicio, un sistema de gestión de base de datos, un servidor web, un
aplicación, etc.requiere un agente de dominio de métricas de rendimiento (PMDA) que es
responsable de recopilar medidas de rendimiento de ese dominio. Todos los PMDA son
controlado por el demonio recopilador de métricas de rendimiento (pmcd(1)) en el mismo host.
Las aplicaciones cliente (las herramientas de supervisión) se conectan a pmcd(1), que actúa como un enrutador para
solicitudes, enviando las solicitudes al PMDA correspondiente y devolviendo las respuestas a
los clientes. Los clientes también pueden acceder a los datos de rendimiento de un archivo de PCP (creado con
registrador de horas(1)) para análisis retrospectivo.
Seguridad filosofía
PCP redistribuye una gran cantidad de información de rendimiento dentro de un host y entre sus
redes. La siguiente filosofía de seguridad subyace en la configuración de varios por defecto
que controlan cuánta información se envía y recibe.
De forma predeterminada, la información expuesta por PMCD sobre un host es aproximadamente la misma
nivel de confidencialidad disponible para un usuario sin privilegios en ese host. Entonces,
datos de rendimiento que están disponibles para ser read completamente libremente en una máquina se puede hacer
disponible por PMCD para la red.
Sin embargo, el host que ejecuta PMCD y su red es No se supone que corre solo amistoso
aplicaciones. Por lo tanto, escribir Las operaciones de tipo, incluidas las del host local, no son
permitido por defecto.
Estos valores predeterminados pueden anularse (expandirse o reducirse) de varias formas, incluso por
especificar ACL de red en pmcd.conf, activando PMDA no predeterminados, o usando PMCD
conexiones que pasan credenciales de usuario. Por ejemplo, algunos PMDA proporcionan automáticamente
mayor información para usuarios o grupos con credenciales particulares.
Aplicaciones
Las siguientes aplicaciones de supervisión del rendimiento se basan principalmente en consolas, normalmente
se ejecutan directamente desde la línea de comando, y son solo un pequeño subconjunto de las herramientas disponibles como
parte del paquete básico de PCP.
Cada herramienta o comando está completamente documentado en su propia página de referencia.
pmstat Genera un resumen ASCII de alto nivel del rendimiento del sistema.
pmie Un motor de inferencia que puede evaluar reglas de acción de predicado para realizar alarmas y
Automatizar las tareas de gestión del sistema.
información pm Interrogar métricas de rendimiento específicas y los metadatos que las describen.
registrador de horas
Genera archivos PCP de métricas de rendimiento adecuadas para que la mayoría de los PCP las reproduzcan
herramientas.
pmval Informes periódicos sencillos para algunas o todas las instancias de una métrica de rendimiento, con
control de tiempo de VCR opcional.
Si el paquete PCP GUI está instalado, estarán disponibles las siguientes herramientas adicionales.
pmchart
Muestra tendencias a lo largo del tiempo de métricas de rendimiento seleccionadas arbitrariamente de uno o
más hosts.
hora de la tarde Utilidad de control de tiempo para coordinar el tiempo entre múltiples herramientas (incluyendo
pmchart y pmval).
pmdumptexto
Genere informes ASCII para combinaciones arbitrarias de métricas de rendimiento.
COMÚN COMANDO LÍNEA ARGUMENTOS
Existe un conjunto de argumentos de línea de comando comunes que la mayoría de los PCP utilizan de manera consistente.
herramientas.
-a Archivo
La información de la métrica de rendimiento se recupera retrospectivamente de Performance
Copiloto (PCP) Archivo, previamente generado por registrador de horas(1).See pcp-
Archivo(5)para formatodocumentación. El -a y -h las opciones son mutuamente excluyentes.
Archivo es el nombre base común a todos los archivos físicos creados por un
en vez de registrador de horas(1), o cualquiera de los archivos físicos, p. Ej. mi archivo (basado
nombre) o mi archivo.meta (el archivo de metadatos) o mi archivo.índice (el índice temporal)
or mi archivo.0 (el primer volumen de datos de Archivo) o mi archivo.0.bz2 or
mi archivo.0.bz (el primer volumen de datos comprimido con bzip2(1)) o mi archivo.0.gz
or mi archivo.0.Z or mi archivo.0.z (el primer volumen de datos comprimido con gzip(1)),
mi archivo.1 or mi archivo.3.bz2 or mi archivo.42.gz etc.
-a Archivo[,Archivo,...]
Una forma alternativa de -a para aplicaciones que pueden manejar varios archivos.
-h hostname
A menos que sea dirigido a otro anfitrión por el -h opción, oa un archivo por el -a
opción, la fuente de métricas de rendimiento será el Recopilador de métricas de rendimiento
Daemon (PMCD) en el host local. Referirse a PMCD HOST Características .
más adelante para obtener más detalles sobre las muchas opciones disponibles al formar el hostname
especificación, así como una descripción detallada del host local predeterminado
conexión. La -a y -h las opciones son mutuamente excluyentes.
-s cualquier
El argumento cualquier define el número de muestras que se recuperarán y notificarán.
If cualquier es 0 o -s no se especifica, la aplicación muestreará e informará
continuamente (en modo de tiempo real) o hasta el final del archivo PCP (en el archivo
modo).
-z Cambie la zona horaria de los informes a la zona horaria local en el host que es la fuente
de las métricas de rendimiento, identificadas a través de la -h or -a .
-Z zona horaria
De forma predeterminada, las aplicaciones informan la hora del día de acuerdo con la zona horaria local en
el sistema donde se ejecuta la aplicación. los -Z la opción cambia la zona horaria
a zona horaria en el formato de la variable de entorno TZ como se describe en
entorno(7).
INTERVALO Características Y ALINEACIÓN
La mayoría de las herramientas de PCP operan con muestreos o informes periódicos, y el -t y -A las opciones pueden
ser utilizado para controlar la duración del intervalo de muestra y la alineación de la muestra
veces.
-t intervalo
Establezca el intervalo de actualización o informe.
El intervalo El argumento se especifica como una secuencia de uno o más elementos del
formulario
número[unidades que]
dónde número es una constante de punto flotante o entero (analizada usando strtod(3)) y
el opcional unidades que es uno de: segundos, second, segundos, AMF, s, minutos, minuto, minutos,
min, m, horas, horas., h, días, day y d. Si el unidad esta vacio, second se supone.
Además, la versión en mayúsculas (o en mayúsculas y minúsculas) de cualquiera de los anteriores también es
aceptable.
Espacios en cualquier lugar del intervalo son ignorados, entonces 4 días 6 horas 30 minutos,
4días6horas30min, Los 4d6h30m y 4d6.5h son todos equivalentes.
Varias especificaciones son aditivas, por ejemplo, ``1hour 15mins 30secs'' se interpreta
como 3600 + 900 + 30 segundos.
-A alinear
Por defecto, las muestras no están necesariamente alineadas en ninguna unidad natural de tiempo. los -A
La opción puede usarse para forzar que la muestra inicial se alinee en el límite de un
unidad de tiempo natural. Por ejemplo -A 1sec, -A 30 min y -A 1hour especificar alineación en
segundos enteros, medias horas y horas enteras respectivamente.
El alinear El argumento sigue la sintaxis de un intervalo argumento descrito anteriormente para
el -t .
Tenga en cuenta que la alineación se produce al adelantar el tiempo según sea necesario, y que -A actúa como un
modificador para avanzar tanto en el inicio de la ventana de tiempo (ver la siguiente sección) como
la hora de origen (si el -O se especifica la opción).
Captura de VENTANA Características
Muchas herramientas de PCP están diseñadas para operar en una ventana de tiempo de interés, por ejemplo, para definir un
tiempo de terminación para monitoreo en tiempo real o para definir una hora de inicio y finalización dentro de un PCP
registro de archivo.
En ausencia de la -O y -A opciones para especificar un origen y tiempo de tiempo de muestra inicial
alineación (ver arriba), la aplicación PCP recuperará la primera muestra al comienzo de
la ventana de tiempo.
Las siguientes opciones pueden usarse para especificar una ventana de tiempo de interés.
-S hora de inicio
Por defecto, la ventana de tiempo comienza inmediatamente en modo de tiempo real o coincide
con la hora al inicio del registro de archivo PCP en modo de archivo. los -S la opción puede
utilizarse para especificar una hora posterior para el inicio de la ventana de tiempo.
El hora de inicio El parámetro puede darse en una de tres formas (intervalo es el mismo que
para -t opción como se describe arriba, datetime se describe a continuación):
intervalo
Para especificar un desfase de la hora actual (en modo de tiempo real) o el
comienzo de un archivo PCP (en modo de archivo) simplemente especifique el intervalo de
el tiempo como argumento. Por ejemplo -S 30 min marcará el inicio del tiempo
ventana para ser exactamente 30 minutos a partir de ahora en modo de tiempo real, o exactamente 30
minutos desde el inicio de un archivo PCP.
-intervalo
Para especificar un desplazamiento desde el final de un registro de archivo de PCP, coloque el prefijo intervalo
argumento con un signo menos. En este caso, el inicio de la ventana de tiempo
precede el tiempo al final del archivo por el intervalo dado. Por ejemplo
-S -1 hora establecerá el inicio de la ventana de tiempo en exactamente una hora
antes de la hora de la última muestra en un registro de archivo de PCP.
@datetime
Para especificar la fecha y hora del calendario (hora local en la zona horaria del informe)
para el inicio de la ventana de tiempo, use la sintaxis de fecha y hora precedida por una en
firmar. Consulte la descripción de fecha y hora a continuación para obtener información detallada.
-T hora de finalización
Por defecto, el final de la ventana de tiempo es ilimitado (en modo de tiempo real) o alineado
con la hora al final de un registro de archivo de PCP (en modo de archivo). los -T la opción puede
utilizarse para especificar una hora anterior para el final de la ventana de tiempo.
El hora de finalización El parámetro puede darse en una de tres formas (intervalo es el mismo que
para -t opción como se describe arriba, datetime se describe a continuación):
intervalo
Para especificar un desplazamiento desde el inicio de la ventana de tiempo, simplemente use el
intervalo de tiempo como argumento. Por ejemplo -T 2h30m marcará el final de
la ventana de tiempo debe ser 2 horas y 30 minutos después del inicio del tiempo
ventana.
-intervalo
Para especificar un desplazamiento hacia atrás desde la hora al final de un registro de archivo de PCP,
prefijo el intervalo argumento con un signo menos. Por ejemplo -T -90m will
establecer el final de la ventana de tiempo en 90 minutos antes de la hora de la última
muestra en un registro de archivo de PCP.
@datetime
Para especificar la fecha y hora del calendario (hora local en la zona horaria del informe)
para el final de la ventana de tiempo, use la sintaxis de fecha y hora precedida por una at
firmar. Consulte la descripción de fecha y hora a continuación para obtener información detallada.
-O natural
Por defecto, las muestras se obtienen desde el inicio de la ventana de tiempo (ver descripción
of -S opción) hasta el final de la ventana de tiempo (ver descripción de -T opción). los -O
La opción permite que la especificación de un origen dentro de la ventana de tiempo se utilice como
el tiempo de muestra inicial. Esto es útil para el uso interactivo de una herramienta PCP con el
hora de la tarde(1) Reproducción de videograbadora.
El natural argumento aceptado por -O se ajusta a la misma sintaxis y semántica que el
hora de inicio argumento para el -T .
Por ejemplo -O -0 especifica que la posición inicial debe estar al final de la
ventana de tiempo; esto es más útil cuando se desea reproducir `` al revés '' dentro del
ventana de tiempo.
El datetime argumento para el -O, -S y -T las opciones consisten en:
datos time zona day relativo
Una fecha puede ser una de las siguientes: AAAA-MM-DD, MM / DD / AA, DD Mes AAAA o Mes DD AAAA. Un tiempo puede ser
uno de: HH: MM: SS, HH: MM. HH: MM puede usar las 12 horas (a través de un sufijo am o pm) o 24
convención de hora. Un día de la semana puede ser un día de la semana detallado, opcionalmente
precedido por un número ordinal como segundo martes. Una zona es un valor de zona horaria como
especificado por el selección de tz(1) mando. Un tiempo relativo puede ser una unidad de tiempo que es:
precedido por un número cardinal como 1 año o 2 meses, precedido por uno de los tiempos
palabras este o último, o sucedido por el tiempo hace palabra. Un tiempo relativo también puede ser uno de
las palabras de tiempo: ayer, hoy, mañana, ahora. Ejemplos de cadenas de fecha y hora son:
1996-03-04 13:07:47 EST Lun, 1996-03-05 14:07:47 EST -1 hora, Lun Mar 4 13:07:47 1996, Mar
4 1996, Mar 4, Mar, 13:07:50 or 13:08.
Para cualquier campo de orden inferior que falte, se asume el valor predeterminado de 0 para horas, minutos y
segundos, 1 para el día del mes y enero para los meses. Por tanto, los siguientes son equivalentes:
-S '@ Mar 1996 ' y -S '@ Mar 1 00:00:00 1996 '.
Si falta algún campo de orden superior, se completa comenzando con el año, el mes
y día desde la hora actual (modo de tiempo real) o la hora al comienzo del PCP
registro de archivo (modo de archivo) y avanzando el tiempo hasta que coincida con los campos que son
especificado. Entonces, por ejemplo, si la ventana de tiempo comienza de forma predeterminada en `` Mon Mar 4 13:07:47
1996 '', luego -S @ 13: 10 corresponde a las 13:10:00 del lunes 4 de marzo de 1996, mientras que -S @ 10: 00
corresponde a las 10:00:00 del martes 5 de marzo de 1996 (tenga en cuenta que es el día siguiente).
Para una mayor precisión que la que ofrece datetime(3), el componente de segundos puede ser un
número de coma flotante.
ACTUACIÓN MÉTRICA - NOMBRES Y IDENTIFICADORES
El número de nombres de métricas de rendimiento admitidos por PCP en la mayoría de las plataformas varía entre muchos
cientos a varios miles. Las bibliotecas y aplicaciones de PCP utilizan un
esquema de identificación que asocia inequívocamente un único entero con cada conocido
métrica de rendimiento. Este número entero se conoce como Identificador de métrica de rendimiento o PMID.
Aunque no es un requisito, los PMID tienden a tener consistencia global en todos los sistemas, por lo que
La métrica de rendimiento particular generalmente tiene el mismo PMID.
Para todos los usuarios y la mayoría de las aplicaciones, el uso directo de los PMID sería inapropiado (p. Ej.
esto limitaría el rango de métricas accesibles, haría que el código fuera difícil de mantener, forzaría
la interfaz de usuario sea particularmente barroca, etc.). De ahí un nombre de métricas de rendimiento
El espacio (PMNS) se utiliza para proporcionar nombres externos y una clasificación jerárquica para
métricas de rendimiento. Un PMNS se representa como un árbol, y cada nodo tiene una etiqueta, una
puntero a un PMID (para nodos hoja) o un conjunto de nodos descendientes en el PMNS (para
nodos no foliares).
Una etiqueta de nodo debe comenzar con un carácter alfabético, seguido de cero o más caracteres
extraído del alfabeto, los dígitos y el carácter `_´ (guión bajo). Para alfabético
Se distinguen los caracteres en una etiqueta de nodo, mayúsculas y minúsculas.
Por convención, el nombre de una métrica de rendimiento se construye mediante la concatenación de
etiquetas de nodo en una ruta a través del PMNS desde el nodo raíz hasta un nodo hoja, con un ``. '' como
un separador. El nodo raíz en el PMNS no está etiquetado, por lo que todos los nombres comienzan con la etiqueta
asociado con uno de los nodos descendientes debajo del nodo raíz del PMNS, p. ej.
kernel.percpu.syscall. Normalmente (aunque esto no es un requisito) habría en
la mayoría de un nombre para cada PMID en un PMNS. Por ejemplo núcleo.toda.cpu.inactivo y disco.dev.leer
son los nombres únicos de dos métricas de rendimiento distintas, cada una con un PMID único.
Los grupos de PMID relacionados se pueden nombrar nombrando un nodo no hoja en el árbol PMNS, p. Ej.
disco.
El PMNS local predeterminado utilizado por pmcd está ubicado en $ PCP_VAR_DIR / pmns / root sin embargo, el
Variable ambiental PMNS_DEFAULT se puede establecer en el nombre de ruta completo de un PMNS diferente
que luego se utilizará como el PMNS local predeterminado.
La mayoría de las aplicaciones no utilizan el PMNS local directamente, sino que importan partes del PMNS.
según sea necesario, desde el mismo lugar donde se obtienen las métricas de rendimiento, es decir, desde pmcd(1)
para monitoreo en vivo o desde un archivo PCP para monitoreo retrospectivo.
Para explorar el uso de PMNS información pm(1), o si el paquete PCP GUI está instalado, New Chart
y las ventanas de búsqueda métrica dentro pmchart(1).
ACTUACIÓN METRICA ESPECIFICACIONES
En archivos de configuración y (en menor medida) opciones de línea de comando, métrica
las especificaciones se adhieren a las siguientes reglas de sintaxis.
Si la fuente de las métricas de rendimiento es en tiempo real de pmcd(1) entonces la sintaxis aceptada es
host:métrico[instancia1,instancia2,...]
Si la fuente de las métricas de rendimiento es un registro de archivo de PCP, la sintaxis aceptada es
Archivo/métrico[instancia1,instancia2,...]
El host:, Archivo/ y [instancia1,instancia2,...] Los componentes son todos opcionales.
El , El delimitador en la lista de nombres de instancia puede ser reemplazado por un espacio en blanco.
Caracteres especiales en ejemplo los nombres se pueden escapar rodeando el nombre en doble
comillas o antes del carácter con una barra invertida.
Los espacios en blanco se ignoran en todas partes excepto dentro de un espacio entre comillas ejemplo nombre.
Un vacío ejemplo se ignora en silencio, y en particular ''[]'' es lo mismo que no
ejemplo, mientras que ''[uno dos]'' se analiza como especificando solo las dos instancias ''uno'' y
``two''.
Como caso especial, si el host es el carácter único `` @ '', entonces esto se refiere a un
PM_CONTEXT_LOCAL fuente, ver pmNuevoContexto(3).
SEGURO PMCD CONEXIONES
Desde la versión 3.6.11 de PCP, un monitor puede solicitar explícitamente una conexión segura a un
host colector en ejecución pmcd(1) o pmproxy(1) usando la bandera de contexto PM_CTXFLAG_SECURE. Si
el host del recopilador de PCP admite esta función; consulte la métrica pmcd.feature.secure para
confirmación de esto: un TLS / SSL (seguridad de la capa de transporte o capa de sockets seguros)
Se puede establecer una conexión que utiliza criptografía de clave pública y técnicas relacionadas.
Estas funciones tienen como objetivo evitar las escuchas clandestinas y la manipulación de datos por parte de un tercero malintencionado.
parte, además de proporcionar autenticación del lado del servidor (identificación segura de un
servidor por un cliente) que se puede utilizar para protegerse contra ataques man-in-the-middle.
Un seguro pmcd la conexión requiere el uso de autenticación basada en certificados. La seguridad
características ofrecidas por pmcd y pmproxy se implementan utilizando los servicios de seguridad de red
(NSS) API y utilidades. El NSS certutil La herramienta se puede utilizar para crear certificados.
adecuado para establecer la confianza entre el monitor PCP y los hosts recolectores.
Una descripción completa está más allá del alcance de este documento, consulte el PPC MEDIO AMBIENTE,
ARCHIVOS y VEA O secciones para obtener información detallada. Esto incluye enlaces a tutoriales sobre
los pasos necesarios para configurar las funciones de seguridad disponibles.
PMCD HOST Características
En ausencia de una especificación explícita del nombre de host, la mayoría de las herramientas utilizarán
anfitrión local en modo de actualización en vivo. En las versiones de PCP desde 3.8.4 en adelante, esto da como resultado un
Se selecciona un protocolo local eficiente, normalmente un socket de dominio Unix. Si esta opcion
se utiliza (que también se puede solicitar explícitamente a través del Unix: especificación de host descrita
a continuación), es importante tener en cuenta que todas las conexiones se autenticarán automáticamente.
En otras palabras, las credenciales del usuario que invoca una herramienta cliente serán automáticamente
puesto a disposición de pmcd(1) y todos sus PMDA, en nombre de los usuarios, de modo que los resultados
personalizarse según los niveles de privilegio de los usuarios individuales.
Nombres de hosts remotos que ejecutan pmcd(1) por supuesto, también se puede proporcionar un demonio para solicitar
se utilizará un host remoto. La forma más básica de pmcd la especificación del host es un host simple
nombre, posiblemente incluyendo el nombre de dominio si es necesario. Sin embargo, esto se puede ampliar en un
varias formas de refinar aún más los atributos de la conexión hecha a pmcd.
El pmcd número de puerto y también opcional pmproxy(1) nombre de host y su número de puerto, se puede
dado como parte de la especificación de host, desde PCP versión 3.0. Estos reemplazan (y
anular) las variables de entorno PMCD_PORT, PMPROXY_HOST y PMPROXY_PORT de estilo antiguo.
Las siguientes son especificaciones de nombre de host válidas que especifican conexiones a pmcd en el anfitrión
nas1.servidores.com con / sin una lista de puertos, con / sin un pmproxy(1) conexión
a través de un firewall y con direcciones IPv6 e IPv4 como se muestra.
$ pcp -h nas1.servers.com:44321,[email protected]: 44322
$ pcp -h nas1.servidores.com:[email protected]: 44322
$ pcp -h nas1.servidores.com:[email protected]
$ pcp-h [email protected]
$ pcp -h nas1.servers.com:44321
$ pcp -h [fe80::2ad2:44ff:fe88:e4f1%p2p1]
$pcp-h 192.168.0.103
Además, también se pueden especificar `` atributos de conexión ''. Estos incluyen nombre de usuario,
contraseña (se puede dar de forma interactiva y puede depender del mecanismo de autenticación
empleado), si apuntar a un contenedor en ejecución específico, si usar seguro
protocolo (cifrado) o nativo (desnudo), etc. Todos los ejemplos anteriores están predeterminados
protocolo nativo y no utilice autenticación. Esto se puede modificar, como en el siguiente
ejemplos.
$ pcp -h pcps: //app2.servers.com? container = cae8e6edc0d5
$ pcp -h pcps: //nas1.servers.com: 44321? username = tanya & method = gssapi
$ pcp -h pcps: //[email protected]? método = llano
$ pcp -h pcp: //nas3.servers.com
$ pcp -h 192.168.0.103?container=cae8e6edc0d5,method=digest-md5
$pcp-h unix:
$ pcp -h locales:
La elección del método de autenticación y otros parámetros resultantes como el nombre de usuario,
opcionalmente, la contraseña, etc., depende de la configuración SASL2 utilizada por cada uno (remoto) pmcd.
Hay tutoriales disponibles que especifican varios aspectos de la configuración de la autenticación.
módulo (s) utilizados, estos detalles finos están fuera del alcance de este documento.
En todas las situaciones, los nombres de host se pueden usar indistintamente con el direccionamiento IPv4 o IPv6
(directamente), como se muestra arriba. En el caso de una dirección IPv6, la dirección completa debe ser
entre corchetes y también se debe especificar el alcance (interfaz).
Las local: El ejemplo anterior ahora es el predeterminado para la mayoría de las herramientas. Esta conexión es una
Conexión de host local autenticada automáticamente en todas las plataformas que admiten Unix
sockets de dominio. No se requiere contraseña y la autenticación es automática. Esto también es
el canal de comunicación más eficiente (menor sobrecarga) disponible.
La diferencia entre los Unix: y local: es que el primero es un socket de dominio Unix estricto
especificación (la conexión falla si no se puede conectar de esa manera), mientras que el último tiene una
una alternativa más indulgente al uso localhost (es decir, se utiliza una conexión de enchufe Inet normal
cuando las conexiones de socket de dominio Unix no están disponibles).
MEDIO AMBIENTE
Además del entorno de ejecución de PCP y las variables de configuración descritas en el
PPC MEDIO AMBIENTE sección siguiente, las siguientes variables de entorno se aplican a todos
instalaciones.
PCP_CONSOLA
Cuando se establece, esto cambia la consola predeterminada de / dev / tty (en Unix) o ESTAFA: (en
Windows) para que sea la consola especificada. El valor especial de ninguna puede ser usado para
indican que no hay ninguna consola disponible para su uso. Esto se usa en lugares donde la consola-
herramientas basadas en la necesidad de interactuar con el usuario y, en particular, se utilizan cuando
se está realizando la autenticación.
PCP_DEBUG
Cuando se establece, esta variable proporciona una forma alternativa de inicializar el valor utilizado para
controlar el diagnóstico y la salida de depuración (el valor predeterminado es 0 para suprimir este
producción). El valor de $ PCP_DEBUG debe ser un entero decimal, consulte pmdbg(1) para un
descripción de los valores admitidos.
PCP_DERIVED_CONFIG
Cuando se establece, esta variable define una lista de archivos y / o directorios separados por dos puntos
(la sintaxis es la misma que para el $ RUTA variable para sh(1)). Los componentes son
expandido en una lista de archivos de la siguiente manera: si un componente de $ PCP_DERIVED_CONFIG is
un archivo, ese archivo se agrega a la lista, de lo contrario, si un componente es un directorio
luego, el descenso recursivo se usa para enumerar todos los archivos debajo de ese directorio y
estos se agregan a la lista.
Se supone que cada archivo de la lista resultante contiene definiciones de
métricas según la sintaxis descrita en pmLoadDerivedConfig(3), y estos están cargados
en orden.
Las métricas derivadas se pueden utilizar para ampliar las métricas disponibles con nuevas (derivadas)
métricas usando expresiones aritméticas simples.
If PCP_DERIVED_CONFIG está configurado, las definiciones de métricas derivadas se procesan
automáticamente a medida que se establece cada nueva fuente de métricas de rendimiento (es decir, cada
tiempo a pmNuevoContexto(3) se llama) o cuando se realizan solicitudes contra el PMNS.
Cualquier componente del $ PCP_DERIVED_CONFIG lista o la lista ampliada de archivos que se
no es un archivo, no es un directorio o no es accesible (debido a permisos o una mala
enlace simbólico) se ignorará en silencio.
PCP_SECURE_SOCKETS
Cuando se establece, esta variable obliga a que se establezcan las conexiones de la herramienta de monitoreo usando
la función de sockets seguros basados en certificados. Si las conexiones no se pueden
establecido de forma segura, fallarán.
PCP_SECURE_DB_METHOD
Con conexiones de socket seguras, el certificado y la base de datos de claves se almacenan usando
el SQL: método por defecto. Usar PCP_SECURE_DB_METHOD para anular el valor predeterminado, la mayoría
generalmente estableciendo el valor en la cadena vacía (para los métodos de base de datos más antiguos).
PCP_STDERR
Muchas herramientas de PCP admiten la variable de entorno PCP_STDERR, que puede ser usado para
controlar dónde se envían los mensajes de error. Cuando está desarmado, el comportamiento predeterminado es que
Los mensajes de `` uso '' y los errores de análisis de opciones se informan sobre errores estándar, otros
los mensajes después del inicio inicial se envían al destino predeterminado de la herramienta,
es decir, error estándar para herramientas ASCII o un diálogo para herramientas GUI.
If PCP_STDERR se establece en el valor literal DISPLAY entonces todos los mensajes serán
mostrado en un diálogo. Se utiliza para cualquier herramienta iniciada desde un escritorio.
ambiente.
If PCP_STDERR se establece en cualquier otro valor, se supone que el valor es un nombre de archivo, y
todos los mensajes se escribirán allí.
PMCD_CONNECT_TIMEOUT
Al intentar conectarse a un control remoto pmcd(1) en una máquina que se está iniciando, el
El intento de conexión podría potencialmente bloquearse durante mucho tiempo hasta que la máquina remota
termina su inicialización. La mayoría de las aplicaciones de PCP y algunas de las bibliotecas de PCP
Las rutinas abortarán y devolverán un error si no se ha establecido la conexión.
después de que haya transcurrido algún intervalo especificado. El intervalo predeterminado es de 5 segundos.
Esto se puede modificar configurando PMCD_CONNECT_TIMEOUT en el medio ambiente a un real
número de segundos para el tiempo de espera deseado. Esto es más útil en los casos en que el
El host remoto se encuentra al final de una red lenta, lo que requiere latencias más largas para
establecer la conexión correctamente.
PMCD_RECONNECT_TIMEOUT
Cuando un monitor o una aplicación cliente pierde la conexión a un pmcd(1), el
la conexión se puede restablecer llamando a una rutina de servicio en la biblioteca del PCP.
Sin embargo, los intentos de reconexión están controlados por una estrategia de retroceso para evitar
inundando la red con solicitudes de reconexión. De forma predeterminada, los retrasos en la retirada
son 5, 10, 20, 40 y 80 segundos para solicitudes de reconexión consecutivas de un
cliente (el último retraso se repetirá para cualquier intento posterior después del quinto).
Establecer la variable de entorno PMCD_RECONNECT_TIMEOUT a una lista separada por comas
de enteros positivos redefinirá los retrasos de retroceso, p. ej.
PMCD_RECONNECT_TIMEOUT a `` 1,2 '' retrocederá durante 1 segundo, luego intentará otro
solicitud de conexión cada 2 segundos a partir de entonces.
PMCD_REQUEST_TIMEOUT
Para aplicaciones de monitor o cliente conectadas a pmcd(1), existe la posibilidad de
la aplicación "cuelga" de una solicitud de métricas de rendimiento, metadatos o ayuda
texto. Estos retrasos pueden volverse graves si el sistema en ejecución pmcd choques, o el
se pierde la conexión a la red. Configurando la variable de entorno
PMCD_REQUEST_TIMEOUT a un número de segundos, solicitudes para pmcd terminará el tiempo de espera después de
este número de segundos. El comportamiento predeterminado es estar dispuesto a esperar 10 segundos.
para una respuesta de cada pmcd para todas las aplicaciones
PMCD_WAIT_TIMEOUT
¿Cuándo? pmcd(1) se inicia desde $ PCP_RC_DIR / pcp entonces la instancia principal de
registrador de horas(1) se iniciará si la bandera de configuración registrador de horas is chkconfig(8)
habilitado y pmcd se está ejecutando y acepta conexiones.
El cheque en pmcdla preparación esperará hasta PMCD_WAIT_TIMEOUT segundos. Si pmcd
tiene un tiempo de inicio prolongado (como en un sistema muy grande), luego PMCD_WAIT_TIMEOUT
se puede configurar para proporcionar una espera máxima superior a los 60 segundos predeterminados.
PMNS_DEFAULT
Si se establece, se interpreta como el nombre de ruta completo que se utilizará como PMNS local predeterminado
para pmLoadNameSpace(3). De lo contrario, el PMNS local predeterminado se encuentra en
$ PCP_VAR_DIR / pcp / pmns / root para instalaciones de PCP base.
PCP_COUNTER_WRAP
Muchas de las métricas de rendimiento exportadas de los agentes de PCP tienen la semántica de
mostrador lo que significa que se espera que aumenten monótonamente. Bajo algunos
circunstancias, un valor de estas métricas puede ser menor que el obtenido previamente
valor. Esto puede suceder cuando un contador de precisión finita se desborda, o cuando el
El agente de PCP se ha restablecido o reiniciado, o cuando el agente de PCP está exportando valores
de alguna instrumentación subyacente que está sujeta a algunos
discontinuidad.
La variable de entorno PCP_COUNTER_WRAP puede configurarse para indicar que todos los
Los casos de un `` contador '' decreciente deben tratarse como un desbordamiento del contador, y
por lo tanto, se supone que los valores se han envuelto una vez en el intervalo entre
muestras consecutivas. Este comportamiento de `` envoltura '' era el predeterminado en PCP anteriores
versiones, pero de forma predeterminada se ha desactivado en la versión PCP a partir de la versión 1.3.
PMDA_RUTA
El PMDA_RUTA La variable de entorno se puede utilizar para modificar la ruta de búsqueda utilizada por
pmcd(1) y pmNuevoContexto(3) (para PM_CONTEXT_LOCAL contextos) al buscar un
demonio o DSO PMDA. La sintaxis sigue que para TRAYECTORIA in sh(1), es decir, dos puntos
lista separada de directorios, y la ruta de búsqueda predeterminada es
`` / var / pcp / lib: / usr / pcp / lib '', (o `` / var / lib / pcp / lib '' en Linux, según el
valor de la variable de entorno $ PCP_VAR_DIR).
PMCD_PORT
Los puertos TPC / IP utilizados por pmcd(1) para crear el zócalo para las conexiones entrantes
y solicitudes, fue históricamente 4321 y más recientemente el registrado oficialmente
puerto 44321; en la versión actual, ambas Los números de puerto se utilizan de forma predeterminada como
arreglo de transición. Esto se puede anular configurando PMCD_PORT a una
un número de puerto diferente o una lista de números de puerto separados por comas. Si no es un incumplimiento
el puerto se usa cuando pmcd se inicia, luego todas las aplicaciones de monitoreo que se conectan a
que pmcd también debe tener PMCD_PORT establecer en su entorno antes de intentar un
conexión.
Las siguientes variables de entorno son relevantes para las instalaciones en las que registrador de horas(1)
se utiliza el registrador de archivos PCP.
PMLOGGER_PORT
La variable de entorno PMLOGGER_PORT se puede utilizar para cambiar el puerto TCP / IP base
número utilizado por registrador de horas(1) para crear el zócalo al que pmlc(1) las instancias intentarán
y conectar. El número de puerto base predeterminado es 4330. Cuando se utiliza, PMLOGGER_PORT
debe establecerse en el medio ambiente antes registrador de horas es ejecutado.
PMLOGGER_REQUEST_TIMEOUT
¿Cuándo? pmlc(1) se conecta a registrador de horas(1), existe una remota posibilidad de pmlc
"colgado" de una solicitud de información como consecuencia de un fallo de la red
or registrador de horas. Configurando la variable de entorno PMLOGGER_REQUEST_TIMEOUT a una
número de segundos, solicitudes para registrador de horas expirará después de este número de segundos.
El comportamiento predeterminado es estar dispuesto a esperar eternamente una respuesta de cada
solicitud a un registrador de horas. Cuando se utiliza, PMLOGGER_REQUEST_TIMEOUT debe establecerse en el
medio ambiente antes pmlc es ejecutado.
Si tiene el producto PCP instalado, las siguientes variables de entorno son
relevantes para los agentes de dominio de métricas de rendimiento (PMDA).
PMDA_LOCAL_PROC
El uso de esta variable ha quedado obsoleto y ahora se ignora. Si el `` proc '' PMDA
está configurado como un DSO para su uso con pmcd(1) en el host local, entonces todos los
Las métricas de `` proc '' estarán disponibles para las aplicaciones que utilicen un PM_CONTEXT_LOCAL
contexto.
El comportamiento anterior era que si se establecía esta variable, entonces un contexto
establecido con el tipo of PM_CONTEXT_LOCAL tendrá acceso al PMDA `` proc ''
para recuperar métricas de rendimiento sobre procesos individuales.
PMDA_LOCAL_SAMPLE
El uso de esta variable ha quedado obsoleto y ahora se ignora. Si la `` muestra ''
PMDA está configurado como DSO para su uso con pmcd(1) en el host local, entonces todos los
Las métricas de `` muestra '' estarán disponibles para las aplicaciones que PM_CONTEXT_LOCAL
contexto.
El comportamiento anterior era que si se establecía esta variable, entonces un contexto
establecido con el tipo of PM_CONTEXT_LOCAL tendrá acceso a la `` muestra ''
PMDA si este PMDA opcional se ha instalado localmente.
PMIECONF_PATH
Si está configurado, pmieconf(1) formará su pmieconf(5) especificación (conjunto de parámetros
pmie(1) reglas) usando todas las reglas pmieconf archivos que se encuentran debajo de cada subdirectorio en este
lista de subdirectorios separados por dos puntos. Si no se establece, el valor predeterminado es
$ PCP_VAR_DIR / config / pmieconf.
Use PCPIntro en línea usando los servicios de onworks.net