Resource URL: /platform/<<version=1>>/job/statistics

    Overview: This resource represents statistics gathered about jobs and
              workers across the cluster.

     Methods: GET

********************************************************************************

Method GET: View job engine statistics.

       URL: GET /platform/<<version=1>>/job/statistics

There are no query arguments for this method.

GET response body schema:
{
  "type": "object", 
  "properties": {
    "total": {
      "type": "integer", 
      "description": "Total number of items available."
    }, 
    "jobs": {
      "items": {
        "type": "object", 
        "properties": {
          "phase": {
            "required": true, 
            "type": "integer", 
            "description": "The current phase of the job."
          }, 
          "nodes": {
            "items": {
              "type": "object", 
              "properties": {
                "node": {
                  "required": true, 
                  "type": "integer", 
                  "description": "The devid of the node."
                }, 
                "workers": {
                  "items": {
                    "type": "object", 
                    "properties": {
                      "stw": {
                        "type": "number", 
                        "description": "The sleep-to-work ratio of this worker; how much time it spends sleeping compared to working."
                      }, 
                      "worker": {
                        "required": true, 
                        "type": "integer", 
                        "description": "The worker ID."
                      }, 
                      "task_result": {
                        "type": "string", 
                        "description": "A representation of the most recent task result produced by the worker; not intended to be read by humans."
                      }, 
                      "task": {
                        "type": "string", 
                        "description": "A representation of the task the worker is currently processing; not intended to be read by humans."
                      }
                    }
                  }, 
                  "required": true, 
                  "type": "array"
                }, 
                "pid": {
                  "required": true, 
                  "type": "integer", 
                  "description": "The process ID of the job on this node."
                }, 
                "total_workers": {
                  "required": true, 
                  "type": "integer", 
                  "description": "The number of workers for this job on this node."
                }, 
                "io": {
                  "required": true, 
                  "type": "object", 
                  "properties": {
                    "read": {
                      "required": true, 
                      "type": "object", 
                      "properties": {
                        "bytes": {
                          "required": true, 
                          "type": "integer", 
                          "description": "The number of bytes recently read by this job on this node."
                        }, 
                        "ops": {
                          "required": true, 
                          "type": "integer", 
                          "description": "The number of read operations recently performed by this job on this node."
                        }
                      }
                    }, 
                    "write": {
                      "required": true, 
                      "type": "object", 
                      "properties": {
                        "bytes": {
                          "required": true, 
                          "type": "integer", 
                          "description": "The number of bytes recently written by this job on this node."
                        }, 
                        "ops": {
                          "required": true, 
                          "type": "integer", 
                          "description": "The number of write operations recently performed by this job on this node."
                        }
                      }
                    }
                  }
                }, 
                "memory": {
                  "required": true, 
                  "type": "object", 
                  "properties": {
                    "virtual": {
                      "required": true, 
                      "type": "object", 
                      "properties": {
                        "current": {
                          "required": true, 
                          "type": "number", 
                          "description": "The current virtual memory utilization of the job on this node, in KB."
                        }, 
                        "average": {
                          "type": "number", 
                          "description": "The average virtual memory utilization of the job on this node, in KB."
                        }, 
                        "minimum": {
                          "required": true, 
                          "type": "number", 
                          "description": "The minimum virtual memory utilization of the job on this node, in KB."
                        }, 
                        "maximum": {
                          "required": true, 
                          "type": "number", 
                          "description": "The maximum virtual memory utilization of the job on this node, in KB."
                        }
                      }
                    }, 
                    "physical": {
                      "required": true, 
                      "type": "object", 
                      "properties": {
                        "current": {
                          "required": true, 
                          "type": "number", 
                          "description": "The current physical memory utilization of the job on this node, in KB."
                        }, 
                        "average": {
                          "type": "number", 
                          "description": "The average physical memory utilization of the job on this node, in KB."
                        }, 
                        "minimum": {
                          "required": true, 
                          "type": "number", 
                          "description": "The minimum physical memory utilization of the job on this node, in KB."
                        }, 
                        "maximum": {
                          "required": true, 
                          "type": "number", 
                          "description": "The maximum physical memory utilization of the job on this node, in KB."
                        }
                      }
                    }
                  }
                }, 
                "cpu": {
                  "required": true, 
                  "type": "object", 
                  "properties": {
                    "current": {
                      "required": true, 
                      "type": "number", 
                      "description": "The current CPU utilization of the job on this node."
                    }, 
                    "average": {
                      "type": "number", 
                      "description": "The average CPU utilization of the job on this node."
                    }, 
                    "minimum": {
                      "required": true, 
                      "type": "number", 
                      "description": "The minimum CPU utilization of the job on this node."
                    }, 
                    "maximum": {
                      "required": true, 
                      "type": "number", 
                      "description": "The maximum CPU utilization of the job on this node."
                    }
                  }
                }
              }
            }, 
            "required": true, 
            "type": "array"
          }, 
          "job_id": {
            "required": true, 
            "type": "integer", 
            "description": "The job ID."
          }, 
          "total_nodes": {
            "required": true, 
            "type": "integer", 
            "description": "The number of nodes participating in the job."
          }
        }
      }, 
      "type": "array"
    }
  }
}
