Knowledgebase:
MarkLogic Fundamentals FAQ - How to work with MarkLogic Support
17 December 2021 04:52 PM
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")

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?

(7 vote(s))
Helpful
Not helpful

Comments (0)