Delen via


Microsoft.ApiManagement-service/apis/diagnostics

Bicep-resourcedefinitie

Het resourcetype service/apis/diagnostics kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource microsoft.ApiManagement/service/apis/diagnostics wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.ApiManagement/service/apis/diagnostics@2024-06-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    alwaysLog: 'string'
    backend: {
      request: {
        body: {
          bytes: int
        }
        dataMasking: {
          headers: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
          queryParams: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
        }
        headers: [
          'string'
        ]
      }
      response: {
        body: {
          bytes: int
        }
        dataMasking: {
          headers: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
          queryParams: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
        }
        headers: [
          'string'
        ]
      }
    }
    frontend: {
      request: {
        body: {
          bytes: int
        }
        dataMasking: {
          headers: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
          queryParams: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
        }
        headers: [
          'string'
        ]
      }
      response: {
        body: {
          bytes: int
        }
        dataMasking: {
          headers: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
          queryParams: [
            {
              mode: 'string'
              value: 'string'
            }
          ]
        }
        headers: [
          'string'
        ]
      }
    }
    httpCorrelationProtocol: 'string'
    largeLanguageModel: {
      logs: 'string'
      requests: {
        maxSizeInBytes: int
        messages: 'string'
      }
      responses: {
        maxSizeInBytes: int
        messages: 'string'
      }
    }
    logClientIp: bool
    loggerId: 'string'
    metrics: bool
    operationNameFormat: 'string'
    sampling: {
      percentage: int
      samplingType: 'string'
    }
    verbosity: 'string'
  }
}

Eigenschapswaarden

BodyDiagnosticSettings

Naam Beschrijving Waarde
Bytes Aantal aanvraagbodybytes dat moet worden geregistreerd. Int

Beperkingen:
Maximumwaarde = 8192

DataMasking

Naam Beschrijving Waarde
Headers Maskeringsinstellingen voor kopteksten DataMaskingEntity[]
queryParams Maskeringsinstellingen voor URL-queryparameters DataMaskingEntity[]

DataMaskingEntity

Naam Beschrijving Waarde
wijze Modus voor gegevensmaskering. 'Verbergen'
'Masker'
waarde De naam van een entiteit die moet worden gemaskeerd (bijvoorbeeld een naam van een header of een queryparameter). snaar

DiagnosticContractProperties

Naam Beschrijving Waarde
alwaysLog Hiermee geeft u op welk type instellingen voor het nemen van berichten niet van toepassing moeten zijn. 'allErrors'
back-end Diagnostische instellingen voor inkomende/uitgaande HTTP-berichten naar de back-end PipelineDiagnosticSettings
front-end Diagnostische instellingen voor inkomende/uitgaande HTTP-berichten naar de gateway. PipelineDiagnosticSettings
httpCorrelationProtocol Hiermee stelt u het correlatieprotocol in dat moet worden gebruikt voor Application Insights-diagnostische gegevens. 'Verouderd'
'Geen'
'W3C'
largeLanguageModel Diagnostische instellingen voor grote taalmodellen LLMDiagnosticSettings
logClientIp Registreer de ClientIP. De standaardwaarde is onwaar. Bool
loggerId Resource-id van een doellogger. tekenreeks (vereist)
Statistieken Aangepaste metrische gegevens verzenden via het beleid voor metrische gegevens verzenden. Alleen van toepassing op diagnostische instellingen van Application Insights. Bool
operationNameFormat De indeling van de bewerkingsnaam voor Application Insights-telemetrieën. De standaardwaarde is Naam. 'Naam'
'URL'
monsterneming Sampling-instellingen voor Diagnostische gegevens. SamplingSettings
langdradigheid Het uitgebreidheidsniveau dat wordt toegepast op traceringen die worden verzonden door traceringsbeleid. 'fout'
"informatie"
'uitgebreid'

HttpMessageDiagnostic

Naam Beschrijving Waarde
lichaam Instellingen voor logboekregistratie van hoofdteksten. BodyDiagnosticSettings
dataMasking Instellingen voor gegevensmaskering. DataMasking-
Headers Matrix van HTTP-headers die moeten worden vastgelegd. tekenreeks[]

LLMDiagnosticSettings

Naam Beschrijving Waarde
Logs Hiermee geeft u op of standaarddiagnose moet worden ingeschakeld voor grote taalmodellen of niet. 'uitgeschakeld'
'ingeschakeld'
Verzoeken Diagnostische instellingen voor aanvragen voor grote taalmodellen. LLMMessageDiagnosticSettings
Reacties Diagnostische instellingen voor antwoorden van grote taalmodellen. LLMMessageDiagnosticSettings

LLMMessageDiagnosticSettings

Naam Beschrijving Waarde
maxSizeInBytes Maximale grootte van bericht naar logboeken in bytes. De standaardgrootte is 32 kB. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 262144
Berichten Hiermee geeft u op welk bericht moet worden geregistreerd. Momenteel is er alleen de optie 'all'. 'all'

Microsoft.ApiManagement/service/apis/diagnostics

Naam Beschrijving Waarde
naam De resourcenaam string

Beperkingen:
Minimale lengte = 1
Maximale lengte = 1
Patroon = ^[^*#&+:<>?]+$ (vereist)
ouder In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd.

Zie onderliggende resource buiten de bovenliggende resourcevoor meer informatie.
Symbolische naam voor resource van het type: service/api's
Eigenschappen Contracteigenschappen voor diagnostische entiteiten. DiagnosticContractProperties-

PipelineDiagnosticSettings

Naam Beschrijving Waarde
verzoek Diagnostische instellingen voor aanvraag. HttpMessageDiagnostic-
antwoord Diagnostische instellingen voor antwoord. HttpMessageDiagnostic-

SamplingSettings

Naam Beschrijving Waarde
percentage De steekproeffrequentie voor steekproeven met vaste frequentie. Int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 100
samplingType Steekproeftype. 'vast'

Resourcedefinitie van ARM-sjabloon

Het resourcetype service/apis/diagnostics kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource microsoft.ApiManagement/service/apis/diagnostics wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "type": "Microsoft.ApiManagement/service/apis/diagnostics",
  "apiVersion": "2024-06-01-preview",
  "name": "string",
  "properties": {
    "alwaysLog": "string",
    "backend": {
      "request": {
        "body": {
          "bytes": "int"
        },
        "dataMasking": {
          "headers": [
            {
              "mode": "string",
              "value": "string"
            }
          ],
          "queryParams": [
            {
              "mode": "string",
              "value": "string"
            }
          ]
        },
        "headers": [ "string" ]
      },
      "response": {
        "body": {
          "bytes": "int"
        },
        "dataMasking": {
          "headers": [
            {
              "mode": "string",
              "value": "string"
            }
          ],
          "queryParams": [
            {
              "mode": "string",
              "value": "string"
            }
          ]
        },
        "headers": [ "string" ]
      }
    },
    "frontend": {
      "request": {
        "body": {
          "bytes": "int"
        },
        "dataMasking": {
          "headers": [
            {
              "mode": "string",
              "value": "string"
            }
          ],
          "queryParams": [
            {
              "mode": "string",
              "value": "string"
            }
          ]
        },
        "headers": [ "string" ]
      },
      "response": {
        "body": {
          "bytes": "int"
        },
        "dataMasking": {
          "headers": [
            {
              "mode": "string",
              "value": "string"
            }
          ],
          "queryParams": [
            {
              "mode": "string",
              "value": "string"
            }
          ]
        },
        "headers": [ "string" ]
      }
    },
    "httpCorrelationProtocol": "string",
    "largeLanguageModel": {
      "logs": "string",
      "requests": {
        "maxSizeInBytes": "int",
        "messages": "string"
      },
      "responses": {
        "maxSizeInBytes": "int",
        "messages": "string"
      }
    },
    "logClientIp": "bool",
    "loggerId": "string",
    "metrics": "bool",
    "operationNameFormat": "string",
    "sampling": {
      "percentage": "int",
      "samplingType": "string"
    },
    "verbosity": "string"
  }
}

Eigenschapswaarden

BodyDiagnosticSettings

Naam Beschrijving Waarde
Bytes Aantal aanvraagbodybytes dat moet worden geregistreerd. Int

Beperkingen:
Maximumwaarde = 8192

DataMasking

Naam Beschrijving Waarde
Headers Maskeringsinstellingen voor kopteksten DataMaskingEntity[]
queryParams Maskeringsinstellingen voor URL-queryparameters DataMaskingEntity[]

DataMaskingEntity

Naam Beschrijving Waarde
wijze Modus voor gegevensmaskering. 'Verbergen'
'Masker'
waarde De naam van een entiteit die moet worden gemaskeerd (bijvoorbeeld een naam van een header of een queryparameter). snaar

DiagnosticContractProperties

Naam Beschrijving Waarde
alwaysLog Hiermee geeft u op welk type instellingen voor het nemen van berichten niet van toepassing moeten zijn. 'allErrors'
back-end Diagnostische instellingen voor inkomende/uitgaande HTTP-berichten naar de back-end PipelineDiagnosticSettings
front-end Diagnostische instellingen voor inkomende/uitgaande HTTP-berichten naar de gateway. PipelineDiagnosticSettings
httpCorrelationProtocol Hiermee stelt u het correlatieprotocol in dat moet worden gebruikt voor Application Insights-diagnostische gegevens. 'Verouderd'
'Geen'
'W3C'
largeLanguageModel Diagnostische instellingen voor grote taalmodellen LLMDiagnosticSettings
logClientIp Registreer de ClientIP. De standaardwaarde is onwaar. Bool
loggerId Resource-id van een doellogger. tekenreeks (vereist)
Statistieken Aangepaste metrische gegevens verzenden via het beleid voor metrische gegevens verzenden. Alleen van toepassing op diagnostische instellingen van Application Insights. Bool
operationNameFormat De indeling van de bewerkingsnaam voor Application Insights-telemetrieën. De standaardwaarde is Naam. 'Naam'
'URL'
monsterneming Sampling-instellingen voor Diagnostische gegevens. SamplingSettings
langdradigheid Het uitgebreidheidsniveau dat wordt toegepast op traceringen die worden verzonden door traceringsbeleid. 'fout'
"informatie"
'uitgebreid'

HttpMessageDiagnostic

Naam Beschrijving Waarde
lichaam Instellingen voor logboekregistratie van hoofdteksten. BodyDiagnosticSettings
dataMasking Instellingen voor gegevensmaskering. DataMasking-
Headers Matrix van HTTP-headers die moeten worden vastgelegd. tekenreeks[]

LLMDiagnosticSettings

Naam Beschrijving Waarde
Logs Hiermee geeft u op of standaarddiagnose moet worden ingeschakeld voor grote taalmodellen of niet. 'uitgeschakeld'
'ingeschakeld'
Verzoeken Diagnostische instellingen voor aanvragen voor grote taalmodellen. LLMMessageDiagnosticSettings
Reacties Diagnostische instellingen voor antwoorden van grote taalmodellen. LLMMessageDiagnosticSettings

LLMMessageDiagnosticSettings

Naam Beschrijving Waarde
maxSizeInBytes Maximale grootte van bericht naar logboeken in bytes. De standaardgrootte is 32 kB. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 262144
Berichten Hiermee geeft u op welk bericht moet worden geregistreerd. Momenteel is er alleen de optie 'all'. 'all'

Microsoft.ApiManagement/service/apis/diagnostics

Naam Beschrijving Waarde
apiVersion De API-versie '2024-06-01-preview'
naam De resourcenaam string

Beperkingen:
Minimale lengte = 1
Maximale lengte = 1
Patroon = ^[^*#&+:<>?]+$ (vereist)
Eigenschappen Contracteigenschappen voor diagnostische entiteiten. DiagnosticContractProperties-
type Het resourcetype 'Microsoft.ApiManagement/service/apis/diagnostics'

PipelineDiagnosticSettings

Naam Beschrijving Waarde
verzoek Diagnostische instellingen voor aanvraag. HttpMessageDiagnostic-
antwoord Diagnostische instellingen voor antwoord. HttpMessageDiagnostic-

SamplingSettings

Naam Beschrijving Waarde
percentage De steekproeffrequentie voor steekproeven met vaste frequentie. Int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 100
samplingType Steekproeftype. 'vast'

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype service/apis/diagnostics kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource microsoft.ApiManagement/service/apis/diagnostics wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis/diagnostics@2024-06-01-preview"
  name = "string"
  body = jsonencode({
    properties = {
      alwaysLog = "string"
      backend = {
        request = {
          body = {
            bytes = int
          }
          dataMasking = {
            headers = [
              {
                mode = "string"
                value = "string"
              }
            ]
            queryParams = [
              {
                mode = "string"
                value = "string"
              }
            ]
          }
          headers = [
            "string"
          ]
        }
        response = {
          body = {
            bytes = int
          }
          dataMasking = {
            headers = [
              {
                mode = "string"
                value = "string"
              }
            ]
            queryParams = [
              {
                mode = "string"
                value = "string"
              }
            ]
          }
          headers = [
            "string"
          ]
        }
      }
      frontend = {
        request = {
          body = {
            bytes = int
          }
          dataMasking = {
            headers = [
              {
                mode = "string"
                value = "string"
              }
            ]
            queryParams = [
              {
                mode = "string"
                value = "string"
              }
            ]
          }
          headers = [
            "string"
          ]
        }
        response = {
          body = {
            bytes = int
          }
          dataMasking = {
            headers = [
              {
                mode = "string"
                value = "string"
              }
            ]
            queryParams = [
              {
                mode = "string"
                value = "string"
              }
            ]
          }
          headers = [
            "string"
          ]
        }
      }
      httpCorrelationProtocol = "string"
      largeLanguageModel = {
        logs = "string"
        requests = {
          maxSizeInBytes = int
          messages = "string"
        }
        responses = {
          maxSizeInBytes = int
          messages = "string"
        }
      }
      logClientIp = bool
      loggerId = "string"
      metrics = bool
      operationNameFormat = "string"
      sampling = {
        percentage = int
        samplingType = "string"
      }
      verbosity = "string"
    }
  })
}

Eigenschapswaarden

BodyDiagnosticSettings

Naam Beschrijving Waarde
Bytes Aantal aanvraagbodybytes dat moet worden geregistreerd. Int

Beperkingen:
Maximumwaarde = 8192

DataMasking

Naam Beschrijving Waarde
Headers Maskeringsinstellingen voor kopteksten DataMaskingEntity[]
queryParams Maskeringsinstellingen voor URL-queryparameters DataMaskingEntity[]

DataMaskingEntity

Naam Beschrijving Waarde
wijze Modus voor gegevensmaskering. 'Verbergen'
'Masker'
waarde De naam van een entiteit die moet worden gemaskeerd (bijvoorbeeld een naam van een header of een queryparameter). snaar

DiagnosticContractProperties

Naam Beschrijving Waarde
alwaysLog Hiermee geeft u op welk type instellingen voor het nemen van berichten niet van toepassing moeten zijn. 'allErrors'
back-end Diagnostische instellingen voor inkomende/uitgaande HTTP-berichten naar de back-end PipelineDiagnosticSettings
front-end Diagnostische instellingen voor inkomende/uitgaande HTTP-berichten naar de gateway. PipelineDiagnosticSettings
httpCorrelationProtocol Hiermee stelt u het correlatieprotocol in dat moet worden gebruikt voor Application Insights-diagnostische gegevens. 'Verouderd'
'Geen'
'W3C'
largeLanguageModel Diagnostische instellingen voor grote taalmodellen LLMDiagnosticSettings
logClientIp Registreer de ClientIP. De standaardwaarde is onwaar. Bool
loggerId Resource-id van een doellogger. tekenreeks (vereist)
Statistieken Aangepaste metrische gegevens verzenden via het beleid voor metrische gegevens verzenden. Alleen van toepassing op diagnostische instellingen van Application Insights. Bool
operationNameFormat De indeling van de bewerkingsnaam voor Application Insights-telemetrieën. De standaardwaarde is Naam. 'Naam'
'URL'
monsterneming Sampling-instellingen voor Diagnostische gegevens. SamplingSettings
langdradigheid Het uitgebreidheidsniveau dat wordt toegepast op traceringen die worden verzonden door traceringsbeleid. 'fout'
"informatie"
'uitgebreid'

HttpMessageDiagnostic

Naam Beschrijving Waarde
lichaam Instellingen voor logboekregistratie van hoofdteksten. BodyDiagnosticSettings
dataMasking Instellingen voor gegevensmaskering. DataMasking-
Headers Matrix van HTTP-headers die moeten worden vastgelegd. tekenreeks[]

LLMDiagnosticSettings

Naam Beschrijving Waarde
Logs Hiermee geeft u op of standaarddiagnose moet worden ingeschakeld voor grote taalmodellen of niet. 'uitgeschakeld'
'ingeschakeld'
Verzoeken Diagnostische instellingen voor aanvragen voor grote taalmodellen. LLMMessageDiagnosticSettings
Reacties Diagnostische instellingen voor antwoorden van grote taalmodellen. LLMMessageDiagnosticSettings

LLMMessageDiagnosticSettings

Naam Beschrijving Waarde
maxSizeInBytes Maximale grootte van bericht naar logboeken in bytes. De standaardgrootte is 32 kB. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 262144
Berichten Hiermee geeft u op welk bericht moet worden geregistreerd. Momenteel is er alleen de optie 'all'. 'all'

Microsoft.ApiManagement/service/apis/diagnostics

Naam Beschrijving Waarde
naam De resourcenaam string

Beperkingen:
Minimale lengte = 1
Maximale lengte = 1
Patroon = ^[^*#&+:<>?]+$ (vereist)
parent_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: service/API's
Eigenschappen Contracteigenschappen voor diagnostische entiteiten. DiagnosticContractProperties-
type Het resourcetype "Microsoft.ApiManagement/service/apis/diagnostics@2024-06-01-preview"

PipelineDiagnosticSettings

Naam Beschrijving Waarde
verzoek Diagnostische instellingen voor aanvraag. HttpMessageDiagnostic-
antwoord Diagnostische instellingen voor antwoord. HttpMessageDiagnostic-

SamplingSettings

Naam Beschrijving Waarde
percentage De steekproeffrequentie voor steekproeven met vaste frequentie. Int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 100
samplingType Steekproeftype. 'vast'