CeLog Registry Settings (Compact 2013)

3/28/2014

You can set the initial CeLog collection zones, change the size of the buffer, and configure the CeLogFlush.exe and OSCapture.exe tools by modifying the following registry values, located in the key HKEY_LOCAL_MACHINE\System\CeLog.

Name

Type

Description

Default value

BufferSize

REG_DWORD

Specifies the size, in bytes, of the CeLog RAM buffer that stores event activity before flushing.

0x00020000 = 131072, or 128KB

FileName

REG_SZ

Name of log file to store the data in.

"\release\celog.clg"

FileSize

REG_DWORD

Specifies a size limit for the generated log file, in hexadecimal.

At the beginning of a flush, if the log file exceeds the specified size, the log file is renamed to <Logfile>.old. Thus, log files can actually grow to approximately twice the specified FileSize.

This option forces the FileFlags value to be set to 2, because the rename happens only when the file is opened at the start of a flush.

0, no limit

FileFlags

REG_DWORD

DWORD value that governs file management. Set to one of the following:

  • 0=Auto-close the log file if no data has been lost recently. This balances performance with file access convenience.
  • 1=Never close the log file. This option maximizes performance, but does not close the file handle.
  • 2=Always close the log file. This option maximizes file accessibility during logging.

0

FlushTimeout

REG_DWORD

Sets the timeout, in milliseconds, between successive "flushes."

If the buffer fills before the elapsed time specified, the buffer will flush to prevent the CeLog from overflowing. Setting FlushTimeout to 0xFFFFFFFF causes an "as needed" flushing behavior; the flush thread will delay flushing until it is full.

0x00002710 = 10000, or 10 seconds

SavedFlushes

REG_DWORD

Sets the number of "flushes" to buffer in RAM.

Ee480468.note(en-us,WinEmbedded.80).gifNote:
This registry setting is deprecated in Windows Embedded Compact 2013.

0x0000000F = 15

SyncBufferSize

REG_DWORD

Specifies the size of the portion of the RAM buffer to use for "sync" data such as process, thread, and module information. The sync buffer is primarily needed by OSCapture, so that the sync data can be used to interpret information from the continuously running ring buffer.

The sync buffer is allocated out of the RAM buffer, so its minimum size is 0, and its maximum size is specified by BufferSize.

When using CeLogFlush, SyncBufferSize is set to 0 and is ignored.

0, no sync buffer

ThreadPriority

REG_DWORD

Sets the priority of the flushing thread (0-255).

0x000000F8 = 248, the lowest real-time priority

Transport

REG_SZ

Transport to use. This value must be set to LocalFile, which stores data in a log file on the local file system.

LocalFile

UseUI

REG_DWORD

Boolean value that indicates type of messages.

  • 1=use popup messages
  • 0=debug messages only

0

ZoneCE

[REG_DWORD

One of the following CeLog zone settings.

  • 0x000043E3
  • This value represents the bitwise OR of the following zone values:
  • CELZONE_PROCESS
  • CELZONE_THREAD
  • CELZONE_RESCHEDULE
  • CELZONE_PRIORITYINV
  • CELZONE_CRITSECT
  • CELZONE_SYNCH
  • CELZONE_LOADER
  • CELZONE_INTERRUPT

If this value is present, CeLogFlush calls CeLogSetZones to pass the zones to CeLog. For more information, see CeLogSetZones.

0

You can set CeLog Zones that control the CeLog collection process during boot by setting the following registry value, located in the key HKEY_CURRENT_USER\Pegasus\Zones.

Name

Type

Description

Default Value

CeLogZoneCE

REG_DWORD

Indicates which OS zones are to be logged.

0xFFBFFFFF

You can expand the number of filtering options that are available, and you can create custom filter parameters for Readlog by setting values in the registry key HKEY_CURRENT_USER\SOFTWARE\Microsoft\CeLog Reader\Filters.

See Also

Reference

CeLog Event Tracking Reference
CeLog Zones