---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from MarkLogic
url: https://docs.influxdata.com/telegraf/v1/input-plugins/marklogic/
estimated_tokens: 1244
product: Telegraf
version: v1
---

-   Telegraf v1.12.0+

# 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
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [MarkLogic Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/marklogic/README.md)