Loading TOC...

GET /manage/v2/servers?view=xdmp:server-status

Summary

This resource address returns more status information for the App Servers in the cluster including active/long running query details.

URL Parameters
format The format of the returned data. Can be either html, json, or xml (default). This value overrides the Accept header if both are present.
group-id Specifies to return only the servers in the specified group. The group can be identified either by id or name.
Request Headers
Accept The expected MIME type of the response. If the format parameter is present, it takes precedence over the Accept header.
Response Headers
Content-type The MIME type of the data in the response body. Depending upon the value of the format parameter or Accept header, one of application/xml, application/json, or text/html.

Response

Upon success, MarkLogic Server returns status code 200 (OK). The response body contains the requested data.

Required Privileges

This operation requires the manage-user role, or the following privilege:

http://marklogic.com/xdmp/privileges/manage

Usage Notes

The structure of the output returned from this REST API is as follows:

server-id

The server id.

server-name

The server name.

host-id

The unique key of the host

error

The error in processing server status.

server-kind

The kind of application server

enabled

The server is enabled.

port

The server socket bind internet port number.

root

The root document directory pathname.

modules

The ID of the database that contains application modules. If on the file-system, then 0.

database

The ID of the content database when applicable. In some cases, this is a forest ID or a random number (when neither a database ID nor a forest ID is available).

ssl-certificate-template

The certificate template.

last-login

The ID of the last login database.

display-last-login

Whether an appserver should display last-login information.

address

The server socket bind numeric internet address.

backlog

The socket listen backlog.

threads

The current number of active applicatiton server threads.

max-threads

The maximum number of application server threads allowed on each host in the group.

request-timeout

The request socket recv timeout, in seconds.

keep-alive-timeout

The keep-alive socket recv timeout, in seconds.

session-timeout

The session expiration timeout, in seconds.

static-expires

The static content expiration interval, in seconds.

max-time-limit

The upper bound for a request's time limit, in seconds.

default-time-limit

The default time limit for a request, in seconds.

max-inference-size

The upper bound for a request's inference size, in megabytes.

default-inference-size

The default inference size for a request, in megabytes.

collation

The default collation for queries.

multi-version-concurrency-control

distribute-timestamps

authentication

The authentication scheme to use for this server

default-user

The user used as the default user in application level authentication. Using the admin user as the default user is equivalent to turning security off.

privilege

The privilege restricting access to the server.

concurrent-request-limit

The concurrent request limit.

default-xquery-version

An application server's default XQuery language version.

current-time

The current time.

request-statuses

The requests being processed by the server.

This is a complex structure with the following children:

request-status

The request being processed by the server.

This is a complex structure with the following children:

request-id

A unique id for a request.

server-id

The server id.

host-id

The unique key of the host

transaction-id

The unique key of the transaction

canceled

Has this request been canceled.

modules

The ID of the database that contains application modules. If on the file-system, then 0.

database

The ID of the content database when applicable. In some cases, this is a forest ID or a random number (when neither a database ID nor a forest ID is available).

root

The root document directory pathname.

request-kind

The kind of request (for example, invoke, eval).

request-text

The request text.

request-rewritten-text

The rewritten request text.

update

Specifies if this request an update (true for update requests).

start-time

The time the operation started.

time-limit

The request's time limit, in seconds.

max-time-limit

The upper bound for a request's time limit, in seconds.

lock-count

The request's current limit on combined count for the number of times a read or a write lock was acquired.

read-size

The request's current limit on combined size read from disk (listSize+compressedTreeSize), in bytes.

user

The unique ID of the user executing the request.

client-address

The network address of a client

trigger-depth

The maximum depth of trigger invocation.

expanded-tree-cache-hits

The number of hits on the expanded cache.

expanded-tree-cache-misses

The number of misses on the expanded cache.

request-state

The state of a request

profiling-allowed

Is profiling allowed for this request.

profiling-enabled

Is profiling currently enabled for this request.

debugging-allowed

Is debugging allowed for this request.

debugging-status

The debugging status of the request.

retry-count

The number of retries on the request.

expr-id

The expression id.

where-stopped

Where the request is stopped.

request-rate

The rate of a request (requests/sec).

queue-size

The number of tasks in the server queue.

queue-limit

The maximum number size of the queue.

expanded-tree-cache-hits

The number of hits on the expanded cache.

expanded-tree-cache-misses

The number of misses on the expanded cache.

expanded-tree-cache-hit-rate

The average number of hits on the expanded cache.

expanded-tree-cache-miss-rate

The average number of misses on the expanded cache.

fs-program-cache-hits

The number of hits on the filesystem program cache.

fs-program-cache-misses

The number of misses on the filesystem program cache.

db-program-cache-hits

The number of hits on the database program cache.

db-program-cache-misses

The number of misses on the database program cache.

env-program-cache-hits

The number of hits on the XSLT environment program cache.

env-program-cache-misses

The number of misses on the XSLT environment program cache.

fs-main-module-seq-cache-hits

The number of hits on the filesystem main module sequence cache.

fs-main-module-seq-cache-misses

The number of misses on the filesystem main module sequence cache.

db-main-module-seq-cache-hits

The number of hits on the database main module sequence cache.

db-main-module-seq-cache-misses

The number of misses on the database main module sequence cache.

fs-lib-module-cache-hits

The number of hits on the filesystem library module cache.

fs-lib-module-cache-misses

The number of misses on the filesystem library module cache.

db-lib-module-cache-hits

The number of hits on the database library module cache.

db-lib-module-cache-misses

The number of misses on the database library module cache.

fs-schema-cache-hits

The number of hits on the filesystem schema cache.

fs-schema-cache-misses

The number of misses on the filesystem schema cache.

db-schema-cache-hits

The number of hits on the database schema cache.

db-schema-cache-misses

The number of misses on the database schema cache.

env-schema-cache-hits

The number of hits on the environment schema cache.

env-schema-cache-misses

The number of misses on the environment schema cache.

temporary-file-read-bytes

The total number of bytes read from temporary files for example for external sort and join.

temporary-file-write-bytes

The total number of bytes written to temporary files for example for external sort and join.

hosts

The host's view of all other hosts in the cluster.

This is a complex structure with the following children:

host

The host connection information.

This is a complex structure with the following children:

host-name

The internet host name.

round-trip-count

The total of round-trip communications between the App Server host and this host. A round trip is the completion of a request sent from the App Server host to another host in the cluster.

round-trip-time

The total time (as xs:dayTimeDuration) to complete the round trips from the App Server to this host.

round-trip-rate

The moving average data throughput of sending a request and receiving result in a round trip, in megabytes per second.

round-trip-load

Time threads spent in sending a request and receiving results in round-trips, in proportion to the elapsed time.

output-sgml-character-entities

The character entities to use during output.

output-encoding

The output encoding of the App Server.

default-error-format

The default error format for protocol errors. One of html,xml,json,compatiable

error-handler

The error handler used, if any.

url-rewriter

The url rewriter used, if any.

request-time

1 minute average of request time for this server.

server-receive-bytes

The number of bytes received over the network.

server-receive-time

The time (as xs:dayTimeDuration) to receive over the network.

server-receive-rate

The moving average of incoming network throughput, in megabytes per second.

server-receive-load

Network time threads spent receiving data, in proportion to the elapsed time.

server-send-bytes

The number of bytes sent over the network.

server-send-time

The time (as xs:dayTimeDuration) to send over the network.

server-send-rate

The moving average of outgoing network throughput, in megabytes per second.

server-send-load

Network time threads spent sending data, in proportion to the elapsed time.

Example


  http://localhost:8002/manage/v2/servers?view=xdmp:server-status&group-id=Default

  ==>  Returns status information for the servers in the cluster. 
    

Stack Overflow iconStack Overflow: Get the most useful answers to questions from the MarkLogic community, or ask your own question.