Export (0) Print
Expand All

Managing Log Files

BizTalk Server RFID creates the following log files that contain troubleshooting information:

  • Installation log file, named RfidServicesSetup(mmddyyhhmm).log, located in the %Temp% directory

  • RFID service log file, named RfidServices.log, located in the %RFIDINSTALLDIR%\Logs folder

  • Provider log files, named <ProviderName>.log, located in the %RFIDDATADIR%\Providers\<ProviderName> folder

  • Process log files, named <ProcessName>.log, located in the \%RFIDDATADIR%\Processes\<ProcessName> folder

  • RFID Administrator tools log file, named RfidTools.log, located at %appdata%\Microsoft Corporation\BizTalk RFID

Ee309298.note(en-US,BTS.10).gifNote
All the environment variables are created during installation. While running setup, in a dialog box the user can provide the installation folder (%RFIDINSTALLDIR%) and another folder for the data files from which %RFIDDATADIR% is populated. %RFIDLOGLOCATIONDIR% denotes the folder where the service logs can be found and points to %RFIDDATADIR%\Logs.

RFID service logs

Contain the logging information recorded from the RFID service.

RFID process logs

Contain the logging information from the Process Manager component and logging done from the event handlers.

Provider logs

Contain the logging information from the device providers.

The following table shows the different levels of logging and their descriptions.

Logging levelDescription

Off

Turns off logging.

Fatal

Enables logging of fatal errors only.

Error

Enables logging of errors and fatal errors.

Warning

Enables logging of warnings, errors, and fatal errors.

Info (default)

Enables logging of brief descriptions of all the activities of the server.

Verbose

Enables logging of detailed descriptions of all the activities of the server.

BizTalk Server RFID allows you to control the size of the log files as well the number of log files in the system, as described in the next section.

  • Log Size. Use this property to specify the maximum size that a log file can reach before it is rotated and a new file is created for RFID service logs. When a log file is rotated, a suffix is added to the file name of the current log file (for example, RfidServices_1.log) and a new RfidServices.log file is created in its place. At the second rotation RfidServices_1.log is renamed to RfidServices_2.log and RfidServices.log is renamed to RfidServices_1.log, and so on.

  • Number of Log Files. Use this property to specify the maximum number of rotated log files that RFID retains, and thus control the maximum amount of disk space that RFID service logs use. For example, if the number of log files is set to 2, on rotating the service logs for the third time, RFID discards the older RfidService_1.log instead of renaming it to RfidService_2.log.

Ee309298.Important(en-US,BTS.10).gifImportant
While the current active log file for the BizTalk RFID service (RfidServices.log) is backed up each time the service is restarted, any rotated log files (RfidServices_x.log) are not backed up. Therefore, the log data collected in these rotated logs is lost when the BizTalk RFID service restarts. In troubleshooting scenarios where a high volume of data is gathered in logs, you can retain logging information by increasing the value of the Log Size property. Alternatively you can manually back up the rotated log files before restarting the BizTalk RFID service.

Ee309298.note(en-US,BTS.10).gifNote
The Log File Backup feature is different from the rotation feature. The backup feature enables you to back up the current service log each time the RFID service is restarted. The backup file has RfidService_<date/time>.log as the file name.

By using RFID Manager as described in the following procedures, you can configure the log level for a BizTalk Server RFID server, a process, and a provider. A process or a provider can inherit or override the log level of the server.

To configure the log level of a BizTalk Server RFID server
  1. Click Start, point to Programs, point to BizTalk RFID, and then click RFID Manager.

  2. Expand RFID Services Administration.

  3. Right-click <your computer name> (local), and then click Properties.

  4. In the left pane, click Logging to switch to the Logging view.

  5. Change Log level to meet your needs.

Ee309298.note(en-US,BTS.10).gifNote
If you set the log level to Verbose, BizTalk Server RFID writes detailed descriptions of all the activities of the server. Therefore, the log file can consume a lot of disk space. If disk space is a concern, set the log level to a lower level than Verbose. The Verbose mode is useful for debugging issues with your BizTalk Server RFID applications.

To override the server log level for a process
  1. In RFID Manager, expand Processes.

  2. Right-click the name of the process for which you want to set the log level, and then click Properties.

  3. Clear the Inherit log level option.

  4. Change Log level to meet your needs.

Ee309298.note(en-US,BTS.10).gifNote
If you click Default in the Properties dialog box, the Inherit log level option is selected. You can also manually select the Inherit log level option.

To override the server log level for a device provider
  1. In RFID Manager, click Device Providers.

  2. In the list of providers, right-click the name of the provider for which you want to set the log level, and then click Properties.

  3. Click Initialization Properties to switch to the Initialization Properties view.

  4. Clear the Inherit log level option.

  5. Change Log level to meet your needs.

Ee309298.note(en-US,BTS.10).gifNote
You can select the Inherit log level option to set it back to its default value.

Show:
© 2014 Microsoft