إعداد جدول باستخدام الخطة الإضافية في مساحة عمل Log Analytics (معاينة)

تتيح لك خطة الجدول المساعدة استيعاب البيانات والاحتفاظ بها في مساحة عمل Log Analytics بتكلفة منخفضة. تدعم سجلات Azure Monitor حاليا خطة الجدول المساعدة على الجداول المخصصة المستندة إلى قاعدة جمع البيانات (DCR) التي ترسل إليها البيانات التي تجمعها باستخدام عامل Azure Monitor أو واجهة برمجة تطبيقات استيعاب السجلات.

تشرح هذه المقالة كيفية إنشاء جدول مخصص باستخدام الخطة الإضافية في مساحة عمل Log Analytics وإعداد قاعدة تجميع بيانات ترسل البيانات إلى هذا الجدول.

فيما يلي مقطع فيديو يشرح بعض استخدامات وفوائد خطة الجدول المساعدة:

هام

راجع قيود المعاينة العامة للمناطق والقيود المدعومة المتعلقة بالجداول المساعدة وقواعد جمع البيانات.

المتطلبات الأساسية

لإنشاء جدول مخصص وجمع بيانات السجل، تحتاج إلى:

  • مساحة عمل Log Analytics حيث لديك حقوق المساهم على الأقل.
  • نقطة نهاية تجميع البيانات (DCE).
  • تحتوي جميع الجداول في مساحة عمل Log Analytics على عمود يسمى TimeGenerated. إذا كانت بيانات السجل الخام الخاصة بك تحتوي على TimeGenerated خاصية، فإن Azure Monitor يستخدم هذه القيمة لتحديد وقت إنشاء السجل. بالنسبة للجدول الذي يحتوي على الخطة الإضافية، TimeGenerated يدعم العمود حاليا تنسيق ISO8601 فقط. للحصول على TimeGenerated معلومات حول التنسيق، راجع تنسيق التاريخ والوقت المعتمد ISO 8601.

إنشاء جدول مخصص باستخدام الخطة الإضافية

لإنشاء جدول مخصص، قم باستدعاء الجداول - إنشاء أو تحديث واجهة برمجة التطبيقات باستخدام هذا الأمر:

https://management.azure.com/subscriptions/{subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.OperationalInsights/workspaces/{workspace_name}/tables/{table name_CL}?api-version=2023-01-01-preview

هام

يتيح لك إصدار 2023-01-01-preview واجهة برمجة التطبيقات فقط حاليا تعيين خطة الجدول المساعد.

توفير هذه الحمولة - تحديث اسم الجدول وضبط الأعمدة استنادا إلى مخطط الجدول:

 {
    "properties": {
        "schema": {
            "name": "table_name_CL",
            "columns": [
                {
                    "name": "TimeGenerated",
                    "type": "datetime"
                },
                {
                    "name": "StringProperty",
                    "type": "string"
                },
                {
                    "name": "IntProperty",
                    "type": "int"
                },
                 {
                    "name": "LongProperty",
                    "type": "long"
                },
                 {
                    "name": "RealProperty",
                    "type": "real"
                },
                 {
                    "name": "BooleanProperty",
                    "type": "boolean"
                },
                 {
                    "name": "GuidProperty",
                    "type": "real"
                },
                 {
                    "name": "DateTimeProperty",
                    "type": "datetime"
                }
            ]
        },
        "totalRetentionInDays": 365,
        "plan": "Auxiliary"
    }
}

إرسال البيانات إلى جدول باستخدام الخطة الإضافية

هناك حاليا طريقتان لاستيعاب البيانات في جدول مخصص باستخدام الخطة الإضافية:

  • اجمع السجلات من ملف نصي باستخدام عامل / Azure Monitor تجميع السجلات من ملف JSON باستخدام عامل Azure Monitor.

    إذا كنت تستخدم هذا الأسلوب، يجب أن يحتوي الجدول المخصص على عمودين فقط - TimeGenerated و RawData (من النوع string). ترسل قاعدة جمع البيانات بالكامل كل إدخال سجل تجمعه إلى RawData العمود، وتملأ TimeGenerated سجلات Azure Monitor العمود تلقائيا مع وقت استيعاب السجل.

  • إرسال البيانات إلى Azure Monitor باستخدام واجهة برمجة تطبيقات استيعاب السجلات.

    لاستخدام هذا الأسلوب:

    1. إنشاء جدول مخصص باستخدام الخطة الإضافية كما هو موضح في هذه المقالة.

    2. اتبع الخطوات الموضحة في البرنامج التعليمي: إرسال البيانات إلى Azure Monitor باستخدام واجهة برمجة تطبيقات استيعاب السجلات إلى:

      1. إنشاء تطبيق Microsoft Entra.
      2. إنشاء قاعدة تجميع بيانات باستخدام قالب ARM هذا.
      {
          "$schema": "https://schema.management.azure.com/schemas/2019-08-01/deploymentTemplate.json#",
          "contentVersion": "1.0.0.0",
          "parameters": {
              "dataCollectionRuleName": {
                  "type": "string",
                  "metadata": {
                      "description": "Specifies the name of the data collection rule to create."
                  }
              },
              "location": {
                  "type": "string",
                  "metadata": {
                      "description": "Specifies the region in which to create the data collection rule. The must be the same region as the destination Log Analytics workspace."
                  }
              },
              "workspaceResourceId": {
                  "type": "string",
                  "metadata": {
                      "description": "The Azure resource ID of the Log Analytics workspace in which you created a custom table with the Auxiliary plan."
                  }
              }
          },
          "resources": [
              {
                  "type": "Microsoft.Insights/dataCollectionRules",
                  "name": "[parameters('dataCollectionRuleName')]",
                  "location": "[parameters('location')]",
                  "apiVersion": "2023-03-11",
                  "kind": "Direct",
                  "properties": {
                      "streamDeclarations": {
                          "Custom-table_name_CL": {
                              "columns": [
                                  {
                                      "name": "TimeGenerated",
                                      "type": "datetime"
                                  },
                                  {
                                      "name": "StringProperty",
                                      "type": "string"
                                  },
                                  {
                                      "name": "IntProperty",
                                      "type": "int"
                                  },
                                  {
                                      "name": "LongProperty",
                                      "type": "long"
                                  },
                                  {
                                      "name": "RealProperty",
                                      "type": "real"
                                  },
                                  {
                                      "name": "BooleanProperty",
                                      "type": "boolean"
                                  },
                                  {
                                      "name": "GuidProperty",
                                      "type": "real"
                                  },
                                  {
                                      "name": "DateTimeProperty",
                                      "type": "datetime"
                                  }
                                      ]
                                      }
                                  },
                      "destinations": {
                          "logAnalytics": [
                              {
                                  "workspaceResourceId": "[parameters('workspaceResourceId')]",
                                  "name": "myworkspace"
                              }
                          ]
                      },
                      "dataFlows": [
                          {
                              "streams": [
                                  "Custom-table_name_CL"
                              ],
                              "destinations": [
                                  "myworkspace"
                              ]
                          }
                      ]
                  }
              }
          ],
          "outputs": {
              "dataCollectionRuleId": {
                  "type": "string",
                  "value": "[resourceId('Microsoft.Insights/dataCollectionRules', parameters('dataCollectionRuleName'))]"
              }
          }
      }
      

      المكان:

    3. امنح التطبيق الخاص بك الإذن لاستخدام DCR الخاص بك.

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

أثناء المعاينة العامة، تنطبق هذه القيود:

  • ويجري تدريجيا نشر الخطة الإضافية في جميع المناطق وهي مدعومة حاليا في:

    المنطقة المواقع
    الأمريكتان وسط كندا
    Central US
    شرق الولايات المتحدة
    East US 2
    غرب الولايات المتحدة
    South Central US
    وسط شمال الولايات المتحدة
    منطقة آسيا المطلة على المحيط الهادئ شرق أستراليا
    جنوب شرق أستراليا
    ‏‏أوروبا شرق آسيا
    أوروبا الشمالية
    جنوب المملكة المتحدة
    وسط غرب ألمانيا
    شمال سويسرا
    وسط فرنسا
    الشرق الأوسط إسرائيل الوسطى
  • يمكنك تعيين الخطة الإضافية فقط على الجداول المخصصة المستندة إلى قواعد جمع البيانات التي تقوم بإنشائها باستخدام الجداول - إنشاء أو تحديث API، الإصدار 2023-01-01-preview.

  • جداول مع الخطة المساعدة:

    • غير المفهين حاليا. لا توجد حاليا رسوم على الاستيعاب والاستعلامات ووظائف البحث والاستبقاء على المدى الطويل.
    • لا تدعم الأعمدة التي تحتوي على بيانات ديناميكية.
    • استبقاء إجمالي ثابت لمدة 365 يوما.
    • دعم تنسيق التاريخ والوقت ISO 8601 فقط.
  • قاعدة تجميع البيانات التي ترسل البيانات إلى جدول مع خطة مساعدة:

    • يمكنه إرسال البيانات إلى جدول واحد فقط.
    • لا يمكن تضمين تحويل.
  • لا تتوفر بيانات الاستيعاب للجداول المساعدة حاليا في جدول استخدام سجلات Azure Monitor. لتقدير حجم استيعاب البيانات، يمكنك حساب عدد السجلات في الجدول المساعد باستخدام هذا الاستعلام:

    MyTable_CL
    | summarize count()
    
  • هذه الميزات غير مدعومة حاليا:

    ميزة تفاصيل
    النسخ المتماثل لمساحة عمل Log Analytics لا يقوم Azure Monitor بنسخ البيانات نسخا متماثلا في الجداول باستخدام الخطة الإضافية إلى مساحة العمل الثانوية. لذلك، هذه البيانات غير محمية من فقدان البيانات في حالة حدوث فشل إقليمي ولا تتوفر عند نقلها إلى مساحة العمل الثانوية.
    المفاتيح التي يديرها العميل يتم تشفير البيانات في الجداول التي تحتوي على الخطة المساعدة باستخدام مفاتيح تديرها Microsoft، حتى إذا قمت بحماية البيانات في بقية مساحة عمل Log Analytics باستخدام مفتاح التشفير الخاص بك.
    مربع تأمين العميل لـ Microsoft Azure لا تنطبق واجهة Lockbox، التي تتيح لك مراجعة طلبات الوصول إلى بيانات العميل والموافقة عليها أو رفضها استجابة لتذكرة دعم بدأها العميل أو مشكلة حددتها Microsoft على الجداول ذات الخطة الإضافية.

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

تعلم المزيد عن: