DescribeSlowLogs操作を呼び出して、ApsaraDB RDSインスタンスの低速クエリログの概要をクエリできます。

この操作を呼び出す前に、インスタンスが次のいずれかのデータベースエンジンバージョンを実行していることを確認してください。

  • RDS Basicエディションで使用されるMySQL 5.7を除くすべてのMySQLバージョン
  • SQL Server 2008 R2
  • MariaDB 10.3
説明 低速クエリログはリアルタイムで収集されず、6時間から8時間の遅延が表示される場合があります。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須/任意 例: 説明 
操作 String 必須 DescribeSlowLogs

実行する操作です。 値をDescribeSlowLogsに設定します。

DBInstanceId String 必須 rm-uf6wjk5xxxxxxx

インスタンスの ID です。

EndTime String 必須 2011-05-30Z

クエリする期間の終了時刻を設定します。 終了時刻は開始時刻よりも後の時刻にする必要があります。 開始時間と終了時間の間の期間は31日を超えることはできません。 yyyy-MM-ddZ の形で時刻を指定します。 時間は UTC にする必要があります。

StartTime String 必須 2011-05-01Z

クエリする期間の開始時刻です。 yyyy-MM-ddZ の形で時刻を指定します。 時間は UTC にする必要があります。

DBName String 任意 RDS_MySQL

照会するデータベースの名前。

SortKey String 任意 TotalExecutionCounts

ApsaraDB RDSが返されたエントリをソートするディメンション。 有効な値:

  • TotalExecutionCounts: ApsaraDB RDSは、実行されたSQL文の総数に基づいて、返されたエントリをソートします。
  • TotalQueryTimes: ApsaraDB RDSは、返されたエントリを合計実行期間に基づいてソートします。
  • TotalLogicalReads: ApsaraDB RDSは、論理読み取りの総数に基づいて、返されたエントリをソートします。
  • TotalPhysicalReads: ApsaraDB RDSは、物理読み取りの総数に基づいて、返されたエントリをソートします。
説明 このパラメーターは、SQL Server 2008 R2を実行するインスタンスでのみサポートされます。
PageSize Integer いいえ 30

各ページで返されるエントリ数。 有効な値: 30100。 デフォルト値: 30

PageNumber Integer いいえ 1

返されるページ数。 有効値:0 以外の正の整数。

既定値:1

レスポンスパラメーター

項目 データ型 例: 説明 
Engine String MySQL

インスタンスのデータベースエンジン。

StartTime String 2011-05-30Z

照会された時間範囲の開始日。

EndTime String 2011-05-30Z

照会された時間範囲の終了日。

TotalRecordCount Integer 5

返されるエントリの総数。

PageNumber Integer 1

返されたページ数。

PageRecordCount Integer 10

現在のページで返されるSQL文の数。

項目 SQLSlowLogの配列

各低速クエリに関する情報で構成される配列。

SQLSlowLog
DBName String RDS_MySQL

照会されたデータベースの名前。

SQLText String tb_tableからid、名前を選択

クエリで実行されたSQL文。

SQLServerTotalExecutionCounts Long 1

クエリで実行されたSQL文の総数。 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。

MySQLTotalExecutionCounts Long 1

クエリで実行されたSQL文の総数。 このパラメーターは、MySQLを実行するインスタンスに対してのみ返されます。

SQLServerTotalExecutionTimes Long 1000

クエリ内のすべてのSQL文の合計実行時間。 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。 単位:ミリ秒。

MySQLTotalExecutionTimes Long 1

クエリ内のすべてのSQL文の合計実行時間。 このパラメーターは、MySQLを実行するインスタンスに対してのみ返されます。 単位:秒。

MaxExecutionTime Long 60

クエリ内の特定のSQLステートメントの最長実行時間。 単位:秒。

レポートタイム String 2011-05-30Z

データレポートが生成された日付。

TotalLockTimes Long 0

クエリ内のすべてのSQL文によって発生した合計ロック期間。 単位:秒。

MaxLockTime Long 0

クエリ内の特定のSQLステートメントによって発生した最長のロック期間。 単位:秒。

ParseTotalRowCounts Long 1

クエリ内のすべてのSQL文によって解析された行の総数。

ParseMaxRowCount Long 1

クエリ内の特定のSQLステートメントによって解析された行の最大数。

ReturnTotalRowCounts Long 1

クエリ内のすべてのSQL文によって返された行の総数。

ReturnMaxRowCount Long 1

クエリ内の特定のSQLステートメントによって返された行の最大数。

CreateTime String 2011-05-30Z

ログが生成された時刻を示します。

AvgExecutionTime Long 1

クエリ内のSQLステートメントあたりの平均実行時間。 単位:秒。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
AvgIOWriteCounts Long 0

クエリ内のSQL文ごとのI/O書き込みの平均数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
AvgLastRowsAffectedCounts Long 0

クエリ内の最後のSQL文の影響を受ける行の平均数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
AvgLogicalReadCounts Long 0

クエリ内のSQL文ごとの論理読み取りの平均数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
AvgPhysicalReadCounts Long 0

クエリ内のSQL文ごとの物理読み取りの平均数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
AvgRowsAffectedCounts Long 0

クエリ内のSQL文ごとに影響を受けた行の平均数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MaxIOWriteCounts Long 0

クエリ内の特定のSQLステートメントによって実行されたI/O書き込みの最大数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MaxLastRowsAffectedCounts Long 0

クエリ内の最後のSQL文の影響を受けた行の最大数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MaxLogicalReadCounts Long 0

クエリ内の特定のSQLステートメントによって実行された論理読み取りの最大数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MaxPhysicalReadCounts Long 0

クエリ内の特定のSQLステートメントによって実行された物理読み取りの最大数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MaxRowsAffectedCounts Long 0

クエリ内の特定のSQL文の影響を受けた行の最大数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MinIOWriteCounts Long 0

クエリ内の特定のSQLステートメントによって実行されたI/O書き込みの最小数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MinLastRowsAffectedCounts Long 0

クエリ内の最後のSQL文の影響を受けた行の最小数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MinLogicalReadCounts Long 0

クエリ内の特定のSQLステートメントによって実行された論理読み取りの最小数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MinPhysicalReadCounts Long 0

クエリ内の特定のSQLステートメントによって実行された物理読み取りの最小数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
MinRowsAffectedCounts Long 0

クエリ内の特定のSQL文の影響を受けた行の最小数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
SQLHASH String U2FsdGVkxxxx

SQL文の一意のID。 IDは、SQL文の低速クエリログを取得するために使用されます。

SQLIdStr String 521584

低速クエリログの統計テンプレート内のSQL文のID。 このパラメーターは、SQLHASHパラメーターに置き換えられます。

SQLServerAvgCpuTime Long 0

クエリ内のSQLステートメントあたりの平均CPU時間。 単位:秒。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
SQLServerAvgExecutionTime Long 0

クエリ内のSQLステートメントあたりの平均実行時間。 単位:秒。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
SQLServerMaxCpuTime Long 0

クエリで特定のSQLステートメントによって使用されたCPU時間の最大値。 単位:秒。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
SQLServerMinCpuTime Long 0

特定のSQLステートメントで使用されたCPU時間の最小値。 単位:秒。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
SQLServerMinExecutionTime Long 0

クエリ内の特定のSQLステートメントの最小実行時間。 単位:秒。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
SQLServerTotalCpuTime Long 0

クエリ内のすべてのSQL文で使用されたCPU時間の合計。 単位:秒。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
SlowLogId Long 26584213

スロークエリログの概要のID。

TotalIOWriteCounts Long 0

クエリ内のすべてのSQL文によって実行されたI/O書き込みの総数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
TotalLastRowsAffectedCounts Long 0

クエリ内の最後のSQL文の影響を受けた行の総数。

説明 このパラメーターは、SQL Serverを実行するインスタンスに対してのみ返されます。
TotalLogicalReadCounts Long 1

クエリ内のすべてのSQL文によって実行された論理読み取りの総数。

TotalPhysicalReadCounts Long 1

クエリ内のすべてのSQL文によって実行された物理読み取りの総数。

TotalPhysicalReadCounts Long 1

クエリ内のすべてのSQL文によって実行された物理読み取りの総数。

TotalRowsAffectedCounts Long 0

クエリ内のすべてのSQL文の影響を受けた行の総数。

DBInstanceId String rm-uf6wjk5xxxxxxx

インスタンスの ID です。

RequestId String 2553A660-E4EB-4AF4-A402-8AFF70A49143

リクエストの ID です。

リクエストの例

http(s):// rds.aliyuncs.com/?Action=DescribeSlowLogs
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2011-05-01Z
&EndTime=2011-05-30Z
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

<DescribeSlowLogsResponse> 
    <RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
    <DBInstanceID>rm-uf6wjk5xxxxxxx</DBInstanceID> 
    <エンジン> SQLServer</Engine>
    <StartTime>2011-06-11Z</StartTime> 
    <EndTime>2011-12-11Z</EndTime> 
    <TotalRecordCount>1</TotalRecordCount>
    <ページ番号> 1 </ PAGENUMBER>
    <PageRecordCount>1</PageRecordCount>
    <Items>
        <SQLSlowLog>
          <SQLText>update test.zxb set id=0 limit 1</SQLText>
          <SQLServerTotalExecutionCounts>178</SQLServerTotalExecutionCounts>
          <SQLServerTotalExecutionTimes>189</SQLServerTotalExecutionTimes>
          <TotalLogicalReadcounts>89</TotalLogicalReadcounts>
          <TotalPhysicalReadcounts>90</TotalPhysicalReadcounts>
          <ReportTime>2013-11-12Z</ReportTime>
       </SQLSlowLog>
    </アイテム>
</DescribeSlowLogsResponse>

JSON 形式

{
    "DescribeSlowLogs": {
        "RequestId": "A5409D02-D661-4BF3-8F3D-0A814D0574E7" 、
        "DBInstanceID": "rm-uf6wjk5xxxxxxx" 、
        "エンジン": "SQLServer" 、
        "StartTime": "2011-06-11Z" 、
        "EndTime": "2011-12-11Z" 、
        "TotalRecordCount": "1" 、
        &quot;ページ番号&quot;: &quot;1&quot;、
        "PageRecordCount": "1" 、
        "Items": {
            "SQLSlowLog": {
                "SQLText": "update test.zxb set id=0 limit 1" 、
                "SQLServerTotalExecutionCounts": "178" 、
                "SQLServerTotalExecutionTimes": "189" 、
                "TotalLogicalReadcounts": "89" 、
                "TotalPhysicalReadcounts": "90" 、
                "ReportTime": "2013-11-12Z"
            }
        }
    }
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明 
400 InvalidSearchTimeRange 検索時間範囲は1か月より長くすることはできません。 開始時刻と終了時刻の間の期間が31日を超えた場合に返されるエラーメッセージ。
400 IO. 例外 IO例外、後で再試行します。 I/Oエラーが発生した場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。