About Agents About Refinery Logs

Managing Conversions 2-27 ■ Viewing Refinery Logs on page 2-28 ■ Viewing Console Output on page 2-28 ■ Viewing Agent Status on page 2-28 ■ Viewing Agent Queues on page 2-28 ■ Viewing Conversion History on page 2-29 ■ Viewing Agent Logs on page 2-29

2.4.1 About Agents

An agent is an entity, such as a content server, that sends conversion jobs to the refinery. The refinery separates conversion status information and logging by agent to make it easier to view the information and find details.

2.4.2 About Refinery Logs

There are two types of log files created for the refinery: ■ Refinery logs : Refinery logs contain general information about refinery functionality that is not specific to conversions performed for agents for example, startup information. One log file is generated for each day the refinery is running. ■ Refinery Agent logs : Refinery agent logs contain information specific to conversions performed for agents sending conversion jobs to the refinery. One log file is generated for each agent, each day that the agent sends at least one conversion job to the refinery. Log entries are listed by date and time. Entries are added to the appropriate log file throughout the day as events occur. The time stamp placed on a refinery log entry designates when the log entry was created, not necessarily when the action took place. Refinery agent log entries list the conversion number at the beginning of each entry because each agent can have multiple concurrent conversions running at a given time. For example: Log entry for conversion job 3513. The following types of log entries are generated: You can enable verbose logging. When verbose logging is on, general agent status information, a detailed description of each conversion engine action for example, when the conversion was started and file details, conversion step details, and conversion results, and errors are recorded in the refinery agent log. When verbose logging is off, only general agent status information and errors are recorded in the refinery agent log. For details, see Enabling Verbose Logging on page 2-33. A log file might include Details links. Clicking the Details links expands and collapses log details. Typically, the log details are either a stack dump or a trace back to the code that generated the error. Log Entry Description Info Displays status information. For example, startup information or a description of a conversion engine action. Error Displays errors that occur. 2-28 Administrators Guide for Conversion

2.4.3 Viewing Refinery Status