تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
قابلية مراقبة نشاط Azure باستخدام StackQL
ستتعلم في هذا الدليل كيفية الاستعلام عن سجلات نشاط Azure وإعداد تقارير عنها باستخدام StackQL، وهي أداة تطوير قوية تتيح الاستعلام عن البنية التحتية والموارد السحابية ونشرها باستخدام بناء جملة SQL.
تم الاختبار باستخدام واجهة SQL الخلفية المضمنة macos linux powershell
استعلام أساسي
يستخدم الاستعلام الأساسي الموضح أدناه المورد azure.monitor.activity_logs في الموفر azure؛ استبدل قيمة subscriptionId بقيمتك. سنستخدم في هذا الاستعلام jsonnet مع متغيرات خارجية للمعالجة المسبقة لاستعلام StackQL، راجع استخدام المتغيرات لمزيد من المعلومات. في هذه الحالة كتبنا ذلك ككتلة تعليمات برمجية jsonnet داخل الاستعلام نفسه، ولكن يمكن أيضًا توفيرها كملف خارجي باستخدام الوسيطة --iqldata أو -q للأمر stackql exec أو stackql shell.
يتم استخدام الدالتين JSON_EXTRACT وSPLIT_PART لمعالجة بيانات الاستجابة.
<<<jsonnet
{
stackqlQuery: {
subscriptionId: '631d1c6d-2a65-43e7-93c2-688bfe4e1468',
filter: "eventTimestamp ge ''" + std.extVar('startdate') + "''",
}
}
>>>
--
-- StackQL query with jsonnet preprocessing to retrieve all recent Azure activity
--
SELECT
eventTimestamp as event_timestamp,
caller,
JSON_EXTRACT(claims, '$.ipaddr') as ip_address,
subscriptionId,
tenantId,
SPLIT_PART(JSON_EXTRACT(authorization, '$.scope'), '/', 5) as resource_group,
SPLIT_PART(resourceId, '/', -1) as resource_name,
level,
JSON_EXTRACT(authorization, '$.action') as action,
JSON_EXTRACT(category, '$.localizedValue') as category,
JSON_EXTRACT(operationName, '$.localizedValue') as operation,
JSON_EXTRACT(status, '$.localizedValue') as status
FROM azure.monitor.activity_logs
WHERE $filter = '{{ .stackqlQuery.filter }}'
AND subscription_id = '{{ .stackqlQuery.subscriptionId }}';
تشغيل الاستعلام بشكل تفاعلي
من جهاز تمت مصادقته لدى Azure (بما في ذلك Azure Portal Cloud Shell):
# to run on mac or linux
./stackql shell --var startdate=$(date -u -d '1 day ago' '+%Y-%m-%dT%H:%M:%SZ')
أو باستخدام PowerShell:
# to run using windows powershell
$startDate = (Get-Date).AddDays(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
stackql.exe shell --var startdate=$startDate
يجب أن يظهر لك إخراج جدولي يحتوي على أعمدة لكل من: event_timestamp وcaller وip_address وsubscriptionId وtenantId وresource_group وresource_name وlevel وaction وcategory وoperation وstatus.
إنشاء تقرير CSV
بحفظ استعلام StackQL في ملف (activity_report.iql)، يمكنك إنشاء تقرير csv من استعلام النشاط على النحو التالي (راجع --output csv لمزيد من المعلومات حول أنواع الإخراج في stackql):
# to run on mac or linux
./stackql exec \
--output csv \
-i activity_report.iql \
-f activity_report.csv \
--var startdate=$(date -u -d '1 day ago' '+%Y-%m-%dT%H:%M:%SZ')
أو باستخدام PowerShell:
# to run using windows powershell
$startDate = (Get-Date).AddDays(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
stackql.exe exec `
--output csv `
-i activity_report.iql `
-f activity_report.csv `
--var startdate=$startDate
التصفية على جانب الخادم باستخدام KQL
تتم التصفية على جانب الخادم في Azure باستخدام KQL (Kusto Query Language). بتوسيع العبارة $filter في استعلامك، يمكنك تصفية البيانات مباشرة على الخادم. يتميز ذلك بكفاءة عالية لأنه يقلل كمية البيانات المنقولة عبر الشبكة. فيما يلي بعض الأمثلة على التصفية على جانب الخادم (للاختصار، تستخدم هذه الاستعلامات المعلمات مباشرة بدلًا من استخدام المعالج المسبق jsonnet):
تحديد نطاق زمني للأنشطة
--
-- List events in a time range
--
SELECT
eventTimestamp as event_timestamp,
caller,
JSON_EXTRACT(claims, '$.ipaddr') as ip_address,
subscriptionId,
tenantId,
SPLIT_PART(JSON_EXTRACT(authorization, '$.scope'), '/', 5) as resource_group,
SPLIT_PART(resourceId, '/', -1) as resource_name,
level,
JSON_EXTRACT(authorization, '$.action') as action,
JSON_EXTRACT(category, '$.localizedValue') as category,
JSON_EXTRACT(operationName, '$.localizedValue') as operation,
JSON_EXTRACT(status, '$.localizedValue') as status
FROM azure.monitor.activity_logs
WHERE $filter = 'eventTimestamp ge ''2024-01-24T00:00:00Z'' and eventTimestamp le ''2024-01-25T00:00:00Z'''
AND subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468';
الحصول على الأنشطة الخاصة بمجموعة موارد
--
-- List events for a resource group
--
SELECT
eventTimestamp as event_timestamp,
caller,
JSON_EXTRACT(claims, '$.ipaddr') as ip_address,
subscriptionId,
tenantId,
SPLIT_PART(resourceId, '/', -1) as resource_name,
level,
JSON_EXTRACT(authorization, '$.action') as action,
JSON_EXTRACT(category, '$.localizedValue') as category,
JSON_EXTRACT(operationName, '$.localizedValue') as operation,
JSON_EXTRACT(status, '$.localizedValue') as status
FROM azure.monitor.activity_logs
WHERE $filter = 'eventTimestamp ge ''2024-01-24T00:00:00Z'' and eventTimestamp le ''2024-01-25T00:00:00Z'' and resourceGroupName eq ''MC_kube-03_aks862a_australiaeast'''
AND subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468';
الحصول على الأنشطة الخاصة بنوع مورد
--
-- List events for a resource provider
--
SELECT
eventTimestamp as event_timestamp,
caller,
JSON_EXTRACT(claims, '$.ipaddr') as ip_address,
subscriptionId,
tenantId,
SPLIT_PART(JSON_EXTRACT(authorization, '$.scope'), '/', 5) as resource_group,
SPLIT_PART(resourceId, '/', -1) as resource_name,
level,
JSON_EXTRACT(authorization, '$.action') as action,
JSON_EXTRACT(category, '$.localizedValue') as category,
JSON_EXTRACT(operationName, '$.localizedValue') as operation,
JSON_EXTRACT(status, '$.localizedValue') as status
FROM azure.monitor.activity_logs
WHERE $filter = 'eventTimestamp ge ''2024-01-24T00:00:00Z'' and eventTimestamp le ''2024-01-25T00:00:00Z'' and resourceProvider eq ''Microsoft.Compute'''
AND subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468';
الحصول على الأنشطة الخاصة بمورد محدد
لاحظ أننا أضفنا الحقل الإضافي (correlationId) الذي سنستخدمه في المرشح التالي على جانب الخادم...
--
-- List events for resource using the resourceUri
--
SELECT
eventTimestamp as event_timestamp,
caller,
JSON_EXTRACT(claims, '$.ipaddr') as ip_address,
subscriptionId,
tenantId,
SPLIT_PART(resourceId, '/', -1) as resource_name,
correlationId,
level,
JSON_EXTRACT(authorization, '$.action') as action,
JSON_EXTRACT(category, '$.localizedValue') as category,
JSON_EXTRACT(operationName, '$.localizedValue') as operation,
JSON_EXTRACT(status, '$.localizedValue') as status
FROM azure.monitor.activity_logs
WHERE $filter = 'eventTimestamp ge ''2024-01-24T00:00:00Z'' and eventTimestamp le ''2024-01-25T00:00:00Z'' and resourceUri eq ''/subscriptions/631d1c6d-2a65-43e7-93c2-688bfe4e1468/resourceGroups/MC_kube-03_aks862a_australiaeast/providers/Microsoft.Compute/virtualMachines/aks-agentpool-35064155-1'''
AND subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468';
الحصول على الأنشطة الخاصة بمعرف ارتباط
معرف الارتباط هو معرف فريد مخصص لتتبع الأحداث المرتبطة بعملية أو معاملة معينة في Azure وتجميعها. يساعد هذا الاستعلام في تحديد أحداث معينة ضمن إطار زمني محدد ترتبط بعملية معينة، مما يسهل استكشاف الأخطاء وإصلاحها أو فهم تسلسل الأنشطة. إليك مثالًا يستخدم قيمة correlationId التي حصلنا عليها في الاستعلام السابق:
--
-- List events for a correlation Id
--
SELECT
eventTimestamp as event_timestamp,
caller,
JSON_EXTRACT(claims, '$.ipaddr') as ip_address,
subscriptionId,
tenantId,
SPLIT_PART(JSON_EXTRACT(authorization, '$.scope'), '/', 5) as resource_group,
SPLIT_PART(resourceId, '/', -1) as resource_name,
level,
JSON_EXTRACT(authorization, '$.action') as action,
JSON_EXTRACT(category, '$.localizedValue') as category,
JSON_EXTRACT(operationName, '$.localizedValue') as operation,
JSON_EXTRACT(status, '$.localizedValue') as status
FROM azure.monitor.activity_logs
WHERE $filter = 'eventTimestamp ge ''2024-01-24T00:00:00Z'' and eventTimestamp le ''2024-01-25T00:00:00Z'' and correlationId eq ''30b92c6d-4a82-401f-ac73-e28377669539'''
AND subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468';
التصفية على جانب العميل باستخدام العبارة WHERE
يمكن إجراء التصفية على جانب العميل باستخدام عبارة SQL التقليدية WHERE. في هذه الحالة تتم تصفية البيانات بعد استردادها من الخادم، مما يوفر مرونة في معالجة البيانات وتحليلها داخل بيئة StackQL.
الحصول على الأنشطة الخاصة بمستخدم محدد
في استعلام المثال، تصفي العبارة WHERE الصفوف حسب الحقل caller (المستخدم)، مما يوفر طبقة إضافية لتنقيح البيانات.
--
-- Filter events for a particular user (caller)
--
SELECT
eventTimestamp as event_timestamp,
caller,
JSON_EXTRACT(claims, '$.ipaddr') as ip_address,
subscriptionId,
tenantId,
SPLIT_PART(JSON_EXTRACT(authorization, '$.scope'), '/', 5) as resource_group,
SPLIT_PART(resourceId, '/', -1) as resource_name,
level,
JSON_EXTRACT(authorization, '$.action') as action,
JSON_EXTRACT(category, '$.localizedValue') as category,
JSON_EXTRACT(operationName, '$.localizedValue') as operation,
JSON_EXTRACT(status, '$.localizedValue') as status
FROM azure.monitor.activity_logs
WHERE $filter = 'eventTimestamp ge ''2024-01-01T00:00:00Z'''
AND subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468'
AND caller = 'javen@stackql.io';
تشغيل استعلامات التلخيص/التجميع
بما أن StackQL محرك SQL كامل، فإن استعلامات GROUP BY والاستعلامات التجميعية (بما في ذلك AVG وCOUNT وSUM وMIN وMAX وغيرها) متاحة بشكل أصلي لجميع الموفرين والخدمات والموارد.
حساب عدد الأحداث حسب مستوى الخطورة
في هذا المثال، سنجمع الأحداث التي وقعت منذ تاريخ ووقت بدء محددين في مجموعات حسب مستوى خطورتها، ونحسب عدد الأحداث في كل مستوى.
--
-- Summarize events by severity level
--
SELECT
level,
COUNT(*) as num_events
FROM azure.monitor.activity_logs
WHERE $filter = 'eventTimestamp ge ''2024-01-29T00:00:00Z'''
AND subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468'
GROUP BY level;
/* returns..
|---------------|------------|
| level | num_events |
|---------------|------------|
| Error | 58 |
|---------------|------------|
| Informational | 57 |
|---------------|------------|
| Warning | 57 |
|---------------|------------|
*/
استخدام الربط JOIN لإثراء الأنشطة
SELECT
l.eventTimestamp as event_timestamp,
l.level,
JSON_EXTRACT(l.operationName, '$.localizedValue') as operation,
vm.name,
vm.location,
JSON_EXTRACT(vm.properties, '$.timeCreated') as time_created
FROM azure.monitor.activity_logs l
INNER JOIN azure.compute.virtual_machines vm
ON vm.name = SPLIT_PART(l.resourceId, '/', -1)
WHERE vm.resource_group_name = 'MC_kube-03_aks862a_australiaeast'
AND subscription_id = '631d1c6d-2a65-43e7-93c2-688bfe4e1468'
AND l.$filter = 'eventTimestamp ge ''2024-01-28T00:00:00Z'' and resourceGroupName eq ''MC_kube-03_aks862a_australiaeast''';
أو باستخدام متغيرات من jsonnet يتم توفيرها كملف باستخدام الوسيطة --iqldata أو -q، أو ككتلة jsonnet كما هو موضح هنا:
<<<jsonnet
{
stackqlQuery: {
subscriptionId: '631d1c6d-2a65-43e7-93c2-688bfe4e1468',
resourceGroupName: 'MC_kube-03_aks862a_australiaeast',
}
}
>>>
SELECT
l.eventTimestamp as event_timestamp,
l.level,
JSON_EXTRACT(l.operationName, '$.localizedValue') as operation,
vm.name,
vm.location,
JSON_EXTRACT(vm.properties, '$.timeCreated') as time_created
FROM azure.monitor.activity_logs l
INNER JOIN azure.compute.virtual_machines vm
ON vm.name = SPLIT_PART(l.resourceId, '/', -1)
WHERE vm.resource_group_name = '{{ .stackqlQuery.resourceGroupName}}'
AND subscription_id = '{{ .stackqlQuery.subscriptionId}}'
AND l.$filter = 'eventTimestamp ge ''2024-01-28T00:00:00Z'' and resourceGroupName eq ''{{ .stackqlQuery.resourceGroupName}}''';
تكون معلمات WHERE غير المنسوبة إلى مورد معين في استعلام JOIN، مثل subscription_id في الحالة أعلاه، مشتركة بين الموردين كليهما (azure.monitor.activity_logs وazure.compute.virtual_machines في هذه الحالة).