All Products
Search
Document Center

E-MapReduce:ListDoctorComputeSummary

Last Updated:Oct 17, 2024

Obtains the information about resource usage by resource type 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****
NextTokenstringNo

The pagination token that is used in the request to retrieve a new page of results.

DD6B1B2A-5837-5237-ABE4-FF0C89568980
MaxResultsintegerNo

The maximum number of entries to return on each page.

20
DateTimestringYes

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

2023-01-01
ComponentTypesarrayNo

The resource types, which are used to filter query results. 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. Currently, only one resource type is supported. If you specify multiple resource types, the first resource type is used by default.

StringstringNo

The resource type.

queue
OrderTypestringNo

The order in which you want to sort the query results. Valid values:

  • ASC: in ascending order.
  • DESC: in descending order.
ASC
OrderBystringNo

The basis on which you want to sort the query results. Valid values:

  1. vcoreSeconds: the total CPU consumption over time in seconds.
  2. memSeconds: the total memory consumption over time in seconds.
  3. vcoreUtilization: the average CPU utilization. The meaning is the same as the %CPU parameter in the output of the top command in Linux.
  4. memUtilization: the average memory usage.
  5. vcoreSecondsDayGrowthRatio: the day-to-day growth rate of the total CPU consumption over time in seconds.
  6. memSecondsDayGrowthRatio: the day-to-day growth rate of the total memory consumption over time in seconds.
  7. readSize: the total amount of data read from the file system.
  8. writeSize: the total amount of data written to the file system.
  9. healthyJobCount: the total number of healthy jobs.
  10. subHealthyJobCount: the total number of sub-healthy jobs.
  11. unhealthyJobCount: the total number of unhealthy jobs.
  12. needAttentionJobCount: the total number of jobs that require attention.
  13. score: the score for jobs.
  14. scoreDayGrowthRatio: the day-to-day growth rate of the score for jobs.
score

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

Dataarray<object>

The details of resource usage.

ListDoctorComputeSummeryDTOobject
ComponentNamestring

The name of the resource whose details are obtained based on the value of ComponentTypes. For example, if the value of ComponentTypes is Queue, the value of this parameter is a queue, such as DW.

DW
Metricsobject

The metric information.

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 results.

HealthyJobCountlong

The total number of healthy jobs.

3
SubHealthyJobCountlong

The total number of sub-healthy jobs.

13
UnhealthyJobCountlong

The total number of unhealthy jobs.

123
NeedAttentionJobCountlong

The total number of jobs that require attention.

23
Scoreinteger

The score for jobs.

56
ScoreDayGrowthRatiofloat

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

0.03
RequestIdstring

The request ID.

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

A pagination token.

DD6B1B2A-5837-5237-ABE4-FF0C89568980
MaxResultsinteger

The maximum number of entries that are returned.

20
TotalCountinteger

The total number of entries returned.

200

Examples

Sample success responses

JSONformat

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

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