jcustomer performance unomi Jahia 8

How can I export support information about Unomi/jCustomer JVM, like thread dumps, heap dumps, bundles states and others?

Question

I have performance issues in my jExperience/jCustomer/Elasticsearch stack, and I suspect the responsible for the performance decay is jCustomer.

Do we have a way to export all relevant support information at once?

Answer

Yes, you can export relevant support information about your Unomi application using karaf console. To connect to karaf console one can use SSH:

#Note: In a default installation the password=karaf

#Command
ssh -p <KARAF_CONSOLE_PORT> <KARAF_USER>@<UNOMI_SERVER>

#Example
ssh -p 8102 karaf@localhost

Then you can run the command dev:dump-create like in the example below:

karaf@root()> dev:dump-create
Created dump zip: 2021-06-22_141609.zip

The zip file will be created under jCustomer installation directory, and it will contain a lot of useful information:

File Description
bundles.txt List containing all installed bundles and its respective states
environment.txt All environment variables and relevant information
features.txt

List of installed features in Unomi

heapdump.hprof JVM heap dump
log Folder containing jCustomer logs
memory.txt Heap and Non-Heap memory allocation information
threads.txt JVM thread dump