Difference Between Tomcat Logs and Performance Logs in Appian ?
Difference Between Tomcat Logs and Performance Logs in Appian ?
Answer
Tomcat logs are for troubleshooting application server errors. Performance logs are for monitoring performance, measuring execution times, and finding bottlenecks.
Tomcat logs | Performance logs | |
|---|---|---|
Purpose | Error diagnosis and troubleshooting | Performance monitoring and optimization |
Location |
|
|
Common format |
|
|
Captures | Server errors, exceptions, plug-in issues | Execution times, resource usage, performance metrics |
Use when | Something fails or throws a server error | Something is slow or uses too many resources |
Tomcat logs
The main file is tomcat-stdOut.log. It helps you investigate:
- Application server errors and their messages
- Java exceptions and stack traces
- Plug-in problems during deployment, initialization, or execution
- Startup errors, which depending on configuration may appear in Tomcat output or in separate application server logs
For example, suppose a process model uses a custom plug-in smart service and the node takes unusually long to finish. Appian may log a work-poller error saying it couldn’t get the execution threads it needed. tomcat-stdOut.log is where you’d confirm that.
Appian also writes tomcat-access.log, which records HTTP requests, response status codes, and request processing times.
Performance logs
These are in <APPIAN_HOME>/logs/perflogs/ and show which operations are slow and how Appian resources are being used.
Log type | What it tells you |
|---|---|
Engine performance | Engine activity, processing time, and resource use |
Process execution | Process models and instances that use a lot of engine processing time |
Data store performance | Database operations, split into Prepare, Execute, and Transform phases |
Interface performance | Interface loading, interactions, and evaluation times |
Expression performance | Expensive expression rules and functions |
Integration performance | Integration execution times, which exposes slow external calls |
If users report that an interface takes several seconds to load, check these files:
sail_details.csvfor slow interface evaluationsdata_store_details.csvfor slow data store operationsexpressions_details.csvfor expensive expression evaluations
Together they show whether the delay comes from interface evaluation, database access, or expression execution.
Performance logs have three levels of detail:
- Summary: aggregated metrics, typically recorded every five minutes
- Details: more granular metrics, typically written hourly
- Trace: event-level diagnostics, disabled by default for many log types
Tomcat logs are only one category of Appian system logs, so not every Appian error ends up in tomcat-stdOut.log.
Official reference: Appian Documentation — System Logs
Check yourself
Question 1 of 5, on what the answer above covers.
- 1.Focus on where you would investigate an application-server exception rather than a performance measurement.
- 2.An Appian record-backed interface is loading slowly. You suspect a database operation and want to analyze its Prepare, Execute, and Transform timings. Which log is most relevant?
- 3.An Appian production application is experiencing several issues. Which situations are appropriate reasons to investigate performance logs? (Select all that apply).
Select all that apply
- 4.In Appian, tomcat-access.log can provide HTTP request information, including response status codes and request processing times.
- 5.In Appian, administrators must enable Trace logging before they can access Summary or Details performance metrics.