---
title: ''
description: Telegraf plugin for collecting metrics from MarkLogic
url: https://docs.influxdata.com/telegraf/v1/input-plugins/marklogic/
estimated_tokens: 730
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/marklogic/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v1.12.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.1/plugins/inputs/marklogic/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.1/plugins/inputs/marklogic/sample.conf)

# MarkLogic Input Plugin

This plugin gathers health status metrics from one or more [MarkLogic](https://www.progress.com/marklogic)hosts.

**Introduced in:** Telegraf v1.12.0**Tags:** server**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Retrieves information on a specific host in a MarkLogic Cluster
[[inputs.marklogic]]
  ## Base URL of the MarkLogic HTTP Server.
  url = "http://localhost:8002"

  ## List of specific hostnames to retrieve information. At least (1) required.
  # hosts = ["hostname1", "hostname2"]

  ## Using HTTP Basic Authentication. Management API requires 'manage-user' role privileges
  # username = "myuser"
  # password = "mypassword"

  ## Optional TLS Config
  # tls_ca = "/etc/telegraf/ca.pem"
  # tls_cert = "/etc/telegraf/cert.pem"
  # tls_key = "/etc/telegraf/key.pem"
  ## Use TLS but skip chain & host verification
  # insecure_skip_verify = false
```

## Metrics

* marklogic
  * tags:
    * source (the hostname of the server address, ex. `ml1.local`)
    * id (the host node unique id ex. `2592913110757471141`)

  * fields:
    * online
    * total\_load
    * total\_rate
    * ncpus
    * ncores
    * total\_cpu\_stat\_user
    * total\_cpu\_stat\_system
    * total\_cpu\_stat\_idle
    * total\_cpu\_stat\_iowait
    * memory\_process\_size
    * memory\_process\_rss
    * memory\_system\_total
    * memory\_system\_free
    * memory\_process\_swap\_size
    * memory\_size
    * host\_size
    * log\_device\_space
    * data\_dir\_space
    * query\_read\_bytes
    * query\_read\_load
    * merge\_read\_bytes
    * merge\_write\_load
    * http\_server\_receive\_bytes
    * http\_server\_send\_bytes

## Example Output

```text
marklogic,host=localhost,id=2592913110757471141,source=ml1.local total_cpu_stat_iowait=0.0125649003311992,memory_process_swap_size=0i,host_size=380i,data_dir_space=28216i,query_read_load=0i,ncpus=1i,log_device_space=28216i,query_read_bytes=13947332i,merge_write_load=0i,http_server_receive_bytes=225893i,online=true,ncores=4i,total_cpu_stat_user=0.150778993964195,total_cpu_stat_system=0.598927974700928,total_cpu_stat_idle=99.2210006713867,memory_system_total=3947i,memory_system_free=2669i,memory_size=4096i,total_rate=14.7697010040283,http_server_send_bytes=0i,memory_process_size=903i,memory_process_rss=486i,merge_read_load=0i,total_load=0.00502600101754069 1566373000000000000
```