All Products
Search
Document Center

E-MapReduce:GetDoctorComputeSummary

Last Updated:Oct 17, 2024

Obtains the information about resource usage in a cluster on E-MapReduce (EMR) Doctor.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID.

cn-hangzhou
ClusterIdstringYes

The cluster ID.

c-b933c5aac8fe****
DateTimestringYes

Specify the date in the ISO 8601 standard. For example, 2023-01-01 represents January 1, 2023.

2023-01-01
ComponentInfoobjectNo

The resource information, which is used to filter the results.

ComponentTypestringNo

The resource type for filtering. Valid values:

  • engine: filters results by engine.
  • queue: filters results by queue.
  • cluster: displays the results at the cluster level.

If you do not specify this parameter, the information at the cluster level is displayed by default.

engine
ComponentNamestringNo

Set the filter condition name based on the value of ComponentType. For example, if you set ComponentType to queue, you can specify a specific queue name to obtain the resource usage of a specific queue.

MAPREDUCE

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

Dataobject

The details of resource usage.

Metricsobject

The metrics.

VcoreSecondsobject

The total CPU consumption over time in seconds.

Namestring

The name of the metric.

vcoreSeconds
Valuelong

The value of the metric.

1231412
Unitstring

The unit of the metric.

VCores * Sec
Descriptionstring

The description of the metric.

Total vcore usage over time in seconds
MemSecondsobject

The total memory consumption over time in seconds.

Namestring

The name of the metric.

memSeconds
Valuelong

The value of the metric.

12312312
Unitstring

The unit of the metric.

MB * Sec
Descriptionstring

The description of the metric.

Total memory usage over time in seconds
VcoreUtilizationobject

The average CPU utilization. The meaning is the same as the %CPU parameter in the output of the top command in Linux.

Namestring

The name of the metric.

vcoreUtilization
Valuefloat

The value of the metric.

32.1
Unitstring

The unit of the metric.

“”
Descriptionstring

The description of the metric.

Ratio of used vcore to total available cores
MemUtilizationobject

The average memory usage.

Namestring

The name of the metric.

memUtilization
Valuefloat

The value of the metric.

0.82
Unitstring

The unit of the metric.

""
Descriptionstring

The description of the metric.

Ratio of used memory to total available memory
VcoreSecondsDayGrowthRatioobject

The day-to-day growth rate of the total CPU consumption over time in seconds.

Namestring

The name of the metric.

vcoreSecondsDayGrowthRatio
Valuefloat

The value of the metric.

0.22
Unitstring

The unit of the metric.

“”
Descriptionstring

The description of the metric.

Growth ratio of virtual core usage in seconds per day
MemSecondsDayGrowthRatioobject

The day-to-day growth rate of the total memory consumption over time in seconds.

Namestring

The name of the metric.

memSecondsDayGrowthRatio
Valuefloat

The value of the metric.

0.36
Unitstring

The unit of the metric.

“”
Descriptionstring

The description of the metric.

Growth ratio of memory usage in seconds per day
ReadSizeobject

The total amount of data read from the file system.

Namestring

The name of the metric.

readSize
Valuelong

The value of the metric.

504888659968
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Total cumulative size of data read in megabytes (MB)
WriteSizeobject

The total amount of data written to the file system.

Namestring

The name of the metric.

writeSize
Valuelong

The value of the metric.

6294093393920
Unitstring

The unit of the metric.

MB
Descriptionstring

The description of the metric.

Total cumulative size of data written in megabytes (MB)
Analysisobject

The resource analysis information.

HealthyJobCountlong

The total number of healthy jobs.

3
SubHealthyJobCountlong

The total number of sub-healthy jobs.

1123
UnhealthyJobCountlong

The total number of unhealthy jobs.

23
NeedAttentionJobCountlong

The total number of jobs that require attention.

234
Scoreinteger

The score for jobs.

73
ScoreDayGrowthRatiofloat

The day-to-day growth rate of the score for jobs.

0.02
RequestIdstring

The request ID.

DD6B1B2A-5837-5237-ABE4-FF0C8944****

Examples

Sample success responses

JSONformat

{
  "Data": {
    "Metrics": {
      "VcoreSeconds": {
        "Name": "vcoreSeconds\n",
        "Value": 1231412,
        "Unit": "VCores * Sec\n",
        "Description": "Total vcore usage over time in seconds\n"
      },
      "MemSeconds": {
        "Name": "memSeconds\n",
        "Value": 12312312,
        "Unit": "MB * Sec\n",
        "Description": "Total memory usage over time in seconds\n"
      },
      "VcoreUtilization": {
        "Name": "vcoreUtilization\n",
        "Value": 32.1,
        "Unit": "“”\n",
        "Description": "Ratio of used vcore to total available cores\n"
      },
      "MemUtilization": {
        "Name": "memUtilization\n",
        "Value": 0.82,
        "Unit": "\"\"",
        "Description": "Ratio of used memory to total available memory\n"
      },
      "VcoreSecondsDayGrowthRatio": {
        "Name": "vcoreSecondsDayGrowthRatio",
        "Value": 0.22,
        "Unit": "“”",
        "Description": "Growth ratio of virtual core usage in seconds per day"
      },
      "MemSecondsDayGrowthRatio": {
        "Name": "memSecondsDayGrowthRatio",
        "Value": 0.36,
        "Unit": "“”",
        "Description": "Growth ratio of memory usage in seconds per day"
      },
      "ReadSize": {
        "Name": "readSize",
        "Value": 504888659968,
        "Unit": "MB",
        "Description": "Total cumulative size of data read in megabytes (MB)"
      },
      "WriteSize": {
        "Name": "writeSize",
        "Value": 6294093393920,
        "Unit": "MB",
        "Description": "Total cumulative size of data written in megabytes (MB)"
      }
    },
    "Analysis": {
      "HealthyJobCount": 3,
      "SubHealthyJobCount": 1123,
      "UnhealthyJobCount": 23,
      "NeedAttentionJobCount": 234,
      "Score": 73,
      "ScoreDayGrowthRatio": 0.02
    }
  },
  "RequestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****"
}

Error codes

HTTP status codeError codeError message
400ConflictParametersParameters that must not be used together. %s
400IncompleteSignatureThe request signature is invalid.
400InvalidActionThe action %s requested is invalid.
400InvalidParameterThe specified parameter %s is not valid.
400InvalidParameterValueThe input parameter %s is invalid or out of range.
400MissingActionThe action %s requested is missing.
400MissingParameterThe input parameter %s that is mandatory for processing this request is not supplied.
400NotAuthorizedYou do not have permission to perform this action. %s
400ThrottlingExceptionThe request was denied due to request throttling. %s
404ResourceNotFoundThe resource not found by %s.
500InternalErrorThe request processing has failed due to some unknown error, exception or failure.
503ServiceFailureThe request has failed due to a temporary failure of %s service.
503ServiceUnavailableThe request has failed due to a temporary failure of the server.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history