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.
Zmiana wyglądu stron generowanych przez LinuxStat. W tym celu można dostosować szablony stron HTML lub opracować własny schemat. zob. szablony
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
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
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.
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.
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.