Метрики экспортируются с помощью правил сбора данных (предварительная версия)

Правила сбора данных (DCR) используются для сбора данных мониторинга из ресурсов Azure. Список сценариев сбора данных см. в разделе "Общие сведения о правилах сбора данных". Теперь можно использовать контроллеры домена для сбора и экспорта метрик платформы.

В настоящее время метрики платформы можно собирать с помощью DCR и параметров диагностики. Растущее число ресурсов поддерживает экспорт метрик с помощью контроллеров домена. Список поддерживаемых ресурсов и регионов см. в разделе "Поддерживаемые ресурсы ".

Использование контроллера домена для экспорта метрик обеспечивает следующие преимущества по сравнению с параметрами диагностики:

• Конфигурация DCR позволяет экспортировать метрики с измерениями.
• Конфигурация DCR позволяет фильтровать по имени метрик, чтобы экспортировать только необходимые метрики.
• Контроллеры домена являются более гибкими и масштабируемыми по сравнению с параметрами диагностики.
• Завершение задержки для контроллеров домена составляет 3 минуты. Это основное улучшение по сравнению с параметрами диагностики, где задержка экспорта метрик составляет 6–10 минут.

Используйте метрики, экспортируемые с помощью контроллеров домена для непрерывного экспорта данных метрик. Для запроса исторических данных используйте API пакетной службы метрик плоскости данных. Для сравнения двух служб см. Запрос Data plane Metrics Batch API и Metrics export.

Создайте контроллеры домена для метрик с помощью REST API, Azure CLI или Azure PowerShell. Сведения о том, как создать правила сбора данных (DCR) для экспорта метрик, см. в разделе "Создание правил сбора данных для метрик".

При создании DCR необходимо создать ассоциацию правил сбора данных (DCRA), чтобы связать DCR с ресурсом для отслеживания. Для многих типов ресурсов можно создать один DCR. Сведения о создании DCRA см. в статье "Создание связей правил сбора данных". При использовании портал Azure DCRA создается автоматически.

Направления экспорта

Метрики можно экспортировать в одно из следующих направлений на DCR:

• Рабочие области Log Analytics

  Экспорт в рабочие области Log Analytics может выполняться в разных регионах. Рабочая область Log Analytics и DCR должны находиться в одном регионе, но отслеживаемые ресурсы могут находиться в любом регионе. Метрики, отправленные в рабочую область log analytics, хранятся в AzureMetricsV2 таблице.

• Учетные записи хранения Azure

  Учетная запись хранения, DCR и отслеживаемые ресурсы должны находиться в одном регионе.

• Центрам событий.

  Центры событий, DCR и отслеживаемые ресурсы должны находиться в одном регионе.

Пример данных в каждом месте назначения см. в разделе "Экспортированные данные".

Ограничения

Контроллеры домена для экспорта метрик имеют следующие ограничения:

• Для каждого DCR можно указать только один тип назначения.
• С одним ресурсом Azure может быть связано не более 5 контроллеров домена.
• Экспорт метрик с использованием DCR не поддерживает экспорт показателей с почасовой детализацией.

Поддерживаемые ресурсы и регионы

Следующие ресурсы поддерживают экспорт метрик с помощью правил сбора данных:

Поддерживаемые регионы

Вы можете создать DCR для экспорта метрик в любом регионе, но ресурсы, из которого требуется экспортировать метрики, должны находиться в одном из следующих регионов:

• Восточная Австралия
• Центральная часть США
• CentralUsEuap
• Южно-Центральная часть США
• Восток США
• Восток США 2
• Eastus2Euap
• Западная часть США
• Западная часть США 2
• Северная Европа
• Западная Европа
• Юг Соединённого Королевства

Спецификации DCR

Правила сбора данных определяются в объекте JSON. Следующие свойства необходимы для создания DCR для экспорта метрик.

Формат JSON для метрик экспортирует DCR

Используйте формат в следующем универсальном объекте JSON для создания DCR для экспорта метрик. Удалите нежелательные назначения при копировании примера.

{
    "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"
}

Удостоверения, назначенные пользователем и системой

Удостоверения, назначенные пользователем и системой, поддерживаются при создании контроллеров домена. Удостоверение требуется для назначений учетной записи хранения и центров событий. Вы можете использовать назначенное системой удостоверение или удостоверение, назначаемое пользователем. Дополнительные сведения см. в статье "Назначение ролей Azure управляемому удостоверению".

Чтобы использовать назначенное системой удостоверение, добавьте identity объект следующим образом:

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

Чтобы использовать назначенное пользователем удостоверение, добавьте identity объект следующим образом:

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

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

    }

Фильтрация метрик

При указании метрик для экспорта можно фильтровать метрики по имени или запрашивать все метрики с помощью Metrics-Group-All. Список поддерживаемых метрик см. в разделе "Поддерживаемые метрики" и категории журналов по типу ресурса.

Чтобы указать несколько метрик из одного типа ресурсов, создайте отдельный элемент потока для каждой метрики.

В следующем примере показано, как фильтровать метрики по имени.

{
    "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"
}

Примеры метрик экспортируют объекты JSON

В следующих примерах показаны примеры объектов JSON DCR для экспорта метрик в каждый тип назначения.

{
    "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"
}

{
    "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"
}

{
    "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"
}

Создание контроллеров домена для экспорта метрик

Создайте контроллеры домена для экспорта метрик с помощью шаблона портал Azure, CLI, PowerShell, REST API или ARM. Дополнительные сведения см. в разделе "Создание правила сбора данных( DCR) для экспорта метрик.

Exported data (Экспортированы данные)

В следующих примерах показаны данные, экспортированные в каждое место назначения.

Рабочие области Log Analytics

Данные, экспортированные в рабочую область Log Analytics, хранятся в AzureMetricsV2 таблице в рабочей области Log Analytics в следующем формате:

Рассмотрим пример.

Учетные записи хранения

В следующем примере показаны данные, экспортированные в учетную запись хранения:

{
    "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"
    }
}

Центры событий

В следующем примере показана метрика, экспортируемая в Центры событий.

    {
      "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"
    }

Дальнейшие шаги

• Создание и изменение правил сбора данных
• Сравнение пакетных запросов API плоскости данных и экспорта метрик
• Правила сбора данных, обзор
• Рекомендации по созданию правила сбора данных и управлению ими в Azure Monitor