Administer > Smart Analytics Administration > Troubleshooting > Troubleshooting: Checking Smart Analytics log files

Troubleshooting: Checking Smart Analytics log files

You can check the following log files to help you troubleshoot Smart Analytics issues:

Service Manager server log

This Service Manager server log file (sm.log) tracks all interactions between Service Manager and Smart Analytics. By default, the sm.log file is in the following directory: <Service Manager>\Server\logs\sm.log.

Smart Analytics log files

The log files from the Smart Analytics IDOL Server provide details to help you identify possible problems or invalid configurations. By default, you can find these log files in three different levels: the main proxy level, the Smart Search proxy level, and the content level. Each connector also has its own log folder. All the log files that are related to content are now in the corresponding content folder.

Check the following table for details about the log files in the IDOL Server.

File name Description
action.log Logs all the actions on IDOL Server.

agentstore_application.log

Logs general application errors, warnings and information relating to the agent index.

agentstore_index.log

Logs messages relating to the indexing, deletion and updating of agents.

agentstore_query.log

Logs messages relating to the querying of agents.

application.log

Logs general application errors, warnings and information relating to indexes.

category_application.log

Logs general application errors, warnings and information relating to the category index.

category_category.log

Logs messages relating to category actions that read or manipulate the categories, including errors, warnings and progress information.

category_cluster.log

Logs messages relating to cluster actions, including errors, warnings and progress information.

category_schedule.log

Logs messages relating to the running of the Analysis Schedules that are specified in the configuration file.

category_taxonomy.log

Logs messages relating to the TaxonomyGenerate action, including errors, warnings and progress information.

content_application.log

Logs general application errors, warnings and information relating to the data index.

content_index.log

Logs messages relating to the indexing, deletion and updating of documents.

content_query.log

Logs messages relating to query processes.

content_queryterms.log

Logs the query terms.

index.log

Logs the index actions that the Smart Analytics server receives.

query.log

Logs all the requests that the Smart Analytics server receives.

stats_index.log

Logs the statistics of the Smart Analytics server.

By default, the IDOL Server keeps the log files in the ./logs folder and compresses the log files into the zip files when the size reaches 20480 KBs. You can customize the settings according to your requirements.

For example, if you want to delete history log files automatically whenever the number of log files is more than 100, you can add LogOldAction=Delete and LogMaxOldFiles=100 into the configuration file.

The following items are the default logging configuration of the IDOL Server:

LogArchiveDirectory=./logs/archive
LogDirectory=./logs
LogTime=TRUE
LogEcho=FALSE
LogLevel=normal
LogExpireAction=compress
LogOldAction=move
LogMaxSizeKBs=20480

You can find these configuration items in the [Logging] section of the IDOL configuration file, which is located in the following path by default:

<SmartAnalytics Installation>\IDOL\AutonomyIDOLServer.cfg

The following table lists the description for these configuration items:

Parameter Description
LogArchiveDirectory Path to log archive directory. Type the directory in which you want the application to archive old log files when LogOldAction is set to Move.
LogDirectory Path to log directory.
LogTime

Displays time with each log entry. Enable this parameter to display the current time next to each log entry in the log file.

Possible values: TRUE or FALSE

LogEcho

Displays logging messages on the console.

Possible values: TRUE or FALSE

LogLevel

The log levels are hierarchical from least logging to most logging. You can use the LogLevelMatch parameter to specify which messages are reported relative to the specified LogLevel. For example, if LogLevelMatch=LessThan and LogLevel=Warning, "Normal" and "Full" message types are reported.

The following are the possible values for this parameter:

  • Always

    Basic processes are logged.

    Note This produces only minimal logging and no errors are logged.

  • Error

    Errors are logged.

  • Warning

    Errors and warnings are logged.

  • Normal

    Errors, warnings, and basic processes are logged.

  • Full

    Every occurrence is logged.

    Note This produces a large log file and can affect performance.

LogExpireAction

Determines how log files are handled when they exceed the maximum size. Type one of the following to determine how log files are handled when they exceed the MaxLogSizeKBs size:

  • Compress

    The log file's name is appended with a timestamp, compressed and saved in the log directory. By default, this is a ZIP file. Use the LogCompressionMode parameter to specify another compression format.

  • Consecutive

    The log file's name is appended with a number and saved in the log directory. When the next log file reaches its LogMaxSizeKBs size, it is appended with the next consecutive number.

  • Datestamp

    The log file's name is appended with a timestamp and saved in the log directory.

  • Previous

    The log file's name is appended with .previous and saved in the log directory. Every time a log file reaches its LogMaxSizeKBs size, it is given the same postfix so that it overwrites the old log file.

  • Day

    Only one log file is created for each day and is appended with the current timestamp. Log files are archived after they reach the LogMaxSizeKBs size.

    Note The LogMaxSizeKBs parameter takes precedence over the LogExpireAction parameter. Therefore, if you set LogExpireAction to Day, and the value for LogMaxSizeKBs results in more than one log file, multiple log files are generated for each day.

LogOldAction

Determines how log files are handled when the maximum number of log files is exceeded. Type one of the following to determine how log files are handled when the LogDirectory has reached the maximum number of log files, as determined by the LogMaxOldFiles parameter:

  • Delete

    The log files are deleted.

  • Move

    The log files are moved to the specified LogArchiveDirectory.

LogMaxSizeKBs

Maximum log file size (in kilobytes). If you do not want to restrict the log file size, type -1.

The LogExpireAction parameter determines how a log file is handled after it has reached its maximum size.

LogMaxOldFiles Maximum number of log files in the log directory. The maximum number of log files the specified LogDirectory can store before the application runs the specified LogOldAction. If you do not want to restrict how many log files the LogDirectory can store, type -1. (default: -1, unlimited)