Managed Instances - List By Managed Instance
관리되는 instance 쿼리를 사용하는 상위 리소스를 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/topqueries?api-version=2021-11-01GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/topqueries?numberOfQueries={numberOfQueries}&databases={databases}&startTime={startTime}&endTime={endTime}&interval={interval}&aggregationFunction={aggregationFunction}&observationMetric={observationMetric}&api-version=2021-11-01URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
managed
|
path | True |
string |
관리되는 인스턴스의 이름입니다. |
|
resource
|
path | True |
string |
리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다. |
|
subscription
|
path | True |
string |
Azure 구독을 식별하는 구독 ID입니다. |
|
api-version
|
query | True |
string |
요청에 사용할 API 버전입니다. |
|
aggregation
|
query |
사용할 집계 함수, 기본값은 'sum' |
||
|
databases
|
query |
string |
검색에 포함할 쉼표로 구분된 데이터베이스 목록입니다. 이 매개 변수를 지정하지 않으면 모든 DB가 포함됩니다. |
|
|
end
|
query |
string |
관찰된 기간의 종료 시간입니다. |
|
|
interval
|
query |
메트릭 값을 요약하는 데 사용할 시간 단계입니다. 기본값은 PT1H입니다. |
||
|
number
|
query |
integer int32 |
반환할 '상위 쿼리' 수입니다. 기본값은 5입니다. |
|
|
observation
|
query |
상위 쿼리의 순위를 지정하는 데 사용할 메트릭입니다. 기본값은 'cpu'입니다. |
||
|
start
|
query |
string |
관찰된 기간의 시작 시간입니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
관리되는 instance 대한 상위 쿼리를 성공적으로 검색했습니다. |
|
| Other Status Codes |
오류 응답: ***
|
예제
Obtain list of instance's top resource consuming queries.
샘플 요청
샘플 응답
{
"value": [
{
"numberOfQueries": 5,
"aggregationFunction": "sum",
"observationMetric": "cpu",
"intervalType": "P1D",
"startTime": "03/01/2020 00:00:00",
"endTime": "03/05/2020 13:00:00",
"queries": [
{
"databaseName": "db1",
"queryId": "25",
"intervals": [
{
"intervalStartTime": "03/03/2020 00:00:00",
"executionCount": 1,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0015841714409722222
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 4.340277777777778E-06
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 8336
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 11306905
}
]
}
]
},
{
"databaseName": "db1",
"queryId": "21",
"intervals": [
{
"intervalStartTime": "03/03/2020 00:00:00",
"executionCount": 1,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0009521432291666667
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 2.3148148148148148E-07
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 1024
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 6620020
}
]
}
]
},
{
"databaseName": "db3",
"queryId": "3",
"intervals": [
{
"intervalStartTime": "03/04/2020 00:00:00",
"executionCount": 104,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0008006611689814815
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 0
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 5543088
}
]
}
]
},
{
"databaseName": "db2",
"queryId": "3",
"intervals": [
{
"intervalStartTime": "03/03/2020 00:00:00",
"executionCount": 89,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0006882543402777778
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 0
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 4761877
}
]
}
]
},
{
"databaseName": "db3",
"queryId": "22",
"intervals": [
{
"intervalStartTime": "03/04/2020 00:00:00",
"executionCount": 1,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0006220661168981482
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 1024
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 4454161
}
]
}
]
}
]
}
]
}Obtain list of instance's top resource consuming queries. Full-blown request and response.
샘플 요청
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/managedInstances/sqlcrudtest-4645/topqueries?databases=db1,db2&startTime=2020-03-10T12:00:00Z&endTime=2020-03-12T12:00:00Z&interval=P1D&observationMetric=cpu&api-version=2021-11-01
샘플 응답
{
"value": [
{
"numberOfQueries": 5,
"aggregationFunction": "sum",
"observationMetric": "cpu",
"intervalType": "P1D",
"startTime": "03/10/2020 00:00:00",
"endTime": "03/12/2020 13:00:00",
"queries": [
{
"databaseName": "db1",
"queryId": "28",
"intervals": [
{
"intervalStartTime": "03/11/2020 00:00:00",
"executionCount": 1,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0015934667245370371
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 4.224537037037037E-06
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 8336
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 11091296
}
]
}
]
},
{
"databaseName": "db1",
"queryId": "24",
"intervals": [
{
"intervalStartTime": "03/11/2020 00:00:00",
"executionCount": 1,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0009522783564814815
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 1.7361111111111112E-07
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 1024
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 6625562
}
]
}
]
},
{
"databaseName": "db1",
"queryId": "3",
"intervals": [
{
"intervalStartTime": "03/11/2020 00:00:00",
"executionCount": 82,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0007183139467592593
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 0
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 4970199
}
]
}
]
},
{
"databaseName": "db1",
"queryId": "29",
"intervals": [
{
"intervalStartTime": "03/11/2020 00:00:00",
"executionCount": 1,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0006494454571759259
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 5.034722222222222E-06
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 1024
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 4530668
}
]
}
]
},
{
"databaseName": "db2",
"queryId": "25",
"intervals": [
{
"intervalStartTime": "03/11/2020 00:00:00",
"executionCount": 1,
"metrics": [
{
"name": "cpu",
"displayName": "Cpu",
"unit": "percentage",
"value": 0.0006275368923611112
},
{
"name": "io",
"displayName": "Physical Io Reads",
"unit": "percentage",
"value": 0
},
{
"name": "logIo",
"displayName": "Log Writes",
"unit": "percentage",
"value": 0
},
{
"name": "memory",
"displayName": "Memory consumption",
"unit": "KB",
"value": 1024
},
{
"name": "duration",
"displayName": "Query duration",
"unit": "microseconds",
"value": 4349943
}
]
}
]
}
]
}
]
}Obtain list of instance's top resource consuming queries. Minimal request and response.
샘플 요청
샘플 응답
{
"value": [
{
"numberOfQueries": 5,
"aggregationFunction": "sum",
"observationMetric": "cpu",
"intervalType": "PT1H",
"startTime": "03/10/2020 12:00:00",
"endTime": "03/11/2020 12:24:07",
"queries": []
}
]
}정의
| Name | Description |
|---|---|
|
Aggregation |
사용할 집계 함수, 기본값은 'sum' |
|
Metric |
상위 쿼리의 순위를 지정하는 데 사용할 메트릭입니다. 기본값은 'cpu'입니다. |
|
Query |
쿼리 메트릭 간격의 속성입니다. |
|
Query |
한 간격으로 최상위 쿼리 메트릭의 속성입니다. |
|
Query |
메트릭의 단위입니다. |
|
Query |
쿼리 실행 통계의 속성입니다. |
|
Query |
간격 유형(길이)입니다. |
|
Top |
|
|
Top |
관리되는 instance 쿼리를 사용하는 상위 리소스 목록 |
AggregationFunctionType
사용할 집계 함수, 기본값은 'sum'
| 값 | Description |
|---|---|
| avg | |
| max | |
| min | |
| stdev | |
| sum |
MetricType
상위 쿼리의 순위를 지정하는 데 사용할 메트릭입니다. 기본값은 'cpu'입니다.
| 값 | Description |
|---|---|
| cpu | |
| dtu | |
| duration | |
| io | |
| logIo |
QueryMetricInterval
쿼리 메트릭 간격의 속성입니다.
| Name | 형식 | Description |
|---|---|---|
| executionCount |
integer |
이 간격의 쿼리 실행 수입니다. |
| intervalStartTime |
string |
메트릭 간격의 시작 시간(ISO-8601 형식)입니다. |
| intervalType |
간격 유형(길이)입니다. |
|
| metrics |
이 간격에 대한 메트릭 개체 목록 |
QueryMetricProperties
한 간격으로 최상위 쿼리 메트릭의 속성입니다.
| Name | 형식 | Description |
|---|---|---|
| avg |
number |
간격에 걸쳐 avg() 집계 함수를 사용하는 경우 메트릭 값입니다. |
| displayName |
string |
메트릭에 적합한 UI 이름입니다. |
| max |
number |
간격 동안 max() 집계 함수를 사용하는 경우 메트릭 값입니다. |
| min |
number |
min() 집계 함수가 간격에 걸쳐 사용되는 경우의 메트릭 값입니다. |
| name |
string |
메트릭의 이름 정보입니다. |
| stdev |
number |
간격 동안 stdev 집계 함수를 사용하는 경우의 메트릭 값입니다. |
| sum |
number |
간격 동안 sum() 집계 함수를 사용하는 경우의 메트릭 값입니다. |
| unit |
메트릭의 단위입니다. |
|
| value |
number |
메트릭의 값입니다. |
QueryMetricUnitType
메트릭의 단위입니다.
| 값 | Description |
|---|---|
| KB | |
| count | |
| microseconds | |
| percentage |
QueryStatisticsProperties
쿼리 실행 통계의 속성입니다.
| Name | 형식 | Description |
|---|---|---|
| databaseName |
string |
이 쿼리가 실행된 데이터베이스의 데이터베이스 이름입니다. |
| endTime |
string |
메트릭의 종료 시간(ISO-8601 형식)입니다. |
| intervals |
적절한 메트릭 데이터가 있는 간격 목록 |
|
| queryId |
string |
고유 쿼리 ID(하나의 데이터베이스 내에서 고유). |
| startTime |
string |
메트릭의 시작 시간(ISO-8601 형식)입니다. |
QueryTimeGrainType
간격 유형(길이)입니다.
| 값 | Description |
|---|---|
| P1D | |
| PT1H |
TopQueries
| Name | 형식 | Description |
|---|---|---|
| aggregationFunction |
string |
쿼리 메트릭을 계산하는 데 사용되는 집계 함수입니다. |
| endTime |
string |
메트릭의 종료 시간(ISO-8601 형식)입니다. |
| intervalType |
간격 유형(길이)입니다. |
|
| numberOfQueries |
integer |
요청된 상위 쿼리 수입니다. |
| observationMetric |
string |
쿼리 순위를 지정하는 데 사용되는 메트릭입니다. |
| queries |
적절한 메트릭 데이터가 있는 상위 리소스 사용 쿼리 목록 |
|
| startTime |
string |
메트릭의 시작 시간(ISO-8601 형식)입니다. |
TopQueriesListResult
관리되는 instance 쿼리를 사용하는 상위 리소스 목록
| Name | 형식 | Description |
|---|---|---|
| nextLink |
string |
연결하여 결과의 다음 페이지를 검색합니다. |
| value |
결과 배열입니다. |