Azure Resource Manager テンプレートを使用して Application Insights スマート検出ルールを管理するManage Application Insights smart detection rules using Azure Resource Manager templates

Application Insights のスマート検出ルールは、Azure Resource Manager テンプレートを使用して管理および構成できます。Smart detection rules in Application Insights can be managed and configured using Azure Resource Manager templates. この手法は、Azure Resource Manager オートメーションで新しい Application Insights リソースをデプロイするとき、または既存のリソースの設定を変更するときに使用できます。This method can be used when deploying new Application Insights resources with Azure Resource Manager automation, or for modifying the settings of existing resources.

スマート検出ルールの構成Smart detection rule configuration

スマート検出ルールに対して次の設定を構成できます。You can configure the following settings for a smart detection rule:

  • ルールが有効になっているかどうか (既定値は true )。If the rule is enabled (the default is true .)
  • 検出が見つかったときに、メールがサブスクリプションの [閲覧者の監視] ロールと [共同作成者の監視] ロールに関連付けられたユーザーに送信される必要がある場合 (既定値は true )。If emails should be sent to users associated to the subscription’s Monitoring Reader and Monitoring Contributor roles when a detection is found (the default is true .)
  • 検出が見つかったときに通知を受ける必要があるその他の電子メール受信者。Any additional email recipients who should get a notification when a detection is found.
    • メールの構成は、 プレビュー とマークされたスマート検出ルールで使用できません。Email configuration is not available for Smart Detection rules marked as preview .

Azure Resource Manager を使用してルールの設定を構成できるように、スマート検出ルールの構成は、Application Insights リソース内で ProactiveDetectionConfigs という名前の内部リソースとして使用できるようになりました。To allow configuring the rule settings via Azure Resource Manager, the smart detection rule configuration is now available as an inner resource within the Application Insights resource, named ProactiveDetectionConfigs . 柔軟性を最大化するために、各スマート検出ルールを一意の通知設定で構成できます。For maximal flexibility, each smart detection rule can be configured with unique notification settings.

Examples

Azure Resource Manager テンプレートを使用してスマート検出ルールの設定を構成する方法を示す例を次にいくつか示します。Below are a few examples showing how to configure the settings of smart detection rules using Azure Resource Manager templates. すべてのサンプルは、 "myApplication" という名前の Application Insights リソースと、 "longdependencyduration" という内部名の "長い依存関係期間スマート検出ルール" を参照します。All samples refer to an Application Insights resource named “myApplication” , and to the "long dependency duration smart detection rule", which is internally named “longdependencyduration” . Application Insights リソース名を置換し、関連するスマート検出ルールの内部名を指定してください。Make sure to replace the Application Insights resource name, and to specify the relevant smart detection rule internal name. 各スマート検出ルールに対応する Azure Resource Manager 内部名の一覧については、次の表をご確認ください。Check the table below for a list of the corresponding internal Azure Resource Manager names for each smart detection rule.

スマート検出ルールを無効にするDisable a smart detection rule

{
      "apiVersion": "2018-05-01-preview",
      "name": "myApplication",
      "type": "Microsoft.Insights/components",
      "location": "[resourceGroup().location]",
      "properties": {
        "Application_Type": "web"
      },
      "resources": [
        {
          "apiVersion": "2018-05-01-preview",
          "name": "longdependencyduration",
          "type": "ProactiveDetectionConfigs",
          "location": "[resourceGroup().location]",
          "dependsOn": [
            "[resourceId('Microsoft.Insights/components', 'myApplication')]"
          ],
          "properties": {
            "name": "longdependencyduration",
            "sendEmailsToSubscriptionOwners": true,
            "customEmails": [],
            "enabled": false
          }
        }
      ]
    }

スマート検出ルールの電子メール通知の送信を無効にするDisable sending email notifications for a smart detection rule

{
      "apiVersion": "2018-05-01-preview",
      "name": "myApplication",
      "type": "Microsoft.Insights/components",
      "location": "[resourceGroup().location]",
      "properties": {
        "Application_Type": "web"
      },
      "resources": [
        {
          "apiVersion": "2018-05-01-preview",
          "name": "longdependencyduration",
          "type": "ProactiveDetectionConfigs",
          "location": "[resourceGroup().location]",
          "dependsOn": [
            "[resourceId('Microsoft.Insights/components', 'myApplication')]"
          ],
          "properties": {
            "name": "longdependencyduration",
            "sendEmailsToSubscriptionOwners": false,
            "customEmails": [],
            "enabled": true
          }
        }
      ]
    }

スマート検出ルールに対して電子メール受信者を追加するAdd additional email recipients for a smart detection rule

{
      "apiVersion": "2018-05-01-preview",
      "name": "myApplication",
      "type": "Microsoft.Insights/components",
      "location": "[resourceGroup().location]",
      "properties": {
        "Application_Type": "web"
      },
      "resources": [
        {
          "apiVersion": "2018-05-01-preview",
          "name": "longdependencyduration",
          "type": "ProactiveDetectionConfigs",
          "location": "[resourceGroup().location]",
          "dependsOn": [
            "[resourceId('Microsoft.Insights/components', 'myApplication')]"
          ],
          "properties": {
            "name": "longdependencyduration",
            "sendEmailsToSubscriptionOwners": true,
            "customEmails": ["alice@contoso.com", "bob@contoso.com"],
            "enabled": true
          }
        }
      ]
    }

スマート検出ルール名Smart detection rule names

Azure Resource Manager テンプレートで使用する必要がある、ポータルに表示されるスマート検出ルール名とその内部名の表を次に示します。Below is a table of smart detection rule names as they appear in the portal, along with their internal names, that should be used in the Azure Resource Manager template.

注意

プレビュー としてマークされているスマート検出ルールでは、メール通知がサポートされません。Smart detection rules marked as preview don’t support email notifications. そのため、これらのルールに対して 有効な プロパティのみを設定できます。Therefore, you can only set the enabled property for these rules.

Azure portal ルール名Azure portal rule name 内部名Internal name
ページの読み込み速度が遅いSlow page load time slowpageloadtimeslowpageloadtime
サーバーの応答速度が遅いSlow server response time slowserverresponsetimeslowserverresponsetime
依存関係の期間が長いLong dependency duration longdependencydurationlongdependencyduration
サーバー応答速度の低下Degradation in server response time degradationinserverresponsetimedegradationinserverresponsetime
依存関係の期間の減少Degradation in dependency duration degradationindependencydurationdegradationindependencyduration
トレースの重大度の比率の低下 (プレビュー)Degradation in trace severity ratio (preview) extension_traceseveritydetectorextension_traceseveritydetector
例外数の異常な上昇 (プレビュー)Abnormal rise in exception volume (preview) extension_exceptionchangeextensionextension_exceptionchangeextension
Potential memory leak detected (潜在的なメモリ リークの検出) (プレビュー)Potential memory leak detected (preview) extension_memoryleakextensionextension_memoryleakextension
Potential security issue detected (潜在的なセキュリティの問題の検出) (プレビュー)Potential security issue detected (preview) extension_securityextensionspackageextension_securityextensionspackage
日次データ ボリュームの異常な上昇 (プレビュー)Abnormal rise in daily data volume (preview) extension_billingdatavolumedailyspikeextensionextension_billingdatavolumedailyspikeextension

失敗の異常の警告ルールFailure Anomalies alert rule

この Azure Resource Manager テンプレートでは、重大度が 2 の失敗の異常警告ルールの構成について示しています。This Azure Resource Manager template demonstrates configuring a Failure Anomalies alert rule with a severity of 2. この新しいバージョンのエラーの異常のアラート ルールは、新しい Azure のアラート プラットフォームの一部であり、従来のアラートの回収プロセスの一環として廃止される従来のバージョンに置き換わります。This new version of the Failure Anomalies alert rule is part of the new Azure alerting platform, and replaces the classic version that is being retired as part of the classic alerts retirement process.

注意

失敗の異常はグローバル サービスであるため、ルールはグローバルな場所に作成されます。Failure Anomalies is a global service therefore rule location is created on the global location.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "type": "microsoft.alertsmanagement/smartdetectoralertrules",
            "apiVersion": "2019-03-01",
            "name": "Failure Anomalies - my-app",
            "location": "global", 
            "properties": {
                  "description": "Failure Anomalies notifies you of an unusual rise in the rate of failed HTTP requests or dependency calls.",
                  "state": "Enabled",
                  "severity": "2",
                  "frequency": "PT1M",
                  "detector": {
                  "id": "FailureAnomaliesDetector"
                  },
                  "scope": ["/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyResourceGroup/providers/microsoft.insights/components/my-app"],
                  "actionGroups": {
                        "groupIds": ["/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/MyResourceGroup/providers/microsoft.insights/actiongroups/MyActionGroup"]
                  }
            }
        }
    ]
}

注意

この Azure Resource Manager テンプレートは、失敗の異常の警告ルールに固有のものであり、この記事で説明されている他の従来のスマート検出ルールとは異なります。This Azure Resource Manager template is unique to the Failure Anomalies alert rule and is different from the other classic Smart Detection rules described in this article. 失敗の異常を手動で管理したい場合は、Azure Monitor アラートで行います。他のすべてのスマート検出ルールは、UI の [スマート検出] ウィンドウで管理されます。If you want to manage Failure Anomalies manually this is done in Azure Monitor Alerts whereas all other Smart Detection rules are managed in the Smart Detection pane of the UI.

次の手順Next Steps

自動検出の詳細を確認します。Learn more about automatically detecting: