Administración de reglas de detección inteligente de Application Insights con plantillas de Azure Resource Manager

  • Artículo

Nota

Puede mirar sus recursos de Application Insight a la detección inteligente basada en alertas (versión preliminar). La migración crea reglas de alerta para los distintos módulos de detección inteligente. Después de crear las reglas, podrá administrarlas y configurarlas como cualquier otra regla de alertas de Azure Monitor. También puede configurar grupos de acciones para estas reglas, lo que habilita varios métodos para realizar acciones o desencadenar notificaciones en nuevas detecciones.

Para obtener más información sobre el proceso de migración y el comportamiento de la detección inteligente después de la migración, consulte Migración de alertas de detección inteligente.

Puede administrar y configurar las reglas de detección inteligente de Application Insights con plantillas de Azure Resource Manager.

Use este método cuando implemente nuevos recursos de Application Insights con la automatización de Resource Manager o cuando modifique la configuración de los recursos actuales.

Configuración de una regla de detección inteligente

Puede configurar los siguientes valores en una regla de detección inteligente:

  • Si la regla está habilitada. (El valor predeterminado es verdadero).
  • Si no se debieran enviar correos electrónicos a los usuarios asociados con los roles Lector de supervisión y Colaborador de supervisión cuando se encuentre una detección. (El valor predeterminado es verdadero).
  • Los destinatarios de otros correos electrónicos que deben recibir una notificación cuando se encuentre una detección.
    • La configuración de correo electrónico no está disponible para las reglas de detección inteligente marcadas como versión preliminar.

Para permitir la configuración de los valores de regla a través de Resource Manager, la configuración de reglas de detección inteligente está disponible como recurso interno en el recurso de Application Insights. Se denomina ProactiveDetectionConfigs.

Para obtener la máxima flexibilidad, es posible configurar cada regla de detección inteligente con valores de notificación únicos.

Ejemplos

Los siguientes ejemplos muestran cómo configurar los valores de reglas de detección inteligente mediante plantillas de Resource Manager.

Todos los ejemplos hacen referencia a un recurso de Application Insights denominado "myApplication". También hacen referencia a la "regla de detección inteligente de larga duración de dependencias". Se denomina "longdependencyduration" internamente.

Asegúrese de reemplazar el nombre de recurso de Application Insights y de especificar el nombre interno de la regla de detección inteligente pertinente. En la tabla siguiente, busque una lista de los nombres internos de Resource Manager correspondientes a cada regla de detección inteligente.

Deshabilitación de una regla de detección inteligente

{
      "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
          }
        }
      ]
    }

Deshabilitación del envío de notificaciones por correo electrónico para una regla de detección inteligente

{
      "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
          }
        }
      ]
    }

Añadir más destinatarios de correo electrónico a una regla de detección inteligente

{
      "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
          }
        }
      ]
    }

Nombres de regla de detección inteligente

En la tabla siguiente, se muestran los nombres de las reglas de detección inteligente a medida que aparecen en el portal. La tabla también muestra sus nombres internos que se usarán en la plantilla de Resource Manager.

Nota

Las reglas de detección inteligente marcadas como de versión preliminar no admiten notificaciones por correo electrónico. Solo se puede establecer la propiedad habilitada para estas reglas.

Nombre de regla de Azure Portal Nombre interno
Carga lenta de página slowpageloadtime
Lentitud en el tiempo de respuesta del servidor slowserverresponsetime
Duración de la dependencia prolongada longdependencyduration
Degradación del tiempo de respuesta del servidor degradationinserverresponsetime
Reducción de la duración de la dependencia degradationindependencyduration
Degradación en la relación de gravedad de seguimiento (versión preliminar) extension_traceseveritydetector
Aumento anormal del volumen de excepciones (versión preliminar) extension_exceptionchangeextension
Detección de una posible fuga de memoria (versión preliminar) extension_memoryleakextension
Detección de un posible problema de seguridad (versión preliminar) extension_securityextensionspackage
Aumento anómalo del volumen de datos diario (versión preliminar) extension_billingdatavolumedailyspikeextension

Regla de alertas Anomalías de errores

Esta plantilla de Resource Manager muestra cómo configurar una regla de alertas de anomalías de errores con una gravedad de 2.

Nota

Las anomalías de errores son un servicio global, por lo que la ubicación de la regla se creará en la ubicación global.

{
    "$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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/MyResourceGroup/providers/microsoft.insights/components/my-app"],
                  "actionGroups": {
                        "groupIds": ["/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/MyResourceGroup/providers/microsoft.insights/actiongroups/MyActionGroup"]
                  }
            }
        }
    ]
}

Nota

Esta plantilla de Resource Manager es única para la regla de alertas de anomalías en los errores y es distinta de las otras reglas clásicas de detección inteligente que se describen en este artículo. Si desea administrar manualmente anomalías de errores, use alertas de Azure Monitor. Todas las demás reglas de detección inteligente se administran en el panel Detección inteligente de la interfaz de usuario.

Pasos siguientes

Más información sobre la detección automática: