تعمل أحمالك على EC2 وRDS وLambda، لكن فريق المناوبة لا يزال يتنقل بين وحدة تحكم CloudWatch وDynatrace. ربط Dynatrace AWS بحساباتك يجمع مقاييس CloudWatch والسجلات في مكان واحد، إلى جانب التتبعات والكيانات التي اكتشفتها OneAgent أصلًا.
كلفة هذا التشتت حقيقية: كل تنقل بين أداتين يطيل متوسط زمن الإصلاح (MTTR)، وتبقى قاعدة RDS المشبعة غير مرئية لأهداف مستوى الخدمة (SLO) ما لم تُربط مقاييسها بالخدمة التي تعتمد عليها. التكامل الجيد يسد هذه الثغرة في التغطية.
هدف هذا الدليل: ربط حساب AWS بدور IAM للقراءة فقط، ثم إرسال مجموعات سجلات CloudWatch إلى Dynatrace عبر Amazon Data Firehose، والتحقق من كل ذلك بـ DQL. المحتوى صالح لـ Dynatrace SaaS؛ وتُذكر الفروق الخاصة بـ Dynatrace Managed في كل خطوة.
ما الذي يغطيه تكامل Dynatrace AWS
يقوم التكامل على تدفقين منفصلين. والخلط بينهما أول مصدر للتذاكر.
| التدفق | الآلية | ما يصل إلى Dynatrace |
|---|---|---|
| المقاييس والبيانات الوصفية | يستعلم Dynatrace من API الخاص بـ CloudWatch متقمصًا دور IAM في حسابك | مقاييس خدمات AWS، والكيانات (الأجهزة والقواعد والدوال)، والوسوم |
| السجلات | يدفع اشتراك CloudWatch Logs إلى تدفق Amazon Data Firehose، الذي يرسل إلى API استيعاب السجلات | سجلات في Grail، مع مجموعة السجلات الأصلية |
التدفق الأول بنمط pull: Dynatrace يقرأ. والثاني بنمط push: AWS يرسل. لذا تختلف الصلاحيات، ولا يفسّر عطل في أحدهما ثغرةً في الآخر أبدًا.
المتطلبات
- حساب AWS بصلاحية إنشاء أدوار IAM وحزم CloudFormation (AWS CLI مهيأة أو CloudShell).
- بيئة Dynatrace SaaS وصلاحية تعديل إعدادات البيئة.
- رمز API في Dynatrace بنطاق استيعاب السجلات (
logs.ingest، «Ingest logs» في الواجهة)، مخزَّن في متغير ولا يوضع أبدًا في مستودع. - في Managed: ActiveGate قادر على الوصول إلى AWS لأنه هو من يستعلم CloudWatch، وعنوان استيعاب للسجلات يمر عبر هذا ActiveGate.
الخطوة 1: إنشاء دور IAM للمراقبة
لا يطلب Dynatrace مفتاح وصول طويل الأمد: فهو يتقمص دورًا عبر sts:AssumeRole، محميًا بـ external ID. عند إنشاء اتصال AWS في إعدادات Dynatrace تمنحك الواجهة هذا المعرّف. انسخه قبل الانتقال إلى جانب AWS.
أنشئ بعد ذلك سياسة الثقة (trust policy) للدور. حساب AWS الخاص بـ Dynatrace المذكور أدناه هو الوارد في الوثائق لـ SaaS؛ تحقق منه في شاشة الاتصال لديك، فهي المرجع.
cat > trust.json <<'EOF'
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": { "AWS": "arn:aws:iam::314146291599:root" },
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": { "sts:ExternalId": "<external-id-fourni-par-dynatrace>" }
}
}
]
}
EOF
aws iam create-role \
--role-name DynatraceMonitoringRole \
--assume-role-policy-document file://trust.json
السطر الحاسم هو الشرط sts:ExternalId: فبدونه يمكن لأي عميل لدى المزوّد نفسه أن يحاول تقمص دورك (المشكلة المعروفة بـ «confused deputy»). لا تحذفه أبدًا «لفك» اتصال متعثر.
في Managed لا يكون الـ principal حساب Dynatrace، بل الدور الذي يحمله ActiveGate العامل داخل AWS. اتبع إجراء Managed في الوثائق لمعرفة الحساب واسم الدور المطلوب السماح لهما.
الخطوة 2: منح صلاحيات قراءة CloudWatch
أرفق بالدور سياسة قراءة فقط. الحد الأدنى يتسع لبضعة إجراءات؛ وتوفر الوثائق سياسة كاملة لكل خدمة مراقَبة.
cat > policy.json <<'EOF'
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"cloudwatch:GetMetricData",
"cloudwatch:GetMetricStatistics",
"cloudwatch:ListMetrics",
"sts:GetCallerIdentity",
"tag:GetResources",
"tag:GetTagKeys",
"ec2:DescribeAvailabilityZones",
"ec2:DescribeInstances",
"rds:DescribeDBInstances",
"lambda:ListFunctions",
"lambda:ListTags"
],
"Resource": "*"
}
]
}
EOF
aws iam put-role-policy \
--role-name DynatraceMonitoringRole \
--policy-name DynatraceMonitoringPolicy \
--policy-document file://policy.json
إجراءات tag:* أهم مما تبدو: فبدونها لا تصعد وسوم AWS، وتفقد التصفية بحسب الفريق أو البيئة التي تُستخدم لاحقًا في توجيه التنبيهات.
الخطوة 3: إنهاء الاتصال واختيار الخدمات
عد إلى Dynatrace والصق ARN الخاص بالدور ومعرّف حساب AWS، ثم احفظ. بعد ذلك اختر الخدمات المراد مراقبتها، وقيّد الجمع عند الحاجة بحسب المنطقة أو الوسم. ابدأ صغيرًا: EC2 وRDS وLambda وموازنات الحمل تغطي معظم الحوادث.
كل خدمة إضافية تضاعف استدعاءات CloudWatch التي تفوترها AWS، وحجم المقاييس في Dynatrace. والتصفية بالوسم (مثل monitoring=dynatrace) تجنّبك دفع كلفة موارد بيئة التجارب.
الخطوة 4: إرسال سجلات CloudWatch عبر Data Firehose
ينشر Dynatrace قالب CloudFormation ينشئ تدفق Firehose، ودلو S3 احتياطيًا للإرسالات الفاشلة، والدور الذي يستخدمه الاشتراك. انشره من صدفة بها AWS CLI أو من CloudShell:
DYNATRACE_API_URL=https://<environment-id>.live.dynatrace.com
DYNATRACE_API_KEY=<token-logs-ingest>
STACK_NAME=dynatrace-log-delivery-stream
wget -O dynatrace-firehose-log-stream.yaml \
https://assets.cloud.dynatrace.com/awslogstreaming/dynatrace-firehose-log-stream.yaml
aws cloudformation deploy \
--capabilities CAPABILITY_NAMED_IAM \
--template-file ./dynatrace-firehose-log-stream.yaml \
--stack-name $STACK_NAME \
--parameter-overrides DtApiUrl=$DYNATRACE_API_URL DtApiToken=$DYNATRACE_API_KEY
في Managed أو خلف ActiveGate يكون العنوان على الشكل https://<activegate>/e/<environment-id>. يشترط Firehose شهادة صالحة: ActiveGate بشهادة موقّعة ذاتيًا لن يُقبل.
اشترك بعد ذلك في مجموعات السجلات المفيدة بالسكربت الذي يوفره Dynatrace:
wget -O dynatrace-firehose-logs.sh \
https://assets.cloud.dynatrace.com/awslogstreaming/dynatrace-firehose-logs.sh
chmod +x dynatrace-firehose-logs.sh
./dynatrace-firehose-logs.sh subscribe \
--log-groups /aws/lambda/checkout /aws/rds/instance/orders/postgresql \
--stack-name $STACK_NAME \
--filter-pattern "?ERROR ?WARN"
المعامل --filter-pattern أول رافعة لضبط الكلفة: فهو يصفّي عند المصدر قبل Firehose. وبدونه تُرسل مجموعة السجلات كاملة، بما فيها ضجيج التصحيح. انتبه: يحدّ CloudWatch عدد مرشحات الاشتراك لكل مجموعة، فإذا كانت أداة أخرى تستخدمها فعلًا يعيد السكربت LimitExceededException.
كيف تتحقق من أن كل شيء يعمل
في جانب AWS افتح حزمة CloudFormation: يجب ألا يُظهر تبويب Events أي إخفاق، ويعطي تبويب Outputs ARN الخاص بتدفق Firehose. وفي مقاييس التدفق، يجب أن تقترب DeliveryToHttpEndpoint.Success من 1.
في جانب Dynatrace افتح notebook وتحقق أولًا من السجلات، مجموعةً مجموعة:
fetch logs, from: now() - 1h
| filter isNotNull(aws.log_group)
| summarize count(), by: {aws.log_group}
ثم المقاييس، مثل استخدام المعالج لأجهزة RDS:
timeseries avg(dt.cloud.aws.rds.cpu.usage)
تصل مقاييس CloudWatch بتأخر بضع دقائق، لأن CloudWatch نفسه ينشرها متأخرة. الرسم الفارغ بعد خمس دقائق ليس فشلًا؛ أما بعد ثلاثين دقيقة فأعد قراءة سياسة IAM. وللاطلاع على استعلامات تحقق أخرى انظر أمثلة استعلامات DQL للتشغيل.
أفضل الممارسات
- دور IAM واحد لكل حساب AWS، بالتسمية نفسها في كل مكان: يصبح استكشاف الأخطاء آليًا.
- صفِّ بالوسم والمنطقة منذ البداية بدل تفعيل كل شيء ثم القطع.
- احتفظ بدلو S3 الاحتياطي الخاص بـ Firehose وراقب حجمه: فهو ينمو حين يفشل الاستيعاب.
- دوّر رمز الاستيعاب وحدّث معامل الحزمة؛ وعند الخطأ 401 اتبع دليلنا لـ استكشاف أخطاء رمز API الخاص بـ Dynatrace.
- نبّه على غياب سجلات مجموعة حرجة، لا على الأخطاء فقط: انظر كشف الصمت في استيعاب السجلات.
الأسئلة الشائعة
هل يجب تثبيت OneAgent إذا كان تكامل AWS مفعّلًا؟
نعم، للمضيفين والتطبيقات. يرى تكامل CloudWatch الموارد من الخارج، بدقة CloudWatch. أما OneAgent فيعطي العمليات والتتبعات الموزعة والمقاييس بدقة الثانية. وهما يكمل أحدهما الآخر: يربط Dynatrace جهاز EC2 الذي يراه CloudWatch بالمضيف الذي تراه OneAgent.
ما الفرق بين SaaS وManaged في هذا التكامل؟
في SaaS يستعلم Dynatrace من AWS انطلاقًا من بنيته التحتية، ويثق الدور بحسابه. وفي Managed يستعلم ActiveGate لديك من AWS: يجب أن يعمل داخل AWS للمصادقة بالدور، وتمر سجلات Firehose عبر عنوان ActiveGate بشهادة صالحة. ولاختيار ActiveGate انظر Environment ActiveGate أم Cluster ActiveGate.
لماذا لا تصل بعض مجموعات السجلات أبدًا؟
تتكرر ثلاثة أسباب: المجموعة غير مشترَك فيها (تحقق من مرشحات الاشتراك في CloudWatch)، أو نمط المرشح يستبعد كل شيء، أو Firehose يفشل في الوصول إلى Dynatrace ويودع الدفعات في دلو S3 الاحتياطي. ابدأ بهذا الدلو: إن احتوى ملفات حديثة فالمشكلة في الرمز أو العنوان.
الخلاصة
يكفي دور IAM للقراءة فقط وحزمة Firehose وبضعة اشتراكات لإعادة CloudWatch إلى Dynatrace. والمكسب ليس في عدد الرسوم البيانية، بل في الترابط: قاعدة RDS المشبعة تظهر أخيرًا إلى جانب الخدمة التي تتباطأ، ويبحث فريق المناوبة في أداة واحدة. ابدأ بخدمتين أو ثلاث حرجة، وتحقق بـ DQL، ثم وسّع. الإجراء المرجعي في docs.dynatrace.com.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. تتطور أسماء الشاشات والإجراءات، لذا تحقق دائمًا من القيم في الوثائق الرسمية الخاصة بإصدارك قبل أي تغيير في الإنتاج.