Question |
Answer |
Further reading |
How do I get help from MarkLogic Support? |
- MarkLogic Support services are for registered customer contacts with current license and maintenance entitlements
- It is VERY IMPORTANT to to register your support contacts before you need them. Creating accounts and verifying entitlements is not how you want to spend time in the event you need immediate assistance
- One registered, you can open a support case via the URLs, email addresses, and phone numbers listed in the "HOW TO CONTACT US" section of our linked Support Handbook
|
MARKLOGIC CUSTOMER SUPPORT HANDBOOK
|
What information should I pass along in my support case? |
For every support case, please send along:
- A summary of the problem
- Status only support dump of the affected cluster
- ErrorLog.txt files from all the nodes in the cluster
For issues centered on performance problems, please also send along:
- Monitoring History or Meters data
- If requested by MarkLogic Support, perf/pstack output
- If requested by MarkLogic Support, output from diagnostic trace events
Do note that MarkLogic's Telemetry feature, if enabled, will send much of this information in the background
|
KB Articles:
|
How do I generate a Support Dump? |
Via the Administration Interface (aka the "Admin Interface" or "Admin UI")
|
Creating a support request
|
Where are the MarkLogic Server Error logs? What log level setting should I use? |
- MarkLogic Server error logs are stored in the
Logs directory under the MarkLogic Server data directory for your platform. For example, on Linux, they're at /var/opt/MarkLogic/Logs/ErrorLog.txt
- It is good practice to run in production with the Debug file log level to get a more detailed record of operations.
|
Documentation
KB Articles:
|
How do I debug performance issues in MarkLogic? |
- Meters data should be provided for analysis of any performance related issue
- If the monitoring history suggests the issue is caused by an inefficient or incorrect query, output from the following calls can help to determine where the problem areas are within a given query:
|
Documentation
KB Articles:
|
When should I provide pstack or perf output? How do I generate pstack or perf output? |
pstack and perf allow a view of what individual threads are doing in a running MarkLogic Server process. MarkLogic Support will request pstack or perf output, if necessary
|
KB Articles:
|
When should I provide trace event output? How do I generate trace event output? |
Trace events are useful when more diagnostic information is needed than is typically available in the standard MarkLogic or Operating System log files
|
How to use diagnostic trace events
|
What is Telemetry? |
Telemetry, when enabled, collects, encrypts, packages, and sends diagnostic and system-level usage information about MarkLogic clusters so that the MarkLogic Support team has access - in advanced - to the typically requested collateral
|
Documentation:
KB Articles:
|
How do I upload files to MarkLogic Support? |
- You can attach any of these files to the Support ticket.
- Alternatively, you can also use our FTP server
|
How do you use the MarkLogic FTP server?
|