Configuring tracing for Content Manager

Enable tracing to obtain detailed information about the activities of (a part of) Content Manager.

Procedure

  1. To enable tracing for all parts of the Content Manager, open Tridion.ContentManager.config, located in your %TRIDION_HOME%\config folder, for editing. Find the tracing element and set its enabled attribute to true. The various parts of Content Manager refer back to this configuration file, which means they inherit this setting by default. Each part does log to its own trace file, as specified in its configuration file.
  2. You can override the default tracing setting for a specific part of Content Manager. That is, you can enable tracing for a part while keeping it disabled elsewhere, or vice versa. To do this, open the configuration file for that part for editing.

    Here are the parts of Content Manager for which you can override default tracing settings, and their corresponding configuration files:

    Content Manager partConfiguration file path and filename
    Core Service%TRIDION_HOME%\bin\TcmServiceHost.exe.config
    Workflow Agent%TRIDION_HOME%\bin\TcmWorkflowAgent.exe.config
    Publisher%TRIDION_HOME%\bin\TcmPublisher.exe.config
    Search Indexer%TRIDION_HOME%\bin\TcmSearchIndexer.exe.config
    Batch Processor%TRIDION_HOME%\bin\TcmBatchProcessor.exe.config
  3. In one or more of these files, declare the presence of a tridion.common section inside your <configSections> section:
    <configSections>
      ...
      <section name="tridion.common" type="Tridion.Configuration.ConfigurationSections, Tridion.Common, 
        Version=7.1.0.20, Culture=neutral, PublicKeyToken=349a39f202fa9b53" />
      ...
    </configSections>
  4. Also create an add element for the section inside the <tridionConfigSections> section:
    <tridionConfigSections>
      <sections>
        <clear />
        <add filePath="..\..\..\..\..\Config\Tridion.ContentManager.config" />
        <add name="tridion.common" />
        ...
      </sections>
    </tridionConfigSections>
    This prevents the section from being inherited from the generic configuration.
  5. Inside the <configuration> level in your configuration file, add a <tridion.common> section and configure it as follows:
    <tridion.common>
      <localization loggingCulture="en-us">
        <resources>
          <add baseName="Tridion.ContentManager.Localization.Resources" 
            assembly="Tridion.ContentManager.Localization, Version=0.0.0.0, Culture=neutral, PublicKeyToken=ddfc895746e5ee6b" />
          <add baseName="Tridion.ContentManager.ImportExport.Resources" 
            assembly="Tridion.ContentManager.ImportExport.Common, Version=0.0.0.0, Culture=neutral, PublicKeyToken=ddfc895746e5ee6b" />
        </resources>
      </localization>
      <tracing enabled="false">
        <parameterValueTruncation default="50">
          <parameterTypes>
            <clear />
            <!-- Do not remove or change the settings for type System.Data.IDataRecord -->
            <add type="System.Data.IDataRecord" 
              assembly="System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" maxLength="0" />
          </parameterTypes>
        </parameterValueTruncation>
      </tracing>
    </tridion.common>

    Apart from the value of the enabled attribute of the tracing element, everything else in this section should be configured as it is configured in the main configuration file, Tridion.ContentManager.config.

  6. Save and close your configuration file.
  7. Restart the service associated with the configuration file you modified.