Spis treści Wstecz

Jak dostosować statystyki do własnego serwisu WWW

W celu lepszej integracji statystyk generowanych przez LinuxStat i własnego serwisu WWW można skorzystać z kilku metod, w zależności od potrzeb.

  1. Zmiana wyglądu stron generowanych przez LinuxStat. W tym celu można dostosować szablony stron HTML lub opracować własny schemat. zob. szablony

  2. Umieszczenie na własnych stronach wykresów, które są przedstawiają aktualne zmiany jakiegoś parametru. Podczas wyświetlania takiego obrazka program zaprezentuje zebrane dane, zgodnie z żądanymi parametrami. zob. dynamiczne obrazki

  3. Wykorzystanie wykresów LinuxStat w dynamicznie budowanych stronach. Za pomocą skryptów CGI lub SSI Apache można wywołać program, który wygeneruje odpowiedni kod HTML i wykres graficzny. zob. dynamiczny kod html

Opisane metody dotyczą programu LinuxStat w wersji co najmniej 2.2

Szablony

Podczas wyświetlania stron program korzysta z szablonów. Są to pliki z kodem HTML odpowiednich stron. W niektórych miejscach zawierają one specjalne znaczniki, ograniczone znakami @@( zob. Strony). Szablony są zebrane w schematy (motywy, skórki), które można wybrać w konfiguracji programu (Ustawienia/Parametry globalne).
Pliki odpowiednich motywów są umieszczone w katalogu skins (domyślnie /usr/local/etc/skins). Są one podzielone według nazwy i wersji językowej. Domyślnym motywem jest sky i język angielski. Pliki graficzne wymagane do tych szablonów są umieszczone w katalogu www/skins, także z podziałem na wersje językowe (lub uni dla wspólnych).
Aby dostosować wygląd stron generowanych przez LinuxStat można zmienić kod HTMLowy któregoś z motywów lub (lepiej) utworzyć własny. Nie trzeba tworzyć wszystkich stron. Jeżeli w motywie zabraknie jakiegoś pliku, to program użyje domyślnego motywu sky. W ten sposób powstał np. motyw light, gdzie zostały "wymienione" tylko 2 strony. Nową "skórkę" należy umieścić w osobnym katalogu, razem z odpowiednią wersją językową. Jeżeli ktoś opracowałby jakiś ciekawy motyw, to chętnie włączę go przyszłych wersji programu.

Za pomocą odpowiednich wpisów w głównym pliku konfiguracyjnym programu config (/usr/local/lstat./etc) można zmienić postać i funkcjonalność niektórych elementów programu. Np. dopisując do tego pliku linię DEMO=1 włączamy tryb DEMO, czyli umożliwiamy użytkownikom zapoznanie się z możliwościami programu bez możliwości zapisania wprowadzonych przez nich zmian w konfiguracji.
Linia HOSTNAME=nazwa umożliwia używanie w szablonach dowolnej nazwy komputera, zamiast domyślnej, pobieranej z systemu. Przydaje się to zwłaszcza w prezentowaniu statystyk serwerów wirtualnych.

Dynamiczne obrazki

Jest to najbardziej elastyczny sposób prezentowania wykresów na stronach własnego serwisu. Aby pokazać dowolny wykres wystarczy umieścić u siebie odpowiedni kod HTML, opisujący wykres i obrazek. Np. umieszczając na swojej stronie kod znacznika

<IMG SRC="/lstat/lstat.cgi?obj=load1&format=png">

uzyskujemy wstawienie tym miejscu wykresu load1 w formacie pliku png. Parametr obj określa nazwę wykresu. Do linii parametrów wykresu możemy wpisać różne wartości opisujące bliżej ten obrazek. Np.

<IMG SRC="/lstat/lstat.cgi?obj=load1&format=png&LANG=pl&from=2h&TYPE=1&WIDTH=300&HEIGHT=150&TITLE=komputer%20PEGAZ">

Podczas tworzenia takiego obrazka, dla wszystkich wykresów możemy używać następujących parametrów (wielkość liter może mieć znaczenie):

Parametr

Opis

LANG

Wersja językowa etykiet wykresu (en, pl lub auto-pobierana z przeglądarki)

from

Początkowa wartość czasu na wykresie. Można tu użyć wartości symbolicznych odwołujących się do przeszłości np. 1h - oznacza godzinę wstecz od chwili obecnej, 2d dwa dni temu, 1w - tydzień temu, 2m dwa miesiące temu -600 oznacza 600 sekund wstecz lub można użyć dowolnego czasu, w postaci liczby sekund, które upłynęły od początku 1970 roku (polecenie date +%s)

to

Wartość końcowa czasu na wykresie, zdefiniowana taki jak dla from. Domyślnie chwila obecna.

TITLE

Tytuł wykresu (spacje i inne znaki specjalne muszą być zakodowane)

WIDTH

Szerokość wykresu (ale nie obrazka z legendą!)

HEIGHT

Wysokość wykresu (ale nie obrazka z legendą!)

Oprócz tych parametrów, niektóre typy wykresów posiadają dodatkowe znaczniki, które wpływają na wygląd wykresu. Ich nazwy można podejrzeć w plikach obj znajdujących się w katalogu objects (/usr/local/lstat/etc). Np. dla wykresów przepływu danych przez interfejsy sieciowe można ustawić parametr LIMIT=wartość, który spowoduje obcięcie danych na wykresie, a BITS zmieni wyświetlanie w bajtach lub bitach na sek.

Dynamiczny kod HTML

Wykresy LinuxStat można także wykorzystywać we własnych skryptach CGI, wywołując program lstat.cgi z odpowiednimi parametrami. Składnia tych parametrów jest podobna do tej opisanej powyżej, ale jako separatora argumentów należy stosować spację. Po wywołaniu programu, zostanie utworzony odpowiedni obrazek i na standardowe wyjście zostanie zwrócona odpowiedź, zależna od użytego formatu.


Zostały zdefiniowane następujące formaty:

Format

Opis

html

zostanie zwrócony kod HTML tabelki z wywołaniem obrazka wykresu i dodatkowych ikonek sterujących. Wygląda to tak jak na stronach generowanych przez LinuxStat

nomenu

zostanie zwrócony tylko kod HTML obrazka

only_name

zwraca unikalną nazwę utworzonego pliku graficznego

nohtml

tylko tworzy obrazek i nie zwraca żadnego tekstu

Przykładowe wywołanie programu:

 ./lstat.cgi obj=int23 format=nomenu BITS=1 from=3d

Tego typu wywołań można użyć w stronach SSI Apache, wykorzystując polecenie INCLUDE.


Spis treści Wstecz