تسجيل Azure Data Manager للزراعة

بعد إنشاء مثيل مورد إدارة البيانات للزراعة، يمكنك مراقبة كيفية ووقت الوصول إلى مواردك، ومن قبل من. يمكنك أيضا تصحيح أسباب فشل طلبات مستوى البيانات. للقيام بذلك، تحتاج إلى تمكين التسجيل ل Azure Data Manager للزراعة. يمكنك بعد ذلك حفظ معلومات السجل في وجهة مثل حساب تخزين أو مركز أحداث أو مساحة عمل تحليلات السجل، التي توفرها.

توفر لك هذه المقالة خطوات إعداد التسجيل ل Azure Data Manager for Agriculture.

تمكين مجموعة السجلات

بعد إنشاء Data Manager لمورد خدمة الزراعة، انتقل إلى إعدادات التشخيص ثم حدد add diagnostics settings. اتبع هذه الخطوات لبدء جمع السجلات وتخزينها:

  1. أدخل اسمًا لإعداد التشخيص.
  2. حدد الفئات التي تريد البدء في جمع السجلات لها.
  3. اختر وجهة التجميع من حساب التخزين أو مركز الأحداث أو مساحة عمل تحليلات السجل.

Screenshot showing steps to create diagnostics setting in Azure portal.

يمكنك الآن الانتقال إلى الوجهة التي حددتها في إعداد التشخيص للوصول إلى السجلات. يمكنك الوصول إلى معلومات التسجيل الخاصة بك بعد 10 دقائق (على الأكثر) من عملية إدارة البيانات للزراعة. في معظم الحالات، يكون الأمر أسرع.

تفسير سجلاتك

يتبع كل سجل المخطط المدرج في الجدول. يحتوي الجدول على أسماء الحقول والأوصاف:

اسم الحقل ‏‏الوصف
الوقت التاريخ والوقت بالتوقيت عالمي المتفق عليه.
resourceId معرف مورد Azure Resource Manager. بالنسبة للسجلات، هذا هو معرف مورد إدارة البيانات للزراعة.
اسم العملية اسم العملية، كما هو موثق.
operationVersion طلب العميل إصدار واجهة برمجة تطبيقات REST.
الفئة نوع النتيجة.
resultType نتيجة طلب واجهة برمجة تطبيقات REST (النجاح أو الفشل).
resultSignature حالة HTTP.
resultDescription وصف إضافي حول النتيجة، عند توفرها.
durationMs الوقت المستغرق في خدمة طلب واجهة برمجة تطبيقات REST، بالمللي ثانية.
CallerIpAddress عنوان IP للعميل الذي قدم الطلب.
مستوي مستوى خطورة الحدث (معلوماتي أو تحذيري أو خطأ أو حرج).
correlationId GUID اختياري يمكن استخدامه لربط السجلات.
الهوية الهوية من الرمز المميز الذي تم تقديمه في طلب واجهة برمجة تطبيقات REST. عادة ما يكون هذا معرف كائن ومعرف تطبيق أو أي من الاثنين.
موقع منطقة المورد الذي ينبعث منها الحدث مثل "شرق الولايات المتحدة"
الخصائص operationName لكل منها يحتوي على: requestUri (URI لطلب واجهة برمجة التطبيقات)، partyId(partyId المقترن بالطلب، حيثما ينطبق)،dataPlaneResourceId (المعرف الذي يعرف مورد مستوى البيانات بشكل فريد في الطلب) و requestBody (يحتوي على نص الطلب لاستدعاء API المقترن operationName بجميع الفئات بخلاف ApplicationAuditLogs).
بخلاف الشائعة المذكورة قبل jobProcessesLogs الفئة لديها:
1. هذه القائمة من الحقول عبر operationNames:
jobRunType (يمكن أن تكون oneTime أو دورية)، (معرف المهمة)، jobIdinitiatedBy (تشير إلى ما إذا كان تم تشغيل مهمة من قبل مستخدم أو بواسطة الخدمة).
2. هذه القائمة هي حقول للوظائف المتعلقة بفشل farmOperation:
farmOperationEntityId (معرف الكيان الذي فشل إنشاؤه بواسطة مهمة farmOperation)، farmOperationEntityType(نوع الكيان الذي فشل إنشاؤه)، errorCode(التعليمات البرمجية لفشل المهمة)، errorMessage(وصف الفشل الذي يوفره الموفرinternalErrorMessageinternalErrorCode(وصف الفشل الذي يوفره الموفر)، providerId(معرف الموفر).

categories يمكن أن يحتوي حقل Data Manager للزراعة على قيم مدرجة في الجدول التالي:

جدول الفئات

فئة ‏‏الوصف
سجلات إدارة المزرعة سجلات لعمليات CRUD للحفلات والمزرعة والحقول والحقول الموسمية والقص والقص والقصة والموسم والمرفق وخرائط الوصفات الطبية والوصفات الطبية ومناطق الإدارة والمناطق وتحليل الأنسجة النباتية وتحليل العناصر الغذائية.
سجلات عمليات المزرعة سجلات لعمليات CRUD لمهمة استيعاب بيانات FarmOperations، ApplicationData، PlantingData، HarvestingData، TillageData
سجلات الأقمار الصناعية سجلات لإنشاء والحصول على عمليات لمهمة استيعاب بيانات الأقمار الصناعية
سجلات الطقس سجلات لإنشاء وحذف والحصول على عمليات لمهمة استيعاب بيانات الطقس
سجلات مصادقة الموفر سجلات الإنشاء والتحديث والحذف وتتالي الحذف والحصول على الكل لموفري Oauth. كما أنه يحتوي على سجلات للحصول على، والحصول على الكل، وتتالي حذف رموز oauth المميزة.
سجلات العمل المجهزة سجلات تشير إلى النجاح أو الفشل وسبب الفشل للوظائف. بالإضافة إلى سجلات تتالي الموارد لحذف المهام ووظائف استيعاب البيانات، فإنه يحتوي أيضا على سجلات لعمليات المزرعة ووظائف معالجة الأحداث.
سجلات الاستدلال النموذجي سجلات لإنشاء والحصول على عمليات لوظيفة نموذج الكتلة الحيوية.
سجلات Insight سجلات للحصول على جميع العمليات للحصول على نتائج التحليلات والحصول عليها.
سجلات تدقيق التطبيق سجلات للإجراءات المميزة مثل إنشاء موارد مستوى البيانات وتحديثها وحذفها وعمليات إدارة الاشتراك. القائمة الكاملة موجودة في جدول اسم العملية أدناه.

operationName قيم الحقول بتنسيق Microsoft.AgFoodPlatform/resource-name/read أو write أو delete أو action.

  • /write اللاحقة في اسم العملية تتوافق مع إنشاء أو تحديث اسم المورد
  • /readتتوافق اللاحقة في اسم العملية مع استدعاءات GET/ LIST /GET ALL API أو حالة GET لمهمة الحذف المتتالية لاسم المورد
  • /delete اللاحقة تتوافق مع حذف اسم المورد
  • /action تتوافق اللاحقة مع استدعاءات أسلوب POST لاسم مورد
  • /processed تتوافق اللاحقة مع إكمال مهمة (استدعاء أسلوب PUT). يشير هذا إلى حالة الوظيفة (النجاح أو الفشل).
  • /failures تتوافق اللاحقة مع فشل مهمة عملية المزرعة (استدعاء أسلوب PUT) وتحتوي على وصف حول سبب الفشل.

التسمية للوظائف هي كما يلي:

  • لمهام استيعاب البيانات: Microsoft.AgFoodPlatform/ingestionJobs/<'resource-name'DataingestionJobs>/write
  • لمهام الحذف: Microsoft.AgFoodPlatform/deletionJobs/<'resource-name'cascadeDeleteJobs>/write

يسرد الجدول التالي قيم operationName والأوامر المقابلة لواجهة برمجة تطبيقات REST لفئة كعلامة تبويب:

سجلات إدارة المزرعة

اسم العملية
Microsoft.AgFoodPlatform/farmers/write
Microsoft.AgFoodPlatform/farmers/read
Microsoft.AgFoodPlatform/deletionJobs/farmersCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/farms/write
Microsoft.AgFoodPlatform/farms/read
Microsoft.AgFoodPlatform/farms/delete
Microsoft.AgFoodPlatform/deletionJobs/farmsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/field/write
Microsoft.AgFoodPlatform/field/read
Microsoft.AgFoodPlatform/field/delete
Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/seasonalField/write
Microsoft.AgFoodPlatform/seasonalField/read
Microsoft.AgFoodPlatform/seasonalField/delete
Microsoft.AgFoodPlatform/deletionJobs/seasonalFieldsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/boundaries/write
Microsoft.AgFoodPlatform/boundaries/read
Microsoft.AgFoodPlatform/boundaries/delete
Microsoft.AgFoodPlatform/boundaries/action
Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/crops/write
Microsoft.AgFoodPlatform/crops/read
Microsoft.AgFoodPlatform/crops/delete
Microsoft.AgFoodPlatform/cropVarieties/write
Microsoft.AgFoodPlatform/cropVarieties/read
Microsoft.AgFoodPlatform/cropVarieties/delete
Microsoft.AgFoodPlatform/seasons/write
Microsoft.AgFoodPlatform/seasons/read
Microsoft.AgFoodPlatform/seasons/delete
Microsoft.AgFoodPlatform/attachments/write
Microsoft.AgFoodPlatform/attachments/read
Microsoft.AgFoodPlatform/attachments/delete
Microsoft.AgFoodPlatform/prescriptions/write
Microsoft.AgFoodPlatform/prescriptions/read
Microsoft.AgFoodPlatform/prescriptions/delete
Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeleteJobs/write
Microsoft.AgFoodPlatform/prescription الخرائط/write
Microsoft.AgFoodPlatform/prescription الخرائط/read
Microsoft.AgFoodPlatform/prescription الخرائط/delete
Microsoft.AgFoodPlatform/deletionJobs/prescription الخرائط CascadeDeleteJobs/write
Microsoft.AgFoodPlatform/managementZones/write
Microsoft.AgFoodPlatform/managementZones/read
Microsoft.AgFoodPlatform/managementZones/delete
Microsoft.AgFoodPlatform/deletionJobs/managementZonescascadeDeletejobs/write
Microsoft.AgFoodPlatform/zones/write
Microsoft.AgFoodPlatform/zones/read
Microsoft.AgFoodPlatform/zones/delete
Microsoft.AgFoodPlatform/deletionJobs/zonesCascadedeleteJobs/write
Microsoft.AgFoodPlatform/plantTissueanalyses/write
Microsoft.AgFoodPlatform/plantTissueanalyses/read
Microsoft.AgFoodPlatform/plantTissueanalyses/delete
Microsoft.AgFoodPlatform/deletionJobs/plantTissueanalysesCascadedeleteJobs/write
Microsoft.AgFoodPlatform/nutrientAnalyses/write
Microsoft.AgFoodPlatform/nutrientAnalyses/read
Microsoft.AgFoodPlatform/nutrientAnalyses/delete
Microsoft.AgFoodPlatform/deletionJobs/nutrientAnalysescascadeDeletejobs/delete

سجلات عمليات المزرعة

اسم العملية
Microsoft.AgFoodPlatform/ingetsionJobs/farmOperationsdataIngestionjobs/write
Microsoft.AgFoodPlatform/applicationData/read
Microsoft.AgFoodPlatform/applicationData/write
Microsoft.AgFoodPlatform/applicationData/delete
Microsoft.AgFoodPlatform/deletionJobs/applicationDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/plantingData/write
Microsoft.AgFoodPlatform/plantingData/read
Microsoft.AgFoodPlatform/plantingData/delete
Microsoft.AgFoodPlatform/deletionJobs/plantingDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/harvestingData/write
Microsoft.AgFoodPlatform/harvestingData/read
Microsoft.AgFoodPlatform/harvestingData/delete
Microsoft.AgFoodPlatform/deletionJobs/harvestingDatacascadeDeletejob/write
Microsoft.AgFoodPlatform/tillageData/Write
Microsoft.AgFoodPlatform/tillageData/Read
Microsoft.AgFoodPlatform/tillageData/Delete
Microsoft.AgFoodPlatform/deletionJobs/tillageDatacascadeDeletejob/write

سجلات الأقمار الصناعية

اسم العملية
Microsoft.AgFoodPlatform/ingestionJobs/satelliteDataingestionJob/write
Microsoft.AgFoodPlatform/scenes/read

سجلات الطقس

اسم العملية
Microsoft.AgFoodPlatform/ingestionJobs/weatherDataingestionJob/write
Microsoft.AgFoodPlatform/weather/read
Microsoft.AgFoodPlatform/deletionJobs/weatherDeletejob/delete

سجلات مصادقة الموفر

اسم العملية
Microsoft.AgFoodPlatform/oauthProviders/write
Microsoft.AgFoodPlatform/oauthProviders/read
Microsoft.AgFoodPlatform/oauthProviders/delete
Microsoft.AgFoodPlatform/oauthTokens/read
Microsoft.AgFoodPlatform/oauthTokens/delete

سجلات عمليات الوظيفة

اسم العملية
Microsoft.AgFoodPlatform/ingestionJobs/satelliteDataIngestionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/satelliteDataDeletionJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/weatherDataIngestionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/weatherDataDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/oauthProvidersCascadeDeleteJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/oauthTokensRemoveJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/الكتلة الحيويةModelJobs/تمت معالجتها
Microsoft.AgFoodPlatform/ingestionJobs/ImageProcessingRasterizeJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationDataIngestionJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationDataIngestionJobs/processed/failures
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationPeriodicJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationPeriodicJobs/processed/failures
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationEventHandlingJobs/processed
Microsoft.AgFoodPlatform/ingestionJobs/farmOperationEventHandlingJobs/processed/failures
Microsoft.AgFoodPlatform/deletionJobs/applicationDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/tillageDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/plantingDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/harvestDataCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/managementZonesCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/zonesCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/plantTissueAnalysesCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/prescriptionsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/prescription الخرائط CascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/insightsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/farmersCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/farmsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/fieldsCascadeDeletionJobs/processed
Microsoft.AgFoodPlatform/deletionJobs/seasonalFieldsCascadeDeletionJobs/processed

سجلات تدقيق التطبيق

سجلات الكتابة والحذف الموجودة في فئات أخرى موجودة أيضا في هذه الفئة. الفرق بين السجلات في هذه الفئة والفئات الأخرى لاستدعاء واجهة برمجة التطبيقات نفسه هو أن ApplicationAuditLogs لا يسجل نص الطلب، بينما يتم ملء نص الطلب في فئات أخرى. استخدم معرف الارتباط لربط سجلات فئتين مختلفتين للحصول على مزيد من التفاصيل. يتم سرد بعض عمليات وحدة التحكم التي ليست جزءا من بقية الفئات أدناه.

اسم العملية
إنشاء مدير بيانات لمورد زراعي
تحديث مدير البيانات لمورد الزراعة
حذف مدير البيانات لمورد الزراعة
إنشاء اشتراك
تحديث الاشتراك
مصادقة مستوى البيانات

الاستعلام عن سجلات الموارد في مساحة عمل تحليلات السجل

categories يتم تعيين جميع سجلات الموارد كجدول في تحليلات السجل. للوصول إلى السجلات لكل فئة، تحتاج إلى إنشاء إعداد تشخيص لإرسال البيانات إلى مساحة عمل تحليلات السجل. في مساحة العمل هذه، يمكنك الاستعلام عن أي من الجداول المدرجة للحصول على السجلات ذات الصلة.

قائمة الجداول في تحليلات السجل وتعيينها إلى فئات في سجلات الموارد

اسم الجدول في تحليلات السجل الفئات في سجلات الموارد ‏‏الوصف
AgriFoodFarmManagementLogs سجلات إدارة المزرعة سجلات لعمليات CRUD للحفلات والمزرعة والحقول والحقول الموسمية والقص والقص والقصة والموسم والمرفق وخرائط الوصفات الطبية والوصفات الطبية ومناطق الإدارة والمناطق وتحليل الأنسجة النباتية وتحليل العناصر الغذائية.
سجلات عمليات AgriFoodFarm سجلات عمليات المزرعة سجلات لعمليات CRUD لمهمة استيعاب بيانات FarmOperations، ApplicationData، PlantingData، HarvestingData، TillageData.
AgriFoodSatelliteLogs سجلات الأقمار الصناعية سجلات لإنشاء والحصول على عمليات لمهمة استيعاب بيانات الأقمار الصناعية.
AgriFoodWeatherLogs سجلات الطقس سجلات لإنشاء وحذف والحصول على عمليات لمهمة استيعاب بيانات الطقس.
AgriFoodProviderAuthLogs سجلات مصادقة الموفر سجلات الإنشاء والتحديث والحذف وتتالي الحذف والحصول على الكل لموفري oauth والحصول عليها. كما أنه يحتوي على سجلات للحصول على، والحصول على الكل، وتتالي حذف رموز oauth المميزة.
AgriFoodInsightLogs سجلات Insight سجلات للحصول على جميع العمليات للحصول على نتائج التحليلات والحصول عليها.
AgriFoodModelInferenceLogs سجلات الاستدلال النموذجي سجلات لإنشاء والحصول على عمليات لوظيفة نموذج الكتلة الحيوية.
AgriFoodJobProcessedLogs سجلات العمل المجهزة سجلات تشير إلى النجاح أو الفشل وسبب الفشل للوظائف. بالإضافة إلى سجلات تتالي الموارد حذف المهام، وظائف استيعاب البيانات. كما يحتوي على سجلات لعمليات المزرعة ومهام معالجة الأحداث.
AgriFoodApplicationAuditLogs سجلات تدقيق التطبيق سجلات للإجراءات المميزة مثل إنشاء موارد مستوى البيانات وتحديثها وحذفها وعمليات إدارة الاشتراك.

قائمة الأعمدة في جداول تحليلات السجل

اسم الحقل ‏‏الوصف
الوقت التاريخ والوقت بالتوقيت عالمي المتفق عليه.
Resourceid معرف مورد Azure Resource Manager لسجلات إدارة البيانات للزراعة.
OperationName اسم العملية، كما هو موثق في الجدول السابق.
إصدار العملية طلب العميل إصدار واجهة برمجة تطبيقات REST.
الفئة تفاصيل الفئة في Data Manager لسجلات الزراعة، يمكن أن تكون هذه أي قيمة كما هو موضح في جدول الفئة.
نوع النتيجة نتيجة طلب واجهة برمجة تطبيقات REST (النجاح أو الفشل).
توقيع النتائج حالة HTTP.
ResultDescription مزيد من الوصف حول النتيجة، عند توفرها.
المدة الزمنية الوقت المستغرق في خدمة طلب واجهة برمجة تطبيقات REST، بالمللي ثانية.
CallerIpAddress عنوان IP للعميل الذي قدم الطلب.
المستوى مستوى خطورة الحدث (إعلامي أو تحذيري أو خطأ أو حرج).
معرف الارتباط GUID اختياري يمكن استخدامه لربط السجلات.
معرف التطبيق معرف التطبيق الذي يشير إلى هوية المتصل.
Objectid معرف الكائن الذي يشير إلى هوية المتصل.
معرف المستأجر العميل معرف مستأجر المتصل.
SubscriptionId. معرف الاشتراك المستخدم من قبل المتصل.
الموقع منطقة المورد الذي ينبعث منها الحدث مثل "شرق الولايات المتحدة"
JobRunType متوفر فقط في AgriFoodJobProcessesLogs الجدول، يشير إلى نوع تشغيل المهمة. يمكن أن تكون القيمة إما دورية أو لمرة واحدة.
معرف الوظيفة متوفر فيAgriFoodJobProcessesLogs و AgriFoodSatelliteLogsAgriFoodWeatherLogsو و AgriFoodModelInferenceLogsيشير إلى معرف الوظيفة.
تم البدء من خلال متوفر فقط في AgriFoodJobProcessesLogs الجدول. يشير إلى ما إذا كان قد تم بدء مهمة من قبل مستخدم أو بواسطة الخدمة.
معرف الطرف معرف الطرف المقترن بالعملية.
الخصائص متوفر فقط فيAgriFoodJobProcessesLogs الجدول، ويحتوي على: farmOperationEntityId (معرف الكيان الذي فشل إنشاؤه بواسطة مهمة farmOperation)، farmOperationEntityType(نوع الكيان الذي فشل إنشاؤه، يمكن أن يكون ApplicationData، PeriodicJob، وما إلى ذلك)، errorCode(رمز فشل الوظيفة في نهاية مدير البيانات للزراعة)،errorMessage (وصف الفشل في نهاية مدير البيانات للزراعة)،internalErrorCode (رمز فشل الوظيفة التي يوفرها الموفر)، internalErrorMessage(وصف الفشل الذي يوفره الموفر)،providerId (معرف الموفر مثل JOHN-DEERE).

يمكن الاستعلام عن كل جدول من هذه الجداول عن طريق إنشاء مساحة عمل تحليلات السجل. مرجع لغة الاستعلام هنا.

قائمة نماذج الاستعلامات في مساحة عمل تحليلات السجل

اسم الاستعلام ‏‏الوصف
حالة عمليات إدارة المزرعة لجهة يجلب عدد مرات النجاح والإخفاق في العمليات ضمن FarmManagementLogs الفئة لكل طرف.
إحصائيات تنفيذ المهمة لجهة يوفر عدد مرات النجاح والفشل لجميع العمليات في JobProcessedLogs الفئة لكل طرف.
فشل التخويل يحدد قائمة بالمستخدمين الذين فشلوا في الوصول إلى المورد وسبب هذا الفشل.
حالة جميع العمليات لجهة تجميع الإخفاقات والنجاحات عبر فئات لأي طرف.
اتجاهات الاستخدام لأكبر 100 طرف استنادا إلى العمليات التي تم إجراؤها استرداد قائمة تضم أفضل 100 طرف استنادا إلى عدد الزيارات المستلمة عبر الفئات. يمكن تحرير هذا الاستعلام لتعقب اتجاه الاستخدام لجهة معينة.

يمكن استخدام جميع الاستعلامات المذكورة أعلاه باعتبارها استعلامات أساسية لتشكيل استعلامات مخصصة في مساحة عمل تحليلات السجل. يمكن أيضا الوصول إلى قائمة الاستعلامات هذه في Logs علامة التبويب في مورد Azure Data Manager for Agriculture على مدخل Microsoft Azure.

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

تعرف على كيفية إعداد الارتباطات الخاصة.