BoxStat fuer Linux-BCM - (C) by DG4MMI 1996 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ (update 1.7) 1. Voraussetzungen 2. Konfigurations-Datei 3. Automatischer Aufruf mittels crontab.bcm 4. Erzeugte Statistiken 5. Optionen beim Programm-Aufruf 5.1 /F 5.2 /M 5.3 /Y 1. Voraussetzungen ------------------ Folgendes ist fuer den Betrieb von BoxStat notwendig: - Perl 4 oder hoeher - Linux-BayCom-Mailbox (fuer die vjbox gibt es eine andere Version!) - BoxStat funktioniert NICHT mit der DOS-Version von Perl, zumindest bei mir nicht; fuer die DOS-BayCom-Mailbox gibt es aber BCM-Stat von DL4MEA 2. Konfigurations-Datei ----------------------- Eine Beispiel-Konfigurations-Datei namens boxstat.cfg ist im Paket ent- halten. Diese ist ausfuehrlich dokumentiert, deshalb wird hier nicht naeher darauf eingegangen. 3. Automatischer Aufruf mittels crontab.bcm ------------------------------------------- Um sich etwas Arbeit zu ersparen, sollte man die Statistik automatisch an jedem Monats-Ersten erzeugen lassen. Dies geschieht durch einen Eintrag in der crontab.bcm, der ungefaehr so aussehen sollte: ;Minute Stunde Tag Monat Wochentag import-Datei 10 0 1 * * boxstat Durch diesen Eintrag wird an jedem Monats-Ersten um 0:10 Uhr eine Datei namens boxstat.imp importiert. Die beiliegende Datei hat folgenden Inhalt: --- oshell /bcm/boxstat sleep 600 batch stat --- Erklaerung: Durch die erste Zeile wird das eigentliche Programm aufgerufen, welches saemtliche Statistiken in eine Datei namens stat.imp schreibt. Befindet sich boxstat nicht im Verzeichnis /bcm, muss diese Zeile entsprechend geaendert werden. Da bei der Linux-BCM mit oshell aufgerufene Programme vollstaendig im Hintergrund ablaufen, muss die Import-Datei mindestens solange angehalten werden, bis das Programm fertig ist. Dies geschieht mit der zweiten Zeile, die einfach 10 Minuten wartet. (10 Minuten sind eigentlich voellig ueber- trieben, ein Probelauf bei DB0AAB-8 brauchte grade mal zweieinhalb Minuten, aber lieber zu viel als zu wenig). Durch die dritte Zeile wird die erzeugte Statistik schliesslich in das Board STATISTI (bzw. in das in boxstat.cfg angegebene Board) eingespielt. 4. Erzeugte Statistiken ----------------------- Seit Version 1.6 werden alle Statistiken erzeugt, die von DL4MEA's BCM-Stat auch erzeugt werden. Kleine Aenderungen und Erweiterungen sind jedoch ent- halten. Die Statistiken im einzelnen: - Diagramme ueber: * an User gesendete Bytes * von Usern empfangene Bytes * an User gesendete Files * von Usern empfangene Files * im Store&Forward gesendete Bytes * im Store&Forward empfangene Bytes * CPU-Belastung * User-Logins - Bei den Diagrammen wird zwischen zwei Arten unterschieden: * Monats-Diagramme: Hierbei wird fuer jeden Tag eines Monats die Gesamt- zahl der oben angegeben Werte berechnet und in einem Diagramm dargestellt. Zusaetzlich wird zwischen den Zeitraeumen 0:00-11:59 Uhr und 12:00-23:59 Uhr unter- schieden. * Tages-Diagramme: Hierbei wird fuer jede Stunde der Tage im Monat die Gesamtzahl der oben angegeben Werte berechnet und in einem Diagramm dargestellt. Eine Spalte im Diagramm entspricht einem Zeitraum von 20 Minuten. - Bei den Diagrammen wird eine automatische Skalierung vorgenommen, d.h. der Wert, der einer Zeile im Diagramm entspricht, wird so festgelegt, dass der Spitzenwert im Diagramm immer moeglichst weit oben liegt. - Einzelauswertungen: Fuer jeden User, der in diesem Monat mindestens einmal eingeloggt war, werden folgende Werte aus- gegeben: * Anzahl der Logins * Gesamt-Login-Dauer * gesendete Bytes * empfangene Bytes * durschnittlich pro Connect uebertragene Bytes * effektive Baudrate * gesendete Files * empfangene Files * insgesamt verbrauchte CPU-Zeit Dies erfolgt in nach Praefixen getrennten Listen, die Rufzeichen innerhalb dieser Listen werden alphabetisch sortiert. - Toplisten: Zu folgenden Werten werden Toplisten erzeugt: * Logins * Gesamt-Login-Dauer * gesendete Bytes * empfangene Bytes * gesendete Files * empfangene Files * insgesamt verbrauchte CPU-Zeit In diesen Toplisten werden jeweils die 15 User angegeben werden, die dabei den hoechsten Wert erzielt haben. Es werden die glei- chen Zahlen wie bei den Einzelauswertungen ausgegeben. - Digi-Topliste: Es werden alle Digipeater ausgegeben, ueber die in diesem Monat mindestens ein Login erfolgt ist. Die Liste wird nach den ueber den jeweiligen Digi uebertragenen Bytes sortiert. Weiterhin wird folgendes angegben: * die Anzahl der Logins * durchschnittlich pro Connect uebertragene Bytes * Gesamt-Login-Zeit * durschnittlich pro Minute uebertragenen Bytes - Gesamt-Auswertung: Hier werden noch ein paar Absolut-Werte dieses Monats angegeben: * Anzahl der User-Connects * Anzahl der User in diesem Monat * Durchschnittliche Verbindungszeit pro Connect * Durchschnittliche Verbindungszeit pro User * Insgesamt an User gesendete Zeichen * Insgesamt von Usern empfangene Zeichen * Ingesamt an/von User(n) uebertragene Zeichen * Ingesamt an User gesendete Files * Ingesamt von Usern empfangene Files * Ingesamt im S&F uebertragene Zeichen * Anteil des S&F am gesamten Datenaufkommen * Durchschnittlich pro Tag uebertragene Zeichen * Durchschnittlich pro Tag uebertragene Files * Insgesamt von den Usern verbrauchte CPU-Zeit * Belastung der CPU durch User * Insgesamt vom S&F verbrauchte CPU-Zeit * Belastung der CPU durch den S&F 5. Optionen beim Programm-Aufruf -------------------------------- Gross-/Kleinschreibung ist bei den Optionen irrelevant. Bei der Angabe von Parametern ist zu beachten, dass die Option und der Parameter durch ein Blank getrennt sein muessen, also z.B.: o boxstat /M 1 /Y 1995 Folgende Optionen koennen angegeben werden: 5.1 /F ------ Diese Option erzwingt die Erzeugung der Statistik. Normalerweise laeuft das Programm nur am Monats-Ersten, um die mehrfache Erzeugung einer Statistik zu vermeiden. 5.2 /M ------ Hinter dieser Option laesst sich das Monat angeben, zu dem die Statistik erzeugt wird. Defaultmaessig wird die Statistik zum letzten Monat erzeugt. 5.3 /Y ------ Hinter dieser Option laesst sich das Jahr angeben, zu dem die Statistik erzeugt wird. Eine Angabe des Jahres ohne Angabe des Monats ist normalerweise nicht sinnvoll. 73s de Jonny, DG4MMI @DB0IRS.#BAY.DEU.EU