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

Query arguments:
 devid=<integer> Restrict the query to the given node.
job_id=<integer> Restrict the query to the given job ID.

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "additionalProperties": false, 
      "type": "object", 
      "properties": {
        "total": {
          "minimum": 0, 
          "type": "integer", 
          "description": "Total number of items available.", 
          "maximum": 4294967295
        }, 
        "jobs": {
          "minItems": 0, 
          "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", 
          "maxItems": 4294967295
        }
      }
    }
  ]
}
