8.7. Integrace WWW rozhraní do firemního webu

WWW rozhraní Kerio Network Monitoru umožňuje přístup k jednotlivým stránkám či jejich částem pomocí speciálních URL. Takto můžete do vašeho vlastního webu integrovat např. grafy zatížení linky, tabulky objemů přenesených dat, výpis aktivních spojení apod.

Obecný formát URL

URL stránek WWW rozhraní má obecně tento formát:

http://netmon:81/adresar/stranka?

parametr1=hodnota&parametr2=hodnota...

kde:

  • netmon — DNS jméno nebo IP adresa počítače, na němž Kerio Network Monitor běží

    Poznámka: Při integraci do jiného webu je třeba brát v úvahu, zda se ke stránkám bude přistupovat z interní sítě, z Internetu či z obou stran. Nejvhodnější je uvést jméno serveru, pro něž existuje odpovídající záznam v interním i veřejném DNS.

  • 81 — port, na němž běží WWW rozhraní Kerio Network Monitoru (viz kapitola 6.6)

  • adresar — adresář virtuálního WWW serveru, kde je příslušná stránka uložena

  • stranka — název stránky (viz dále)

  • parametr=hodnota — název parametru a příslušná hodnota (viz dále). Parametry jsou nepovinné — nebude-li některý parametr uveden, bude do něj dosazena výchozí hodnota. Neznámý (neexistující) parametr bude ignorován. Některé stránky žádné parametry nevyžadují.

Poznámka: V názvech stránek a parametrů by měla být dodržena malá a velká písmena. Na pořadí parametrů nezáleží.

Veškeré operace budou prováděny s právy nepřihlášeného uživatele.

Zobrazení aktivních spojení

Stránku aktivních spojení (Current connections) zobrazíme pomocí URL:

http://netmon:81/conn.html

Tato stránka nemá žádné nastavitelné parametry.

Graf objemu přenesených dat

K zobrazení stránky s grafem objemu přenesených dat slouží následující URL:

http://netmon:81/chart/form.html?

resolution=1&IP1=1.2.3.4&IP2=5.6.7.8&IP3=10.11.12.13&service=1

kde:

  • resolution — výběr časového úseku dle následující tabulky:

    Hodnota01234
    Význam1 minuta5 minut15 minut1 hodina6 hodin
    Hodnota5678
    Význam1 den1 týden1 měsíc1 rok

  • IP1, IP2, IP3 — IP adresy, pro něž bude v grafu zobrazován objem přenesených dat (červeně, zeleně a modře — v tomto pořadí). Místo IP adresy konkrétního počítače lze také uvést adresu 0.0.0.0 (součet objemu dat za všechny počítače) nebo 127.0.0.1 (zpětnovazební adresa; bude nahrazena IP adresou počítače, z něhož byla stránka otevřena)

  • service — výběr sledované služby:

    Hodnota01234567
    VýznamVšechny službyHTTPPOP3SMTPFTPTelnetIMAP4SSH

Pro zobrazení samotného grafu (obrázku) použijte následující URL:

http://netmon:81/chart/image.png

Všechny výše popsané parametry zůstávají v platnosti.

Příklad:

http://netmon:81/chart/image.png?

resolution=3&IP1=0.0.0.0&IP2=127.0.0.1&service=1

zobrazí samotný graf pro období 1 hodina, červeně bude znázorněn objem přenesených dat za všechny počítače a zeleně pro počítač, z něhož stránky prohlížíme.

Tabulka objemu přenesených dat

Následující URL zobrazí tabulku objemu přenesených dat (Report) podle zadaných parametrů:

http://netmon:81/report/output.html?

interval=2&back=7&columnscount=7&columnswidth=1&

sort=3&direction=3&service=0

kde:

  • interval — základ šířky sloupce, násobí se parametrem columnwidth. Možné hodnoty jsou:

    Hodnota012345
    Významminutyhodinydnytýdnyměsíceroky
  • back — počet časových období, o která se má Network Monitor „posunout zpět“ (nastavení začátku tabulky). Hodnota 0 znamená aktuální období.

  • columnscount — počet sloupců v tabulce

  • columnswidth — šířka sloupce. Součin tohoto parametru s parametrem interval udává časové období obsažené v jednom sloupci.

  • sort — hodnota, podle které bude tabulka seřazena:

    Hodnota123
    VýznamIP adresajméno počítačeobjem přenesených dat
  • direction — směr dat, který má být v tabulce zobrazen:

    Hodnota123
    Význampříchozí (download)odchozí (upload)součet dat v obou směrech
  • service — služba, pro niž má být objem dat zobrazen (viz výše — sekce Graf objemu přenesených dat)

Správné nastavení parametrů tabulky nejlépe vysvětlí příklad.

http://netmon:81/report/output.html?

interval=2&back=1&columnscount=7&columnswidth=1&

sort=3&direction=3&service=0

  • interval=2 — základní jednotkou šířky sloupce bude den

  • columnswidth=1 — šířka sloupce (časové období) bude 1 den

  • columnscount=7 — počet sloupců tabulky bude 7, celá tabulka tedy bude pokrývat časové období 7 dní (1 týden)

  • back=1 — časový posun o jedno období (tj. 1 týden) zpět. V důsledku to znamená, že tabulka bude zahrnovat období „-2 týdny až -1 týden“.

  • direction=3 — tabulka bude obsahovat součet příchozích i odchozích dat

  • service=0 — zobrazen bude celkový objem přenesených dat (pro všechny služby)

Záznamy

Pro zobrazení záznamů slouží URL:

http://netmon:81/log/output.html?

log=2&age=7&maxlines=1000&filter=text

kde:

  • log — číslo záznamového souboru dle následující tabulky:

    Hodnota234
    VýznamHTTP LogConnection LogMail Log
  • age — maximální stáří záznamu (v dnech)

  • maxlines — maximální počet řádek ve výstupu (vyhovuje-li ostatním podmínkám více řádek, zobrazí se pouze nejnovější záznamy)

  • filter — hledaný text. Ve výstupu budou zobrazeny pouze řádky záznamu obsahující tento text.