KB-1946 General guide to providing Appian Support with logs when creating a support case

Kevin Kleinegger — Thu, 03 Nov 2022 19:50:31 GMT

Current Revision posted to Appian Knowledge Base by Kevin Kleinegger on 11/3/2022 7:50:31 PM

Purpose

Appian Support will request various logs depending on the reported issue. This article is a guide to which logs can be provided immediately to start off the troubleshooting process. Please note that this is a general guideline and is not all-encompassing. Appian Support may request additional logs at any point.

Instructions

Always Provide

Files/logs to provide (found in the <APPIAN_HOME> directory)
- /logs/tomcat-stdOut.log
- /conf/appian-topology.xml
- /conf/build.info

Engine Issues

Files/logs to provide (found in the <APPIAN_HOME> directory):
- /logs/db_* logs for the impacted engines
- /logs/service_manager.log
- Zip file of the /logs/service-manager directory
- /logs/perflogs/perf_monitor_db_*.csv
Logs generated from KB-1655
Other information to be provided
- Output of <APPIAN-HOME>/services/bin/status.sh (status.bat)
- Presence of recent *.l files
  - Note: These logs may contain sensitive data and Appian does not recommend supplying these files over a support case. Simply provide a screenshot of the *.l files that exist and Appian Support can review the actual file over a WebEx.
- Other environments running into the same issue
- System related issues (examples include: NFS/NAS/Network/Resource Contention etc.)

Search Server Issues

Files/logs to provide (found in the <APPIAN_HOME> directory)
- /logs/data-metrics/search_server_cluster.csv
- Zip file of the /logs/search-server directory
Other information to be provided
- Any changes, if any, performed on the server post which search-server encountered issues

Data Server Issues

Files/logs to provide (found in the <APPIAN_HOME> directory)
- Zip file of the /logs/data-server directory
Other Information to be provided
- Any changes, if any, performed on the server post which data server encountered issues
- Output of <APPIAN-HOME>/data-server/bin/health.sh (health.bat)

Tomcat Issues

Files/logs to provide (found in the <APPIAN_HOME> directory)
- /logs/tomcat-stdOut.log
- /logs/tomcat-access.log
Other information to be provided
- Any changes, if any, performed on the server post which application server encountered issues
- Timestamp when the issue was first encountered
- Health of the primary database
- Any issues encountered in any other lower region
- Health of other Appian components: engines, data-server and search-server

Performance Issues

Files/logs to provide (found in the <APPIAN_HOME> directory):
- Zip file of the /logs/perflogs/ directory from all servers hosting the environment
- /logs/data-metrics/system.csv from all servers hosting Tomcat instances
- tomcat access logs covering the period of the issue: /logs/tomcat-access.log.*
- tomcat-stdOut logs covering the period of the issue: /logs/tomcat-stdOut.log.*
- Note: If any of these directories or files are too large such that you cannot share them, please include only the latest files that cover the period of the issue.
Logs generated from KB-1655
Other information to be provided:
- Where specifically is slowness observed? Example: Records, Tempo, Sites, a particular application etc.
  - Screen recordings/screenshots would be helpful.
- Is this a Production, Testing, Staging, or Development Environment
- Timestamp when the performance degradation was first experienced in the environment
- Details around performance degradation:
  - Is it intermittent or does it persist throughout the day
  - Is the slowness experienced by all users, or a subset?
- When was the last application deployment made on the environment?

Note: For performance issues, provide these set of logs from the time the issue was observed and also from a time where the issue was not observed so that Appian Support has a baseline for comparison.

Design Issues

Files/logs to provide (found in the <APPIAN_HOME> directory):
- /logs/tomcat-stdOut.log
- /logs/tomcat-access.log
Other information to be provided
- Timestamp including time zone when the issue was first experienced
- Was this working previously, or is this a new feature?
- Information about any recent changes to the application?
- Is the issue consistently reproducible, or is it intermittent? If intermittent, when does it usually occur?
- Could you provide a timestamp, including time zone when the issue occurred
- Does this issue occur in any other environments?
- Any troubleshooting steps taken so far
- Screenshots that will help explain the issue

WebAPI/Integration Issues

Files/logs to provide (found in the <APPIAN_HOME> directory):
- /logs/tomcat-stdOut.log
- /logs/tomcat-access.log
Other information to be provided
- Was this working previously, or is it a new implementation?
- How is the connection established with Appian integration/WebAPI?
- Screenshots of the integration/WebAPI configuration
- Screenshots of the error encountered
- Is the issues encountered with a specific integration/WebAPI or is it impacting multiple integrations/WebAPIs?
- Is the encountered in all environments?
- Are you able to connect to the integration/WebAPI using third party clients like SoapUI or Postman?

Other Considerations

The Logging documentation can be reviewed for details about these log files as well as where they can be located.
Ensure the logs that are provided include the times when the issue was observed. The timestamps are logged in GMT.
If the environment in question is distributed or highly available, ensure that the logs from all relevant servers have been provided and the attachments are labeled by server name. For example, if the environment has three engine servers and the reported issue is engine related, provide the logs from all three engine servers like so: engine_server_1.zip, engine_server_2.zip, engine_server_3.zip.
This article does not apply to Appian Cloud environments.
Appian support may request additional logs, if required.

Affected Versions

This article applies to all versions of Appian self-managed.

Last Reviewed: November 2022

Tags: logging, administration, infrastructure

KB-1946 General guide to providing Appian Support with logs when creating a support case

Parmida Borhani — Thu, 30 May 2019 01:49:53 GMT

Revision 7 posted to Appian Knowledge Base by Parmida Borhani on 5/30/2019 1:49:53 AM

Purpose

Instructions

Always Provide

The application server log
appian-topology.xml
The build.info file

Engine Issues

Presence of recent *.l files
- Note: These logs may contain sensitive data and Appian does not recommend supplying these files over a support case. Simply provide a screenshot of the *.l files that exist and Appian Support can review the actual file over a WebEx.
db_*.log
perf_monitor_db_*.csv
Logs generated from KB-1655

Performance Issues

system.csv
ZIP of the <APPIAN_HOME>/logs/perflogs directory
Logs generated from KB-1655

Other Considerations

The Logging documentation can be reviewed for details about these log files as well as where they can be located.
Ensure the logs that are provided include the times when the issue was observed. The timestamps are logged in GMT.
If the environment in question is distributed or highly available, ensure that the logs from all relevant servers have been provided and the attachments are labeled by server name. For example, if the environment has three engine servers and the reported issue is engine related, provide the logs from all three engine servers like so: engine_server_1.zip, engine_server_2.zip, engine_server_3.zip.
This article does not apply to Appian Cloud environments.

Affected Versions

This article applies to all versions of Appian self-managed.

Last Reviewed: May 2019

Tags: logging, administration, infrastructure

DRAFT KB-XXXX General guide to providing Appian Support with logs when creating a support case

Parmida Borhani — Mon, 27 May 2019 01:12:31 GMT

Revision 6 posted to Appian Knowledge Base by Parmida Borhani on 5/27/2019 1:12:31 AM

Purpose

Instructions

Always Provide

The application server log
appian-topology.xml
The build.info file

Engine Issues

Presence of recent *.l files
- Note: These logs may contain sensitive data and Appian does not recommend supplying these files over a support case. Simply provide a screenshot of the *.l files that exist and Appian Support can review the actual file over a WebEx.
db_*.log
perf_monitor_db_*.csv
Logs generated from KB-1655

Performance Issues

system.csv
ZIP of the <APPIAN_HOME>/logs/perflogs directory
Logs generated from KB-1655

Other Considerations

The Logging documentation can be reviewed for details about these log files as well as where they can be located.
Ensure the logs that are provided include the times when the issue was observed. The timestamps are logged in GMT.
If the environment in question is distributed or highly available, ensure that the logs from all relevant servers have been provided and the attachments are labeled by server name. For example, if the environment has three engine servers and the reported issue is engine related, provide the logs from all three engine servers like so: engine_server_1.zip, engine_server_2.zip, engine_server_3.zip.
This article does not apply to Appian Cloud environments.

Affected Versions

This article applies to all versions of Appian on-premise.

Last Reviewed: May 2019

Tags: logging, administration, infrastructure

DRAFT KB-XXXX General guide to providing Appian Support with logs when creating a support case

Parmida Borhani — Mon, 27 May 2019 01:06:56 GMT

Revision 5 posted to Appian Knowledge Base by Parmida Borhani on 5/27/2019 1:06:56 AM

Purpose

Appian Support will request various logs depending on the reported issue. This article is a general guide to which logs can be provided immediately to assist with the troubleshooting process. Please note that this is a general guideline and is not all-encompassing. Appian Support may request additional logs at any point.

Instructions

Always Provide

The application server log
appian-topology.xml
The build.info file

Engine Issues

Presence of recent *.l files
- Note: These logs may contain sensitive data and Appian does not recommend supplying these files over a support case. Simply provide a screenshot of the *.l files that exist and Appian Support can review the actual file over a WebEx.
db_*.log
perf_monitor_db_*.csv
Logs generated from KB-1655

Performance Issues

system.csv
ZIP of the <APPIAN_HOME>/logs/perflogs directory
Logs generated from KB-1655

Other Considerations

The Logging documentation can be reviewed for details about these log files as well as where they can be located.
Ensure the logs that are provided include the times when the issue was observed. The timestamps are logged in GMT.
If the environment in question is distributed or highly available, ensure that the logs from all relevant servers have been provided and the attachments are labeled by server name. For example, if the environment has three engine servers and the reported issue is engine related, provide the logs from all three engine servers like so: engine_server_1.zip, engine_server_2.zip, engine_server_3.zip.
This article does not apply to Appian Cloud environments.

Affected Versions

This article applies to all versions of Appian on-premise.

Last Reviewed: May 2019

Tags: logging, administration, infrastructure

DRAFT KB-XXXX General guide to providing Appian Support with logs when creating a support case

Parmida Borhani — Mon, 27 May 2019 01:05:06 GMT

Revision 4 posted to Appian Knowledge Base by Parmida Borhani on 5/27/2019 1:05:06 AM

Purpose

Instructions

Always Provide

The application server log
appian-topology.xml
The build.info file

Engine Issues

Presence of recent *.l files
- Note: These logs may contain sensitive data and Appian does not recommend supplying these files over a support case. Simply provide a screenshot of the *.l files that exist and Appian Support can review the actual file over a WebEx.
db_*.log
perf_monitor_db_*.csv
Logs generated from KB-1655

Performance Issues

system.csv
ZIP of the <APPIAN_HOME>/logs/perflogs directory
Logs generated from KB-1655

Other Considerations

The Logging documentation can be reviewed for details about these log files as well as where they can be located.
Ensure the logs that are provided include the times when the issue was observed.The timestamps are logged in GMT.
If the environment in question is distributed or highly available, ensure that the logs from all relevant servers have been provided and the attachments are labeled by server name. For example, if the environment has three engine servers and the reported issue is engine related, provide the logs from all three engine servers like so: engine_server_1.zip, engine_server_2.zip, engine_server_3.zip.
This article does not apply to Appian Cloud environments.

Affected Versions

This article applies to all versions of Appian on-premise.

Last Reviewed: May 2019

Tags: logging, administration, infrastructure

DRAFT KB-XXXX General guide to providing Appian Support with logs when creating a support case

Parmida Borhani — Fri, 24 May 2019 01:01:19 GMT

Revision 3 posted to Appian Knowledge Base by Parmida Borhani on 5/24/2019 1:01:19 AM

Purpose

Instructions

Always Provide

The application server log
appian-topology.xml
The build.info file

Engine Issues

Presence of recent *.l files
- Note: These logs may contain sensitive data. If you do not wish to supply these logs over the case, simply provide a screenshot of the *.l files that exist and Appian Support can review the actual file over a WebEx.
db_*.log
perf_monitor_db_*.csv
Logs generated from KB-1655

Performance Issues

system.csv
ZIP of the <APPIAN_HOME>/logs/perflogs directory

Other Considerations

The Logging documentation can be reviewed for details about these log files as well as where they can be located.
If the environment in question is distributed or highly available, ensure that the logs from all relevant servers have been provided and the attachments are labeled by server name. For example, if the environment has three engine servers and the reported issue is engine related, provide the logs from all three engine servers like so: engine_server_1.zip, engine_server_2.zip, engine_server_3.zip.
This article does not apply to Appian Cloud environments.

Affected Versions

This article applies to all versions of Appian on-premise.

Last Reviewed: May 2019

Tags: logging, administration, infrastructure

DRAFT KB-XXXX General guide to providing Appian Support with logs when creating a support case

Parmida Borhani — Fri, 24 May 2019 00:50:24 GMT

Revision 2 posted to Appian Knowledge Base by Parmida Borhani on 5/24/2019 12:50:24 AM

Purpose

Instructions

Always Provide

The application server log
appian-topology.xml
The build.info file

Engine Issues

Presence of recent *.l files
- Note: These logs may contain sensitive data. If you do not wish to supply these logs over the case, simply provide a screenshot of the *.l files that exist and Appian Support can review the actual file over a WebEx.
db_*.log
perf_monitor_db_*.csv
Logs generated from KB-1655

Performance Issues

system.csv
ZIP of the <APPIAN_HOME>/logs/perflogs directory

Other Considerations

The Logging documentation can be reviewed for details about these log files as well as where they can be located.
If the environment in question is distributed or highly available, ensure that the logs from all relevant servers have been provided. For example, if the environment has three engine servers and the reported issue is engine related, provide the logs from all three engine servers.
This article does not apply to Appian Cloud environments.

Affected Versions

This article applies to all versions of Appian on-premise.

Last Reviewed: May 2019

Tags: logging, administration, infrastructure

DRAFT KB-XXXX General guide to providing Appian Support with logs when creating a support case

Parmida Borhani — Fri, 24 May 2019 00:44:41 GMT

Revision 1 posted to Appian Knowledge Base by Parmida Borhani on 5/24/2019 12:44:41 AM

Purpose

Instructions

Always Provide

The application server log
appian-topology.xml
The build.info file

Engine Issues

Presence of recent *.l files
- Note: These logs may contain sensitive data. If you do not wish to supply these logs over the case, simply provide a screenshot of the *.l files that exist and Appian Support can review the actual file over a WebEx.
service_manager.log
db_*.log
perf_monitor_db_*.csv
engine_call_summary.csv
engine_call_details.csv

Performance Issues

system.csv
perf_monitor_db_*.csv
plugin_functions_running_during_high_system_memory.csv
plugin_functions_slow.csv

Other Considerations

The Logging documentation can be reviewed for details about these log files as well as where they can be located.
If the environment in question is distributed or highly available, ensure that the logs from all relevant servers have been provided. For example, if the environment has three engine servers and the reported issue is engine related, provide the logs from all three engine servers.

Affected Versions

This article applies to all versions of Appian on-premise.

Last Reviewed: May 2019

Tags: logging, administration, infrastructure