Enable Diagnostic Logging
You can enable logging in File Content Extraction to diagnose issues that might occur. You configure logging in the formats.ini
configuration file, by creating a [Logging]
section.
CAUTION: Turning on logging can slow File Content Extraction down and quickly generate many large log files. OpenText recommends that you turn on logging only when you need to diagnose a problem, in conjunction with OpenText technical support.
The [Logging]
configuration uses the same format as File Content Extraction standard logging. In most cases, the following configuration is sufficient:
[Logging] LogDirectory=./logs 0=FilterLogStream [FilterLogStream] LogFile=filter LogTypeCSVs=Filter
In the [Logging]
section you set general parameters to apply to all log streams and define the names of your log stream section. You then define a section for each log stream, which contains settings for only that log stream.
The following table contains more details about the logging configuration parameters.
Parameter Name | Description |
---|---|
LogArchiveDirectory
|
The path to a directory to use to archive old log files when LogOldAction is set to Move. |
LogDirectory
|
The path to the directory to use to save log files. Relative paths are relative to the bin directory. |
LogEcho
|
Set this parameter to True to display logging messages on the console. |
LogExpireAction
|
The option to use to expire logs when they exceed the maximum size set by
|
LogFile
|
A file name prefix to use for all the log files that File Content Extraction creates for this log stream. File Content Extraction uses this prefix with the process ID and session to identify log files for each of your sessions. |
LogHistorySize
|
The number of log messages to store in memory. The maximum value is 520. |
LogLevel
|
The type of message to log. Use one of the following options:
The default value is Normal, when you enable logging. |
LogMaxLineLength
|
The maximum number of characters to allow in a log entry before it is truncated. You can increase this value when you need to log long actions in full. The maximum allowed value is 2000000000, but OpenText recommends that you set the value lower than 1000000. |
LogMaxOldFiles
|
The maximum number of log files to store in the log directory. When this value is exceeded, File Content Extraction applies the LogOldAction . |
LogMaxSizeKBs
|
The maximum size of log files, in kilobytes. When this value is exceeded, File Content Extraction applies the NOTE: File Content Extraction creates a separate log for each session and each kvoop process. With the default kvoop settings, the kvoop log is unlikely to reach the maximum log size before File Content Extraction refreshes the process, so the logs might not be expired. |
LogOldAction
|
The option to use to handle log files when the number of log files exceeds the value set by
|
LogOutputLogLevel
|
Set this parameter to False if you do not want to include the log level in the log entry. |
LogOutputSeverity
|
Set this parameter to False if you do not want to include the severity rating in the log entry. |
LogSysLog
|
Set this parameter to True to write messages to the Linux Syslog or Windows Event Log. |
LogTime
|
Set this parameter to False if you do not want to include the current time in the log entry. |
LogTypeCSVs
|
The type of logs to create. You must set this option to Filter. |
For more information about File Content Extraction logging, refer to the Help for a File Content Extraction component, for example the Content Component Help.