Ölçümler veri toplama kuralları aracılığıyla dışarı aktarılıyor (Önizleme)

Makale
09/23/2024

Veri toplama kuralları (DCR) Azure kaynaklarınızdan izleme verilerini toplamak için kullanılır. Veri toplama senaryosunun listesi için bkz . Veri toplama kuralları - Genel Bakış. Artık platform ölçümlerini toplamak ve dışarı aktarmak için DCR'leri kullanabilirsiniz.

Şu anda platform ölçümleri hem DCR hem de Tanılama Ayarları kullanılarak toplanabilir. Giderek artan sayıda kaynak, DCR'ler kullanılarak ölçüm dışarı aktarmayı destekler. Destekleyici kaynakların listesi için bkz . Desteklenen kaynaklar ve bölgeler .

Ölçümleri dışarı aktarmak için DCR'lerin kullanılması tanılama ayarlarına göre aşağıdaki avantajları sağlar:

DCR yapılandırması, ölçümlerin boyutlarla dışarı aktarmasını sağlar.
DCR yapılandırması, yalnızca ihtiyacınız olan ölçümleri dışarı aktarabilmeniz için ölçüm adına göre filtrelemeyi etkinleştirir.
DCR'ler Tanılama Ayarları'na kıyasla daha esnek ve ölçeklenebilirdir.
DCR'ler için uçtan uca gecikme süresi 3 dakika içindedir. Bu, ölçümlerin dışarı aktarma gecikme süresinin 6-10 dakika olduğu Tanılama Ayarları'na göre önemli bir geliştirmedir.

Ölçüm verilerini sürekli dışarı aktarmak için DCR'ler aracılığıyla ölçümleri dışarı aktarmayı kullanın. Geçmiş verileri sorgulamak için Veri Düzlemi Ölçümler Toplu İş API'sini kullanın. İki hizmetin karşılaştırması için bkz . Veri düzlemi Ölçümleri Toplu API sorgusu ve Ölçüm dışarı aktarma.

REST API, Azure CLI veya Azure PowerShell kullanarak ölçümler için DCR'ler oluşturun. Ölçüm dışarı aktarma için DCR oluşturma hakkında bilgi için bkz . Ölçümler için veri toplama kuralları oluşturma.

DCR oluşturduğunuzda, DCR'yi izlenecek kaynakla ilişkilendirmek için bir Veri toplama kuralı ilişkisi (DCRA) oluşturmanız gerekir. Birçok kaynak türü için tek bir DCR oluşturabilirsiniz. DCRA oluşturma hakkında bilgi için bkz . Veri toplama kuralı ilişkilendirmeleri oluşturma. Azure portalı kullanılırken DCRA otomatik olarak oluşturulur.

Not

DCR'leri ve tanılama ayarlarını aynı anda kullanmak mümkündür. Yinelenen veri toplamayı önlemek için DCR'leri kullanırken ölçümler için tanılama ayarlarını devre dışı bırakmanızı öneririz.

Hedefleri dışarı aktarma

Ölçümler DCR başına aşağıdaki hedeflerden birine aktarılabilir:

Log Analytics çalışma alanları.
Log Analytics çalışma alanlarına dışarı aktarma, bölgeler arasında olabilir. Log Analytics çalışma alanı ve DCR aynı bölgede olmalıdır, ancak izlenen kaynaklar herhangi bir bölgede olabilir. Log Analytics çalışma alanına gönderilen ölçümler tabloda depolanır AzureMetricsV2 .
Azure depolama hesapları.
Depolama hesabı, DCR ve izlenen kaynakların tümü aynı bölgede olmalıdır.
Event Hubs.
Event Hubs, DCR ve izlenen kaynakların tümü aynı bölgede olmalıdır.

Her hedefteki verilerin bir örneği için bkz . Dışarı aktarılan veriler.

Not

Ölçümleri dışarı aktarma gecikme süresi yaklaşık 3 dakikadır. İlk kurulumdan sonra ölçümlerin hedefte görünmeye başlaması için 15 dakikaya kadar izin verin.

Sınırlamalar

Ölçüm dışarı aktarma için DCR'ler aşağıdaki sınırlamalara sahiptir:

DCR başına yalnızca bir hedef türü belirtilebilir.
Tek bir Azure Kaynağı ile en fazla 5 DCR ilişkilendirilebilir.
DCR tarafından metrik dışarı aktarma, saatlik dilimli ölçümlerin dışarı aktarımını desteklemez.

Desteklenen kaynaklar ve bölgeler

Aşağıdaki kaynaklar, veri toplama kurallarını kullanarak ölçümleri dışarı aktarmayı destekler:

Kaynak türü	Akış belirtimi
Sanal Makine ölçek kümeleri	Microsoft.compute/virtualmachinescalesets
Sanal makineler	Microsoft.compute/virtualmachines
Redis Cache	Microsoft.cache/redis
IOT hub'ları	Microsoft.devices/iothubs
Anahtar kasaları	Microsoft.keyvault/vaults
Depolama hesapları	Microsoft.storage/storageaccounts Microsoft.storage/Storageaccounts/blobservices Microsoft.storage/storageaccounts/fileservices Microsoft.storage/storageaccounts/queueservices Microsoft.storage/storageaccounts/tableservices
SQL Server	Microsoft.sql/sunucular Microsoft.sql/sunucular/veritabanları
Operasyonel İçgörüler	Microsoft.operationalinsights/workspaces
Medya hizmetleri	Microsoft.media/mediaservices Microsoft.media/mediaservices/streamingendpoints Microsoft.media/mediaservices/liveevents
Veri koruması	Microsoft.dataprotection/backupvaults
Azure Kubernetes Service	Microsoft.ContainerService/managedClusters

Desteklenen bölgeler

Herhangi bir bölgede ölçüm dışarı aktarma için bir DCR oluşturabilirsiniz, ancak ölçümleri dışarı aktarmak istediğiniz kaynakların aşağıdaki bölgelerden birinde olması gerekir:

Doğu Avustralya
Orta ABD
CentralUsEuap
Orta Güney ABD
Doğu ABD
Doğu ABD 2
Eastus2Euap
Batı ABD
Batı ABD 2
Kuzey Avrupa
West Europe
Güney Birleşik Krallık

DCR belirtimleri

Veri toplama kuralları bir JSON nesnesinde tanımlanır. Ölçüm dışarı aktarma için DCR oluşturmak için aşağıdaki özellikler gereklidir.

Özellik	Açıklama
`dataSources.platformTelemetry.streams`	Kaynak türlerini ve ölçümleri listeler. Kaynağın tüm ölçümlerini toplamak için belirtin `Metrics-Group-All` veya tek tek ölçümleri belirtin. Biçim: `<resource type>:Metrics-Group-All \| <metric name>` Örneğin `Microsoft.Compute/virtualMachines:Percentage CPU`
`dataSources.platformTelemetry.name`	Veri kaynağının adı.
`destinations`	Ölçümlerin hedefi. DCR başına yalnızca bir hedef desteklenir. Geçerli Hedef türleri: `storageAccounts` `logAnalytics` `eventHubs`
`dataflows.streams`	Hedefe şu biçimde geçirilecek akışların listesi: `<resource type>:Metrics-Group-All \|<metric name>` Örneğin, Microsoft.Compute/virtualMachines:Percentage CPU"
`dataflows.destinations`	Akışın özelliğinde tanımlandığı şekilde geçirilecek `destinations` hedef.
`identity.type`	DCR için kullanılacak kimlik türü. Depolama hesabı hedefleri için gereklidir. Geçerli değerler: `systemAssigned` `userAssigned`
`kind`	Veri toplama kuralı türü. Ölçümleri dışarı aktarma için olarak `PlatformTelemetry` ayarlayın.
`location`	DCR'nin konumu.

Not

DCR başına yalnızca bir hedef türü belirtilebilir.

Ölçüm dışarı aktarma DCR için JSON biçimi

Ölçümleri dışarı aktarmaya yönelik bir DCR oluşturmak için aşağıdaki genel JSON nesnesindeki biçimi kullanın. Örneği kopyalarken istenmeyen hedefleri kaldırın.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                    // a list of resource types and metrics to collect metrics from
                        "<resourcetype>:<metric name> | Metrics-Group-All", 
                        "<resourcetype>:<metric name> | Metrics-Group-All"
                    ],
                    "name": "<data sources name>"
                }
            ]
        },
        "destinations": {
            // Choose a single destination type of either logAnalytics, storageAccounts, or eventHubs
            "logAnalytics": [
                {
                    "workspaceResourceId": "workspace Id",
                    "name": "<destination name>"
                }
            ],    
            "storageAccounts": [
                {
                    "storageAccountResourceId": "<storage account Id>", 
                    "containerName": "<container name>",
                    "name": "<destination name>"
                }
            ],
            "eventHubs": [ 
                 { 
                    "eventHubResourceId": "event hub id", 
                     "name": "<destination name>" 
                 } 
             ],     },
        "dataFlows": [
            {
                "streams": [
                 // a list of resource types and metrics to pass to the destination
                        "<resourcetype>:<metric name> | Metrics-Group-All", 
                        "<resourcetype>:<metric name> | Metrics-Group-All"               
                         ],
                "destinations": [
                    "<destination name>"               
                ]
            }
        ]
    },
    // identity is required for Storage Account and Event Hubs destinations
    "identity": {
         "type": "userassigned", 
         "userAssignedIdentities": { 
					 "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.ManagedIdentity/userAssignedIdentities/DRCIdentity": {} 
         }    
    },
"kind": "PlatformTelemetry",
    "location": "eastus"
}

Not

CLI, kind, locationve identity kullanılarak dışarı aktarılan ölçümler için DCR oluşturulurken bağımsız değişken olarak geçirilir ve JSON nesnesinden kaldırılmalıdır.

Kullanıcı ve sistem tarafından atanan kimlikler

DCR'ler oluşturulurken hem kullanıcı hem de sistem tarafından atanan kimlikler desteklenir. Depolama Hesabı ve Event Hubs hedefleri için bir kimlik gereklidir. Sistem tarafından atanan veya kullanıcı tarafından atanan bir kimlik kullanabilirsiniz. Daha fazla bilgi için bkz . Yönetilen kimliğe Azure rolleri atama.

Sistem tarafından atanan bir kimlik kullanmak için nesnesini aşağıdaki gibi ekleyin identity :

    "identity": {
         "type": "systemAssigned"
    },

Kullanıcı tarafından atanan bir kimlik kullanmak için nesnesini aşağıdaki gibi ekleyin identity :

    "identity": {
         "type": "userassigned", 

         "userAssignedIdentities": { 
           "/subscriptions/<subscriptionId>/resourceGroups/<resource group name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity name>": {} 
         }    

    }

Ölçümleri filtreleme

Dışarı aktarılacak ölçümleri belirtirken, kullanarak Metrics-Group-Allölçümleri ada göre filtreleyebilir veya tüm ölçümleri isteyebilirsiniz. Desteklenen ölçümlerin listesi için bkz . Kaynak türüne göre desteklenen ölçümler ve günlük kategorileri.

Aynı kaynak türünden birden fazla ölçüm belirtmek için her ölçüm için ayrı bir akış öğesi oluşturun.

Aşağıdaki örnekte ölçümlerin ada göre nasıl filtreleneceği gösterilmektedir.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows",  
                        "Microsoft.Compute/virtualMachineScaleSets:Percentage CPU",
                        "Microsoft.Cache/redis:Cache Hits"
                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "logAnalytics": [
                {
                    "workspaceResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/arg-001/providers/microsoft.operationalinsights/workspaces/loganalyticsworkspace001",
                    "name": "destinationName"
                }
            ]
        },
        "dataFlows": [
            {
                "streams": [
                    "Microsoft.Compute/virtualMachines:Percentage CPU",
                    "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                    "Microsoft.Compute/virtualMachines:Inbound Flows",
                    "Microsoft.Compute/virtualMachineScaleSets:Percentage CPU",
                    "Microsoft.Cache/redis:Cache Hits"
                ],
                "destinations": [
                    "destinationName"
                ]
            }
        ]
    },
    "kind": "PlatformTelemetry",
    "location": "eastus"
}

Örnek ölçümler JSON nesnelerini dışarı aktarma

Aşağıdaki örneklerde, her hedef türüne dışarı aktarılan ölçümler için örnek DCR JSON nesneleri gösterilmektedir.

Log Analytics çalışma alanları

Aşağıdaki örnekte sanal makinelerden, sanal makine ölçek kümelerinden ve tüm anahtar kasası ölçümlerinden log analytics çalışma alanına belirli ölçümleri gönderen ölçümler için veri toplama kuralı gösterilmektedir:

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows",
                        "Microsoft.Compute/virtualMachineScaleSets:Available Memory Bytes",
                         "Microsoft.KeyVault/vaults:Metrics-Group-All"
                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "logAnalytics": [ 
                { 
                    "workspaceResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-001/providers/microsoft.operationalinsights/workspaces/laworkspace001", 
                    "name": "ladestination" 
                } 
            ] 
        },
        "dataFlows": [
            {
                "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows",
                        "Microsoft.Compute/virtualMachineScaleSets:Available Memory Bytes",
                        "Microsoft.KeyVault/vaults:Metrics-Group-All"
                        ],    
                "destinations": [
                    "ladestination"
                    
                ]
            }
        ]
    },

"kind": "PlatformTelemetry",
    "location": "centralus"
}

Depolama hesapları

Aşağıdaki örnekte, sanal makinelerden ölçümler, ve sanal makine ölçek kümeleri, Disk Read BytesRedis önbelleği ve Inbound Flows Key Vaults için tüm ölçümleri depolama hesabına gönderenPercentage CPU ölçümler için bir veri toplama kuralı gösterilmektedir.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Percentage CPU",
                        "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                        "Microsoft.Compute/virtualMachines:Inbound Flows"
                        "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                        "Microsoft.Cache/redis:Metrics-Group-All",
                        "Microsoft.keyvault/vaults:Metrics-Group-All"
                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "storageAccounts": [
                {
                    "storageAccountResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-001/providers/Microsoft.Storage/storageAccounts/metricsexport001",
                    "containerName": "metritcs-001",
                    "name": "desitnationName"
                }
            ]
        },
        "dataFlows": [
            {
                "streams": [
                    "Microsoft.Compute/virtualMachines:Percentage CPU",
                    "Microsoft.Compute/virtualMachines:Disk Read Bytes",
                    "Microsoft.Compute/virtualMachines:Inbound Flows"
                    "Microsoft.Compute/virtualMachineScaleSets:Metrics-Group-All",
                    "Microsoft.Cache/redis:Metrics-Group-All",
                    "Microsoft.keyvault/vaults:Metrics-Group-All"
                ],
                "destinations": [
                    "desitnationName"
                ]
            }
        ]
    },
    "identity": {
         "type": "systemAssigned"
    },
"kind": "PlatformTelemetry",
    "location": "eastus2"
}

Event Hubs

Aşağıdaki örnekte, sanal makinelerdeki tüm ölçümleri ve ServiceApiHit Key Vaults'taki ve Availability ölçümlerini Event Hubs'a gönderen ölçüm dışarı aktarma için bir veri toplama kuralı gösterilmektedir.

{
    "properties": {
        "dataSources": {
            "platformTelemetry": [
                {
                    "streams": [
                        "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                        "Microsoft.keyvault/vaults:ServiceApiHit",
                        "Microsoft.keyvault/vaults:Availability"

                    ],
                    "name": "myPlatformTelemetryDataSource"
                }
            ]
        },
        "destinations": {
            "eventHubs": [ 
                { 
                    "eventHubResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.EventHub/namespaces/event-hub-001/eventhubs/hub-001", 
                    "name": "hub1" 
                } 
           ] 
        },
        "dataFlows": [
            {
                "streams": [
                    "Microsoft.Compute/virtualMachines:Metrics-Group-All",
                        "Microsoft.keyvault/vaults:ServiceApiHit",
                        "Microsoft.keyvault/vaults:Availability"
                ],
                "destinations": [
                    "hub1"
                ]
            }
        ]
    },
    "identity": {
         "type": "systemAssigned"
    },
"kind": "PlatformTelemetry",
    "location": "eastus"
}

Ölçüm dışarı aktarma için DCR oluşturma

Azure portalı, CLI, PowerShell, REST API veya ARM şablonunu kullanarak ölçüm dışarı aktarma için DCR'ler oluşturun. Daha fazla bilgi için bkz . Ölçüm dışarı aktarma için veri toplama kuralı (DCR) oluşturma.

Dışarı aktarılan veriler

Aşağıdaki örneklerde her hedefe dışarı aktarılan veriler gösterilmektedir.

Log Analytics çalışma alanları

Log Analytics çalışma alanına aktarılan veriler Log Analytics çalışma alanında aşağıdaki biçimde tabloda depolanır AzureMetricsV2 :

Sütun	Türü	Açıklama
Ortalama	real	Zaman aralığında toplanan ortalama değer.
_BilledSize	real	Bayt cinsinden kayıt boyutu
Sayı	real	Zaman aralığı boyunca toplanan örnek sayısı.
Boyut	dynamic	Ölçümün JSON biçiminde ilişkili boyutu.
_IsBillable	Dize	Verilerin alınıp alınmayacağını belirtir. _IsBillable `false` alımı Azure hesabınıza faturalandırılmadığında
En Büyük	real	Zaman aralığında toplanan maksimum değer.
MetricCategory	Dize	Ölçümün kategori adı.
MetricName	Dize	Ölçümün görünen adı.
MetricResourceType	Dize	Ölçümü bildiren Azure kaynağının kaynak türü.
Minimum	real	Zaman aralığında toplanan minimum değer.
_ResourceId	Dize	Kaydın ilişkili olduğu kaynağın benzersiz tanımlayıcısı
SourceSystem	Dize	Olayın toplandığı aracı türü. Örneğin, `OpsManager` Windows aracısı için, doğrudan bağlantı veya Operations Manager, `Linux` tüm Linux aracıları için veya `Azure` Azure Tanılama
_SubscriptionId	Dize	Kaydın ilişkili olduğu abonelik için benzersiz tanımlayıcı
TenantId	Dize	Log Analytics çalışma alanı kimliği
TimeGenerated	datetime	Kaydın oluşturulduğu zaman damgası (UTC).
ZamanBirimi	Dize	Ölçümün zaman dilimi.
Toplam	real	Zaman aralığındaki tüm değerlerin toplamı.
Tür	Dize	Tablonun adı
UnitName	Dize	Ölçümün birimi.

Örneğin:

Depolama hesapları

Aşağıdaki örnekte depolama hesabına aktarılan veriler gösterilmektedir:

{
    "Average": "31.5",
    "Count": "2",
    "Maximum": "52",
    "Minimum": "11",
    "Total": "63",
    "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-dcrs/providers/microsoft.keyvault/vaults/dcr-vault",
    "time": "2024-08-20T14:13:00.0000000Z",
    "unit": "MilliSeconds",
    "metricName": "ServiceApiLatency",
    "timeGrain": "PT1M",
    "dimension": {
        "ActivityName": "vaultget",
        "ActivityType": "vault",
        "StatusCode": "200",
        "StatusCodeClass": "2xx"
    }
}

Event Hubs

Aşağıdaki örnekte Event Hubs'a dışarı aktarılan bir ölçüm gösterilmektedir.

    {
      "Average": "1",
      "Count": "1",
      "Maximum": "1",
      "Minimum": "1",
      "Total": "1",
      "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/rg-dcrs/providers/microsoft.keyvault/vaults/dcr-vault",
      "time": "2024-08-22T13:43:00.0000000Z",
      "unit": "Count",
      "metricName": "ServiceApiHit",
      "timeGrain": "PT1M",
      "dimension": {
        "ActivityName": "keycreate",
        "ActivityType": "key"
      },
      "EventProcessedUtcTime": "2024-08-22T13:49:17.1233030Z",
      "PartitionId": 0,
      "EventEnqueuedUtcTime": "2024-08-22T13:46:04.5570000Z"
    }

Aracılığıyla paylaş

Ölçümler veri toplama kuralları aracılığıyla dışarı aktarılıyor (Önizleme)

Hedefleri dışarı aktarma

Sınırlamalar

Desteklenen kaynaklar ve bölgeler

Desteklenen bölgeler

DCR belirtimleri

Ölçüm dışarı aktarma DCR için JSON biçimi

Kullanıcı ve sistem tarafından atanan kimlikler

Ölçümleri filtreleme

Örnek ölçümler JSON nesnelerini dışarı aktarma

Log Analytics çalışma alanları

Depolama hesapları

Event Hubs

Ölçüm dışarı aktarma için DCR oluşturma

Dışarı aktarılan veriler

Log Analytics çalışma alanları

Depolama hesapları

Event Hubs

Sonraki adımlar

Geri Bildirim

Ek kaynaklar