MarkLogic DHS

MarkLogic Data Hub Service (DHS) provides the fastest and most cost-effective way for enterprises to integrate, store, harmonize, analyze, and secure mission-critical data in the cloud. Because it is a managed service, not all of the monitoring options are available in DHS as are available using MarkLogic Server with the Data Hub Framework.

Differences running on AWS and Azure

The management ports differ depending on which cloud provider you are using to host DHS. DHS on AWS uses port 8002 for the managment endpoint. DHS on Azure uses port 8003 for the management endpoint.

Dashboard and History

The Monitoring Dashboard, and Monitoring History can also be accessed on the management port.

The Monitoring Dashboard provides task-based views of MarkLogic Server performance metrics in real time

• https://[DHS Address]:[port]/dashboard/

Monitoring History feature allows you to view critical performance data collected from your cluster

• https://[DHS Address]:[port]/history/

Database Status

Return status information for the named database:

• https://[DHS Address]:[port]/manage/v2/databases/data-hub-FINAL?view=status
• https://[DHS Address]:[port]/manage/v2/databases/data-hub-STAGING?view=status

Database Metrics

Retrieve historical monitoring data about the databases in the cluster

• https://[DHS Address]:[port]/manage/v2/databases?view=metrics

Retrieve historical monitoring data about the named databases:

• https://[DHS Address]:[port]/manage/v2/databases?view=metrics&database=data-hub-FINAL
• https://[DHS Address]:[port]/manage/v2/databases?view=metrics&database=data-hub-STAGING

Server Logs

Available Log Files

List the logs available on the server

• https://[DHS Address]:[port]/manage/v2/logs

Retrieving, Filtering, and Formatting Logs

The Log files can be retrieved with text, json, or xml formatting. The files can be retrieved in whole, or they can be filtered using any combination of:

• Start time (start)
• End time (end)
• Regular expression/s (regex)

Retrieve data-hub-STAGING app server error log with text, json, or xml formatting

• https://[DHS Address]:[port]/manage/v2/logs?filename=8010_ErrorLog.txt&format=[text|json|text]

Retrieve Server ErrorLog entries for a specific time range with xml formatting

• https://[DHS Address]:[port]manage/v2/logs?filename=ErrorLog.txt&format=text&start=2020-12-09T10:37:00.168Z&end=2020-12-09T15:13:00.206Z

Retrieve Server ErrorLog looking for the patterns SVC or XDMP. Regex or condition, |, is URL encoded (%7C) between the two patterns.

• https://[DHS Address]:[port]manage/v2/logs?filename=ErrorLog.txt&format=text&regex=SVC%7CXDMP