Partilhar via


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.

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' = {
  scope: resourceSymbolicName or scope
  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 Localização do recurso string (obrigatório)
Designação O nome do recurso string (obrigatório)
propriedades As propriedades do perfil de log do recurso. LogProfileProperties (obrigatório)
âmbito Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
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. RetentionPolicy (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)

Tags de Recursos

Designação Descrição Valor

Política de retenção

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)

Definição de recurso de modelo ARM

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.

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 Localização do recurso 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. RetentionPolicy (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)

Tags de Recursos

Designação Descrição Valor

Política de retenção

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)

Exemplos de uso

Definição de recursos Terraform (provedor AzAPI)

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.

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 Localização do recurso string (obrigatório)
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. 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. RetentionPolicy (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)

Tags de Recursos

Designação Descrição Valor

Política de retenção

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)

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    = ["*"]
}