Provozní logování

Provozní logování obsahuje hlavní a podstatné informace o provozu na webových službách jako jsou Datum a čas volání, ID procesu, ID vlákna, IP adresu volajícího, Uživatelské jméno volajícího (pokud se v hlavičce identifikoval), Dobu trvání procesu, Název volané metody a Doplňující informace (Výsledek volání).

Nastavení provozního logování

Provozní logování je možné nastavit dvěma způsoby lišícími se dle zamýšleného použití LTD.

V konfiguračních souborech se vyplní:

Cesta k CSV souboru. Je nutné, aby provozní CSV soubor byl přístupný pro zápis tomu uživateli, pod kterým běží aplikační pool webové služby LTD.

LogMethodCalls

Konfigurační soubor služby

Při integraci řešení přes webové služby se konfigurace nastavuje v souboru InstallDir\WebService\Web.config.

Příklad zápisu v konfiguračním souboru (elementy configuration a appSettings bývají již vytvořené):

<configuration>
    <appSettings>
        ...
        <add key="LogMethodCalls" value="C:\logs\LTDSDK_WS_provoz.csv" />
        ...
    </appSettings>
</configuration>

Konfigurační soubor produktu

Při integraci řešení přes .NET rozhraní se konfigurace nastavuje v souboru InstallDir\Engine\Engine.config.

Zápis je stejný jako u webové služby.

Fragmentování logu

Od verze 2.0.101.0425 přidán nový konfigurační klíč LogMethodCallsFragments (jehož výchozí hodnota je 0). Pokud je nastaven, rozděluje se CSV soubor po dnech dle zvolené hodnoty s tím, že se ponechává LogMethodCallsFragments nejnovějších log souborů.

Příklad: když je nastavena hodnota LogMethodCallsFragments na 14 (dnů), potom log z 15. dne se přepíše logem z 1. dne.

Výchozí maska souboru LogMethodCallsFragments je yyyy-MM-dd (příklad LTD_2020-07-10.csv). Masku lze nastavit pomocí klíče LogMethodCallsFragmentsMask. Vhodné např. pro rozdělení provozních CSV logů po měsících nastavením masky na hodnotu yyyy-MM.

Provozní logovací CSV soubor je (v případě potřeby auditní stopy) možné vlastním voláním metody ConvertFile/ConvertFileEx převést do PDF či PDF/A a podepsat včetně časového razítka.