KB-2334 How to find logs in an Appian on Kubernetes installation

pauline.delacruz — Wed, 19 Mar 2025 21:54:12 GMT

Current Revision posted to Appian Knowledge Base by pauline.delacruz on 3/19/2025 9:54:12 PM

Purpose

In certain troubleshooting scenarios, it may be necessary to gather specific logs and configuration files for Appian Support. This article will help users find where the requested information inside their Appian on Kubernetes install.

For any feedback or issue related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.
Replace <namespace>, <pod-name>, <your_appian>, etc. with actual values from your environment while running the commands.

Note: Copying logs from Kubernetes pods, especially large files, may temporarily cause fluctuation to node performance. To minimize impact, consider running log collection during low-traffic periods and monitoring node resource usage while transferring large files.

Important Logs for Each Component

General Configuration Files:

Note: The information equivalent to build.info, custom.properties, tomcatResources.xml, appian-topology.xml will all be included in the same command output. Only one copy of appian-cr.yaml needs to be uploaded to the support case.

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

Affected Versions

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

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:38:31 GMT

Revision 46 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:38:31 PM

Purpose

For any feedback or issue related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.
Replace <namespace>, <pod-name>, <your_appian>, etc. with actual values from your environment while running the commands.

Important Logs for Each Component

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

Affected Versions

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

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:37:59 GMT

Revision 45 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:37:59 PM

Purpose

For any feedback related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.
Replace <namespace>, <pod-name>, <your_appian>, etc. with actual values from your environment while running the commands.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

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

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:37:29 GMT

Revision 44 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:37:29 PM

Purpose

For any feedback related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.
Replace <namespace>, <pod-name>, <your_appian>, etc. with actual values from your environment while running the commands.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:36:47 GMT

Revision 43 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:36:47 PM

Purpose

For any feedback related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.
Replace <namespace>, <pod-name>, <your_appian>, etc. with actual values from your environment while running the commands.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:35:42 GMT

Revision 42 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:35:42 PM

Purpose

For any feedback related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.
Replace <namespace>, <pod-name>, <your_appian> , etc. with actual values from your environment while running the commands.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:28:48 GMT

Revision 41 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:28:48 PM

Purpose

For any feedback related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:27:49 GMT

Revision 40 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:27:49 PM

Purpose

For any feedback related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

Note: build.info, custom.properties, tomcatResources.xml, appian-topology.xml are all included in the same command output. Only one copy of appian-cr.yaml needs to be uploaded.

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:26:05 GMT

Revision 39 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:26:05 PM

Purpose

For any feedback related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

Note: build.info, custom.properties, tomcatResources.xml, appian-topology.xml are all included in the same command output. Only one copy of appian-cr.yaml needs to be uploaded.

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:24:41 GMT

Revision 38 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:24:41 PM

Purpose

For any feedback related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

Note: build.info, custom.properties, tomcatResources.xml, appian-topology.xml are all included in the same command output.

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: March 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 21:22:13 GMT

Revision 37 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 9:22:13 PM

Purpose

For any feedback related to the commands' utilization, please feel free to include in your support case.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.
The commands should be run from outside the pods. There is no need to exec into a certain pod in order to run the commands.
Copying logs from Kubernetes pods, especially large files, may temporarily cause fluctuation to node performance. To minimize impact, consider running log collection during low-traffic periods and monitoring node resource usage while transferring large files.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

Note: build.info, custom.properties, tomcatResources.xml, appian-topology.xml are all included in the same command output.

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 20:31:28 GMT

Revision 36 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 8:31:28 PM

Purpose

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

Note: build.info, custom.properties, tomcatResources.xml, appian-topology.xml are all included in the same command output.

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > appian-cr.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Yiyi Tao — Wed, 19 Mar 2025 20:02:38 GMT

Revision 35 posted to Appian Knowledge Base by Yiyi Tao on 3/19/2025 8:02:38 PM

Purpose

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Kaushal Patel — Mon, 24 Feb 2025 19:29:12 GMT

Revision 34 posted to Appian Knowledge Base by Kaushal Patel on 2/24/2025 7:29:12 PM

Purpose

In certain troubleshooting scenarios, it may be necessary to gather specific logs and files for Appian Support. This article will help users find where the requested information inside their Appian on Kubernetes install.

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <namespace> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <namespace> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <namespace> get secret
kubectl -n <namespace> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <namespace> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <namespace> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

pauline.delacruz — Tue, 11 Feb 2025 22:32:07 GMT

Revision 33 posted to Appian Knowledge Base by pauline.delacruz on 2/11/2025 10:32:07 PM

Purpose

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <name-space> get secret
kubectl -n <name-space> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <name-space> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

pauline.delacruz — Tue, 11 Feb 2025 22:30:38 GMT

Revision 32 posted to Appian Knowledge Base by pauline.delacruz on 2/11/2025 10:30:38 PM

Purpose

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

passwords.properties

Get the list of secrets in your Appian: kubectl -n <name-space> get secret
kubectl -n <name-space> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

appian-topology.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <name-space> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA:

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics:

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

pauline.delacruz — Tue, 11 Feb 2025 22:28:45 GMT

Revision 31 posted to Appian Knowledge Base by pauline.delacruz on 2/11/2025 10:28:45 PM

Purpose

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server logs

Application Server:

Tomcat logs

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/custom.properties

passwords.properties

Get the list of secrets in your Appian: kubectl -n <name-space> get secret
kubectl -n <name-space> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/tomcatResources.xml

appian-topology.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <name-space> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server:

Tomcat Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA

RPA Logs

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics

Performance Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Logs

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

pauline.delacruz — Tue, 11 Feb 2025 22:06:11 GMT

Revision 30 posted to Appian Knowledge Base by pauline.delacruz on 2/11/2025 10:06:11 PM

Purpose

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Data Server Health
ADS logs

Search Server:

Status of Search Server
Search Server Logs

Application Server:

tomcat-stdOut.log
tomcat-access.log

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/custom.properties

passwords.properties

Get the list of secrets in your Appian: kubectl -n <name-space> get secret
kubectl -n <name-space> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/tomcatResources.xml

appian-topology.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <name-space> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Service (ADS):

Health

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server:

Health

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Logs

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server

Tomcat StdOut Log & Tomcat Access Log:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA

RPA Logs:

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics

Performance Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Log:

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

If there are any issues with pulling the requested logs, please reach out to Appian Support.

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

Kaushal Patel — Tue, 11 Feb 2025 19:17:12 GMT

Revision 29 posted to Appian Knowledge Base by Kaushal Patel on 2/11/2025 7:17:12 PM

Purpose

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Status of Data Server
ADS logs

Search Server:

Status of Search Server
Search Server log

Application Server:

tomcat-stdOut.log
tomcat-access.log

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info:

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/

custom.properties:

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/custom.properties

passwords.properties

Get the list of secrets in your Appian: kubectl -n <name-space> get secret
kubectl -n <name-space> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/tomcatResources.xml

appian-topology.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <name-space> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs:

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs:

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs:

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs:

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Server (ADS)

Health & Status:

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs:

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server

Health & Status:

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Log:

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server

Tomcat StdOut Log & Tomcat Access Log:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA

RPA Logs:

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics

Performance Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Log:

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

pauline.delacruz — Tue, 11 Feb 2025 19:11:20 GMT

Revision 28 posted to Appian Knowledge Base by pauline.delacruz on 2/11/2025 7:11:20 PM

Purpose

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Status of Data Server
ADS logs

Search Server:

Status of Search Server
Search Server log

Application Server:

tomcat-stdOut.log
tomcat-access.log

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info:

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in any pod’s /usr/local/appian/ae/conf/

custom.properties:

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in any pod’s /usr/local/appian/ae/conf/custom.properties

passwords.properties

Get the list of secrets in your Appian: kubectl -n <name-space> get secret
kubectl -n <name-space> get secret passwords-properties -o yaml > passwords-properties.yaml

tomcatResources.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/tomcatResources.xml

appian-topology.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in any pod’s /usr/local/appian/ae/conf/appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Health & Status

kubectl -n <name-space> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs:

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs:

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs:

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs:

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Server (ADS)

Health & Status:

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs:

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server

Health & Status:

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Log:

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server

Tomcat StdOut Log & Tomcat Access Log:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA

RPA Logs:

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics

Performance Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Log:

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes

[DRAFT SUPP-879] KB-XXXX How to find logs in Appian on Kubernetes installation

pauline.delacruz — Tue, 11 Feb 2025 17:54:34 GMT

Revision 27 posted to Appian Knowledge Base by pauline.delacruz on 2/11/2025 5:54:34 PM

Purpose

Instructions

Based on the requested files, please ensure the following:

The user is able to access the worker nodes.

Important Logs for Each Component

General Configuration Files:

build.info
custom.properties
passwords.properties
tomcatResources.xml
appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Status of Service Manager, engines and messaging services
Service Manager logs
Engine logs
Kafka logs
Zookeeper logs

Appian Data Server (ADS):

Status of Data Server
ADS logs

Search Server:

Status of Search Server
Search Server log

Application Server:

tomcat-stdOut.log
tomcat-access.log

RPA:

RPA logs

Performance Metrics:

Performance logs
Data Metrics logs
long-running-work-items.log

General Configuration Files:

build.info:

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Can also be a physical file in any pod’s /usr/local/appian/ae/conf/

custom.properties:

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in any pod’s /usr/local/appian/ae/conf/custom.properties

passwords.properties

Get the list of secrets in your Appian: kubectl -n <name-space> get secret
kubectl -n <name-space> get secret passwords-properties -o yaml > passwords-properties.yam

tomcatResources.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in webapp pod’s /usr/local/appian/ae/conf/tomcatResources.xml

appian-topology.xml

kubectl -n <name-space> get appian <your_appian> -o yaml > operator.yaml
Physical file in any pod’s /usr/local/appian/ae/conf/appian-topology.xml

Engines, Service Manager, Kafka and Zookeeper:

Health & Status:

kubectl -n <name-space> exec -it <any-engine-pod-name> -- /bin/bash -c "/usr/local/appian/ae/serviceManagerScriptWrapper.sh services/bin/status.sh -c" > service_manager_health.txt

Service Manager Logs:

kubectl -n <namespace> get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; kubectl -n <namespace> cp $pod_name:/usr/local/appian/ae/logs/service_manager.log ./$pod_name.log; done && tar -cf service_manager-$(date +%Y%m%d).tar *service-manager*.log && rm -r *service-manager*.log

Engine Logs:

kubectl -n my-appian-site get pods -o name | grep 'service-manager' | while read pod; do pod_name=${pod#pod/}; echo $pod_name; latest_db_log=$(kubectl -n my-appian-site exec "$pod_name" -- bash -c "ls -t /usr/local/appian/ae/logs/db_*.log 2>/dev/null | head -n1"); echo $latest_db_log; kubectl -n my-appian-site cp "$pod_name":/"$latest_db_log" ./logs/"$pod_name"_"$latest_log".log; done && tar -cf engine_logs-$(date +%Y%m%d).tar logs/ && rm -r logs/

Kafka Logs:

kubectl -n <namespace> exec -it <kafka-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf kafka.tar kafka/logs"
kubectl -n <namespace> cp <kafka-pod-name>:/usr/local/appian/ae/kafka.tar ./kafka-$(date +"%Y%m%d").tar

Zookeeper Logs:

kubectl -n <namespace> exec -it <zookeeper-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && tar -cvf zookeeper.tar zookeeper/logs"
kubectl -n <namespace> cp <zookeeper-pod-name>:/usr/local/appian/ae/zookeeper.tar ./zookeeper-$(date +"%Y%m%d").tar

Appian Data Server (ADS)

Health & Status:

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "/usr/local/appian/ae/data-server/bin/health.sh" > data-server-health.txt

ADS Logs:

kubectl -n <namespace> exec -it <data-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-server -type f -mtime -3 | tar -cf data-server.tar --files-from=-"
kubectl -n <namespace> cp <data-server-pod-name>:/usr/local/appian/ae/logs/data-server.tar data-server-$(date +"%Y%m%d").tar

Search Server

Health & Status:

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "curl localhost:9200/_cluster/health?pretty" > search-server-health.txt

Search Server Log:

kubectl -n <namespace> exec -it <search-server-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find search-server -type f -mtime -3 | tar -cf search-server.tar --files-from=-"
kubectl -n <namespace> cp <search-server-pod-name>:/usr/local/appian/ae/logs/search-server.tar search-server-$(date +"%Y%m%d").tar

Application Server

Tomcat StdOut Log & Tomcat Access Log:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae && find logs/ -type f -name 'tomcat*' -mtime -3 | tar --transform='s|^logs/|tomcat-logs/|' -cf webapp.tar --files-from=-"

RPA

RPA Logs:

kubectl -n <namespace> exec -it <rpa-pod-name> -- bash -c 'log_dir="/data/tomcat8/logs";catalina_log=$(ls -t $log_dir | grep "catalina" | head -1);localhost_log=$(ls -t $log_dir | grep "localhost\.[0-9]" | head -1);localhost_access=$(ls -t $log_dir | grep "localhost_access_log" | head -1);tar -cvf /tmp/rpa_logs.tar $log_dir/jidoka.log $log_dir/rtdo.log $log_dir/rpdo.log $log_dir/robotRDO.log $log_dir/$catalina_log $log_dir/$localhost_log $log_dir/$localhost_access'
kubectl -n <namespace> cp <rpa-pod-name>:/tmp/rpa_logs.tar rpa-$(date +"%Y%m%d").tar

Performance Metrics

Performance Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find perflogs -type f -mtime -1 | tar -cf perflogs.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/perflogs.tar perflogs$(date +"%Y%m%d").tar

Data Metrics Logs:

kubectl -n <namespace> exec -it <webapp-pod-name> -- /bin/bash -c "cd /usr/local/appian/ae/logs && find data-metrics-type f -mtime -1 | tar -cf data-metrics.tar --files-from=-"
kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/data-metrics.tar data-metrics-$(date +"%Y%m%d").tar

Long Running Work Items Log:

kubectl -n <namespace> cp <webapp-pod-name>:/usr/local/appian/ae/long-running-work-items.log long-running-work-items-$(date +"%Y%m%d").log

Affected Versions

This article applies to all versions of Appian on Kubernetes

Last Reviewed: February 2025

Tags: how-to, infrastructure, Kubernetes