Perfis de log do Microsoft.Insights

Definição de recursos do bíceps

O tipo de recurso logprofiles pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Exemplos de uso

Amostras do Bicep

Um exemplo básico de implantação de perfis de log do Insights.

targetScope = 'subscription'

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource resourceGroup 'Microsoft.Resources/resourceGroups@2020-06-01' = {
  name: resourceName
  location: location
}

resource logProfile 'Microsoft.Insights/logProfiles@2016-03-01' = {
  name: resourceName
  properties: {
    categories: [
      'Action'
    ]
    locations: [
      'westeurope'
      'westeurope'
    ]
    retentionPolicy: {
      days: 7
      enabled: true
    }
    storageAccountId: module1.outputs.storageAccountId
  }
}

module module1 'main-rg-module.bicep' = {
  name: 'deploy-rg-resources'
  scope: resourceGroup
  params: {
    resourceName: resourceName
    location: location
  }
}

Um exemplo básico de implantação de perfis de log do Insights.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard_GRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
    allowBlobPublicAccess: true
    allowCrossTenantReplication: true
    allowSharedKeyAccess: true
    defaultToOAuthAuthentication: false
    encryption: {
      keySource: 'Microsoft.Storage'
      services: {
        queue: {
          keyType: 'Service'
        }
        table: {
          keyType: 'Service'
        }
      }
    }
    isHnsEnabled: false
    isNfsV3Enabled: false
    isSftpEnabled: false
    minimumTlsVersion: 'TLS1_2'
    networkAcls: {
      defaultAction: 'Allow'
    }
    publicNetworkAccess: 'Enabled'
    supportsHttpsTrafficOnly: true
  }
}

// Module outputs for cross-scope references
output storageAccountId string = storageAccount.id

Formato do recurso

Para criar um recurso Microsoft.Insights/logprofiles, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Insights/logprofiles@2016-03-01' = {
  location: 'string'
  name: 'string'
  properties: {
    categories: [
      'string'
    ]
    locations: [
      'string'
    ]
    retentionPolicy: {
      days: int
      enabled: bool
    }
    serviceBusRuleId: 'string'
    storageAccountId: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

Microsoft.Insights/logprofiles

Designação Descrição Valor
localização A geolocalização onde o recurso vive string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades As propriedades do perfil de log do recurso. LogProfileProperties (obrigatório)
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

LogProfileProperties

Designação Descrição Valor
Categorias as categorias dos logs. Essas categorias são criadas conforme for conveniente para o usuário. Alguns valores são: 'Gravar', 'Excluir' e/ou 'Ação'. string[] (obrigatório)
Locais Lista de regiões para as quais os eventos do Log de Atividades devem ser armazenados ou transmitidos. É uma lista separada por vírgulas de locais ARM válidos, incluindo o local 'global'. string[] (obrigatório)
retençãoPolítica A política de retenção para os eventos no log. MicrosoftCommonRetentionPolicy (obrigatório)
serviceBusRuleId A ID da regra do barramento de serviço do namespace do barramento de serviço no qual você gostaria de ter Hubs de Eventos criados para transmitir o Log de Atividades. O ID da regra tem o formato: '{service bus resource ID}/authorizationrules/{key name}'. cadeia (de caracteres)
storageAccountId o ID do recurso da conta de armazenamento para a qual você deseja enviar o Registro de atividades. cadeia (de caracteres)

MicrosoftCommonRetentionPolicy

Designação Descrição Valor
Dias o número de dias para a retenção em dias. Um valor de 0 reterá os eventos indefinidamente. Int

Restrições:
Valor mínimo = 0 (obrigatório)
ativado Um valor que indica se a política de retenção está habilitada. bool (obrigatório)

TrackedResourceTags

Designação Descrição Valor

Definição de recurso de modelo ARM

O tipo de recurso logprofiles pode ser implantado com operações direcionadas:

Exemplos de uso

Formato do recurso

Para criar um recurso Microsoft.Insights/logprofiles, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Insights/logprofiles",
  "apiVersion": "2016-03-01",
  "name": "string",
  "location": "string",
  "properties": {
    "categories": [ "string" ],
    "locations": [ "string" ],
    "retentionPolicy": {
      "days": "int",
      "enabled": "bool"
    },
    "serviceBusRuleId": "string",
    "storageAccountId": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

Microsoft.Insights/logprofiles

Designação Descrição Valor
Versão da API A versão api '2016-03-01'
localização A geolocalização onde o recurso vive string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades As propriedades do perfil de log do recurso. LogProfileProperties (obrigatório)
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.Insights/logprofiles'

LogProfileProperties

Designação Descrição Valor
Categorias as categorias dos logs. Essas categorias são criadas conforme for conveniente para o usuário. Alguns valores são: 'Gravar', 'Excluir' e/ou 'Ação'. string[] (obrigatório)
Locais Lista de regiões para as quais os eventos do Log de Atividades devem ser armazenados ou transmitidos. É uma lista separada por vírgulas de locais ARM válidos, incluindo o local 'global'. string[] (obrigatório)
retençãoPolítica A política de retenção para os eventos no log. MicrosoftCommonRetentionPolicy (obrigatório)
serviceBusRuleId A ID da regra do barramento de serviço do namespace do barramento de serviço no qual você gostaria de ter Hubs de Eventos criados para transmitir o Log de Atividades. O ID da regra tem o formato: '{service bus resource ID}/authorizationrules/{key name}'. cadeia (de caracteres)
storageAccountId o ID do recurso da conta de armazenamento para a qual você deseja enviar o Registro de atividades. cadeia (de caracteres)

MicrosoftCommonRetentionPolicy

Designação Descrição Valor
Dias o número de dias para a retenção em dias. Um valor de 0 reterá os eventos indefinidamente. Int

Restrições:
Valor mínimo = 0 (obrigatório)
ativado Um valor que indica se a política de retenção está habilitada. bool (obrigatório)

TrackedResourceTags

Designação Descrição Valor

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso logprofiles pode ser implantado com operações direcionadas:

Exemplos de uso

Amostras Terraform

Um exemplo básico de implantação de perfis de log do Insights.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "storageAccount" {
  type      = "Microsoft.Storage/storageAccounts@2021-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "StorageV2"
    properties = {
      accessTier                   = "Hot"
      allowBlobPublicAccess        = true
      allowCrossTenantReplication  = true
      allowSharedKeyAccess         = true
      defaultToOAuthAuthentication = false
      encryption = {
        keySource = "Microsoft.Storage"
        services = {
          queue = {
            keyType = "Service"
          }
          table = {
            keyType = "Service"
          }
        }
      }
      isHnsEnabled      = false
      isNfsV3Enabled    = false
      isSftpEnabled     = false
      minimumTlsVersion = "TLS1_2"
      networkAcls = {
        defaultAction = "Allow"
      }
      publicNetworkAccess      = "Enabled"
      supportsHttpsTrafficOnly = true
    }
    sku = {
      name = "Standard_GRS"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "logProfile" {
  type      = "Microsoft.Insights/logProfiles@2016-03-01"
  parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  name      = var.resource_name
  location  = ""
  body = {
    properties = {
      categories = [
        "Action",
      ]
      locations = [
        "westeurope",
        "westeurope",
      ]
      retentionPolicy = {
        days    = 7
        enabled = true
      }
      storageAccountId = azapi_resource.storageAccount.id
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Formato do recurso

Para criar um recurso Microsoft.Insights/logprofiles, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Insights/logprofiles@2016-03-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      categories = [
        "string"
      ]
      locations = [
        "string"
      ]
      retentionPolicy = {
        days = int
        enabled = bool
      }
      serviceBusRuleId = "string"
      storageAccountId = "string"
    }
  }
}

Valores de propriedade

Microsoft.Insights/logprofiles

Designação Descrição Valor
localização A geolocalização onde o recurso vive string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades As propriedades do perfil de log do recurso. LogProfileProperties (obrigatório)
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.Insights/logprofiles@2016-03-01"

LogProfileProperties

Designação Descrição Valor
Categorias as categorias dos logs. Essas categorias são criadas conforme for conveniente para o usuário. Alguns valores são: 'Gravar', 'Excluir' e/ou 'Ação'. string[] (obrigatório)
Locais Lista de regiões para as quais os eventos do Log de Atividades devem ser armazenados ou transmitidos. É uma lista separada por vírgulas de locais ARM válidos, incluindo o local 'global'. string[] (obrigatório)
retençãoPolítica A política de retenção para os eventos no log. MicrosoftCommonRetentionPolicy (obrigatório)
serviceBusRuleId A ID da regra do barramento de serviço do namespace do barramento de serviço no qual você gostaria de ter Hubs de Eventos criados para transmitir o Log de Atividades. O ID da regra tem o formato: '{service bus resource ID}/authorizationrules/{key name}'. cadeia (de caracteres)
storageAccountId o ID do recurso da conta de armazenamento para a qual você deseja enviar o Registro de atividades. cadeia (de caracteres)

MicrosoftCommonRetentionPolicy

Designação Descrição Valor
Dias o número de dias para a retenção em dias. Um valor de 0 reterá os eventos indefinidamente. Int

Restrições:
Valor mínimo = 0 (obrigatório)
ativado Um valor que indica se a política de retenção está habilitada. bool (obrigatório)

TrackedResourceTags

Designação Descrição Valor