مراقبة بيانات Azure Cosmos DB باستخدام إعدادات تشخيص Azure Monitor Log Analytics

1. قم بتسجيل الدخول إلى بوابة Azure.

2. انتقل إلى حساب Azure Cosmos DB الحالي.

3. في قسم Monitoring من قائمة الموارد، حدد Diagnostic settings. ثم حدد الخيار Add diagnostic setting .

   

   هام

   قد ترى مطالبة "تمكين استعلام النص الكامل [...] لتسجيل أكثر تفصيلا" إذا لم يتم تمكين ميزة استعلام النص الكامل في حسابك. يمكنك تجاهل هذا التحذير بأمان إذا كنت لا ترغب في تمكين هذه الميزة. لمزيد من المعلومات، راجع تمكين استعلام النص الكامل.

4. في جزء Diagnostic settings ، قم بتسمية الإعداد example-setting ثم حدد فئة QueryRuntimeStatistics . قم بتمكين خانة الاختيار إرسال إلى مساحة عمل Log Analytics، مع تحديد مساحة العمل الموجودة. وأخيرا، حدد Resource specific كخيار الوجهة.

   

az monitor diagnostic-settings create استخدم الأمر لإنشاء إعداد تشخيص باستخدام Azure CLI. راجع وثائق هذا الأمر للحصول على أوصاف لمعاملاته.

1. تأكد من تسجيل الدخول إلى Azure CLI. لمزيد من المعلومات، راجع تسجيل الدخول باستخدام Azure CLI.

2. استخدم az monitor diagnostic-settings create لإنشاء الإعداد.

   az monitor diagnostic-settings create \
     --resource $(az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     ) \
     --workspace $(az monitor log-analytics workspace show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     ) \
     --name "example-setting" \
     --export-to-resource-specific true \
     --logs '[
       {
         "category": "QueryRuntimeStatistics",
         "enabled": true
       }
     ]'
   

   هام

   يستخدم هذا النموذج الوسيطة --export-to-resource-specific لتمكين الجداول الخاصة بالموارد.

3. راجع نتائج إنشاء الإعداد الجديد باستخدام az monitor diagnostics-settings show.

   az monitor diagnostic-settings show \
     --name "example-setting" \
     --resource $(az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     )
   

استخدم Azure Monitor REST API لإنشاء إعداد تشخيص عبر وحدة التحكم التفاعلية.

1. تأكد من تسجيل الدخول إلى Azure CLI. لمزيد من المعلومات، راجع تسجيل الدخول باستخدام Azure CLI.

2. إنشاء إعداد التشخيص لمورد Azure Cosmos DB باستخدام طلب HTTP PUT و az rest.

   diagnosticSettingName="example-setting"
   
   resourceId=$(az cosmosdb show \
     --resource-group "<resource-group-name>" \
     --name "<account-name>" \
     --query "id" \
     --output "tsv" \
   )
   
   workspaceId=$(az monitor log-analytics workspace show \
     --resource-group "<resource-group-name>" \
     --name "<account-name>" \
     --query "id" \
     --output "tsv" \
   )
   
   az rest \
     --method "PUT" \
     --url "$resourceId/providers/Microsoft.Insights/diagnosticSettings/$diagnosticSettingName" \
     --url-parameters "api-version=2021-05-01-preview" \
     --body '{
       "properties": {
         "workspaceId": "'"$workspaceId"'",
         "logs": [
           {
             "category": "QueryRuntimeStatistics",
             "enabled": true
           }
         ],
         "logAnalyticsDestinationType": "Dedicated"
       }
     }'
   

   هام

   يعين هذا النموذج الخاصية logAnalyticsDestinationType لتمكين Dedicated الجداول الخاصة بالموارد.

3. استخدم az rest مرة أخرى مع فعل HTTP GET للحصول على خصائص إعداد التشخيص.

   diagnosticSettingName="example-setting"
   
   resourceId=$(az cosmosdb show \
     --resource-group "<resource-group-name>" \
     --name "<account-name>" \
     --query "id" \
     --output "tsv" \
   )
   
   az rest \
     --method "GET" \
     --url "$resourceId/providers/Microsoft.Insights/diagnosticSettings/$diagnosticSettingName" \
     --url-parameters "api-version=2021-05-01-preview"
   

استخدم قالب Bicep لإنشاء إعداد التشخيص.

1. تأكد من تسجيل الدخول إلى Azure CLI. لمزيد من المعلومات، راجع تسجيل الدخول باستخدام Azure CLI.

2. إنشاء ملف جديد يسمى diagnosticSetting.bicep.

3. أدخل محتوى قالب Bicep التالي الذي ينشر إعداد التشخيص لمورد Azure Cosmos DB.

   @description('The name of the diagnostic setting to create.')
   param diagnosticSettingName string = 'example-setting'
   
   @description('The name of the Azure Cosmos DB account to monitor.')
   param azureCosmosDbAccountName string
   
   @description('The name of the Azure Monitor Log Analytics workspace to use.')
   param logAnalyticsWorkspaceName string
   
   resource azureCosmosDbAccount 'Microsoft.DocumentDB/databaseAccounts@2021-06-15' existing = {
     name: azureCosmosDbAccountName
   }
   
   resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2023-09-01' existing = {
     name: logAnalyticsWorkspaceName
   }
   
   resource diagnosticSetting 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
     name: diagnosticSettingName
     scope: azureCosmosDbAccount
     properties: {
       workspaceId: logAnalyticsWorkspace.id
       logAnalyticsDestinationType: 'Dedicated'
       logs: [
         {
           category: 'QueryRuntimeStatistics'
           enabled: true
         }
       ]
     }
   }    
   

   هام

   يعين هذا النموذج الخاصية logAnalyticsDestinationType لتمكين Dedicated الجداول الخاصة بالموارد.

4. انشر القالب باستخدام az deployment group create.

   az deployment group create \
       --resource-group "<resource-group-name>" \
       --template-file diagnosticSetting.bicep \
       --parameters \
         azureCosmosDbAccountName="<azure-cosmos-db-account-name>" \
         logAnalyticsWorkspaceName="<log-analytics-workspace-name>"
   

   تلميح

   az bicep build استخدم الأمر لتحويل قالب Bicep إلى قالب Azure Resource Manager.

استخدم قالب Azure Resource Manager لإنشاء إعداد التشخيص.

1. تأكد من تسجيل الدخول إلى Azure CLI. لمزيد من المعلومات، راجع تسجيل الدخول باستخدام Azure CLI.

2. إنشاء ملف جديد يسمى diagnosticSetting.bicep.

3. أدخل محتوى قالب Azure Resource Manager التالي الذي ينشر إعداد التشخيص لمورد Azure Cosmos DB.

   {
     "$schema": "<https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#>",
     "contentVersion": "1.0.0.0",
     "parameters": {
       "diagnosticSettingName": {
         "type": "string",
         "defaultValue": "example-setting",
         "metadata": {
           "description": "The name of the diagnostic setting to create."
         }
       },
       "azureCosmosDbAccountName": {
         "type": "string",
         "metadata": {
           "description": "The name of the Azure Cosmos DB account to monitor."
         }
       },
       "logAnalyticsWorkspaceName": {
         "type": "string",
         "metadata": {
           "description": "The name of the Azure Monitor Log Analytics workspace to use."
         }
       }
     },
     "resources": [
       {
         "type": "Microsoft.Insights/diagnosticSettings",
         "apiVersion": "2021-05-01-preview",
         "scope": "[format('Microsoft.DocumentDB/databaseAccounts/{0}', parameters('azureCosmosDbAccountName'))]",
         "name": "[parameters('diagnosticSettingName')]",
         "properties": {
           "workspaceId": "[resourceId('Microsoft.OperationalInsights/workspaces', parameters('logAnalyticsWorkspaceName'))]",
           "logAnalyticsDestinationType": "Dedicated",
           "logs": [
             {
               "category": "QueryRuntimeStatistics",
               "enabled": true
             }
           ]
         }
       }
     ]
   }
   

   هام

   يعين هذا النموذج الخاصية logAnalyticsDestinationType لتمكين Dedicated الجداول الخاصة بالموارد.

4. انشر القالب باستخدام az deployment group create.

   az deployment group create \
       --resource-group "<resource-group-name>" \
       --template-file azuredeploy.json \
       --parameters \
         azureCosmosDbAccountName="<azure-cosmos-db-account-name>" \
         logAnalyticsWorkspaceName="<log-analytics-workspace-name>"
   

   تلميح

   az bicep decompile استخدم الأمر لتحويل قالب Azure Resource Manager إلى قالب Bicep.

1. في صفحة حساب Azure Cosmos DB الموجودة، حدد خيار الميزات ضمن قسم الإعدادات من قائمة الموارد. ثم حدد ميزة استعلام النص الكامل للتشخيص.

   

2. في مربع الحوار، حدد Enable. يتم تطبيق هذا الإعداد في غضون بضع دقائق. تحتوي جميع السجلات التي تم إدخالها حديثا الآن على النص الكامل أو نص PIICommand لكل طلب.

   

استخدم Azure CLI لتمكين استعلام النص الكامل لحساب Azure Cosmos DB الخاص بك.

1. تمكين استعلام النص الكامل باستخدام az rest مرة أخرى باستخدام فعل HTTP PATCH وحمولة JSON.

   az rest \
     --method "PATCH" \
     --url $(az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     ) \
     --url-parameters "api-version=2021-05-01-preview" \
     --body '{
       "properties": {
         "diagnosticLogSettings": {
           "enableFullTextQuery": "True"
         }
       }
     }'
   

2. انتظر بضع دقائق حتى تكتمل العملية. تحقق من حالة استعلام النص الكامل باستخدام az rest مرة أخرى مع HTTP GET.

   az rest \
     --method "GET" \
     --url $(az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --query "id" \
       --output "tsv" \
     ) \
     --url-parameters "api-version=2021-05-01-preview" \
     --query "{accountName:name,fullTextQueryEnabled:properties.diagnosticLogSettings.enableFullTextQuery}"
   

   يجب أن يكون الإخراج مشابها لهذا المثال.

   {
     "accountName": "<account-name>",
     "fullTextQueryEnabled": "True"
   }