次の方法で共有

.show commands コマンド

  • [アーティクル]

.show commands は、完了した 管理コマンドを含むテーブルを返します。 これらのコマンドとクエリは 30 日間使用できます。

注意

このコマンドは、各管理コマンドで使用されるリソースを示しているため、パフォーマンスの問題を調査するのに役立ちます。 例を参照してください。

アクセス許可

データベース管理者またはデータベース モニター では、データベースで呼び出された任意のコマンドを表示できます。 他のユーザーは、自分のコマンドのみを表示できます。

構文

.show commands

戻り値

戻り値テーブルには、完了したすべてのコマンドのリソース消費の詳細を含む 2 つの列があります。

  • TotalCpu - このコマンドによって消費される CPU クロック時間の合計 (ユーザー モード + カーネル モード)。
  • ResourceUtilization - TotalCpu を含め、そのコマンドに関連するすべてのリソース使用情報が含まれます。

追跡されるリソース使用量には、データの更新と、現在の管理者コマンドに関連付けられているクエリが含まれます。 現時点では、一部の管理コマンドのみがコマンド テーブル (.ingest、.set-or-replace.set.append.set-or-append) でカバーされています。 徐々に、コマンド テーブルにさらにコマンドが追加されます。

出力例

ClientActivityId CommandType Text データベース StartedOn LastUpdatedOn Duration State RootActivityId User FailureReason Application プリンシパル TotalCpu ResourceUtilization WorkloadGroup
KD2RunCommand;a069f9e3-6062-4a0e-aa82-75a1b5e16fb4 ExtentsMerge .merge async Operations ... DB1 2017-09-05 11:08:07.5738569 2017-09-05 11:08:09.1051161 00:00:01.5312592 完了 b965d809-3f3e-4f44-bd2b-5e1f49ac46c5 AAD アプリ ID=5ba8cec2-9a70-e92c98cad651 Kusto.Azure.DM.Svc aadapp=5ba8cec2-9a70-e92c98cad651 00:00:03.5781250 { "ScannedExtentsStatistics": { "MinDataScannedTime": null, "MaxDataScannedTime": null }, "CacheStatistics": { Memory": { "Misses": 2, "Hits": 20 }, "Disk": { "Misses": 2, "Hits": 0 } }, "MemoryPeak": 159620640, "TotalCpu": "00:00:03.5781250" } internal
KE.RunCommand; 710e08ca-2cd3-4d2d-b7bd-2738d335aa50 DataIngestPull .ingest into MyTableName ... TestDB 2017-09-04 16:00:37.0915452 2017-09-04 16:04:37.2834555 00:04:00.1919103 失敗 a8986e9e-943f-81b0270d6fae4 cooper@fabrikam.com ソケット接続は破棄されています。 Kusto.Explorer aaduser=... 00:00:00 { "ScannedExtentsStatistics": { "MinDataScannedTime": null, "MaxDataScannedTime": null }, "CacheStatistics": { "Memory": { "Misses": 0, Hits": 0 }, "Disk": { "Misses": 0, "Hits": 0 } }, "MemoryPeak": 0, "TotalCpu": "00:00:00"} default
KD2RunCommand;97db47e6-93e2-4306-8b7d-670f2c3307ff ExtentsRebuild .merge async Operations ... DB2 2017-09-18 13:29:38.5945531 2017-09-18 13:29:39.9451163 00:00:01.3505632 完了 d5ebb755-d5df-4e94-b240-9accdf06c2d1 AAD アプリ ID=5ba8cec2-9a70-e92c98cad651 Kusto.Azure.DM.Svc aadapp=5ba8cec2-9a70-e92c98cad651 00:00:00.8906250 { "ScannedExtentsStatistics": { "MinDataScannedTime": null, "MaxDataScannedTime": null }, "CacheStatistics": { Memory": { "Misses": 0, "Hits": 1 }, "Disk": { "Misses": 0, "Hits": 0 } }, "MemoryPeak": 88828560, "TotalCpu": "00:00:00.8906250"} internal

例

列からデータを抽出するResourceUtilization

列内 ResourceUtilization のいずれかのプロパティにアクセスするには、 を呼び出します ResourcesUtilization。PropertyName。

Note

ResourceUtilization は動的な列です。 値を操作するには、最初にそれを特定のデータ型に変換する必要があります。 tolong、toint、 totimespanなどの変換関数を使用します。

次に例を示します。

.show commands
| where CommandType == "TableAppend"
| where StartedOn > ago(1h)
| extend MemoryPeak = tolong(ResourcesUtilization.MemoryPeak)
| top 3 by MemoryPeak desc
| project StartedOn, MemoryPeak, TotalCpu, Text

出力

StartedOn MemoryPeak TotalCpu Text
2017-09-28 12:11:27.8155381 800396032 00:00:04.5312500 .append Server_Boots <| let bootStartsSourceTable = SessionStarts; ...
2017-09-28 11:21:26.7304547 750063056 00:00:03.8218750 .set-or-append WebUsage <| database('CuratedDB').WebUsage_v2 | summarize ... | project ...
2017-09-28 12:16:17.4762522 676289120 00:00:00.0625000 .set-or-append AtlasClusterEventStats with(...) <| Atlas_Temp(datetime(2017-09-28 12:13:28.7621737), datetime(2017-09-28 12:14:28.8168492))

列のクエリを実行するTotalCpu

過去 1 日の CPU 消費クエリの上位 10 件。

.show commands
| where StartedOn > ago(1d)
| top 10 by TotalCpu
| project StartedOn, CommandType, ClientActivityId, TotalCpu

TotalCpu が 3 分を経過した過去 10 時間以内のすべてのクエリ。

.show commands
| where StartedOn > ago(10h) and TotalCpu > 3m
| project StartedOn, CommandType, ClientActivityId, TotalCpu 
| order by TotalCpu

TotalCpu がユーザーとプリンシパル別にグループ化されて 5 分を経過した過去 24 時間のすべてのクエリ。

.show commands  
| where StartedOn > ago(24h)
| summarize TotalCount=count(), CountAboveThreshold=countif(TotalCpu > 2m), AverageCpu = avg(TotalCpu), MaxTotalCpu=max(TotalCpu), (50th_Percentile_TotalCpu, 95th_Percentile_TotalCpu)=percentiles(TotalCpu, 50, 95) by User, Principal
| extend PercentageAboveThreshold = strcat(substring(CountAboveThreshold * 100 / TotalCount, 0, 5), "%")
| order by CountAboveThreshold desc
| project User, Principal, CountAboveThreshold, TotalCount, PercentageAboveThreshold, MaxTotalCpu, AverageCpu, 50th_Percentile_TotalCpu, 95th_Percentile_TotalCpu

Timechart: 平均 CPU 対 95 パーセンタイル対最大 CPU。

.show commands 
| where StartedOn > ago(1d) 
| summarize MaxCpu_Minutes=max(TotalCpu)/1m, 95th_Percentile_TotalCpu_Minutes=percentile(TotalCpu, 95)/1m, AverageCpu_Minutes=avg(TotalCpu)/1m by bin(StartedOn, 1m)
| render timechart

列のクエリを実行するMemoryPeak

過去 1 日の上位 10 個のクエリで、値が最も MemoryPeak 高い。

.show commands
| where StartedOn > ago(1d)
| extend MemoryPeak = tolong(ResourcesUtilization.MemoryPeak)
| project StartedOn, CommandType, ClientActivityId, TotalCpu, MemoryPeak
| top 10 by MemoryPeak

MemoryPeak の平均対 95 番目のパーセンタイル対 Max MemoryPeak の時間グラフ。

.show commands 
| where StartedOn > ago(1d)
| project MemoryPeak = tolong(ResourcesUtilization.MemoryPeak), StartedOn 
| summarize Max_MemoryPeak=max(MemoryPeak), 95th_Percentile_MemoryPeak=percentile(MemoryPeak, 95), Average_MemoryPeak=avg(MemoryPeak) by bin(StartedOn, 1m)
| render timechart

関連コンテンツ