KB-1575 How to enable loggers for commonly seen Appian issues

Wasil Akhtar — Tue, 07 Jan 2025 11:17:29 GMT

Current Revision posted to Appian Knowledge Base by Wasil Akhtar on 1/7/2025 11:17:29 AM

Purpose

In certain troubleshooting scenarios, it may be necessary to enable DEBUG logging to retrieve additional information related to the issue observed. This article details how to enable DEBUG logging for some of the most commonly seen issues in Appian. The DEBUG statements will be logged to the application server log, unless configured otherwise.

Instructions

Warning: Enabling the DEBUG logs in an environment can lead to large log files and introduce potential performance degradation. Appian Technical Support advises to enable loggers on lower environments before doing so on production.

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
OpenID Connect User Authentication
OAuth 2.0 Token Request Sequence
Application Import/Export
Appian Health Check
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues
Plugin Deployment
XSD Validation for record types
HTTP Connected System Request Executions
Connected Environments DevOps
Connected Environments (Retrieval of Public Keys)
Compare and Deploy Inspection requests
Salesforce Connected Systems
Webserver logging
Quick Apps
Deployments stuck in progress
Record Sync Incidents

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG
log4j.logger.org.opensaml.core.xml.util=TRACE

OpenID Connect User Authentication:

log4j.logger.com.appiancorp.security.auth.oidc=DEBUG

OAuth 2.0 Token Request Sequence:

log4j.logger.com.appiancorp.connectedsystems.http.oauth.HttpOAuthTokenRetriever=DEBUG
log4j.logger.com.appiancorp.connectedsystems.contracts.HttpOAuthTokenService=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.strategies=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.oauth=DEBUG
log4j.logger.com.appiancorp.oauth.inbound=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Health Check:

Note: Only applicable when using the Health Check Plugin. These loggers do not apply when Health Check is configured through the Admin Console.

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.healthcheck=DEBUG, HEALTH_CHECK

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Plugin Deployment:

log4j.logger.com.appiancorp.process.admin=DEBUG

XSD Validation:

Note: This is used when record type validation fails or when deploying a plugin which constructs a CDT.

log4j.logger.com.appiancorp.type.config.xsd=DEBUG

HTTP Connected Systems Request Execution:

Note: This is to check the request contents, how it was received, if response was received or timed out, etc.

log4j.logger.com.appiancorp.connectedsystems.http=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.AppianHttpRequestExecutor=DEBUG

Connected Environments DevOps:

log4j.logger.com.appiancorp.connectedenvironments.logging.DevOpsInfrastructureHandlerAuditLogger=DEBUG
log4j.logger.com.appiancorp.designobjectdiffs.functions.application.DodConnEnvCallSystemRuleHandler=DEBUG

Connected Environment (Retrieval of Public Keys):

log4j.logger.com.appiancorp.connectedenvironments.ConnectedEnvironmentPublicKeyRetriever=DEBUG
log4j.logger.com.appiancorp.connectedenvironments.service.ConnectedEnvironmentsInitialRequestor=DEBUG
log4j.logger.com.appiancorp.connectedenvironments.service.JwtUtils=DEBUG
log4j.logger.com.appiancorp.connectedenvironments.KeyUtils=DEBUG

Compare & Deploy (Inspection phase): Compare

log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvAsyncInspectHandler=DEBUG
log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvInspectHandler=DEBUG

Salesforce connected Systems (returns error stacktrace returned by Salesforce):

log4j.logger.com.appiancorp.connectedsystems.salesforce=DEBUG

Webserver (returns data transferred to and from the servers when executing HTTP requests): Quick Apps:

**these loggers are verbose, switch loggers to ERROR first before removing them from appian_log4j.properties file

log4j.logger.org.apache.http=DEBUG
log4j.logger.org.apache.http.wire=DEBUG

Quick Apps:

log4j.logger.com.appiancorp..object.quickapps.QuickAppObjectType=TRACE

Deployment Stuck in Progress:

log4j.logger.com.appian.kafka.KafkaTopicManager=DEBUG

Record Sync Incidents:

log4j.logger.com.appiancorp..record.data.recordloaders.ads.AdsReplicaTransaction=DEBUG
log4j.logger.com.appiancorp.record.fn.RefreshReplicaForRecordTypeReaction=DEBUG
log4j.logger.com.appiancorp.record.service.RecordReplicaUpdateService=DEBUG
log4j.logger.com.appiancorp.record.service.quartz.ReplicaLoadJob=DEBUG
log4j.logger.com.appiancorp.record.replicaupdate.LogRyowVsBulk=DEBUG
log4j.logger.com.appiancorp.record.service.ReplicaSyncPollerImpl=DEBUG
log4j.logger.com.appiancorp.record.service.quartz.scheduling.ScheduleManagerImpl=DEBUG
log4j.logger.com.appiancorp.record.service.quartz.LoggingTriggerListener=DEBUG

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: December 2024

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Maggie Deppe-Walker — Wed, 08 May 2024 00:11:04 GMT

Revision 45 posted to Appian Knowledge Base by Maggie Deppe-Walker on 5/8/2024 12:11:04 AM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
OpenID Connect User Authentication
OAuth 2.0 Token Request Sequence
Application Import/Export
Appian Health Check
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues
Plugin Deployment
XSD Validation for record types
HTTP Connected System Request Executions
Connected Environments
Compare and Deploy Inspection requests
Salesforce Connected Systems
Webserver logging

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG
log4j.logger.org.opensaml.core.xml.util=TRACE

OpenID Connect User Authentication:

log4j.logger.com.appiancorp.security.auth.oidc=DEBUG

OAuth 2.0 Token Request Sequence:

log4j.logger.com.appiancorp.connectedsystems.http.oauth.HttpOAuthTokenRetriever=DEBUG
log4j.logger.com.appiancorp.connectedsystems.contracts.HttpOAuthTokenService=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.strategies=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.oauth=DEBUG
log4j.logger.com.appiancorp.oauth.inbound=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Health Check:

Note: Only applicable when using the Health Check Plugin. These loggers do not apply when Health Check is configured through the Admin Console.

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.healthcheck=DEBUG, HEALTH_CHECK

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Plugin Deployment:

log4j.logger.com.appiancorp.process.admin=DEBUG

XSD Validation:

Note: This is used when record type validation fails or when deploying a plugin which constructs a CDT.

log4j.logger.com.appiancorp.type.config.xsd=DEBUG

HTTP Connected Systems Request Execution:

Note: This is to check the request contents, how it was received, if response was received or timed out, etc.

log4j.logger.com.appiancorp.connectedsystems.http=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.AppianHttpRequestExecutor=DEBUG

Connected Environments DevOps:

log4j.logger.com.appiancorp.connectedenvironments.logging.DevOpsInfrastructureHandlerAuditLogger=DEBUG
log4j.logger.com.appiancorp.designobjectdiffs.functions.application.DodConnEnvCallSystemRuleHandler=DEBUG

Compare & Deploy (Inspection phase): Compare

log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvAsyncInspectHandler=DEBUG
log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvInspectHandler=DEBUG

Salesforce connected Systems (returns error stacktrace returned by Salesforce):

log4j.logger.com.appiancorp.connectedsystems.salesforce=DEBUG

Webserver (returns data transferred to and from the servers when executing HTTP requests):

**these loggers are verbose, switch loggers to ERROR first before removing them from appian_log4j.properties file

log4j.logger.org.apache.http=DEBUG
log4j.logger.org.apache.http.wire=DEBUG

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2024

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

pauline.delacruz — Mon, 15 Apr 2024 21:38:07 GMT

Revision 44 posted to Appian Knowledge Base by pauline.delacruz on 4/15/2024 9:38:07 PM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG
log4j.logger.org.opensaml.core.xml.util=TRACE

OpenID Connect User Authentication:

log4j.logger.com.appiancorp.security.auth.oidc=DEBUG

OAuth 2.0 Token Request Sequence:

log4j.logger.com.appiancorp.connectedsystems.http.oauth.HttpOAuthTokenRetriever=DEBUG
log4j.logger.com.appiancorp.connectedsystems.contracts.HttpOAuthTokenService=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.strategies=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.oauth=DEBUG
log4j.logger.com.appiancorp.oauth.inbound=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Health Check:

Note: Only applicable when using the Health Check Plugin. These loggers do not apply when Health Check is configured through the Admin Console.

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.healthcheck=DEBUG, HEALTH_CHECK

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Plugin Deployment:

log4j.logger.com.appiancorp.process.admin=DEBUG

XSD Validation:

Note: This is used when record type validation fails or when deploying a plugin which constructs a CDT.

log4j.logger.com.appiancorp.type.config.xsd=DEBUG

HTTP Connected Systems Request Execution:

Note: This is to check the request contents, how it was received, if response was received or timed out, etc.

log4j.logger.com.appiancorp.connectedsystems.http=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.AppianHttpRequestExecutor=DEBUG

Connected Environments DevOps:

log4j.logger.com.appiancorp.connectedenvironments.logging.DevOpsInfrastructureHandlerAuditLogger=DEBUG
log4j.logger.com.appiancorp.designobjectdiffs.functions.application.DodConnEnvCallSystemRuleHandler=DEBUG

Compare & Deploy (Inspection phase): Compare

log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvAsyncInspectHandler=DEBUG
log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvInspectHandler=DEBUG

Salesforce connected Systems (returns error stacktrace returned by Salesforce):

log4j.logger.com.appiancorp.connectedsystems.salesforce=DEBUG

Webserver (returns data transferred to and from the servers when executing HTTP requests):

**these loggers are verbose, switch loggers to ERROR first before removing them from appian_log4j.properties file

log4j.logger.org.apache.http=DEBUG
log4j.logger.org.apache.http.wire=DEBUG

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2024

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

pauline.delacruz — Mon, 15 Apr 2024 21:36:38 GMT

Revision 43 posted to Appian Knowledge Base by pauline.delacruz on 4/15/2024 9:36:38 PM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG
log4j.logger.org.opensaml.core.xml.util=TRACE

OpenID Connect User Authentication:

log4j.logger.com.appiancorp.security.auth.oidc=DEBUG

OAuth 2.0 Token Request Sequence:

log4j.logger.com.appiancorp.connectedsystems.http.oauth.HttpOAuthTokenRetriever=DEBUG
log4j.logger.com.appiancorp.connectedsystems.contracts.HttpOAuthTokenService=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.strategies=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.oauth=DEBUG
log4j.logger.com.appiancorp.oauth.inbound=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Health Check:

Note: Only applicable when using the Health Check Plugin. These loggers do not apply when Health Check is configured through the Admin Console.

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.healthcheck=DEBUG, HEALTH_CHECK

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Plugin Deployment:

log4j.logger.com.appiancorp.process.admin=DEBUG

XSD Validation:

Note: This is used when record type validation fails or when deploying a plugin which constructs a CDT.

log4j.logger.com.appiancorp.type.config.xsd=DEBUG

HTTP Connected Systems Request Execution:

Note: This is to check the request contents, how it was received, if response was received or timed out, etc.

log4j.logger.com.appiancorp.connectedsystems.http=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.AppianHttpRequestExecutor=DEBUG

Connected Environments DevOps:

log4j.logger.com.appiancorp.connectedenvironments.logging.DevOpsInfrastructureHandlerAuditLogger=DEBUG
log4j.logger.com.appiancorp.designobjectdiffs.functions.application.DodConnEnvCallSystemRuleHandler=DEBUG

Compare & Deploy (Inspection phase): Compare

log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvAsyncInspectHandler=DEBUG
log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvInspectHandler=DEBUG

Salesforce connected Systems (returns error stacktrace returned by Salesforce):

log4j.logger.com.appiancorp.connectedsystems.salesforce=DEBUG

Webserver (returns data transferred to and from the servers when executing HTTP requests):

**these loggers are verbose, switch loggers to ERROR first before removing them from appian_log4j.properties file

log4j.logger.org.apache.http=DEBUG
log4j.logger.org.apache.http.wire=DEBUG

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: February 2024

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

pauline.delacruz — Mon, 15 Apr 2024 21:33:11 GMT

Revision 42 posted to Appian Knowledge Base by pauline.delacruz on 4/15/2024 9:33:11 PM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG
log4j.logger.org.opensaml.core.xml.util=TRACE

OpenID Connect User Authentication:

log4j.logger.com.appiancorp.security.auth.oidc=DEBUG

OAuth 2.0 Token Request Sequence:

log4j.logger.com.appiancorp.connectedsystems.http.oauth.HttpOAuthTokenRetriever=DEBUG
log4j.logger.com.appiancorp.connectedsystems.contracts.HttpOAuthTokenService=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.strategies=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.oauth=DEBUG
log4j.logger.com.appiancorp.oauth.inbound=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Health Check:

Note: Only applicable when using the Health Check Plugin. These loggers do not apply when Health Check is configured through the Admin Console.

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.healthcheck=DEBUG, HEALTH_CHECK

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Plugin Deployment:

log4j.logger.com.appiancorp.process.admin=DEBUG

XSD Validation:

Note: This is used when record type validation fails or when deploying a plugin which constructs a CDT.

log4j.logger.com.appiancorp.type.config.xsd=DEBUG

HTTP Connected Systems Request Execution:

Note: This is to check the request contents, how it was received, if response was received or timed out, etc.

log4j.logger.com.appiancorp.connectedsystems.http=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.AppianHttpRequestExecutor=DEBUG

Connected Environments DevOps:

log4j.logger.com.appiancorp.connectedenvironments.logging.DevOpsInfrastructureHandlerAuditLogger=DEBUG
log4j.logger.com.appiancorp.designobjectdiffs.functions.application.DodConnEnvCallSystemRuleHandler=DEBUG

Compare & Deploy (Inspection phase): Compare

log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvAsyncInspectHandler=DEBUG
log4j.logger.com.appiancorp.designdeployments.handler.DplConnEnvInspectHandler=DEBUG

Salesforce connected Systems (returns error stacktrace returned by Salesforce):

log4j.logger.com.appiancorp.connectedsystems.salesforce=DEBUG

Webserver (returns data transferred to and from the servers when executing HTTP requests):

**these loggers are verbose, switch loggers to ERROR first before removing them from appian_log4j.properties file

log4j.logger.org.apache.http=DEBUG
log4j.logger.org.apache.http.wire=DEBUG

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: February 2024

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Maggie Deppe-Walker — Mon, 25 Sep 2023 07:01:12 GMT

Revision 41 posted to Appian Knowledge Base by Maggie Deppe-Walker on 9/25/2023 7:01:12 AM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
OpenID Connect User Authentication
OAuth 2.0 Token Request Sequence
Application Import/Export
Appian Health Check
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

OpenID Connect User Authentication:

log4j.logger.com.appiancorp.security.auth.oidc=DEBUG

OAuth 2.0 Token Request Sequence:

log4j.logger.com.appiancorp.connectedsystems.http.oauth.HttpOAuthTokenRetriever=DEBUG
log4j.logger.com.appiancorp.connectedsystems.contracts.HttpOAuthTokenService=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.execution.strategies=DEBUG
log4j.logger.com.appiancorp.connectedsystems.http.oauth=DEBUG
log4j.logger.com.appiancorp.oauth.inbound=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Health Check:

Note: Only applicable when using the Health Check Plugin. These loggers do not apply when Health Check is configured through the Admin Console.

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: June 2023

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Parmida Borhani — Thu, 21 Nov 2019 04:19:30 GMT

Revision 40 posted to Appian Knowledge Base by Parmida Borhani on 11/21/2019 4:19:30 AM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Health Check
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Health Check:

Note: Only applicable when using the Health Check Plugin. These loggers do not apply when Health Check is configured through the Admin Console.

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: November 2019

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Parmida Borhani — Thu, 21 Nov 2019 04:18:09 GMT

Revision 39 posted to Appian Knowledge Base by Parmida Borhani on 11/21/2019 4:18:09 AM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Health Check
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Health Check:

Note: Only when using the Health Check Plugin. These loggers do not apply when Health Check is configured through the Admin Console.

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: November 2019

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Rebecca Jonas — Tue, 19 Nov 2019 20:19:59 GMT

Revision 38 posted to Appian Knowledge Base by Rebecca Jonas on 11/19/2019 8:19:59 PM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: October 2019

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Parmida Borhani — Thu, 31 Oct 2019 00:08:51 GMT

Revision 37 posted to Appian Knowledge Base by Parmida Borhani on 10/31/2019 12:08:51 AM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the application server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: October 2019

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Parmida Borhani — Tue, 11 Dec 2018 00:59:55 GMT

Revision 36 posted to Appian Knowledge Base by Parmida Borhani on 12/11/2018 12:59:55 AM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Open the appian_log4j.properties file. For Appian 18.3 and later, this file can be found in <APPIAN_HOME>/deployment/web.war/WEB-INF/resources. For Appian 18.2 and earlier, this file can be found in <APPIAN_HOME>/ear/suite.ear/resources.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: December 2018

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Parmida Borhani — Wed, 22 Aug 2018 01:32:44 GMT

Revision 35 posted to Appian Knowledge Base by Parmida Borhani on 8/22/2018 1:32:44 AM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: August 2018

Tags: logging, administration, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Parmida Borhani — Wed, 22 Aug 2018 01:32:14 GMT

Revision 34 posted to Appian Knowledge Base by Parmida Borhani on 8/22/2018 1:32:14 AM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS
Workpoller Issues

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Workpoller Issues:

log4j.logger.com.appiancorp.ra.workpoller=DEBUG, WORK_POLLER

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: August 2018

Tags: logging, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Parmida Borhani — Sun, 06 May 2018 21:28:09 GMT

Revision 33 posted to Appian Knowledge Base by Parmida Borhani on 5/6/2018 9:28:09 PM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2018

Tags: logging, application server, how-to

KB-1575 How to enable loggers for commonly seen Appian issues

Nick Vigilante — Thu, 03 May 2018 17:53:34 GMT

Revision 32 posted to Appian Knowledge Base by Nick Vigilante on 5/3/2018 5:53:34 PM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2018

Tags: logging, application server, how-to

INT-1575 How to enable loggers for commonly seen Appian issues

Parmida Borhani — Thu, 03 May 2018 01:22:16 GMT

Revision 31 posted to Appian Knowledge Base by Parmida Borhani on 5/3/2018 1:22:16 AM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2018

Tags: logging, application server

DRAFT INT-XXXX How to enable DEBUG logs for some commonly seen Appian issues

Parmida Borhani — Wed, 02 May 2018 21:20:38 GMT

Revision 30 posted to Appian Knowledge Base by Parmida Borhani on 5/2/2018 9:20:38 PM

Purpose

Instructions

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2018

Tags: application server, jboss, debug

DRAFT INT-XXXX How to enable DEBUG logs for some commonly seen Appian issues

Tejas Kargutkar — Wed, 02 May 2018 16:13:48 GMT

Revision 29 posted to Appian Knowledge Base by Tejas Kargutkar on 5/2/2018 4:13:48 PM

Purpose

In certain troubleshooting scenarios, it may be necessary to enable DEBUG logging to retrieve additional information related to the issue observed. This article details how to enable DEBUG logging for some of the most commonly seen issues in Appian. The DEBUG statements will be logged to the JBoss or WebLogic server logs.

Instructions

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2018

Tags: application server, jboss, debug

DRAFT INT-XXXX How to enable DEBUG logs for some commonly seen Appian issues

Tejas Kargutkar — Wed, 02 May 2018 16:10:12 GMT

Revision 28 posted to Appian Knowledge Base by Tejas Kargutkar on 5/2/2018 4:10:12 PM

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2018

Tags: application server, jboss, debug

DRAFT INT-XXXX How to enable DEBUG logs for some commonly seen Appian issues

Tejas Kargutkar — Wed, 02 May 2018 16:06:32 GMT

Revision 27 posted to Appian Knowledge Base by Tejas Kargutkar on 5/2/2018 4:06:32 PM

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2018

Tags: application server, jboss, debug

DRAFT INT-XXXX How to enable DEBUG logs for some commonly seen Appian issues

Tejas Kargutkar — Wed, 02 May 2018 16:06:16 GMT

Revision 26 posted to Appian Knowledge Base by Tejas Kargutkar on 5/2/2018 4:06:16 PM

The steps to enable DEBUG logging are as follows:

Navigate to <APPIAN_HOME>/ear/suite.ear/resources and open the appian_log4j.properties file.
Find and uncomment the lines which apply to the particular issue you are trying to troubleshoot.
Set the value of the line to DEBUG.
Save and exit out of the file.

The steps to disable DEBUG logging are as follows:

Return to the appian_log4j.properties file, and update the lines you modified so that the value is changed from DEBUG back to ERROR.
Save the file and check the JBoss or WebLogic server log to verify that the DEBUG and TRACE log entries are no longer being recorded.

When adding any of these loggers, check if they already exist in appian_log4j.properties, if they do, edit the existing line, otherwise add the lines to the appian_log4j.properties.

Loggers:

Appian Authentication, SAML, LDAP
Application Import/Export
Appian Healthcheck
CDT Import/Export
Start Processes via Email
Process Models Exposed as Web Service
Process to Process Messaging
Query Timeouts
Query RDBMS Node Execution
Capture SQL Statements using Hibernate Trace Logs
SAIL Pink Box Errors
Send Emails via the Send Email Smart Service
Call Web Service Smart Service
Importing Web Service CDTs
Background activity in Appian Engines
Details on CDT Transformation
High Transformation Time When Processing the Results Received from the RDBMS

Appian Authentication, SAML, LDAP:

log4j.logger.com.appiancorp.security=DEBUG
log4j.logger.org.springframework.security=DEBUG

Application Import/Export:

log4j.logger.com.appiancorp.ix=DEBUG

Appian Healthcheck:

log4j.logger.com.appiancorp.plugins.labs.BulkLogDownloadServlet=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG
log4j.logger.com.appiancorp.tools.labs.analysis.util.LabsFileFilter=DEBUG

CDT Import/Export:

log4j.logger.com.appiancorp.type.external.teneoimpl.TeneoAnnotationsValidator=DEBUG
log4j.logger.com.appiancorp.type.external.teneoimpl.AppianHbSessionDataStore=DEBUG

Starting Processes by E-mail (email polling):

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG 
log4j.logger.com.appiancorp.mdb=DEBUG

Process Models Exposed as Web Services:

log4j.logger.com.appiancorp.process.webservices.pmserver=DEBUG

Process to Process Messaging:

log4j.logger.com.appiancorp.messaging.MessagePublisherServiceImpl=DEBUG 
log4j.logger.com.appiancorp.process.execution.service.ProcessExecutionServiceFacade=DEBUG

Query Timeouts:

log4j.logger.org.hibernate.util.JDBCExceptionReporter=DEBUG

Query RDBMS Execution and Validation:

log4j.logger.com.appiancorp.process.runtime.activities.QueryRdbmsActivity=DEBUG
log4j.logger.com.appiancorp.process.runtime.activities.JdbcActivity=DEBUG

Capture SQL Statements:

log4j.logger.org.hibernate.SQL=DEBUG
log4j.logger.org.hibernate.type=TRACE

SAIL (unmask pink pop-up errors):

log4j.logger.com.appiancorp.rest.shared.AppianExceptionMapper=DEBUG
log4j.logger.com.appiancorp.core.expr.tree.Variable=DEBUG
log4j.logger.com.appiancorp.core.expr.Parse=DEBUG

Sending Emails with Send Email Smart Service:

log4j.logger.com.appiancorp.process.runtime.activities.SendEmailActivity=DEBUG
log4j.logger.com.appiancorp.ap2.mail=DEBUG

Call Web Service Smart Service:

log4j.logger.com.appiancorp.ws=DEBUG
log4j.logger.org.apache.axis2=DEBUG
log4j.logger.httpclient.wire.header=TRACE
log4j.logger.org.apache.commons.httpclient=TRACE

Importing Web Service CDTs:

log4j.logger.com.appiancorp.type.config.xsd.SchemaFactory=DEBUG

Background activity in Appian Engines:

log4j.logger.com.appiancorp.process.background.EngineWorkSpringContextListener=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerFactory=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkControllerRunnable=DEBUG
log4j.logger.com.appiancorp.process.background.EngineWorkController=DEBUG

Details on CDT Transformation:

log4j.logger.com.appiancorp.type.xmlconversion=DEBUG 
log4j.logger.com.appiancorp.suiteapi.common.TypeConverter=DEBUG 
log4j.logger.com.appiancorp.core.data.converter=DEBUG

High Transformation Time When Processing the Results Received from the RDBMS:

log4j.logger.com.appian.perflogs.ecore-tv-conversion-trace=INFO, ECORE_TV_CONVERSION_PERF_TRACE
log4j.additivity.com.appian.perflogs.ecore-tv-conversion-trace=false
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE=com.appiancorp.common.logging.AppianFileAppender
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.layout=com.appiancorp.type.data.ecore.EcoreToTvConversionPerfLogger$TraceLayout
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.File=${AE_LOGS}/perflogs/perf_ecore_tv_conversion_trace.csv
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxFileSize=10MB
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.MaxBackupIndex=1000
log4j.appender.ECORE_TV_CONVERSION_PERF_TRACE.encoding=UTF-8

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: April 2018

Tags: application server, jboss, debug