## histograma

2000
John Kodis
2001
José Antonio Salgueiro (traducción al Castellano)

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy of the GNU Free Documentation License from the Free Software Foundation by visiting their Web site or by writing to: Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and those trademarks are made aware to the members of the GNOME Documentation Project, the names have been printed in caps or initial caps.

Esta es la versión 1.0 del manual del histograma.

## Introducción

El programa histograma de GNOME representa varios parámetros definidos por el usuario como función del tiempo. Su utilidad principal es representar los parámetros de rendimiento del sistema tales como la carga de la CPU, la utilización de la CPU, el nivel de tráfico de la red, y así. Otros usos más ingeniosos se dejan como ejercicio para los usuarios interesados. Está incluído en el paquete `gnome-utils`, el cual es parte del entorno de escritorio GNOME. Este documento describe la &version; del programa histograma .

El programa histograma lee periódicamente los datos de un archivo, extrae su valor, y representa esos valores en uno de varios formatos. El formato por defecto es una pantalla gráfica parecida a un histograma. De ahí el nombre, histograma.

Ventana Principal del Histograma

En sistemas tales como Linux, en los cuales los parámetros del sistema están disponibles en un formato legible en el directorio /proc, el programa histograma es una herramienta elegante de monitorización del rendimiento del sistema, parecida pero más universal que xload.

En lugar de estar limitado a unos pocos parámetros de rendimiento estándar, el programa histograma puede dibujar cualquier parámetro que varíe con el tiempo que pueda ser leído de un fichero o tubería ("pipe"). Esta facultad de leer datos de una tubería proporciona una forma muy polivalente y fácil de fijar una pantalla personalizada.

La aplicación histograma está disponible como un programa sólo, o como un aplique del panel de GNOME. El programa puede ser iniciado seleccionando elemento histograma del submenú Utilidades del Menú Principal, seleccionando el elemento histograma del submenú Monitores del panel de Gnome Apliques, o ejecutando la orden `stripchart` o `stripchart-applet` desde la línea de comandos.

Ventana del Aplique Histograma

## Utilización de Histograma

Aunque el programa histograma puede ser utilizado para representar casi cualquier parámetros de interés, la configuración por defecto producirá un útil resumen de los parámetros de rendimiento del sistema en el cual se está ejecutando. Esta sección describe la utilización básica del programa histograma en su configuración por defecto. Más adelante se proporcionará una descripción de cómo personalizar los parámetros que se representan.

Cuando Vd. inicia por primera vez el programa histograma puede ver la ventana principal, tal como or in .

### Ventana Principal de Histograma

Ventana Principal de Histograma

### Ventana del Aplique Histograma

Ventana del Aplique Histograma

En su configuración por defecto, el programa histograma crea una ventana de 200 por 500 pixels que contiene dos elementos principales — una "cinta" a la izquierda, y una serie de "plumas" a la derecha. El applet histograma es parecido, pero su tamaño se adapta al panel en el cual se ejecuta. Cuando se utiliza la configuración por defecto, habrá una "pluma" y una línea de "cintas" en la cual aparece en azul los valores actuales y anteriores de la utilización de la CPU del sistema, el amarillo la carga media durante un minuto, en blanco el porcentaje de utilización del espacio de intercambio, y en rojo y verde los volúmenes de tráfico de red de entrada y salida, respectivamente. Si está activo un interface PPP, se mostrará una luz indicadora verde en la esquina superior izquierda de la ventana principal.

Pulsando en la ventana principal del histograma con el botón del ratón izquierdo aparecerá una ventana de valores numéricos. La ventana de valores numéricos correspondiente a la ventana principal mostrada en se muestra abajo en .

### Ventana de Parámetros de Valores Numéricos

Ventana de Parámetros de Valores Numéricos Esta ventana proporciona una visualización multi-línea, textual del nombre, valor actual, valor de la escala completa, y escalado (lineal o logarítmico) de cada uno de los parámetros representados. Puede ser cerrado bien presionando en el botón cerrar de la barra de título de la ventana valor numérico, o presionando otra vez el ratón sobre la ventana principal.

Presionando en la ventana principal del histograma con el botón derecho (3) aparecerá un menú Aplicación que contiene Ayuda, Sobre, Mostrar valores , Editar Prefs,Edit Params, y Salir , tal y como se muestra más abajo en .

### Ventana Principal con el Menú Desplegable

Ventana Principal con el Menú Desplegable Los elementos de menú Ayuda y Sobre muestran esta información de ayuda y el habitual caja "sobre", respectivamente, y el elemento de menú Salir finaliza la ejecución del programa histograma. El elemento de menú Mostrar valores desplegará una ventana de valor numérico, tal y cómo se describe más arriba,

El funcionamiento de la aplicación histograma puede ser personalizado editando las preferencias y parámetros que se representan. El elemento de menú Editar Prefs muestra una ventana de edición de las preferencias de la aplicación, tal y como se observa en . Los valores de la Ventana Preferencias se explican en .

### Ventana Preferencias

Ventana Preferencias

El elemento de menú Editar Params muestra una ventana que contiene un bloc de notas con una página que describe los detalles de cada parámetro, tal como se observa en . Los parámetros se pueden editar tal y como se describe en .

### Ventana de Parámetros

Ventana de Parámetros

## Opciones de la línea de comandos

Hay unos pocos conmutadores de la línea de comandos que se pueden utilizar para alterar el comportamiento del programa. Además a las opciones habituales de ayuda, utilización, versión, Gnome, Gtk, y gestión de sesión, están disponibles las siguientes opciones específicas del histograma:

--geometry GEOMETRY-SPEC

  Una especificación estándar de la geometría de X11 de la forma WxH±X±Y.

--config-file FILENAME

  Indica el fichero del cual se leerá la información sobre la configuración, sobreescribiendo el fichero configuración donde aparece el orden normal de las búsquedas tal como se describe en . Vd. puede cambiar los parámetros seguidos por una parte del programa histograma indicando un fichero de configuración alternativo.

## Preferencias

La Ventana Preferencias proporciona una forma de ajustar los elementos que tienen efecto sobre la operación del programa histograma. Se proporcionan unos conjuntos separados de controles para la operación de las "plumas" y para la operación de la carta de la ventana principal.

Ventana Preferencias

Ambos, carta y plumas, tienen sus propios ajustes para el intervalo de actualización y para el nivel de suavizado que se realizará. El intervalo de actualización determina con que frecuencia un nuevo conjunto de datos de puntos se recogerán y mostrarán. Por defecto uno cada segundo para las plumas, y uno cada 5 segundos para las líneas de carta. El valor de suavizado determina la dureza con la que se aplicará un filtro paso-bajo a los datos sin procesar antes de mostrarlos. Por defecto, este valor es 0.5 para plumas y carta. Fijando un suavizado cero elimina este filtro de los datos sin procesar, causando que en las actualizaciones aparezcan saltos o dientes. Fijando un suavizado a uno se congela el valor actual. Valores intermedios generan nuevos valores de la gráfica tomando la diferencia entre el último valor y en nuevo valor del parámetro sin procesar, multiplicado por la constante de suavizado, y sumado al último valor.

La porción de carta de la Ventana Preferencias tiene también una caja de chequeo para habilitar o deshabilitar la visualización de marcas en el eje temporal del histograma. Cuando se habilita la visualización de las marcas, se pueden ajustar los intervalos entre marcas menores y mayores. Los valores por defecto son una marca menor cada doce pixels y una marca mayor cada cinco marcas menores. Con el intervalo de actualización de cinco segundos, estos valores situarán una marca menor cada minuto y una marca mayor cada cinco minutos.

La porción de pluma de la Ventana Preferencias proporciona una caja de chequeo para habilitar o no la porción de ls pluma del histograma. Mientras las plumas proporcionan una forma rápida de visualizar los parámetros seguidos, su movimiento constante puede distraer. Ajústese a su gusto.

Los botones estándar "Ok", "Aplicar", y "Cancelar" se pueden utilizar para aplicar los nuevos valores y cerrar el diálogo de Preferencias, para aplicar los nuevos valores sin cerrar el diálogo Preferencias, y para cerrar el diálogo Preferencias sin alterar los valores actuales, respectivamente.

## Parámetros

Los parámetros mostrados en el histograma se pueden examinar y editar utilizando la ventana del Editor de Parámetros. Aunque histograma proporciona un gran potencial para añadir parámetros a medida, la mayoría de los usuarios estarán satistechos inicialmente con la selección de la lista de los parámetros pre-conofigurados suministrada. Para añadir o borrar estos parámetros véase .

Ventana Parámetros

### Guía Rápida para el Editor de Parámetros

Para borrar uno de los parámetros actuales activos:

- Seleccione el parámetros que borrará pulsando en su pestaña en la parte inferior de la ventana del Editor de Parámetros ;

- Seleccione el elemento de menú Editar ;

- Seleccione el elemento de menú Borrar Parámetro .

Para añadir un de los parámetros predefinidos:

- Seleccione el elemento de menú Editar ;

- Seleccione o bien el elemento de menú Añadir Parámetro Antes o bien Añadir Parámetro Después para incluir una nueva página de parámetro vacía;

- Seleccione uno de los parámetros predefinidos de la lista de elementos en la línea "Parámetro" de la página. Esto rellenará los campos necesarios para el parámetro recién creado, y comenzará a representarlo.

### Creando Parámetros Personalizados

ARREGLE ÉSTO

ecuación: CADENA

  Una ecuación usada para obtener el valor que ha de ser representado para este parámetro.

  Un valor se obtiene evaluando la línea "ecuación" empleando estos valores de campo. El primer valor (o único) se escribe como $1, el siguiente como $2, y así sucesivamente. La diferencia entre los valores de los campos entre el último y la iteración actual se escribe como ~1,~2, y así. El tiempo transcurrido en segundos desde la última iteración hasta la actual es ~t. El intervalo de actualización pedido.

  Están disponibles los operadores aritméticos habituales "infix" — suma (+), resta (-), multiplicación (+), división (/), y resto (%) — juntamente con los paréntesis para agrupar subexpresión.

filename: NOMBREFICHERO

  El fichero del cual se lee un valor del parámetro. Cuando se suministra un nombre de fichero comenzando con un "|", las líneas de entrada se leerán de una tubería (pipe).

  En cada iteración, se mostrará el valor que se obtiene para cada parámetro en el fichero de configuración. Se abrirá el fichero nombrado en la línea "filename" -- ya sea como una tubería si el fichero comienza con un carácter de tubería (|), o de otra forma como un fichero normal -- y se lee una línea.

  Si se especifica un patrón, se leen las líneas hasta que se encuentra uno que contiene la cadena patrón en cualquier parte de la línea. Esta línea se separa en una serie de campos separados por espacios en blanco, cada uno de los cuales se interpreta como un número en coma flotante.

pattern: CADENA

  El patrón que identifica la línea de la cual se estraerá un valor de parámetro. Si no se proporciona ningún patrón, se utiliza la primera línea del fichero.

### Valores de libgtop

Habitualmente, el programa histograma se construye enlazado con la biblioteca libgtop. La biblioteca libgtop proporciona un método portable y bien establecido de acceder a los parámetros comunes de rendimiento del sistema. Este es el método preferido para obtener el valor que se representará.

Se dispone de los siguiente parámetros de libgtop:

- Estadísticas de CPU — cpu_total, cpu_user, cpu_nice, cpu_sys, cpu_idle, and cpu_freq

- Estadísticas de Memoria — mem_total, mem_used, mem_free, mem_shared, mem_buffer, mem_cached, mem_user, mem_locked

- Estadísticas de Intercambio — swap_total, swap_used, swap_free, swap_pagein, swap_pageout

- Estadísticas de Actividad — uptime, idletime

- Estadísticas de CargaMedia — load_running, load_tasks, load_1m, load_5m, load_15m

- Estadísticas de Red — net_pkts_in, net_pkts_out, net_pkts_total, net_bytes_in, net_bytes_out, net_bytes_total, net_errs_in, net_errs_out, net_errs_total

  Dese cuenta que los valores de las estadísticas de red no utilizan la biblioteca glibtop. En su lugar, se lee directamente de /proc/net/dev, entonces sólo está disponible para Linux.

Todas las cantidades son enteros largos con signo, excepto para el tiempo de actividad, tiempo de inactividad, y los cinco valores de carga que son valores de coma flotante.

## Ficheros de Configuración y Parámetros

El programa histograma determina los parámetros que se mostrarán leyendo un fichero de configuración. El programa histograma busca un fichero de configuración en el siguiente orden:

- primero, un fichero de configuración indicado en la línea de comandos,

- entonces, un fichero llamado `stripchart.conf` en el directorio de trabajo actual,

- entonces, un fichero nombrado `stripchart.conf` en el directorio de usuario,

- entonces, un fichero denominado `/etc/stripchart.conf` ,

- y por último, por un fichero llamado `stripchart.conf` en el directorio CONFDIR , que será habitualmente

  `/usr/share/histograma/` o `/usr/local/share/histograma/`.

Si no es encuentra ningún fichero de configuración, el programa muestra un mensaje de error y finaliza.

Los parámetros conservados que se muestran en la ventana del Editor de Parametros se leen del fichero `stripchart.param` en el directorio `{prefix}/share/histograma` .

## Errores y Limitaciones Conocidas

La opción --geometry no interpreta correctamente argumentos de posición negativa.

El tráfico de red sólo está disponible para Linux.

## Autores

El programa Histograma ha sido escrito por John Kodis (kodis@jagunet.com). Por favor envíe todos los comentarios, sugerencias, e informes de errores a la Base de Datos de Seguimiento de Errores de GNOME . (Las Instrucciones para enviar informes de errores se pueden encontrar on-line.) Si Vd. está utilizando GNOME 1.1 o posterior, podrá también utilizar la Herramienta de Informe de Errores (`bug-buddy`), disponible en el submenú Utilidades delMenú Principal, para enviar informe de errores.

Ese manual ha sido escrito por John Kodis (kodis@jagunet.com). Por favor envíe todos los comentarios y sugerencias sobre este manual al Proyecto de Documentación de GNOME por email a docs@gnome.org. Vd. también puede enviar sus comentarios online utilizando la Tabla del Status de la Documentación de GNOME.

La traducción al español fue realizada por José Antonio Salgueiro (joseantsa@retemail.es) y juampe juampe@retemail.es Por favor envíe todos los comentarios y sugerencias referidas a esta traducción a traductores@es.gnome.org.

## Liccencia

Este programa es software libre; Vd. puede distribuirlo y/o modificarlo bajo los término de la Licencia Pública General GNU tal y como publicó la Fundación del Software Libre (FSF); o bien en su versión 2 de la Licencia, o cualesquiera posteriores (a su elección.

Este programa se distribuye con el ánimo de que sea útil, pero SIN GARANTÍA ALGUNO; sin, incluso la garantía MERCANTIL implícita o de UTILIDAD PARA UN USO ESPECÍFICO. Véase la Licencia Pública General GNU para más detalles.

Se incluye una copia de la Licencia Pública General GNU en un apéndice de la Guía de Usuario de GNOME . Vd. puede también ohtener un a copia de la Licencia Pública General GNU de la Fundación del Software Libre (FSF) visitando su sitio Web o escribiendo a

    Free Software Foundation, Inc.  59 Temple
        Place - Suite 330 Boston, MA
        02111-1307 Estados Unidos