Microsoft.ApiManagement hizmeti/apis/diagnostics 2021-08-01
Bicep kaynak tanımı
Hizmet/apis/tanılama kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:
- kaynak grupları
- Bkz. kaynak grubu dağıtım komutları
Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.
Kaynak biçimi
Microsoft.ApiManagement/service/apis/diagnostics kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.
resource symbolicname 'Microsoft.ApiManagement/service/apis/diagnostics@2021-08-01' = {
name: 'string'
parent: resourceSymbolicName
properties: {
alwaysLog: 'allErrors'
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'
logClientIp: bool
loggerId: 'string'
metrics: bool
operationNameFormat: 'string'
sampling: {
percentage: int
samplingType: 'fixed'
}
verbosity: 'string'
}
}
Özellik değerleri
service/apis/diagnostics
| Ad | Açıklama | Değer |
|---|---|---|
| ad | Kaynak adı Bicep'nde alt kaynaklar için adları ve türleri ayarlamayı öğrenin. |
dize (gerekli) |
| ebeveyn | Bicep'te bir alt kaynak için üst kaynak belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir. Daha fazla bilgi için bkz. Alt kaynaküst kaynak dışında. |
Tür kaynağı için sembolik ad: api'leri |
| Özellikler | Tanılama varlığı sözleşme özellikleri. | DiagnosticContractProperties |
DiagnosticContractProperties
| Ad | Açıklama | Değer |
|---|---|---|
| alwaysLog | Ne tür ileti örnekleme ayarlarının uygulanmaması gerektiğini belirtir. | 'allErrors' |
| arka uç | Arka uçtan gelen/giden HTTP iletileri için tanılama ayarları | pipelinediagnosticSettings |
| ön uç | Ağ geçidine gelen/giden HTTP iletileri için tanılama ayarları. | pipelinediagnosticSettings |
| httpCorrelationProtocol | Application Insights tanılaması için kullanılacak bağıntı protokollerini ayarlar. | 'Eski' 'Hiçbiri' 'W3C' |
| logClientIp | ClientIP'yi günlüğe kaydetme. Varsayılan değer false'tur. | Bool |
| loggerId | Hedef günlükçü kaynak kimliği. | dize (gerekli) |
| Ölçüm | Yayma ölçümü ilkesi aracılığıyla özel ölçümler yayma. Yalnızca Application Insights tanılama ayarları için geçerlidir. | Bool |
| operationNameFormat | Application Insights telemetrileri için İşlem Adı biçimi. Varsayılan Ad'dır. | 'Ad' 'Url' |
| Örnekleme | Tanılama için örnekleme ayarları. | SamplingSettings |
| Ayrıntı | İzleme ilkeleri tarafından yayılan izlemelere uygulanan ayrıntı düzeyi. | 'error' 'information' 'ayrıntılı' |
PipelineDiagnosticSettings
| Ad | Açıklama | Değer |
|---|---|---|
| istek | İstek için tanılama ayarları. | httpmessagediagnostic |
| yanıt | Yanıt için tanılama ayarları. | httpmessagediagnostic |
HttpMessageDiagnostic
| Ad | Açıklama | Değer |
|---|---|---|
| beden | Gövde günlüğü ayarları. | BodyDiagnosticSettings |
| dataMasking | Veri maskeleme ayarları. | DataMasking |
| Üstbilgi | Günlüğe kaydedilecek HTTP Üst Bilgileri dizisi. | string[] |
BodyDiagnosticSettings
| Ad | Açıklama | Değer |
|---|---|---|
| Bayt | Günlüğe kaydedilecek istek gövdesi bayt sayısı. | Int Kısıtlama -ları: Maksimum değer = 8192 |
DataMasking
| Ad | Açıklama | Değer |
|---|---|---|
| Üstbilgi | Üst bilgiler için maskeleme ayarları | DataMaskingEntity |
| queryParams | Url sorgu parametreleri için maskeleme ayarları | DataMaskingEntity |
DataMaskingEntity
| Ad | Açıklama | Değer |
|---|---|---|
| mod | Veri maskeleme modu. | 'Gizle' 'Maske' |
| değer | Maskeleneceği varlığın adı (örneğin, üst bilgi adı veya sorgu parametresi). | dizgi |
SamplingSettings
| Ad | Açıklama | Değer |
|---|---|---|
| Yüzde | Sabit oranlı örnekleme için örnekleme oranı. | Int Kısıtlama -ları: En düşük değer = 0 Maksimum değer = 100 |
| samplingType | Örnekleme türü. | 'düzeltildi' |
ARM şablonu kaynak tanımı
Hizmet/apis/tanılama kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:
- kaynak grupları
- Bkz. kaynak grubu dağıtım komutları
Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.
Kaynak biçimi
Microsoft.ApiManagement/service/apis/diagnostics kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.
{
"type": "Microsoft.ApiManagement/service/apis/diagnostics",
"apiVersion": "2021-08-01",
"name": "string",
"properties": {
"alwaysLog": "allErrors",
"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",
"logClientIp": "bool",
"loggerId": "string",
"metrics": "bool",
"operationNameFormat": "string",
"sampling": {
"percentage": "int",
"samplingType": "fixed"
},
"verbosity": "string"
}
}
Özellik değerleri
service/apis/diagnostics
| Ad | Açıklama | Değer |
|---|---|---|
| tür | Kaynak türü | 'Microsoft.ApiManagement/service/apis/diagnostics' |
| apiVersion | Kaynak API'sinin sürümü | '2021-08-01' |
| ad | Kaynak adı |
dize (gerekli) |
| Özellikler | Tanılama varlığı sözleşme özellikleri. | DiagnosticContractProperties |
DiagnosticContractProperties
| Ad | Açıklama | Değer |
|---|---|---|
| alwaysLog | Ne tür ileti örnekleme ayarlarının uygulanmaması gerektiğini belirtir. | 'allErrors' |
| arka uç | Arka uçtan gelen/giden HTTP iletileri için tanılama ayarları | pipelinediagnosticSettings |
| ön uç | Ağ geçidine gelen/giden HTTP iletileri için tanılama ayarları. | pipelinediagnosticSettings |
| httpCorrelationProtocol | Application Insights tanılaması için kullanılacak bağıntı protokollerini ayarlar. | 'Eski' 'Hiçbiri' 'W3C' |
| logClientIp | ClientIP'yi günlüğe kaydetme. Varsayılan değer false'tur. | Bool |
| loggerId | Hedef günlükçü kaynak kimliği. | dize (gerekli) |
| Ölçüm | Yayma ölçümü ilkesi aracılığıyla özel ölçümler yayma. Yalnızca Application Insights tanılama ayarları için geçerlidir. | Bool |
| operationNameFormat | Application Insights telemetrileri için İşlem Adı biçimi. Varsayılan Ad'dır. | 'Ad' 'Url' |
| Örnekleme | Tanılama için örnekleme ayarları. | SamplingSettings |
| Ayrıntı | İzleme ilkeleri tarafından yayılan izlemelere uygulanan ayrıntı düzeyi. | 'error' 'information' 'ayrıntılı' |
PipelineDiagnosticSettings
| Ad | Açıklama | Değer |
|---|---|---|
| istek | İstek için tanılama ayarları. | httpmessagediagnostic |
| yanıt | Yanıt için tanılama ayarları. | httpmessagediagnostic |
HttpMessageDiagnostic
| Ad | Açıklama | Değer |
|---|---|---|
| beden | Gövde günlüğü ayarları. | BodyDiagnosticSettings |
| dataMasking | Veri maskeleme ayarları. | DataMasking |
| Üstbilgi | Günlüğe kaydedilecek HTTP Üst Bilgileri dizisi. | string[] |
BodyDiagnosticSettings
| Ad | Açıklama | Değer |
|---|---|---|
| Bayt | Günlüğe kaydedilecek istek gövdesi bayt sayısı. | Int Kısıtlama -ları: Maksimum değer = 8192 |
DataMasking
| Ad | Açıklama | Değer |
|---|---|---|
| Üstbilgi | Üst bilgiler için maskeleme ayarları | DataMaskingEntity |
| queryParams | Url sorgu parametreleri için maskeleme ayarları | DataMaskingEntity |
DataMaskingEntity
| Ad | Açıklama | Değer |
|---|---|---|
| mod | Veri maskeleme modu. | 'Gizle' 'Maske' |
| değer | Maskeleneceği varlığın adı (örneğin, üst bilgi adı veya sorgu parametresi). | dizgi |
SamplingSettings
| Ad | Açıklama | Değer |
|---|---|---|
| Yüzde | Sabit oranlı örnekleme için örnekleme oranı. | Int Kısıtlama -ları: En düşük değer = 0 Maksimum değer = 100 |
| samplingType | Örnekleme türü. | 'düzeltildi' |
Terraform (AzAPI sağlayıcısı) kaynak tanımı
Hizmet/apis/tanılama kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:
- Kaynak grupları
Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.
Kaynak biçimi
Microsoft.ApiManagement/service/apis/diagnostics kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ApiManagement/service/apis/diagnostics@2021-08-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
alwaysLog = "allErrors"
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"
logClientIp = bool
loggerId = "string"
metrics = bool
operationNameFormat = "string"
sampling = {
percentage = int
samplingType = "fixed"
}
verbosity = "string"
}
})
}
Özellik değerleri
service/apis/diagnostics
| Ad | Açıklama | Değer |
|---|---|---|
| tür | Kaynak türü | "Microsoft.ApiManagement/service/apis/diagnostics@2021-08-01" |
| ad | Kaynak adı | dize (gerekli) |
| parent_id | Bu kaynağın üst öğesi olan kaynağın kimliği. | Tür kaynağı kimliği: API'leri |
| Özellikler | Tanılama varlığı sözleşme özellikleri. | DiagnosticContractProperties |
DiagnosticContractProperties
| Ad | Açıklama | Değer |
|---|---|---|
| alwaysLog | Ne tür ileti örnekleme ayarlarının uygulanmaması gerektiğini belirtir. | "allErrors" |
| arka uç | Arka uçtan gelen/giden HTTP iletileri için tanılama ayarları | pipelinediagnosticSettings |
| ön uç | Ağ geçidine gelen/giden HTTP iletileri için tanılama ayarları. | pipelinediagnosticSettings |
| httpCorrelationProtocol | Application Insights tanılaması için kullanılacak bağıntı protokollerini ayarlar. | "Eski" "Yok" "W3C" |
| logClientIp | ClientIP'yi günlüğe kaydetme. Varsayılan değer false'tur. | Bool |
| loggerId | Hedef günlükçü kaynak kimliği. | dize (gerekli) |
| Ölçüm | Yayma ölçümü ilkesi aracılığıyla özel ölçümler yayma. Yalnızca Application Insights tanılama ayarları için geçerlidir. | Bool |
| operationNameFormat | Application Insights telemetrileri için İşlem Adı biçimi. Varsayılan Ad'dır. | "Ad" "Url" |
| Örnekleme | Tanılama için örnekleme ayarları. | SamplingSettings |
| Ayrıntı | İzleme ilkeleri tarafından yayılan izlemelere uygulanan ayrıntı düzeyi. | "error" "bilgi" "ayrıntılı" |
PipelineDiagnosticSettings
| Ad | Açıklama | Değer |
|---|---|---|
| istek | İstek için tanılama ayarları. | httpmessagediagnostic |
| yanıt | Yanıt için tanılama ayarları. | httpmessagediagnostic |
HttpMessageDiagnostic
| Ad | Açıklama | Değer |
|---|---|---|
| beden | Gövde günlüğü ayarları. | BodyDiagnosticSettings |
| dataMasking | Veri maskeleme ayarları. | DataMasking |
| Üstbilgi | Günlüğe kaydedilecek HTTP Üst Bilgileri dizisi. | string[] |
BodyDiagnosticSettings
| Ad | Açıklama | Değer |
|---|---|---|
| Bayt | Günlüğe kaydedilecek istek gövdesi bayt sayısı. | Int Kısıtlama -ları: Maksimum değer = 8192 |
DataMasking
| Ad | Açıklama | Değer |
|---|---|---|
| Üstbilgi | Üst bilgiler için maskeleme ayarları | DataMaskingEntity |
| queryParams | Url sorgu parametreleri için maskeleme ayarları | DataMaskingEntity |
DataMaskingEntity
| Ad | Açıklama | Değer |
|---|---|---|
| mod | Veri maskeleme modu. | "Gizle" "Maske" |
| değer | Maskeleneceği varlığın adı (örneğin, üst bilgi adı veya sorgu parametresi). | dizgi |
SamplingSettings
| Ad | Açıklama | Değer |
|---|---|---|
| Yüzde | Sabit oranlı örnekleme için örnekleme oranı. | Int Kısıtlama -ları: En düşük değer = 0 Maksimum değer = 100 |
| samplingType | Örnekleme türü. | "düzeltildi" |