Diagnostics - Execute Site Analysis
分析の実行の説明
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/diagnostics/{diagnosticCategory}/analyses/{analysisName}/execute?api-version=2024-11-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/diagnostics/{diagnosticCategory}/analyses/{analysisName}/execute?startTime={startTime}&endTime={endTime}&timeGrain={timeGrain}&api-version=2024-11-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
analysis
|
path | True |
string |
分析リソース名 |
diagnostic
|
path | True |
string |
カテゴリ名 |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+[^\.]$ |
リソースが属するリソース グループの名前。 |
site
|
path | True |
string |
サイト名 |
subscription
|
path | True |
string |
Azure のサブスクリプション ID。 これは GUID 形式の文字列です (例: 000000000-0000-0000-0000-000000000000)。 |
api-version
|
query | True |
string |
API バージョン |
end
|
query |
string (date-time) |
終了時刻 |
|
start
|
query |
string (date-time) |
開始時刻 |
|
time
|
query |
string pattern: PT[1-9][0-9]+[SMH] |
時間グレイン |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
[OK] |
|
Other Status Codes |
App Service エラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントを偽装する |
例
Execute site analysis |
Execute site slot analysis |
Execute site analysis
要求のサンプル
応答のサンプル
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/Sample-WestUSResourceGroup/providers/Microsoft.Web/sites/SampleApp/diagnostics/availability/analyses/apprestartanalyses",
"name": "apprestartanalysis",
"properties": {
"startTime": "2017-11-05T22:50:00Z",
"endTime": "2017-11-06T22:50:00Z",
"abnormalTimePeriods": [
{
"startTime": "2017-11-05T22:50:00Z",
"endTime": "2017-11-06T22:50:00Z",
"events": [
{
"startTime": "2017-11-06T22:21:50Z",
"endTime": "2017-11-06T22:21:48Z",
"message": "Your application process was restarted as application environment variables changed. This can most likely occur due to update in app settings or swap operation. This event occurred multiple times during the day.",
"source": null,
"priority": 0,
"metaData": [
[
{
"name": "feature",
"value": "auditlogs"
},
{
"name": "displayedName",
"value": "Check Audit Logs"
}
]
],
"type": "ServiceIncident",
"solutions": []
}
],
"solutions": []
}
],
"payload": [
{
"source": "workerprocessrecycle",
"metrics": [
{
"name": "All Application Stop Events",
"unit": null,
"startTime": "2017-11-05T22:50:00Z",
"endTime": "2017-11-06T22:50:00Z",
"timeGrain": "00:05:00",
"values": [
{
"timestamp": "2017-11-06T00:00:00Z",
"roleInstance": "RD00155D3C15BE",
"total": 2
},
{
"timestamp": "2017-11-06T00:00:00Z",
"total": 2,
"isAggregated": true
},
{
"timestamp": "2017-11-06T00:10:00Z",
"roleInstance": "RD00155D3C15C1",
"total": 2
},
{
"timestamp": "2017-11-06T00:10:00Z",
"roleInstance": "RD00155D3BE0FB",
"total": 2
},
{
"timestamp": "2017-11-06T00:10:00Z",
"total": 4,
"isAggregated": true
}
]
},
{
"name": "User Events",
"unit": "",
"startTime": "2017-11-05T22:50:00Z",
"endTime": "2017-11-06T22:50:00Z",
"timeGrain": "00:05:00",
"values": [
{
"timestamp": "2017-11-06T22:20:00Z",
"total": 3,
"isAggregated": true
},
{
"timestamp": "2017-11-06T22:20:00Z",
"roleInstance": "RD00155D3C09FC",
"total": 1
},
{
"timestamp": "2017-11-06T22:20:00Z",
"roleInstance": "RD00155D3C2ADC",
"total": 1
},
{
"timestamp": "2017-11-06T22:20:00Z",
"roleInstance": "RD00155D3C214E",
"total": 1
}
]
}
],
"data": [],
"detectorMetaData": null
}
],
"nonCorrelatedDetectors": []
}
}
Execute site slot analysis
要求のサンプル
応答のサンプル
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/Sample-WestUSResourceGroup/providers/Microsoft.Web/sites/SampleApp/slots/staging/diagnostics/availability/analyses/apprestartanalyses",
"name": "apprestartanalysis",
"properties": {
"startTime": "2017-11-05T22:50:00Z",
"endTime": "2017-11-06T22:50:00Z",
"abnormalTimePeriods": [
{
"startTime": "2017-11-05T22:50:00Z",
"endTime": "2017-11-06T22:50:00Z",
"events": [
{
"startTime": "2017-11-06T22:21:50Z",
"endTime": "2017-11-06T22:21:48Z",
"message": "Your application process was restarted as application environment variables changed. This can most likely occur due to update in app settings or swap operation. This event occurred multiple times during the day.",
"source": null,
"priority": 0,
"metaData": [
[
{
"name": "feature",
"value": "auditlogs"
},
{
"name": "displayedName",
"value": "Check Audit Logs"
}
]
],
"type": "ServiceIncident",
"solutions": []
}
],
"solutions": []
}
],
"payload": [
{
"source": "workerprocessrecycle",
"metrics": [
{
"name": "All Application Stop Events",
"unit": null,
"startTime": "2017-11-05T22:50:00Z",
"endTime": "2017-11-06T22:50:00Z",
"timeGrain": "00:05:00",
"values": [
{
"timestamp": "2017-11-06T00:00:00Z",
"roleInstance": "RD00155D3C15BE",
"total": 2
},
{
"timestamp": "2017-11-06T00:00:00Z",
"total": 2,
"isAggregated": true
},
{
"timestamp": "2017-11-06T00:10:00Z",
"roleInstance": "RD00155D3C15C1",
"total": 2
},
{
"timestamp": "2017-11-06T00:10:00Z",
"roleInstance": "RD00155D3BE0FB",
"total": 2
},
{
"timestamp": "2017-11-06T00:10:00Z",
"total": 4,
"isAggregated": true
}
]
},
{
"name": "User Events",
"unit": "",
"startTime": "2017-11-05T22:50:00Z",
"endTime": "2017-11-06T22:50:00Z",
"timeGrain": "00:05:00",
"values": [
{
"timestamp": "2017-11-06T22:20:00Z",
"total": 3,
"isAggregated": true
},
{
"timestamp": "2017-11-06T22:20:00Z",
"roleInstance": "RD00155D3C09FC",
"total": 1
},
{
"timestamp": "2017-11-06T22:20:00Z",
"roleInstance": "RD00155D3C2ADC",
"total": 1
},
{
"timestamp": "2017-11-06T22:20:00Z",
"roleInstance": "RD00155D3C214E",
"total": 1
}
]
}
],
"data": [],
"detectorMetaData": null
}
],
"nonCorrelatedDetectors": []
}
}
定義
名前 | 説明 |
---|---|
Abnormal |
診断で特定された異常な期間を表すクラス |
Analysis |
分析に使用される検出器の証拠を表すクラス |
Data |
検出器で使用されるデータ ソースを表すクラス |
Default |
App Service エラー応答。 |
Details | |
Detector |
異常な期間を表すクラスが検出されました。 |
Detector |
検出器の定義を表すクラス |
Diagnostic |
アプリケーションで実行される診断分析を表すクラス |
Diagnostic |
診断メトリックを表すクラス |
Diagnostic |
診断メトリック情報を表すクラス |
Error |
エラー モデル。 |
Issue |
Detector の種類を表します。 |
Name |
名前の値のペア。 |
Response |
|
Solution |
問題の解決策を表すクラスが検出されました。 |
Solution |
ソリューションの種類 |
AbnormalTimePeriod
診断で特定された異常な期間を表すクラス
名前 | 型 | 説明 |
---|---|---|
endTime |
string (date-time) |
ダウンタイムの終了時刻 |
events |
ダウンタイムの考えられる原因の一覧 |
|
solutions |
Solution[] |
提案されたソリューションの一覧 |
startTime |
string (date-time) |
ダウンタイムの開始時刻 |
AnalysisData
分析に使用される検出器の証拠を表すクラス
名前 | 型 | 説明 |
---|---|---|
data |
その他のソース データ |
|
detectorDefinition |
Detector の定義 |
|
detectorMetaData |
Detector メタ データ |
|
metrics |
ソース メトリック |
|
source |
string |
Detector の名前 |
DataSource
検出器で使用されるデータ ソースを表すクラス
名前 | 型 | 説明 |
---|---|---|
dataSourceUri |
データソース URI リンク |
|
instructions |
string[] |
データ ソースに対する手順 (ある場合) |
DefaultErrorResponse
App Service エラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
エラー モデル。 |
Details
名前 | 型 | 説明 |
---|---|---|
code |
string |
プログラムによってエラーを識別するための標準化された文字列。 |
message |
string |
エラーの詳細な説明とデバッグ情報。 |
target |
string |
エラーの詳細な説明とデバッグ情報。 |
DetectorAbnormalTimePeriod
異常な期間を表すクラスが検出されました。
名前 | 型 | 説明 |
---|---|---|
endTime |
string (date-time) |
関連付けられたイベントの終了時刻 |
message |
string |
イベントを説明するメッセージ |
metaData |
ダウンタイム メタデータ |
|
priority |
number (double) |
検出機能のランクを表します。 |
solutions |
Solution[] |
提案されたソリューションの一覧 |
source |
string |
Detector の名前を表します。 |
startTime |
string (date-time) |
関連付けられたイベントの開始時刻 |
type |
Detector の種類を表します。 |
DetectorDefinition
検出器の定義を表すクラス
名前 | 型 | 説明 |
---|---|---|
description |
string |
検出器の説明 |
displayName |
string |
検出器の表示名 |
isEnabled |
boolean |
検出機能が有効かどうかを表すフラグ。 |
rank |
number (double) |
検出器ランク |
DiagnosticAnalysis
アプリケーションで実行される診断分析を表すクラス
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソース ID。 |
kind |
string |
リソースの種類。 |
name |
string |
リソース名。 |
properties.abnormalTimePeriods |
期間の一覧。 |
|
properties.endTime |
string (date-time) |
期間の終了時刻 |
properties.nonCorrelatedDetectors |
コアレートしなかった検出器の各検出器によるデータ |
|
properties.payload |
各検出器によるデータ |
|
properties.startTime |
string (date-time) |
期間の開始時刻 |
type |
string |
リソースの種類。 |
DiagnosticMetricSample
診断メトリックを表すクラス
名前 | 型 | 説明 |
---|---|---|
isAggregated |
boolean |
値がすべてのワーカーにわたって集計されているかどうか |
maximum |
number (double) |
期間中にサンプリングされたメトリックの最大値 |
minimum |
number (double) |
期間中にサンプリングされたメトリックの最小値 |
roleInstance |
string |
ロール インスタンス。 このカウンターがインスタンスごとにない場合は Null。これは返され、返される必要があるインスタンス名である必要があります。つまり、CPU とメモリは RDWORKERNAME (LargeDed..._IN_0) を返します。RDWORKERNAME は下のマシン名で、RoleInstance 名はかっこで指定します。 |
timestamp |
string (date-time) |
メトリックを測定する時刻 |
total |
number (double) |
メトリックの合計値。 複数の測定値が行われる場合、これはすべて合計になります。 |
DiagnosticMetricSet
診断メトリック情報を表すクラス
名前 | 型 | 説明 |
---|---|---|
endTime |
string (date-time) |
期間の終了時刻 |
name |
string |
メトリックの名前 |
startTime |
string (date-time) |
期間の開始時刻 |
timeGrain |
string |
表示される時間グレイン。 現時点でサポートされているグレインは PT1M、PT1H、P1D です |
unit |
string |
メトリックの単位 |
values |
{Microsoft.Web.Hosting.Administration.DiagnosticMetricSet.TimeGrain} に基づく、選択した期間のメトリック値のコレクション |
Error
エラー モデル。
名前 | 型 | 説明 |
---|---|---|
code |
string |
プログラムによってエラーを識別するための標準化された文字列。 |
details |
Details[] |
詳細なエラー。 |
innererror |
string |
デバッグ エラーの詳細。 |
message |
string |
エラーの詳細な説明とデバッグ情報。 |
target |
string |
エラーの詳細な説明とデバッグ情報。 |
IssueType
Detector の種類を表します。
値 | 説明 |
---|---|
AppCrash | |
AppDeployment | |
AseDeployment | |
Other | |
PlatformIssue | |
RuntimeIssueDetected | |
ServiceIncident | |
UserIssue |
NameValuePair
名前の値のペア。
名前 | 型 | 説明 |
---|---|---|
name |
string |
ペア名。 |
value |
string |
ペア値。 |
ResponseMetaData
名前 | 型 | 説明 |
---|---|---|
dataSource |
データのソース |
Solution
問題の解決策を表すクラスが検出されました。
名前 | 型 | 説明 |
---|---|---|
data |
ソリューション データ。 |
|
description |
string |
ソリューションの説明 |
displayName |
string |
ソリューションの表示名 |
id |
number (double) |
ソリューション ID。 |
metadata |
ソリューション メタデータ。 |
|
order |
number (double) |
ソリューションの順序。 |
type |
ソリューションの種類 |
SolutionType
ソリューションの種類
値 | 説明 |
---|---|
BestPractices | |
DeepInvestigation | |
QuickSolution |