使用有关 Azure SQL 数据库和 Azure SQL 托管实例性能问题的智能见解性能诊断日志

适用于： Azure SQL 数据库 Azure SQL 托管实例

本页介绍如何使用智能见解生成的有关 Azure SQL 数据库和 Azure SQL 托管实例性能问题的性能诊断日志，以及其格式和它为满足自定义开发需求所包含的数据。 可将此诊断日志发送到 Azure 事件中心、Azure 存储或第三方解决方案，用于自定义 DevOps 警报和报告功能。

日志标头

诊断日志使用 JSON 标准格式输出 Intelligent Insights 的发现成果。 访问 Intelligent Insights 日志的确切类别属性是固定值“SQLInsights”。

日志的标头很常见，由时间戳 (TimeGenerated) 组成，它显示条目的创建时间。 它还包括一个引用条目所涉及的特定数据库的资源 ID (ResourceId)。 类别 (Category)、级别 (Level) 和操作名称 (OperationName) 为固定属性，其值不会改变。 它们指示日志项目是信息性的，并表示日志项目来自 Intelligent Insights (SQLInsights)。

"TimeGenerated" : "2017-9-25 11:00:00", // time stamp of the log entry
"ResourceId" : "database identifier", // value points to a database resource
"Category": "SQLInsights", // fixed property
"Level" : "Informational", // fixed property
"OperationName" : "Insight", // fixed property

问题 ID 和受影响的数据库

问题标识属性 (issueId_d) 提供一种跟踪性能问题直至解决的独特方法。 同一问题的日志报告状态中的多个事件记录将共享同一问题 ID。

除问题 ID 外，诊断日志还会报告与在诊断日志中所报告问题相关的特定事件的开始 (intervalStartTime_t) 和结束 (intervalEndTme_t) 时间戳。

弹性池 (elasticPoolName_s) 属性指示出问题数据库属于哪个弹性池。 如果数据库不属于弹性池，此属性将没有值。 检测到问题的数据库在数据库名称 (databaseName_s) 属性中公开。

"intervalStartTime_t": "2017-9-25 11:00", // start of the issue reported time stamp
"intervalEndTme_t":"2017-9-25 12:00", // end of the issue reported time stamp
"elasticPoolName_s" : "", // resource elastic pool (if applicable)
"databaseName_s" : "db_name", // database name
"issueId_d" : 1525, // unique ID of the issue detected
"status_s" : "Active" // status of the issue - possible values: "Active", "Verifying", and "Complete"

检测到的问题

Intelligent Insights 性能日志的下一部分包括通过内置人工智能检测到的性能问题。 检测结果会在 JSON 诊断日志的属性中公开。 这些检测结果包含问题类别、问题的影响、受影响的查询和指标。 检测属性可能包含多个检测到的性能问题。

检测到的性能问题使用以下检测属性结构进行报告：

"detections_s" : [{
"impact" : 1 to 3, // impact of the issue detected, possible values 1-3 (1 low, 2 moderate, 3 high impact)
"category" : "Detectable performance pattern", // performance issue detected, see the table
"details": <Details outputted> // details of an issue (see the table)
}]

下表提供了输出到诊断日志的可检测性能模式和详细信息。

检测类别

类别 (category) 属性介绍了可检测性能模式的类别。 请查看下表，了解可检测性能模式的所有可能类别。 有关详细信息，请参阅使用 Intelligent Insights 排查数据库性能问题。

相应地，诊断日志文件中输出的详细信息可能因检测到的性能问题而异。

影响

影响 (impact) 属性描述检测到的行为对数据库的问题造成了多大的影响。 影响范围从 1 到 3，3 影响最大、2 影响居中，1 影响最小。 影响值可以用作自定义警报自动化的输入，具体取决于特定需求。 受影响的属性查询 (QueryHashes) 提供受特定检测影响的查询哈希的列表。

受影响的查询

Intelligent Insights 日志的下一部分提供关于受检测到的性能问题影响的特定查询信息。 此信息公开为嵌入 impact_s 属性的一组对象。 影响属性包含实体和指标。 实体引用特定查询（类型：Query）。 唯一的查询哈希值在值 (Value) 属性下公开。 此外，每个公开的查询后跟指标和值，指示检测到的性能问题。

在以下日志示例中，使用哈希 0x9102EXZ4 的查询被检测到其执行持续时间延长（指标：DurationIncreaseSeconds）。 值 110 秒表示此特定查询的执行时间延长 110 秒。 因为可以检测到多个查询，所以此特定日志部分可能包含多个查询条目。

"impact" : [{
"entity" : {
"Type" : "Query", // type of entity - query
"Value" : "query hash value", // for example "0x9102EXZ4" query hash value },
"Metric" : "DurationIncreaseSeconds", // measured metric and the measurement unit (in this case seconds)
"Value" : 110 // value of the measured metric (in this case seconds)
}]

指标

每个报告的指标的测量单位在指标 (metric) 属性下提供，可能的值有：秒、数字和百分比。 测量的指标值在值 (value) 属性中报告。

DurationIncreaseSeconds 属性提供以秒为单位的测量单位。 CriticalErrorCount 测量单位是一个数字，表示错误计数。

"metric" : "DurationIncreaseSeconds", // issue metric type - possible values: DurationIncreaseSeconds, CriticalErrorCount, WaitingSeconds
"value" : 102 // value of the measured metric (in this case seconds)

根本原因分析和改进建议

Intelligent Insights 性能日志的最后部分是对已确定的性能下降问题的根本原因进行自动分析。 以用户友好措辞形式出现的信息会显示在根本原因分析 (rootCauseAnalysis_s) 属性中。 日志中可能包含改进建议。

// example of reported root cause analysis of the detected performance issue, in a human-readable format

"rootCauseAnalysis_s" : "High data IO caused performance to degrade. It seems that this database is missing some indexes that could help."

后续步骤

• 了解有关 Intelligent Insights 的概念。
• 了解如何使用智能见解排查性能问题。
• 了解如何从 Azure 资源收集和使用日志数据。