Salesforce

Log Files (Magic xpi 4.13)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

Log Files (Magic xpi 4.13)

Information about errors that occurred during runtime is logged to several log files and in several locations.

Magic xpi uses the logback infrastructure for logging, and the logging configuration is set in the <Magic xpi installation>\Runtime\Java\classes\logback.xml file. The logs defined in the logback.xml file are written by default to the <Magic xpi installation>\Runtime\logs\java folder. .NET-based connectors use the <Magic xpi installation>\Runtime\Config\Log4net.config file.

To know more about the logging configuration in Magic xpi, click here.

Logs Folder

Created log file

Contains information about:

Where the log path is set or where the log file is enabled:

debugger_error.log

Debugger errors

log environment variable

ifs.log

Server activities

Server log location setting.

mgerror.log

Magic xpa component errors or when generating the Data Mapper

logs > magic.ini > [MAGIC_ENV]GeneralErrorLog entry*

migration_error.log

Migration process error. This is only created when there are errors.

logs > migration.ini > [MAGIC_ENV]GeneralErrorLog entry*

<project_name>_error.log

Errors from a specific project. These are Magic xpa errors produced by the project’s engine.

In each project's logs > ifs.ini file > [MAGIC_ENV]GeneralErrorLog entry*

mapper.log

Errors that occurred during runtime when Magic xpi executes a Data Mapper step that uses a database. It also gives partial information about the SQL statements sent to the database. Note that the gateway log shows the actual statement.

For more information, see How Do I Create a Gateway Log for the Magic xpi Server?

Activated from the Debugging Flags area of the Settings dialog box or by setting DebugMapper=Y in one of the .ini files.

Before you add the DebugMapper=Y flag to the Magic.ini file, make sure that it is not included in any of the other Magic xpi configuration files. If the flag is included in any of these configuration files, the flag will be overwritten and the file will not be created.

sfdc_logs folder

Shows the specific IDs created when working with the Salesforce connector's Replicate Last Update method.

MDCRM_Debug.log

Dynamics CRM

Activated from the Debugging Flags area of the Settings dialog box or by setting [MAGIC_IBOLT] DebugMDCRMComponent=Y in the ifs.ini file.

DynamicsAX_[PID].log

Dynamics AX 2012

The logs are configured according to the log4net.config file, which is located at <Magic xpi>/config.

Sharepoint_Debug.log

SharePoint

Activated from the Debugging Flags area of the Settings dialog box or by setting [MAGIC_IBOLT] DebugSharepointComponent=Y in the ifs.ini file.

Exchange_Debug.log

Exchange

Activated from the Debugging Flags area of the Settings dialog box or by setting [MAGIC_IBOLT] DebugExchangeComponent=Y in the ifs.ini file.

HL7Debug.log

HL7

Activated from the Debugging Flags area of the Settings dialog box or by setting [MAGIC_IBOLT] DebugHL7Component=Y in the ifs.ini file.

DynamicsCRM_studio_<<process id>>.log

Dynamics CRM

DCRM design time log file is generated under <Magic xpi installation>\Studio\Log folder.

DynamicsCRM_runtime_<<process id>>.log

Dynamics CRM

DCRM runtime log file is generated under <Magic xpi installation>\Runtime\Logs folder.

The configuration related to Log4net can be provided in Log4net.config file which is located under <Magic xpi installation>\Runtime\Config folder.

* Note that if you leave this entry blank, an error log file will not be created for that scenario. In addition, changes made to this entry are effective as of the next session.

Logs/Java Folder

PID in the following logs represents the process ID of the process that wrote the log.

Created log file

Contains information about:

Where the log path is set or where the log file is enabled:

general_[PID].log

Third-party programs

logback.xml

magicxpi_[PID].log

The space, including processing units and space services

logback.xml

magicxpi-external_[PID].log

Programs external to the space

logback.xml

stderror.log

Errors encountered while accessing Java classes

logback.xml

stdout.log

Provides output messages

logback.xml

mgxpicmdl.log

The command line, including problems encountered when the GSA tries to load the Magic xpi executable via the command line.

logback.xml

To enable logs for Java-based components, update the logback.xml by changing the level value from “off” to one of the other levels. See the Logging Level section below.

exceptions.log

The exceptions that occur in a project.

logback.xml

root.log

All log files inherit their settings from this file. It does not contain information particular to Magic xpi.

logback.xml

ftptrace_[PID].log

FTP and Directory Scanner FTP activity

logback.xml

enterprisedt_[PID].log

FTP connector infrastructure

logback.xml

ifc.scanner_[PID].log

Directory Scanner component

logback.xml

ifc.email_[PID].log

Email component

logback.xml

ifc.googlecalendar_[PID].log

Google Calendar connector

logback.xml

ifc. googledrive_[PID].log

Google Drive connector

logback.xml

ifc.google_[pid].log

Google connectors’ infrastructure

logback.xml

ifc.sapr3_[PID].log

SAP ERP connector

logback.xml or by setting DebugR3Component=Y in the ifs.ini file.

For more information, see How Do I Create Log Files for the SAP R/3 (JCO) Component?

ifc.sapR3Trigger_[PID].log

SAP ERP trigger connector

ifc.sugarcrm_[PID].log

Sugar connector

logback.xml

ifc.WEBSERVICECLIENT_[PID].log

Web Services Client connector

logback.xml

Note that there are additional log files that you can add in the logback.xml. Open up the file and search for the three <!-- other optional modules:--> tags.

GigaSpaces\Logs Folder

Created log file

Contains information about:

Where the log path is set or where the log file is enabled:

[Date~Time]-[GigaSpaces entity]-{computer name}-PID.log

For example: 2013-10-07~14.07-gigaspaces-lus_5-DEBBIES-7-4400.log

The GigaSpaces infrastructure.

The files without the {computer name} can be ignored.

Messaging Folder

Created log file

Contains information about:

Where the log path is set or where the log file is enabled:

MG_message_err.log

Messaging components

MessagingErrorLogFile environment variable

db\[database name] Folder

Created log file

Contains information about:

Where the log path is set or where the log file is enabled:

[database name].log

For example: mssql.log.

A specific database. This log file is defined when manually installing the database.

<Magic xpi root> Folder

Created log file

Contains information about:

Where the log path is set or where the log file is enabled:

*.trc

For example: JCO20121109_120458790.trc

SAP ERP and SAP A1 trace logs. You can add extended trace options using the Magic.ini file’s DebugTraceLevel= configuration flag.

Enabled from the SAP ERP resource's SAP Trace setting and from the SAP A1 resource's SAP Trace setting. By default this is set to No.

Logging Level

In the logback.xml file, you can change the value of the logging level in the <level value="xxx"/> tag to any of the following values:

  • all: Turns on all levels of logging.

  • trace: Provides further information in addition to the debug level.

  • debug: Helps the developer see what is going on in the project for debugging purposes.

  • info: Provides information about the progress of the project.

  • warn: Provides warnings about unexpected events.

  • error: Provides information about serious errors that may result in unstable behavior.

  • fatal: Provides information about severe error events, which will probably lead to the application aborting the log.

  • off: Turns off all levels of logging.

You can change the logging level during runtime. This is especially useful when deploying your projects.

It is recommended to turn off logging following completion of a debug session and before application deployment. Logging significantly slows down the execution of a program. However, for the logging of code related to GigaSpaces logs (general_[PID].log , magicxpi_[PID].log and magicxpi-external_[PID].log), the logging level can be changed in the logback.xml while running and does not require an application restart.

Additional Activity Logging Capabilities

In addition, the Magic xpi Studio contains several logging capabilities, such as:

  • Logging function: This function enables and disables the gateway log dynamically.

  • Logging properties in the components: This writes information to the Activity Log.

  • Activity Log: The Activity Log provides information about the execution flow.

Reference
Attachment 
Attachment