مراقبة Azure Digital Twins باستخدام المقاييس والتنبيهات والتشخيصات

يتكامل Azure Digital Twins مع Azure Monitor لتوفير المقاييس والمعلومات التشخيصية التي يمكنك استخدامها لمراقبة موارد Azure Digital Twins. يتم تمكين المقاييس بشكل افتراضي، وتمنحك معلومات حول حالة موارد Azure Digital Twins في اشتراك Azure الخاص بك. يمكن للتنبيهات إعلامك بشكل استباقي عند العثور على شروط معينة في بيانات المقاييس الخاصة بك. يمكنك أيضا جمع سجلات التشخيص لمثيل الخدمة لمراقبة أدائه والوصول إليه وبيانات أخرى.

يمكن أن تساعدك ميزات المراقبة هذه في تقييم الصحة العامة لخدمة Azure Digital Twins والموارد المتصلة بها. يمكنك استخدامها لفهم ما يحدث في مثيل Azure Digital Twins الخاص بك، وتحليل الأسباب الجذرية بشأن المشكلات دون الحاجة إلى الاتصال بدعم Azure.

يمكن الوصول إليها من مدخل Microsoft Azure، مجمعة تحت عنوان المراقبة لمورد Azure Digital Twins.

المقاييس والتنبيهات

للحصول على معلومات عامة حول عرض مقاييس موارد Azure، راجع بدء استخدام مستكشف المقاييس في وثائق Azure Monitor. للحصول على معلومات عامة حول تكوين التنبيهات لمقاييس Azure، راجع إنشاء قاعدة تنبيه جديدة.

يصف الجزء المتبقي من هذا القسم المقاييس التي يتم تعقبها بواسطة كل مثيل Azure Digital Twins، وكيفية ارتباط كل مقياس بالحالة الإجمالية للمثيل الخاص بك.

مقاييس لتتبع حدود الخدمة

يمكنك تكوين هذه المقاييس لتتبع وقت الاقتراب من حد الخدمة المنشورة لبعض جوانب الحل الخاص بك.

لإعداد التعقب، استخدم ميزة التنبيهات في Azure Monitor. يمكنك وضع حدود لهذه المقاييس بحيث تتلقى تنبيهًا عندما يصل المقياس إلى نسبة مئوية معينة من حده المنشور.

مقاييس طلب واجهة برمجة التطبيقات

المقاييس التي لها علاقة بطلبات واجهة برمجة التطبيقات:

مقاييس الفوترة

المقاييس التي لها علاقة بالفوترة:

لمزيد من المعلومات حول طريقة فوترة Azure Digital Twins، راجع تسعير Azure Digital Twins.

مقاييس الإدخال

المقاييس المتعلقة بإدخال البيانات:

مقاييس العملية المجمعة (من واجهات برمجة تطبيقات الوظائف)

المقاييس التي لها علاقة بالعمليات المجمعة من واجهات برمجة تطبيقات الوظائف:

مقاييس التوجيه

المقاييس المتعلقة بالتوجيه:

أبعاد المقاييس

تساعد الأبعاد في تحديد مزيد من التفاصيل حول المقاييس. توفّر بعض مقاييس التوجيه معلومات لكل نقطة نهاية. يسرد الجدول أدناه القيم المحتملة لهذه الأبعاد.

سجلات التشخيص

للحصول على معلومات عامة حول إعدادات تشخيص Azure، بما في ذلك كيفية تمكينها، راجع إعدادات التشخيص في Azure Monitor. للحصول على معلومات حول الاستعلام عن سجلات التشخيص باستخدام Log Analytics، راجع نظرة عامة على Log Analytics في Azure Monitor.

يصف باقي هذا القسم فئات سجل التشخيص التي يمكن ل Azure Digital Twins جمعها، ومخططاتها.

فئات السجلات

فيما يلي مزيد من التفاصيل حول فئات السجلات التي تجمعها Azure Digital Twins.

تتكون كل فئة من فئات السجل من عمليات الكتابة والقراءة والحذف والعمل. يتم تعيين هذه الفئات إلى استدعاءات REST API كما يلي:

فيما يلي قائمة شاملة بالعمليات واستدعاءات Azure Digital Twins REST API المقابلة التي تم تسجيلها في كل فئة.

مخططات السجل

تحتوي كل فئة سجل على مخطط يحدد كيفية الإبلاغ عن الأحداث في تلك الفئة. يتم تخزين كل إدخال فردي في السجل كنص ويتم تنسيقه على هيئة JSON blob. يتم توفير الحقول الموجودة في السجل وأمثلة نصوص JSON لكل نوع سجل أدناه.

ADTDigitalTwinsOperation، ADTModelsOperation، واستخدم ADTQueryOperation مخطط سجل API متناسق. ADTEventRoutesOperation توسيع المخطط ليحتوي على endpointName حقل في الخصائص.

مخططات سجل API

مخطط السجل هذا متناسق ل ADTDigitalTwinsOperation، ، ADTModelsOperation. ADTQueryOperation يتم استخدام نفس المخطط أيضا ل ADTEventRoutesOperation، باستثناء Microsoft.DigitalTwins/eventroutes/action اسم العملية (لمزيد من المعلومات حول هذا المخطط، راجع القسم التالي، مخططات سجل الخروج).

يحتوي المخطط على معلومات ذات صلة باستدعاءات واجهة برمجة التطبيقات إلى مثيل Azure Digital Twins.

فيما يلي وصف الحقول والخصائص لسجلات API.

فيما يلي أمثلة على أجسام JSON لهذه الأنواع من السجلات.

ADTDigitalTwinsOperation

{
  "time": "2020-03-14T21:11:14.9918922Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/digitaltwins/write",
  "operationVersion": "2020-10-31",
  "category": "DigitalTwinOperation",
  "resultType": "Success",
  "resultSignature": "200",
  "resultDescription": "",
  "durationMs": 8,
  "callerIpAddress": "13.68.244.*",
  "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/digitaltwins/factory-58d81613-2e54-4faa-a930-d980e6e2a884?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTModelsOperation

{
  "time": "2020-10-29T21:12:24.2337302Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/models/write",
  "operationVersion": "2020-10-31",
  "category": "ModelsOperation",
  "resultType": "Success",
  "resultSignature": "201",
  "resultDescription": "",
  "durationMs": "80",
  "callerIpAddress": "13.68.244.*",
  "correlationId": "bbbb1111-cc22-3333-44dd-555555eeeeee",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/Models?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTQueryOperation

{
  "time": "2020-12-04T21:11:44.1690031Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/query/action",
  "operationVersion": "2020-10-31",
  "category": "QueryOperation",
  "resultType": "Success",
  "resultSignature": "200",
  "resultDescription": "",
  "durationMs": "314",
  "callerIpAddress": "13.68.244.*",
  "correlationId": "cccc2222-dd33-4444-55ee-666666ffffff",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/query?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTEventRoutesOperation

فيما يلي مثال على نص JSON ل ADTEventRoutesOperation الذي ليس من Microsoft.DigitalTwins/eventroutes/action النوع (لمزيد من المعلومات حول هذا المخطط، راجع القسم التالي، مخططات سجل الخروج).

  {
    "time": "2020-10-30T22:18:38.0708705Z",
    "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
    "operationName": "Microsoft.DigitalTwins/eventroutes/write",
    "operationVersion": "2020-10-31",
    "category": "EventRoutesOperation",
    "resultType": "Success",
    "resultSignature": "204",
    "resultDescription": "",
    "durationMs": 42,
    "callerIpAddress": "212.100.32.*",
    "correlationId": "dddd3333-ee44-5555-66ff-777777aaaaaa",
    "identity": {
      "claims": {
        "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
      }
    },
    "level": "4",
    "location": "southcentralus",
    "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/EventRoutes/egressRouteForEventHub?api-version=2020-10-31",
    "properties": {},
    "traceContext": {
      "traceId": "95ff77cfb300b04f80d83e64d13831e7",
      "spanId": "b630da57026dd046",
      "parentId": "9f0de6dadae85945",
      "traceFlags": "01",
      "tracestate": "k1=v1,k2=v2"
    }
  },

مخططات سجل الخروج

المثال التالي هو مخطط السجلات ADTEventRoutesOperation الخاصة Microsoft.DigitalTwins/eventroutes/action باسم العملية. تحتوي هذه على تفاصيل تتعلق بالاستثناءات وعمليات واجهة برمجة التطبيقات حول نقاط نهاية الخروج المتصلة بمثيل Azure Digital Twins.

فيما يلي مثال على نص JSON لهذا ADTEventRoutesOperationMicrosoft.DigitalTwins/eventroutes/action النوع.

{
  "time": "2020-11-05T22:18:38.0708705Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/eventroutes/action",
  "operationVersion": "",
  "category": "EventRoutesOperation",
  "resultType": "",
  "resultSignature": "",
  "resultDescription": "Unable to send EventHub message to [myPath] for event Id [f6f45831-55d0-408b-8366-058e81ca6089].",
  "durationMs": -1,
  "callerIpAddress": "",
  "correlationId": "dddd3333-ee44-5555-66ff-777777aaaaaa",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "",
  "properties": {
    "endpointName": "myEventHub"
  },
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
},

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

اقرأ المزيد حول Azure Monitor وقدراته في وثائق Azure Monitor.