This documentation supports the 9.1 to 9.1 Service Pack 3 version and its patches of BMC Atrium Core. The documentation for version 9.1.04 and its patches is available here.

To view the latest version, select the version from the Product version menu.

Reconciliation job logging

The Reconciliation Engine logs all activities that it performs: Identification, Compare, Merge, Delete, and Purge. A log file for a job is created each time the Reconciliation Engine runs that job. The Reconciliation job logging is enabled by default.

The Reconciliation job logging topic provides information about log details, naming conventions, viewing events, and interpreting log entries.

Log entry details

Each entry in the log provides the following details:

  • Timestamp — The date and time of the log entry.
  • Log Type — The type of log entry:
    • Error — Logs detailed messages for errors and warnings (default).
    • Info — Logs class-level details, such as dataset name and class name.
    • Debug — Logs trace messages, which are used for debugging errors.
      All these logging levels are inclusive of their preceding levels. For example, if you set the Logging Level at Debug, you receive log messages for Error, Info, and Debug types. You can specify the Logging Level for the log files from the Modify Server Configuration window of the Reconciliation Engine Console.
  • Message — The message for the log entry.

You can specify additional settings for the log files in the Modify Server Configuration window of the Reconciliation Engine Console. For more information about these settings, see Reconciling data.

Log file naming convention

The Reconciliation job log files use the following naming convention:
jobName_ctr.log

jobName is the name of the job that you created in the Reconciliation Manager (for example, BMCAsset - Identification and Purge).

ctr is a numeric value that starts from 1 and is incremented when a new log file is created for the job run. The Reconciliation Engine continues to log errors in a new log file when an existing log reaches its size limit.

For example, if multiple files are created for the BMCAsset - Identification and Purge job run, the job log files will be named as:

  • BMCAsset - Identification and Purge_1.log
  • BMCAsset - Identification and Purge_2.log

Viewing Reconciliation job events in the log file

When the log file for the Reconciliation job is created, an event associated to the job is added to the Reconciliation Engine Console. This event contains the job file name and location.

To view the event for the log

  1. Log in to the BMC Remedy Mid Tier.
  2. Select BMC Atrium Core Console > Reconciliation Manager.
  3. From the navigation link on the left, click Job History.
    The Job History Console is displayed.
  4. From the Jobs table on the top of the window, choose the specific job.
    The Related Runs table is populated with the run status of the job.
  5. Select the specific job run for the job.
    The Related Events table is populated with event information for the job.
  6. Click the RE Log File & Location event and click View.
    The Job Event Information window is displayed.
  7. Click the Diary field to view the log file path information.

To analyze Reconciliation job log files

The general process of analyzing Reconciliation job logs is the following:

  1. Open the first job log in a text editor
  2. Disable line wrap, so you can see the activity more clearly by scrolling to the right in the log.
  3. To find a particular Configuration Item (CI) in the log, search for its instanceid or ReconciliationIdentity value.
  4. If the Reconciliation job run generated multiple logs, search in each of the log files.
  5. When you identify the particular CI, note the value of the thread ID (TID) on that line.
  6. Search up and down in the file for lines with that TID to view the processing of that CI.
  7. If the particular CI is not found, search for the class of the CI to see how or if the class was processed.

Interpreting entries in the log file

The Reconciliation job log is a multi-threaded program with all threads writing to the same log file. The log files are divided by activity names. Each of these activities has a start or run entry, indicating the start of the activity, and an end or completed entry indicating the end of the activity. The following examples illustrate both these entries.

Example 1: Starting an activity

[Tues Apr 24 2007 12:10.08.4748] [INFO] [TID: 000011]: Running activity: BMC Topology Import - Identification Activity

Example 2: Ending an activity

[Tues Apr 24 2007 12:10.08.4748] [INFO] [TID: 000011]: Activity completed: BMC Topology Import - Identification Activity

Each entry contains a thread ID (TID) that identifies a unique activity. If multiple instances need to be identified, the Reconciliation job creates separate threads for each instance identification. Therefore, the log file contains mixed entries for various threads instead of having one section for each thread.

The following code is an example of a Reconciliation job log file.

[2007/03/30 10:35:36.1370] [DETAILS] [TID: 003720] : Started waiting for all the threads to finish
[2007/03/30 10:35:39.7710] [DETAILS] [TID: 002696] : Started identifying instance <class = QA_Patch2_No_Ident_Multi_Match: Patch2_1Class_No_Ident_Multi_Match, id = ID00087492D05D8nFOQw8SSKBAawAA>
[2007/03/30 10:35:39.7710] [ TRACE ] [TID: 002696] : Found matching rule group <Patch002-Identify D2 against D1> for class <QA_Patch2_No_Ident_Multi_Match:Patch2_1Class_No_Ident_Multi_Match > in dataset <Data Set 02>
[2007/03/30 10:35:39.7710] [ TRACE ] [TID: 002696] : Applying rule <'Character_Field' = $Character_Field$> and looking in dataset <Data Set 01>
[2007/03/30 10:35:39.7710] [DETAILS] [TID: 002696] : Substituting values in the qualification
[2007/03/30 10:35:39.7710] [DETAILS] [TID: 002696] : Replaced field <id = 536870999 and name = Character_Field> with value <All Match Error During Identification - Recon ID (Below) should remain 0>
[2007/03/30 10:35:39.7810] [ ERROR ] [TID: 002696] : Found multiple matches (instances) for class <QA_Patch2_No_Ident_Multi_Match:Patch2_1Class_No_Ident_Multi_Match > in look-up dataset <Data Set 01>
[2007/03/30 10:35:39.7810] [ ERROR ] [TID: 002696] : for qualification <'Character_Field' = <Character_Field$> of group <Patch002-Identify D2 against D1> with values
[2007/03/30 10:35:39.7810] [ ERROR ] [TID: 002696] : <Character_Field = All Match Error During Identification - Recon ID (Below) should remain 0 >
[2007/03/30 10:35:40.1310] [ INFO ] [TID: 002696] : Processed instance without finding a match for instance <ID00087492D05D8nFOQw8SSKBAawAA> for class <QA_Patch2_No_Ident_Multi_Match:Patch2_1Class_No_Ident_Multi_Match > in dataset
[2007/03/30 10:35:40.1310] [ ERROR ] [TID: 002696] : Cannot identify the instance of class <QA_Patch2_No_Ident_Multi_Match:Patch2_1Class_No_Ident_Multi_Match > with instance id <ID00087492D05D8nFOQw8SSKBAawAA> in dataset <Data Set 02>
[2007/03/30 10:35:40.1310] [ INFO ] [TID: 002696] : Cancelled the processing of rest of the sub-tree for instance of class = QA_Patch2_No_Ident_Multi_Match:Patch2_1Class_No_Ident_Multi_Match and instance id = ID00087492D05D8nFOQw8SSKBAawAA
[2007/03/30 10:35:40.6720] [DETAILS] [TID: 003720] : Finished waiting



In this example, the Identification Rule looks for a match based on the value of the Character_Field attribute. An error is generated for this job because the Reconciliation Engine finds multiple matches in the lookup dataset against which the CI is to be identified. As a result of the error, the Configuration Item (CI) in the source dataset is not identified and the Reconciliation ID remains 0.

Was this page helpful? Yes No Submitting... Thank you

Comments