Virtlab:LoggingDebugging
Z VirtlabWiki
Verze z 17:32, 25. 7. 2007 Gry72 (Diskuse | příspěvky) ← Předchozí porovnání |
Verze z 19:02, 25. 7. 2007 Gry72 (Diskuse | příspěvky) Následující porovnání → |
||
Řádka 12: | Řádka 12: | ||
=== Úrovně logování === | === Úrovně logování === | ||
- | Úrovně logování částečně předurčen formátem používaných Syslogem. | + | Úrovně logování (priority zpráv) částečně předurčeny formátem používaných Syslogem. |
+ | |||
+ | * LOG_EMERG (system is unusable) | ||
+ | * LOG_ALERT (action must be taken immediately) | ||
+ | * LOG_CRIT (critical conditions) | ||
+ | * LOG_ERR (error conditions) | ||
+ | * LOG_WARNING (warning conditions) | ||
+ | * LOG_NOTICE (normal, but significant, condition) | ||
+ | * LOG_INFO (informational message) | ||
+ | * LOG_DEBUG (debug-level message) | ||
+ | |||
+ | Z priorit Syslogu využíváme následující úrovně: | ||
+ | |||
+ | |||
+ | Používané facilities: | ||
+ | |||
+ | *user | ||
+ | *local0 | ||
+ | *local1 | ||
+ | *local2 | ||
+ | *local3 | ||
+ | *local4 | ||
+ | *local5 | ||
+ | *local6 | ||
+ | *local7 | ||
+ | |||
+ | Synonyma použivaná pro jednotlivé facilities jsou v souboru virtlab_facilities.h | ||
+ | *FAC_WWWAPP (local0) - webová aplikace řídícího serveru lokality (GUI, mapovací algoritmus) | ||
+ | *FAC_RSVSRV (local1) - rezervační server | ||
+ | *FAC_CONSRV (local2) - konzolový server | ||
+ | *FAC_CONFSRV (local3) - konfigurační server | ||
+ | *FAC_CONFSRV (local4) - aktivátor konfigurací a konfigurační skripty vč. VLANStore | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | === Sjednocený formát textů logovaných zpráv === | ||
+ | |||
=== Knihovní funkce pro logování === | === Knihovní funkce pro logování === | ||
+ | <nowiki> | ||
+ | man logger | ||
+ | man 3 syslog: | ||
+ | void openlog(const char *ident, int option, int facility); | ||
+ | openlog("msg-prepend-string",LOG_NDELAY|LOG_CONS|LOG_PID, int facility (LOG_USER)); | ||
+ | |||
+ | void syslog(FACILITY | PRIORITY , const char *format, ...); | ||
+ | |||
+ | man 3 setlogmask: | ||
+ | int setlogmask(int mask); | ||
+ | - bitovým součtem se určí úrovně, které se mají funkcí syslog() skutečně logovat | ||
+ | |||
+ | </nowiki> | ||
+ | |||
+ | A process has a log priority mask that determines which calls to sys- | ||
+ | log(3) may be logged. All other calls will be ignored. Logging is | ||
+ | enabled for the priorities that have the corresponding bit set in mask. | ||
+ | The initial mask is such that logging is enabled for all priorities. | ||
+ | |||
+ | |||
+ | |||
+ | |||
Abychom dosáhli jednotné a pro programátory bezpracné nastavení úrovně logování u každého programu, | Abychom dosáhli jednotné a pro programátory bezpracné nastavení úrovně logování u každého programu, | ||
U PHP kódu předpokládáme nastavení úrovně debugování ve vhodném .php souboru, který se pomocí include připojuje ke všem .php souborům (soubor s konstantami, soubor s autentizací ?) | U PHP kódu předpokládáme nastavení úrovně debugování ve vhodném .php souboru, který se pomocí include připojuje ke všem .php souborům (soubor s konstantami, soubor s autentizací ?) |
Verze z 19:02, 25. 7. 2007
Obsah |
Logování a debugging
Pro odladění, sledování provozu a řešení incidentů celého distribuovaného systému virtuální laboratoře je nutný konzistentní systém ukládání informací o běhu na různých úrovních, které bude možné snadno automaticky vyhodnocovat a informovat příslušné správce o kritických nebo nestandardních stavech. Informace o běhu všech komponent (serverů) lokality budou shromažďovány na Syslog serveru dané lokality, kde budou vyhodnocovány příslušnými skripty a podle nastavených pravidel případně přeposílány emailem na správné zodpovědné správce. Logovací soubory syslog serverů všech lokalit budou zpřístupněny správcům všech ostatních lokalit (patrně přes WWW). Z důvodu snadné rozšiřitelnosti bude použit Syslog Next Generation (Syslog-ng).
Jednotlivé servery budou zasílat debug informace na syslog jednotně pomocí k tomu účelu vytvořené univerzální funkce (C), kterou budou formou knihovny přilinkovávat (PHP bude patrně volat jako externí program). Funkce předá zprávu Syslog serveru lokality (démonu Syslog-ng) zápisem do souboru (named pipe), na kterém Syslog démon poslouchá. V případě, že budou servery distribuovány na více strojů, bude na každém z nich instalován proxy syslog démon, který bude nastaven tak, aby zprávy pouze přeposílal na hlavní syslog démon lokality.
Formát logovacích zpráv
Formát logovacích zpráv je částečně předurčen formátem používaných Syslogem.
Úrovně logování
Úrovně logování (priority zpráv) částečně předurčeny formátem používaných Syslogem.
- LOG_EMERG (system is unusable)
- LOG_ALERT (action must be taken immediately)
- LOG_CRIT (critical conditions)
- LOG_ERR (error conditions)
- LOG_WARNING (warning conditions)
- LOG_NOTICE (normal, but significant, condition)
- LOG_INFO (informational message)
- LOG_DEBUG (debug-level message)
Z priorit Syslogu využíváme následující úrovně:
Používané facilities:
- user
- local0
- local1
- local2
- local3
- local4
- local5
- local6
- local7
Synonyma použivaná pro jednotlivé facilities jsou v souboru virtlab_facilities.h
- FAC_WWWAPP (local0) - webová aplikace řídícího serveru lokality (GUI, mapovací algoritmus)
- FAC_RSVSRV (local1) - rezervační server
- FAC_CONSRV (local2) - konzolový server
- FAC_CONFSRV (local3) - konfigurační server
- FAC_CONFSRV (local4) - aktivátor konfigurací a konfigurační skripty vč. VLANStore
Sjednocený formát textů logovaných zpráv
Knihovní funkce pro logování
man logger man 3 syslog: void openlog(const char *ident, int option, int facility); openlog("msg-prepend-string",LOG_NDELAY|LOG_CONS|LOG_PID, int facility (LOG_USER)); void syslog(FACILITY | PRIORITY , const char *format, ...); man 3 setlogmask: int setlogmask(int mask); - bitovým součtem se určí úrovně, které se mají funkcí syslog() skutečně logovat
A process has a log priority mask that determines which calls to sys- log(3) may be logged. All other calls will be ignored. Logging is enabled for the priorities that have the corresponding bit set in mask. The initial mask is such that logging is enabled for all priorities.
Abychom dosáhli jednotné a pro programátory bezpracné nastavení úrovně logování u každého programu,
U PHP kódu předpokládáme nastavení úrovně debugování ve vhodném .php souboru, který se pomocí include připojuje ke všem .php souborům (soubor s konstantami, soubor s autentizací ?)