Výchozí nastavení logování dané instalačním programem je možné upravit prostřednictvím aplikace Konfigurátor DATASYS UMS v částí Společná nastavení > Syslog.
Viz příručka pro aplikaci Konfigurátor DATASYS UMS.
Poznámka: Logování v defaultním stavu probíhá připojením k SYSLOG serveru. V případě, že je potřeba logovat do txt souboru je možné použít například opensource nástroj NXLog.
Formát SYSLOG zprávy
identifikace SYSLOG zdroje: "UMS"
seznam parametrů: "název_parametru"="hodnota_parametru"
oddělovač parametrů: ","
escape znak: "\"
Příklad zprávy:
TIME="2020-06-11 06:40:05.219", COMPONENT="SmtpReceiver", PID="2500", TYPE="CTL_EXPORT", TO_NUMBER="776677828", FROM_EMAIL="uzivatel@datasys.cz", PREV_SYSTEM_TYPE="email", APPLICATION="sms", TO_NAME="777123456", PREV_SYSTEM_SENDER="127.0.0.1", FROM_SMTP="uzivatel@datasys.cz", MESSAGE_ID="s2_00006a78.ctl", PREV_MESSAGE_ID="<000a01c699bd$23a5e0a0$3a20a8c0@umszl.local>"
Názvy parametrů:
APPLICATION - aplikace/použití komponenty:
DbConnector a SMSInfo3Connector zde zapisuje název konektoru
SmtpReceiver zde zapisuje aktuální SmtpReceiver aplikaci ("sms", "sms_notify", ...)
SmtpSender zde zapisuje UMS produkt ("FaxChange", "MobilChange", "UMS")
ATTEMPT_ID - ID pokusu o odeslání
CAMPAIGN_ID - ID SmsInfo3 kampaně
CAMPAIGN_NAME - název SmsInfo3 kampaně
COMPONENT - název zapisující komponenty, viz níže
DESCRIPTION - bližší popis události (např. důvod zastavení komponenty)
DISPLAYONLY - zobrazit jen na displeji? (0/1)
DR - doručenka vyžadována? (0/1)
FROM_EMAIL - e-mail uživatele (nebo aplikace), který zprávu fakticky odeslal; reporty chodí na tuto adresu
FROM_NAME - jméno odesílatele
FROM_NUMBER - tel. číslo odesílatele
FROM_SMTP - e-mail uživatele (nebo aplikace), který se vydává za odesilatele; mimo reportů se použije na vše ostatní (zda smí MX použít, zda požaduje DR/NDR, k započtení do limitů/nákladů, ...)
LINE - název linky
MESSAGE_ID - ID zprávy v zapisující komponentě
MESSAGE_STATUS_ID - číselná hodnota/ID stavu zprávy podle tabulky MX_SMS_SEND_STATUS
MESSAGE_STATUS - šablona stavu zprávy podle tabulky MX_SMS_SEND_STATUS; pokud stav nemá šablonu, je zde interní název stavu v MX kernelu - např. stavu 10 odpovídá "Sending"
NOMODIFY - nemodifikovat text zprávy? (0/1)
PART - aktuální část zprávy
PART_MAX - počet částí zprávy
PID - ID procesu zapisující komponenty
PREV_MESSAGE_ID - ID zprávy v předchozí komponentě/systému
PREV_SYSTEM_TYPE - typ předchozího systému, např. "database", "email", "file", "smsinfo3", ...
PREV_SYSTEM_SENDER - identifikace předchozího systému který zprávu odeslal, např. IP adresa SMTP klienta
PRIORITY - priorita zprávy
REF_MESSAGE_ID - ID zprávy, na kterou je tato zpráva odpovědí
RULE_ID - ID routovacího pravidla
RULE - název routovacího pravidla
TIME - UTC čas události ve formátu yyyy-MM-dd HH:mm:ss.fff
TO_EMAIL - e-mail příjemce
TO_NAME - jméno příjemce
TO_NUMBER - tel. číslo příjemce
TYPE - typ události (viz níže)
USER / USER_NAME - jméno/login/ID nebo jiné označení uživatele
USER_IP_ADDRESS - IP adresa uživatele
VERSION - verze zapisující komponenty
Typy komponent a jejich událostí:
komponenta SmtpReceiver:
START - spuštění komponenty
STOP - zastavení/ukončení běhu komponenty
ERROR - chybový stav komponenty
CTL_EXPORT - zápis přijaté zprávy do CTL souboru
komponenta SmtpSender:
START - spuštění komponenty
STOP - zastavení/ukončení běhu komponenty
ERROR - chybový stav komponenty
CTL_IMPORT - import zprávy z CTL souboru do SMTP souboru
MSG_STATUS - stav zprávy změněn
komponenta MxKernel:
START - spuštění komponenty
STOP - zastavení/ukončení běhu komponenty
ERROR - chybový stav komponenty
MSG_STATUS - stav zprávy změněn
CTL_IMPORT - import zprávy z CTL souboru do UMS DB
ROUTE_IN - routování/směrování vstupní zprávy
ROUTE_OUT - routování/směrování výstupní zprávy
komponenta Drivery linek:
START - spuštění komponenty
STOP - zastavení/ukončení běhu komponenty
ERROR - chybový stav komponenty
MSG_STATUS - stav zprávy změněn
komponenta MxDbConnector a SmsInfo3Connector:
START - spuštění komponenty
STOP - zastavení/ukončení běhu komponenty
ERROR - chybový stav komponenty
DB_EXPORT - export přijaté zprávy z UMS do externí/SmsInfo3 databáze
DB_IMPORT - import odesílané zprávy z externí/SmsInfo3 databáze do UMS
komponenta MxServicePoints:
START - spuštění komponenty
STOP - zastavení/ukončení běhu komponenty
ERROR - chybový stav komponenty
DB_EXPORT - export přijaté zprávy z UMS do externího systému
DB_IMPORT - import odesílané zprávy z externího systému do UMS
IGNORED - ignorovaná zpráva/notifikace
komponenta SmsInfo3:
START - spuštění komponenty
STOP - zastavení/ukončení běhu komponenty
ERROR - chybový stav komponenty
LOGIN - přihlášení uživatele
CAMPAIGN_CREATED - vytvořena nová kampaň
Úroveň závažnosti (severity):
je vypočítaná z první hodnoty na řádku, uzavřené v <xxx>, tímto vzorcem: <xxx> = facility * 8 + závažnost.
Úroveň závažnosti nabývá hodnot
0 - EMERGENCY
1 - ALERT
2 - CRITICAL
3 - ERROR
4 - WARNING
5 - NOTICE
6 - INFORMATIONAL
7 - DEBUG
Facility number:
16 - local0
17 - local1
18 - local2
19 - local3
20 - local4
21 - local5
22 - local6
23 - local7
Příklad:
<186>Sep 27 2023 17:32:00 NAZEV-SERVERU UMS: TIME="2023-09-27 15:32:00.607", COMPONENT="MxKernel", PID="7348", TYPE="ERROR", DESCRIPTION="File import general error: The process cannot access the file because it is being used by another process.
Facility = local7
186 = 23 * 8 + 2
Hodnota závažnosti je 2, tedy CRITICAL