Dela via


Microsoft.Insights diagnosticSettings 2021-05-01-preview

Anmärkningar

Information om hur du distribuerar övervakningslösningar finns i Skapa övervakningsresurser med hjälp av Bicep.

Bicep-resursdefinition

Resurstypen diagnosticSettings kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Insights/diagnosticSettings-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
  scope: resourceSymbolicName or scope
  name: 'string'
  properties: {
    eventHubAuthorizationRuleId: 'string'
    eventHubName: 'string'
    logAnalyticsDestinationType: 'string'
    logs: [
      {
        category: 'string'
        categoryGroup: 'string'
        enabled: bool
        retentionPolicy: {
          days: int
          enabled: bool
        }
      }
    ]
    marketplacePartnerId: 'string'
    metrics: [
      {
        category: 'string'
        enabled: bool
        retentionPolicy: {
          days: int
          enabled: bool
        }
        timeGrain: 'string'
      }
    ]
    serviceBusRuleId: 'string'
    storageAccountId: 'string'
    workspaceId: 'string'
  }
}

Egenskapsvärden

DiagnostikInställningar

Namn Beskrivning Värde
eventHubAuthorizationRuleId Resurs-ID:t för händelsehubbens auktoriseringsregel. sträng
eventHubName Namnet på händelsehubben. Om inget anges väljs standardhändelsehubben. sträng
logAnalyticsDestinationType En sträng som anger om exporten till Log Analytics ska använda standardmåltypen, t.ex. AzureDiagnostics, eller använda en måltyp som konstruerats på följande sätt: <normaliserad tjänstidentitet>_<normaliserat kategorinamn>. Möjliga värden är: Dedikerad och null (null är standard.) sträng
Loggar Listan över logginställningar. LogSettings[]
marketplacePartnerId Det fullständiga ARM-resurs-ID:t för Marketplace-resursen som du vill skicka diagnostikloggar till. sträng
metrik Listan över måttinställningar. MetricSettings[]
serviceBusRuleId Service Bus-regel-ID för diagnostikinställningen. Detta är här för att upprätthålla bakåtkompatibilitet. sträng
storageAccountId Resurs-ID för lagringskontot som du vill skicka diagnostikloggar till. sträng
workspaceId Det fullständiga ARM-resurs-ID:t för Log Analytics-arbetsytan som du vill skicka diagnostikloggar till. Exempel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2 sträng

LogSettings

Namn Beskrivning Värde
kategori Namnet på en kategori för diagnostikloggar för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över kategorier för diagnostikloggar för en resurs utför du först en get-diagnostikinställningsåtgärd. sträng
categoryGroup Namnet på en kategorigrupp för diagnostikloggar för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över kategorier för diagnostikloggar för en resurs utför du först en get-diagnostikinställningsåtgärd. sträng
Aktiverat ett värde som anger om loggen är aktiverad. bool (krävs)
retentionPolicy kvarhållningsprincipen för den här loggen. RetentionPolicy

MetricSettings

Namn Beskrivning Värde
kategori Namnet på en kategori för diagnostikmått för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över diagnostikmåttkategorier för en resurs utför du först en get-diagnostikinställningsåtgärd. sträng
Aktiverat ett värde som anger om den här kategorin är aktiverad. bool (krävs)
retentionPolicy kvarhållningsprincipen för den här kategorin. RetentionPolicy
timeGrain måttets tidsintervall i ISO8601 format. sträng

Microsoft.Insights/diagnosticSettings

Namn Beskrivning Värde
Namn Resursnamnet sträng (krävs)
Egenskaper Egenskaper för en resurs för diagnostikinställningar. DiagnosticSettings
omfattning Använd när du skapar en resurs i ett annat omfång än distributionsomfånget. Ange den här egenskapen till det symboliska namnet på en resurs för att tillämpa -tilläggsresursen.

RetentionPolicy

Namn Beskrivning Värde
Dagar antalet dagar för kvarhållningen i dagar. Värdet 0 behåller händelserna på obestämd tid. Int

Begränsningar:
Minsta värde = 0 (krävs)
Aktiverat ett värde som anger om kvarhållningsprincipen är aktiverad. bool (krävs)

Snabbstartsexempel

Följande snabbstartsexempel distribuerar den här resurstypen.

Bicep-fil Beskrivning
AKS-kluster med en NAT Gateway och en Application Gateway- Det här exemplet visar hur du distribuerar ett AKS-kluster med NAT Gateway för utgående anslutningar och en Application Gateway för inkommande anslutningar.
AKS-kluster med Application Gateway-ingresskontrollanten Det här exemplet visar hur du distribuerar ett AKS-kluster med Application Gateway, Application Gateway Ingress Controller, Azure Container Registry, Log Analytics och Key Vault
Application Gateway med intern API Management och Web App Application Gateway dirigerar Internettrafik till en API Management-instans för virtuellt nätverk (internt läge) som servar ett webb-API som finns i en Azure-webbapp.
Application Gateway med WAF och brandväggsprincip Den här mallen skapar en Application Gateway med WAF konfigurerad tillsammans med en brandväggsprincip
Azure Container Registry med principer och diagnostik Azure Container Registry med principer och diagnostik (bicep)
Azure Data Factory med Git och konfiguration av hanterade virtuella nätverk Den här mallen skapar Azure Data Factory med Git-konfiguration och hanterat virtuellt nätverk.
Azure Game Developer Virtual Machine Azure Game Developer Virtual Machine innehåller Licencsed-motorer som Unreal.
Azure SQL Server med granskning skriven till Log Analytics Med den här mallen kan du distribuera en Azure SQL-server med Granskning aktiverat för att skriva granskningsloggar till Log Analytics (OMS-arbetsyta)
Skapa en Premium Redis Cache med klustring Den här mallen visar hur du konfigurerar klustring i en Premium Azure Redis Cache-instans.
Skapa en Redis Cache med hjälp av en mall Den här mallen skapar en Azure Redis Cache med diagnostikdata som lagras på ett lagringskonto.
Skapa API Management i internt VNet med App Gateway Den här mallen visar hur du skapar en instans av Azure API Management i ett privat nätverk som skyddas av Azure Application Gateway.
Skapa nyckelvalv med loggning aktiverat Den här mallen skapar ett Azure Key Vault och ett Azure Storage-konto som används för loggning. Du kan också skapa resurslås för att skydda dina Key Vault- och lagringsresurser.
Skapa Premium Redis Cache med Den här mallen visar hur du konfigurerar beständighet i en Premium Azure Redis Cache-instans.
Skapa Recovery Services-valv och aktivera diagnostik Den här mallen skapar ett Recovery Services-valv och aktiverar diagnostik för Azure Backup. Detta distribuerar även lagringskonto och oms-arbetsyta.
Skapa Recovery Services-valv med säkerhetskopieringsprinciper Den här mallen skapar ett Recovery Services-valv med säkerhetskopieringsprinciper och konfigurerar valfria funktioner som systemidentitet, lagringstyp för säkerhetskopiering, återställning mellan regioner och diagnostikloggar och ett borttagningslås.
Distribuera ett enkelt Azure Spring Apps-mikrotjänstprogram Den här mallen distribuerar ett enkelt Azure Spring Apps-mikrotjänstprogram som ska köras i Azure.
Distribuera säker Azure AI Studio med ett hanterat virtuellt nätverk Den här mallen skapar en säker Azure AI Studio-miljö med robusta nätverks- och identitetssäkerhetsbegränsningar.
Front Door Premium med WAF- och Microsoft-hanterade regeluppsättningar Den här mallen skapar en Front Door Premium inklusive en brandvägg för webbprogram med Microsoft-hanterade standard- och botskyddsregeluppsättningar.
Front Door Standard/Premium med WAF och anpassad regel Den här mallen skapar en Front Door Standard/Premium inklusive en brandvägg för webbprogram med en anpassad regel.
FrontDoor CDN med WAF, domäner och loggar till EventHub Den här mallen skapar en ny Azure FrontDoor cdn-profil. Skapa WAF med anpassade och hanterade regler, cdn-vägar, ursprung och grupper med deras koppling till WAF och vägar, konfigurerar anpassade domäner, skapar händelsehubb och diagnostikinställningar för att skicka CDN-åtkomstloggar med hjälp av händelsehubben.
Log Analytics-arbetsyta med lösningar och datakällor Distribuerar en Log Analytics-arbetsyta med angivna lösningar och datakällor
Log Analytics-arbetsyta med VM Insights, Container Insights Distribuerar en Log Analytics-arbetsyta med VM Insights, Container Insights-lösningar och diagnostik.
nätverkssäkerhetsgrupp med diagnostikloggar Den här mallen skapar en nätverkssäkerhetsgrupp med diagnostikloggar och ett resurslås
Använda Azure Firewall som EN DNS-proxy i en Topologi för Hub & Spoke Det här exemplet visar hur du distribuerar en hub-spoke-topologi i Azure med hjälp av Azure Firewall. Det virtuella hubbnätverket fungerar som en central anslutningspunkt för många virtuella ekernätverk som är anslutna till det virtuella hubbnätverket via peering för virtuella nätverk.
virtuellt nätverk med diagnostikloggar Den här mallen skapar ett virtuellt nätverk med diagnostikloggar och gör att valfria funktioner kan läggas till i varje undernät

Resursdefinition för ARM-mall

Resurstypen diagnosticSettings kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Insights/diagnosticSettings-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.Insights/diagnosticSettings",
  "apiVersion": "2021-05-01-preview",
  "name": "string",
  "properties": {
    "eventHubAuthorizationRuleId": "string",
    "eventHubName": "string",
    "logAnalyticsDestinationType": "string",
    "logs": [
      {
        "category": "string",
        "categoryGroup": "string",
        "enabled": "bool",
        "retentionPolicy": {
          "days": "int",
          "enabled": "bool"
        }
      }
    ],
    "marketplacePartnerId": "string",
    "metrics": [
      {
        "category": "string",
        "enabled": "bool",
        "retentionPolicy": {
          "days": "int",
          "enabled": "bool"
        },
        "timeGrain": "string"
      }
    ],
    "serviceBusRuleId": "string",
    "storageAccountId": "string",
    "workspaceId": "string"
  }
}

Egenskapsvärden

DiagnostikInställningar

Namn Beskrivning Värde
eventHubAuthorizationRuleId Resurs-ID:t för händelsehubbens auktoriseringsregel. sträng
eventHubName Namnet på händelsehubben. Om inget anges väljs standardhändelsehubben. sträng
logAnalyticsDestinationType En sträng som anger om exporten till Log Analytics ska använda standardmåltypen, t.ex. AzureDiagnostics, eller använda en måltyp som konstruerats på följande sätt: <normaliserad tjänstidentitet>_<normaliserat kategorinamn>. Möjliga värden är: Dedikerad och null (null är standard.) sträng
Loggar Listan över logginställningar. LogSettings[]
marketplacePartnerId Det fullständiga ARM-resurs-ID:t för Marketplace-resursen som du vill skicka diagnostikloggar till. sträng
metrik Listan över måttinställningar. MetricSettings[]
serviceBusRuleId Service Bus-regel-ID för diagnostikinställningen. Detta är här för att upprätthålla bakåtkompatibilitet. sträng
storageAccountId Resurs-ID för lagringskontot som du vill skicka diagnostikloggar till. sträng
workspaceId Det fullständiga ARM-resurs-ID:t för Log Analytics-arbetsytan som du vill skicka diagnostikloggar till. Exempel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2 sträng

LogSettings

Namn Beskrivning Värde
kategori Namnet på en kategori för diagnostikloggar för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över kategorier för diagnostikloggar för en resurs utför du först en get-diagnostikinställningsåtgärd. sträng
categoryGroup Namnet på en kategorigrupp för diagnostikloggar för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över kategorier för diagnostikloggar för en resurs utför du först en get-diagnostikinställningsåtgärd. sträng
Aktiverat ett värde som anger om loggen är aktiverad. bool (krävs)
retentionPolicy kvarhållningsprincipen för den här loggen. RetentionPolicy

MetricSettings

Namn Beskrivning Värde
kategori Namnet på en kategori för diagnostikmått för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över diagnostikmåttkategorier för en resurs utför du först en get-diagnostikinställningsåtgärd. sträng
Aktiverat ett värde som anger om den här kategorin är aktiverad. bool (krävs)
retentionPolicy kvarhållningsprincipen för den här kategorin. RetentionPolicy
timeGrain måttets tidsintervall i ISO8601 format. sträng

Microsoft.Insights/diagnosticSettings

Namn Beskrivning Värde
apiVersion API-versionen "2021-05-01-preview"
Namn Resursnamnet sträng (krävs)
Egenskaper Egenskaper för en resurs för diagnostikinställningar. DiagnosticSettings
typ Resurstypen "Microsoft.Insights/diagnosticSettings"

RetentionPolicy

Namn Beskrivning Värde
Dagar antalet dagar för kvarhållningen i dagar. Värdet 0 behåller händelserna på obestämd tid. Int

Begränsningar:
Minsta värde = 0 (krävs)
Aktiverat ett värde som anger om kvarhållningsprincipen är aktiverad. bool (krävs)

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Beskrivning
AKS-kluster med en NAT Gateway och en Application Gateway-

Distribuera till Azure
Det här exemplet visar hur du distribuerar ett AKS-kluster med NAT Gateway för utgående anslutningar och en Application Gateway för inkommande anslutningar.
AKS-kluster med Application Gateway-ingresskontrollanten

Distribuera till Azure
Det här exemplet visar hur du distribuerar ett AKS-kluster med Application Gateway, Application Gateway Ingress Controller, Azure Container Registry, Log Analytics och Key Vault
Application Gateway med intern API Management och Web App

Distribuera till Azure
Application Gateway dirigerar Internettrafik till en API Management-instans för virtuellt nätverk (internt läge) som servar ett webb-API som finns i en Azure-webbapp.
Application Gateway med WAF och brandväggsprincip

Distribuera till Azure
Den här mallen skapar en Application Gateway med WAF konfigurerad tillsammans med en brandväggsprincip
Azure Container Registry med principer och diagnostik

Distribuera till Azure
Azure Container Registry med principer och diagnostik (bicep)
Azure Data Factory med Git och konfiguration av hanterade virtuella nätverk

Distribuera till Azure
Den här mallen skapar Azure Data Factory med Git-konfiguration och hanterat virtuellt nätverk.
Azure Game Developer Virtual Machine

Distribuera till Azure
Azure Game Developer Virtual Machine innehåller Licencsed-motorer som Unreal.
Azure SQL Server med granskning skriven till Log Analytics

Distribuera till Azure
Med den här mallen kan du distribuera en Azure SQL-server med Granskning aktiverat för att skriva granskningsloggar till Log Analytics (OMS-arbetsyta)
Skapa en Premium Redis Cache med klustring

Distribuera till Azure
Den här mallen visar hur du konfigurerar klustring i en Premium Azure Redis Cache-instans.
Skapa en Redis Cache med hjälp av en mall

Distribuera till Azure
Den här mallen skapar en Azure Redis Cache med diagnostikdata som lagras på ett lagringskonto.
Skapa API Management i internt VNet med App Gateway

Distribuera till Azure
Den här mallen visar hur du skapar en instans av Azure API Management i ett privat nätverk som skyddas av Azure Application Gateway.
Skapa nyckelvalv med loggning aktiverat

Distribuera till Azure
Den här mallen skapar ett Azure Key Vault och ett Azure Storage-konto som används för loggning. Du kan också skapa resurslås för att skydda dina Key Vault- och lagringsresurser.
Skapa Premium Redis Cache med

Distribuera till Azure
Den här mallen visar hur du konfigurerar beständighet i en Premium Azure Redis Cache-instans.
Skapa Recovery Services-valv och aktivera diagnostik

Distribuera till Azure
Den här mallen skapar ett Recovery Services-valv och aktiverar diagnostik för Azure Backup. Detta distribuerar även lagringskonto och oms-arbetsyta.
Skapa Recovery Services-valv med säkerhetskopieringsprinciper

Distribuera till Azure
Den här mallen skapar ett Recovery Services-valv med säkerhetskopieringsprinciper och konfigurerar valfria funktioner som systemidentitet, lagringstyp för säkerhetskopiering, återställning mellan regioner och diagnostikloggar och ett borttagningslås.
Skapa SQL MI med konfigurerad sändning av loggar och mått

Distribuera till Azure
Med den här mallen kan du distribuera SQL MI och ytterligare resurser som används för att lagra loggar och mått (diagnostikarbetsyta, lagringskonto, händelsehubb).
Distribuera ett enkelt Azure Spring Apps-mikrotjänstprogram

Distribuera till Azure
Den här mallen distribuerar ett enkelt Azure Spring Apps-mikrotjänstprogram som ska köras i Azure.
Distribuera säker Azure AI Studio med ett hanterat virtuellt nätverk

Distribuera till Azure
Den här mallen skapar en säker Azure AI Studio-miljö med robusta nätverks- och identitetssäkerhetsbegränsningar.
Front Door Premium med WAF- och Microsoft-hanterade regeluppsättningar

Distribuera till Azure
Den här mallen skapar en Front Door Premium inklusive en brandvägg för webbprogram med Microsoft-hanterade standard- och botskyddsregeluppsättningar.
Front Door Standard/Premium med WAF och anpassad regel

Distribuera till Azure
Den här mallen skapar en Front Door Standard/Premium inklusive en brandvägg för webbprogram med en anpassad regel.
FrontDoor CDN med WAF, domäner och loggar till EventHub

Distribuera till Azure
Den här mallen skapar en ny Azure FrontDoor cdn-profil. Skapa WAF med anpassade och hanterade regler, cdn-vägar, ursprung och grupper med deras koppling till WAF och vägar, konfigurerar anpassade domäner, skapar händelsehubb och diagnostikinställningar för att skicka CDN-åtkomstloggar med hjälp av händelsehubben.
Log Analytics-arbetsyta med lösningar och datakällor

Distribuera till Azure
Distribuerar en Log Analytics-arbetsyta med angivna lösningar och datakällor
Log Analytics-arbetsyta med VM Insights, Container Insights

Distribuera till Azure
Distribuerar en Log Analytics-arbetsyta med VM Insights, Container Insights-lösningar och diagnostik.
nätverkssäkerhetsgrupp med diagnostikloggar

Distribuera till Azure
Den här mallen skapar en nätverkssäkerhetsgrupp med diagnostikloggar och ett resurslås
Använda Azure Firewall som EN DNS-proxy i en Topologi för Hub & Spoke

Distribuera till Azure
Det här exemplet visar hur du distribuerar en hub-spoke-topologi i Azure med hjälp av Azure Firewall. Det virtuella hubbnätverket fungerar som en central anslutningspunkt för många virtuella ekernätverk som är anslutna till det virtuella hubbnätverket via peering för virtuella nätverk.
virtuellt nätverk med diagnostikloggar

Distribuera till Azure
Den här mallen skapar ett virtuellt nätverk med diagnostikloggar och gör att valfria funktioner kan läggas till i varje undernät

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen diagnosticSettings kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.Insights/diagnosticSettings-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Insights/diagnosticSettings@2021-05-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      eventHubAuthorizationRuleId = "string"
      eventHubName = "string"
      logAnalyticsDestinationType = "string"
      logs = [
        {
          category = "string"
          categoryGroup = "string"
          enabled = bool
          retentionPolicy = {
            days = int
            enabled = bool
          }
        }
      ]
      marketplacePartnerId = "string"
      metrics = [
        {
          category = "string"
          enabled = bool
          retentionPolicy = {
            days = int
            enabled = bool
          }
          timeGrain = "string"
        }
      ]
      serviceBusRuleId = "string"
      storageAccountId = "string"
      workspaceId = "string"
    }
  })
}

Egenskapsvärden

DiagnostikInställningar

Namn Beskrivning Värde
eventHubAuthorizationRuleId Resurs-ID:t för händelsehubbens auktoriseringsregel. sträng
eventHubName Namnet på händelsehubben. Om inget anges väljs standardhändelsehubben. sträng
logAnalyticsDestinationType En sträng som anger om exporten till Log Analytics ska använda standardmåltypen, t.ex. AzureDiagnostics, eller använda en måltyp som konstruerats på följande sätt: <normaliserad tjänstidentitet>_<normaliserat kategorinamn>. Möjliga värden är: Dedikerad och null (null är standard.) sträng
Loggar Listan över logginställningar. LogSettings[]
marketplacePartnerId Det fullständiga ARM-resurs-ID:t för Marketplace-resursen som du vill skicka diagnostikloggar till. sträng
metrik Listan över måttinställningar. MetricSettings[]
serviceBusRuleId Service Bus-regel-ID för diagnostikinställningen. Detta är här för att upprätthålla bakåtkompatibilitet. sträng
storageAccountId Resurs-ID för lagringskontot som du vill skicka diagnostikloggar till. sträng
workspaceId Det fullständiga ARM-resurs-ID:t för Log Analytics-arbetsytan som du vill skicka diagnostikloggar till. Exempel: /subscriptions/4b9e8510-67ab-4e9a-95a9-e2f1e570ea9c/resourceGroups/insights-integration/providers/Microsoft.OperationalInsights/workspaces/viruela2 sträng

LogSettings

Namn Beskrivning Värde
kategori Namnet på en kategori för diagnostikloggar för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över kategorier för diagnostikloggar för en resurs utför du först en get-diagnostikinställningsåtgärd. sträng
categoryGroup Namnet på en kategorigrupp för diagnostikloggar för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över kategorier för diagnostikloggar för en resurs utför du först en get-diagnostikinställningsåtgärd. sträng
Aktiverat ett värde som anger om loggen är aktiverad. bool (krävs)
retentionPolicy kvarhållningsprincipen för den här loggen. RetentionPolicy

MetricSettings

Namn Beskrivning Värde
kategori Namnet på en kategori för diagnostikmått för en resurstyp som den här inställningen tillämpas på. Om du vill hämta listan över diagnostikmåttkategorier för en resurs utför du först en get-diagnostikinställningsåtgärd. sträng
Aktiverat ett värde som anger om den här kategorin är aktiverad. bool (krävs)
retentionPolicy kvarhållningsprincipen för den här kategorin. RetentionPolicy
timeGrain måttets tidsintervall i ISO8601 format. sträng

Microsoft.Insights/diagnosticSettings

Namn Beskrivning Värde
Namn Resursnamnet sträng (krävs)
parent_id ID:t för resursen som den här tilläggsresursen ska tillämpas på. sträng (krävs)
Egenskaper Egenskaper för en resurs för diagnostikinställningar. DiagnosticSettings
typ Resurstypen "Microsoft.Insights/diagnosticSettings@2021-05-01-preview"

RetentionPolicy

Namn Beskrivning Värde
Dagar antalet dagar för kvarhållningen i dagar. Värdet 0 behåller händelserna på obestämd tid. Int

Begränsningar:
Minsta värde = 0 (krävs)
Aktiverat ett värde som anger om kvarhållningsprincipen är aktiverad. bool (krävs)