مشاركة عبر

تصدير المقاييس من خلال قواعد جمع البيانات (معاينة)

  • مقالة

تستخدم قواعد جمع البيانات (DCRs) لجمع بيانات المراقبة من موارد Azure. للحصول على قائمة بسيناريو جمع البيانات، راجع قواعد جمع البيانات - نظرة عامة. يمكنك الآن استخدام DCRs لجمع مقاييس النظام الأساسي وتصديرها.

حاليا، يمكن جمع مقاييس النظام الأساسي باستخدام كل من إعدادات DCR والتشخيص. يدعم عدد متزايد من الموارد تصدير المقاييس باستخدام DCRs. راجع الموارد والمناطق المدعومة للحصول على قائمة بالموارد الداعمة.

يوفر استخدام DCRs لتصدير المقاييس المزايا التالية على إعدادات التشخيص:

  • يتيح تكوين DCR تصدير المقاييس ذات الأبعاد.
  • يتيح تكوين DCR التصفية استنادا إلى اسم القياس - بحيث يمكنك تصدير المقاييس التي تحتاجها فقط.
  • DCRs أكثر مرونة وقابلية للتطوير مقارنة بإعدادات التشخيص.
  • زمن الانتقال من طرف إلى طرف ل DCRs في غضون 3 دقائق. هذا تحسين كبير على إعدادات التشخيص حيث يكون زمن انتقال تصدير المقاييس من 6 إلى 10 دقائق.

استخدم تصدير المقاييس من خلال DCRs للتصدير المستمر لبيانات المقاييس. للاستعلام عن البيانات التاريخية ، استخدم واجهة برمجة تطبيقات Batch لمقاييس مستوى البيانات. للمقارنة بين الخدمتين، راجع استعلام واجهة برمجة تطبيقات Batch لمقاييس مستوى البيانات مقابل تصدير المقاييس.

إنشاء DCRs للمقاييس باستخدام واجهة برمجة تطبيقات REST أو Azure CLI أو Azure PowerShell. للحصول على معلومات حول كيفية إنشاء DCRs لتصدير المقاييس، راجع إنشاء قواعد جمع البيانات للمقاييس.

عند إنشاء DCR، يجب إنشاء اقتران قاعدة تجميع البيانات (DCRA) لربط DCR بالمورد المراد مراقبته. يمكنك إنشاء DCR واحد للعديد من أنواع الموارد. للحصول على معلومات حول كيفية إنشاء DCRA، راجع إنشاء اقترانات قواعد تجميع البيانات. عند استخدام مدخل Microsoft Azure، يتم إنشاء DCRA تلقائيا.

إشعار

من الممكن استخدام DCRs وإعدادات التشخيص في نفس الوقت. نوصي بتعطيل إعدادات التشخيص للمقاييس عند استخدام DCRs لتجنب تكرار جمع البيانات.

وجهات التصدير

يمكن تصدير المقاييس إلى إحدى الوجهات التالية لكل DCR:

  • مساحات عمل Log Analytics.
    يمكن أن يكون التصدير إلى مساحات عمل Log Analytics عبر المناطق. يجب أن تكون مساحة عمل Log Analytics وDCR في نفس المنطقة ولكن يمكن أن تكون الموارد التي تتم مراقبتها في أي منطقة. يتم تخزين المقاييس المرسلة إلى مساحة عمل تحليلات السجل في AzureMetricsV2 الجدول.

  • حسابات تخزين Azure.
    يجب أن يكون حساب التخزين وDCR والموارد التي تتم مراقبتها كلها في نفس المنطقة.

  • مراكز الأحداث.
    يجب أن تكون مراكز الأحداث وDCR والموارد التي تتم مراقبتها كلها في نفس المنطقة.

للحصول على عينة من البيانات في كل وجهة، راجع البيانات المصدرة.

إشعار

زمن الانتقال لتصدير المقاييس حوالي 3 دقائق. السماح بما يصل إلى 15 دقيقة حتى تبدأ المقاييس في الظهور في الوجهة بعد الإعداد الأولي.

القيود

DCRs لتصدير المقاييس لها القيود التالية:

  • يمكن تحديد نوع وجهة واحد فقط لكل DCR.
  • يمكن ربط 5 DCRs كحد أقصى بمورد Azure واحد.

الموارد والمناطق المدعومة

تدعم الموارد التالية تصدير المقاييس باستخدام قواعد جمع البيانات:

نوع المورد مواصفات الدفق
مجموعات مقياس الآلة الافتراضية Microsoft.compute/virtualmachinescalesets
الأجهزة الظاهرية Microsoft.compute/virtualmachines
ذاكرة تخزين مؤقت Redis Microsoft.cache/redis
مراكز IOT Microsoft.devices/iothubs
خزائن المفاتيح Microsoft.keyvault/vaults
حسابات التخزين⁧ حسابات التخزين/التخزين من Microsoft
Microsoft.storage/Storageaccounts/blobservices
Microsoft.storage/storageaccounts/fileservices
Microsoft.storage/storageaccounts/queueservices
Microsoft.storage/storageaccounts/tableservices
SQL Server Microsoft.sql/الخوادم
Microsoft.sql/الخوادم/قواعد البيانات
المشكلات التشغيلية Microsoft.operationalinsights/workspaces
Media Services Microsoft.media/mediaservices
Microsoft.media/mediaservices/streamingendpoints
Microsoft.media/mediaservices/liveevents
حماية البيانات Microsoft.dataprotection/backupvaults
Azure Kubernetes Service Microsoft.ContainerService/managedClusters

المناطق المدعومة

يمكنك إنشاء DCR لتصدير المقاييس في أي منطقة، ولكن يجب أن تكون الموارد التي تريد تصدير المقاييس منها في إحدى المناطق التالية:

  • شرق أستراليا
  • Central US
  • CentralUsEuap
  • South Central US
  • شرق الولايات المتحدة
  • East US 2
  • Eastus2Euap
  • غرب الولايات المتحدة
  • West US 2
  • أوروبا الشمالية
  • أوروبا الغربية
  • جنوب المملكة المتحدة

مواصفات DCR

يتم تعريف قواعد جمع البيانات في كائن JSON. الخصائص التالية مطلوبة لإنشاء DCR لتصدير المقاييس.

الخاصية ‏‏الوصف
dataSources.platformTelemetry.streams يسرد أنواع الموارد والمقاييس. حدد Metrics-Group-All لتجميع جميع المقاييس للمورد أو حدد مقاييس فردية. تنسيق: <resource type>:Metrics-Group-All | <metric name>
على سبيل المثال، Microsoft.Compute/virtualMachines:Percentage CPU
dataSources.platformTelemetry.name اسم مصدر البيانات.
destinations وجهة المقاييس. يتم دعم وجهة واحدة فقط لكل DCR.
أنواع الوجهات الصالحة:
storageAccounts
logAnalytics
eventHubs
dataflows.streams قائمة بالتدفقات لتمريرها إلى الوجهة بالتنسيق: <resource type>:Metrics-Group-All |<metric name>
على سبيل المثال، Microsoft.Compute/virtualMachines:النسبة المئوية لوحدة المعالجة المركزية"
dataflows.destinations الوجهة لتمرير التدفقات إلى كما هو محدد في الخاصية destinations .
identity.type نوع الهوية المراد استخدامه ل DCR. مطلوب لوجهات حساب التخزين.
القيم الصالحة:
systemAssigned
userAssigned
kind نوع قاعدة جمع البيانات. تعيين إلى PlatformTelemetry لتصدير المقاييس.
location موقع DCR.

إشعار

يمكن تحديد نوع وجهة واحد فقط لكل 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"
}

إشعار

عند إنشاء DCR لتصدير المقاييس باستخدام CLI و kindlocationو و identity و كوسيطات ويجب إزالتها من كائن JSON.

الهويات المعينة من قبل المستخدم والنظام

يتم دعم كل من الهويات المعينة للمستخدم والنظام عند إنشاء DCRs. مطلوب هوية لوجهات حساب التخزين ومراكز الأحداث. يمكنك استخدام هوية النظام المعينة أو المعينة من قبل المستخدم. لمزيد من المعلومات، راجع تعيين أدوار 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

تظهر الأمثلة التالية نموذج كائنات DCR JSON لتصدير المقاييس إلى كل نوع وجهة.

مساحات عمل Log Analytics

يوضح المثال التالي قاعدة تجميع بيانات للمقاييس التي ترسل مقاييس محددة من الأجهزة الظاهرية ومجموعات مقياس الجهاز الظاهري وجميع مقاييس المخزن الرئيسي إلى مساحة عمل Log Analytics:

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

إنشاء DCRs لتصدير المقاييس

إنشاء DCRs لتصدير المقاييس باستخدام مدخل Microsoft Azure أو CLI أو PowerShell أو REST API أو قالب ARM. لمزيد من المعلومات، راجع إنشاء قواعد جمع البيانات (DCRs) والاقترانات وتحريرها في Azure Monitor.

البيانات المصدرة

توضح الأمثلة التالية البيانات المصدرة إلى كل وجهة.

مساحات عمل تحليلات السجل

يتم تخزين البيانات المصدرة إلى مساحة عمل Log Analytics في AzureMetricsV2 الجدول في مساحة عمل Log Analytics بالتنسيق التالي:

Column نوع ‏‏الوصف
المتوسط real متوسط القيمة التي تم جمعها أثناء في النطاق الزمني.
_BilledSize real حجم السجل بالبايت
عدد real عدد العينات التي تم جمعها خلال النطاق الزمني.
البُعد ديناميكي البعد المقترن بالمقياس بتنسيق JSON.
_IsBillable سلسلة تحديد ما إذا كان استيعاب البيانات قابلا للفوترة. عندما _IsBillable لا false تتم فوترة الاستيعاب إلى حساب Azure الخاص بك
الحد الأقصى real الحد الأقصى للقيمة التي تم جمعها أثناء في النطاق الزمني.
MetricCategory سلسلة اسم فئة المقياس.
MetricName سلسلة اسم العرض للمقياس.
MetricResourceType سلسلة نوع المورد لمورد Azure الذي يبلغ عن المقياس.
الحد الأدنى real الحد الأدنى للقيمة التي تم جمعها أثناء في النطاق الزمني.
_ResourceId سلسلة معرّف فريد للمورد الذي يقترن به السجل
نظام المصدر سلسلة نوع العامل الذي تم جمع الحدث من قبله. على سبيل المثال، OpsManager بالنسبة لعامل Windows، إما الاتصال المباشر أو Operations Manager، Linux لجميع عوامل Linux، أو Azure لتشخيص Azure
_SubscriptionId سلسلة معرّف فريد للاشتراك الذي يقترن السجل به
TenantId سلسلة معرف مساحة عمل Log Analytics
TimeGenerated datetime الطابع الزمني (UTC) عند إنشاء السجل.
TimeGrain سلسلة الفترة الزمنية للمقياس.
الإجمالي real مجموع كافة القيم في النطاق الزمني.
نوع سلسلة اسم الجدول
اسم الوحدة سلسلة وحدة المقياس.

على سبيل المثال:

لقطة شاشة لاستعلام تحليلات السجل لجدول AzureMetricsV2.

حسابات التخزين⁧

يوضح المثال التالي البيانات المصدرة إلى حساب تخزين:

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

الخطوات التالية