Get machine learning memory usage info Added in 8.2.0

GET /_ml/memory/_stats

Get information about how machine learning jobs and trained models are using memory, on each node, both within the JVM heap, and natively, outside of the JVM.

Query parameters

  • master_timeout string

    Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.

    Values are -1 or 0.

  • timeout string

    Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.

    Values are -1 or 0.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • _nodes object Required
      Hide _nodes attributes Show _nodes attributes object
      • failures array[object]
        Hide failures attributes Show failures attributes object
        • type string Required

          The type of error

        • reason string | null

          A human-readable explanation of the error, in English.

        • stack_trace string

          The server stack trace. Present only if the error_trace=true parameter was sent with the request.

        • caused_by object
        • root_cause array[object]
        • suppressed array[object]
      • total number Required

        Total number of nodes selected by the request.

      • successful number Required

        Number of nodes that responded successfully to the request.

      • failed number Required

        Number of nodes that rejected the request or failed to respond. If this value is not 0, a reason for the rejection or failure is included in the response.

    • cluster_name string Required
    • nodes object Required
      Hide nodes attribute Show nodes attribute object
      • * object Additional properties
        Hide * attributes Show * attributes object
        • attributes object Required
          Hide attributes attribute Show attributes attribute object
          • * string Additional properties
        • jvm object Required
          Hide jvm attributes Show jvm attributes object
          • heap_max number | string

          • heap_max_in_bytes number Required

            Maximum amount of memory, in bytes, available for use by the heap.

          • java_inference number | string

          • java_inference_in_bytes number Required

            Amount of Java heap, in bytes, currently being used for caching inference models.

          • java_inference_max number | string

          • java_inference_max_in_bytes number Required

            Maximum amount of Java heap, in bytes, to be used for caching inference models.

        • mem object Required
          Hide mem attributes Show mem attributes object
          • adjusted_total number | string

          • adjusted_total_in_bytes number Required

            If the amount of physical memory has been overridden using the es.total_memory_bytes system property then this reports the overridden value in bytes. Otherwise it reports the same value as total_in_bytes.

          • total number | string

          • total_in_bytes number Required

            Total amount of physical memory in bytes.

          • ml object Required
            Hide ml attributes Show ml attributes object
            • anomaly_detectors number | string

            • anomaly_detectors_in_bytes number Required

              Amount of native memory, in bytes, set aside for anomaly detection jobs.

            • data_frame_analytics number | string

            • data_frame_analytics_in_bytes number Required

              Amount of native memory, in bytes, set aside for data frame analytics jobs.

            • max number | string

            • max_in_bytes number Required

              Maximum amount of native memory (separate to the JVM heap), in bytes, that may be used by machine learning native processes.

            • native_code_overhead number | string

            • native_code_overhead_in_bytes number Required

              Amount of native memory, in bytes, set aside for loading machine learning native code shared libraries.

            • native_inference number | string

            • native_inference_in_bytes number Required

              Amount of native memory, in bytes, set aside for trained models that have a PyTorch model_type.

        • name string Required
        • roles array[string] Required

          Roles assigned to the node.

        • transport_address string Required
        • ephemeral_id string Required
GET /_ml/memory/_stats
curl \
 --request GET 'http://api.example.com/_ml/memory/_stats' \
 --header "Authorization: $API_KEY"