When enabled, a unique data service log file records log events for each server request that runs a real-time data service
(as processed by DFWSVC.) The name of each data service log file is added to the DataFlux Data Management Server log file
dmserver.log. The server log also contains debugging information for the job run of the real-time data service. If a new service
process is used, then the server log includes the
PID of the corresponding process.
Note: To maximize performance,
data service logging is disabled by default. To enable data service
logging for testing purposes, follow the steps provided later in this
section.
Each new data service
log file is stored by default in the following directory:
install-path/var/server_logs/log-subdirectory
The name of the log
subdirectory specifies the date, time, process ID, and server request
ID.
The name of the data
service log file is illustrated in the following example:
10.52.24.226_2778_datasvc_Verify-Address-Job.ddf.log
In the preceding example, 10.52.24.226 is
a time stamp, 2778 is the server request
ID, and datasvc is the log file type. The
remainder of the name specifies the name of the real-time service.
Data service logging
is configured by default by the following file:
install-path/etc/service.log.xml
Follow these steps to
enable logging for real-time services:
-
Open service.log.xml
and locate the
root tag.
-
Change the
OFF value
in <level value="OFF"/> to
DEBUG or
TRACE,
depending on the level of information that you want to gather. TRACE
provides the greatest level of information.
-
Restart the Data Management
Server.
-
At the conclusion of
testing, repeat this procedure to disable logging.
If you require additional
information to conclude your testing process, contact your SAS technical
support representative.
To change the name and
location of the data service log configuration file service.log.xml,
open the following file:
install-path/etc/service.cfg
In service.cfg, change
value of the option BASE/LOGCONFIG_PATH, and then restart the Data
Management Server.
To change the encoding
of the job logs for your real-time data services, set the configuration
option BASE/JOB_LOG_ENCODING in the file install-path/etc/app.cfg.
By default, the log is written in the encoding of the locale of the
process that executes the job. For English-speaking organizations,
the encoding can be LATIN-1 or UTF-8. If a log line contains characters
that cannot be represented in the encoding, then the log line is not
written to the log file.