Get security stats Generally available; Added in 9.2.0

GET /_security/stats
Api key auth Basic auth Bearer auth

Gather security usage statistics from all node(s) within the cluster.

Required authorization

  • Cluster privileges: monitor

Responses

  • 200 application/json
    Hide response attribute Show response attribute object
    • nodes object Required

      A map of node IDs to security statistics for that node.

      Hide nodes attribute Show nodes attribute object
      • * object Additional properties
        Hide * attribute Show * attribute object
        • roles object Required

          Role statistics.

          Hide roles attribute Show roles attribute object
          • dls object Required

            Document-level security (DLS) statistics.
GET /_security/stats 
curl \
 --request GET 'http://api.example.com/_security/stats' \
 --header "Authorization: $API_KEY"
Response examples (200)
A successful response from `GET /_security/stats`. 
{
  "nodes": {
    "CLeCBfYETO2mQ1R2Il5-SA": {
      "roles": {
        "dls": {
          "bit_set_cache": {
            "count": 1,
            "memory": "16b",
            "memory_in_bytes": 16,
            "hits": 212,
            "misses": 1,
            "evictions": 0,
            "hits_time_in_millis": 5,
            "misses_time_in_millis": 0
          }
        }
      }
    }
  }
}