Ranger RAZ Metrics API

One Ranger RAZ API returns a response in JSON format. The other Ranger RAZ API returns a response in prometheus compatible format. Neither API that fetches Ranger RAZ metrics requires authentication as it does not provide any sensitive information. Both APIs return the same value. You can reduce (or increase) the metrics collection interval using the hadoop-metrics2.properties file.

You can access two APIs that fetch Ranger RAZ metrics.

JSON compatible API:

accessible at a url with format:



Prometheus compatible API:

accessible at a url with format:




The response is grouped into raz & Ranger JVM categories. Since both APIs return the same value, only json responses are discussed in this document.

This group of metrics gives all metrics related to RAZ application.

Sample json response follows:

  "Raz": {
       "RequestPoolCount": 1600,
        "RequestPoolCountBUSY": 882,
       "SpoolDirSizeSOLR": 0,
       "SpoolDirSizeHDFS": 67123185,
       "AuthzTime": 109873,
       "AuthzCount": 190,
       "AuthzALLOWED": 100,
       "AuthzDENIED": 80,
       "AuthzNOTDETERMINED": 10,
Table 1. Raz Metrics Descriptions
Metric Description
RequestPoolCount Count of threads available in tomcat pool.
RequestPoolCountBUSY Count of threads busy in tomcat pool.
SpoolDirSizeSOLR Current size of solr spool directory.
SpoolDirSizeHDFS Current size of HDFS spool directory.
AuthzTime Total time taken to process all requests.
AuthzCount Count of requests overall.
AuthzALLOWED Count of requests allowed.
AuthzDENIED Count of requests denied.
AuthzNOTDETERMINED Count of requests with status not determined.
Ranger JVM:

This metrics group represents the JVM metrics needed to get internal state of admin.

Sample json response follows:

"RangerJvm": {
        "GcTimeTotal": 5315,
        "SystemLoadAvg": 3.91,
        "ThreadsBusy": 2250,
        "GcCountTotal": 472,
        "MemoryMax": 1066401792,
        "MemoryCurrent": 179763416,
        "ThreadsWaiting": 2248,
        "ProcessorsAvailable": 4,
        "GcTimeMax": 5002,
        "ThreadsBlocked": 25,
        "ThreadsRemaining": 4
Table 2. Ranger RAZ JVM Metrics Decriptions
Metric Description
GcTimeTotal Total time taken by JVM Garbage Collector.
GcTimeMax Maximum time taken by a single JVM Garbage Collection process.
GcCountTotal Number of times JVM Garbage Collector runs.
SystemLoadAvg Average load on the host on which the service is running.
ThreadsBusy Total JVM threads which are busy.
ThreadsWaiting Total JVM threads which are waiting.
ThreadsBlocked Total JVM threads which are blocked.
ThreadsRemaining Total remaining (not busy/ waiting/ blocked) JVM threads.
MemoryMax Maximum memory (RAM) JVM can get from the host.
MemoryCurrent Currently occupied memory (RAM) by JVM.
ProcessorsAvailable Currently available processor cores on host.