Stackify Retrace Linux Agent Extension

تنبيه

تشير هذه المقالة إلى CentOS، وهو توزيع Linux يقترب من حالة نهاية العمر الافتراضي (EOL). يرجى مراعاة استخدامك والتخطيط وفقا لذلك. لمزيد من المعلومات، راجع إرشادات نهاية العمر الافتراضي CentOS.

نظرة عامة

يوفر Stackify منتجات تتعقب تفاصيل حول تطبيقك للمساعدة في العثور على المشكلات وإصلاحها بسرعة. بالنسبة لفرق المطورين، يعد Retrace قوة فائقة متكاملة تماماً ومتعددة البيئات وأداء التطبيق. فهو يجمع بين العديد من الأدوات التي يحتاجها كل فريق تطوير.

Retrace هي الأداة الوحيدة التي توفر جميع الإمكانات التالية عبر جميع البيئات في نظام أساسي واحد.

• إدارة أداء التطبيق (APM)
• تسجيل التطبيق والخادم
• تعقب الأخطاء ومراقبتها
• الخادم والتطبيق والمقاييس المخصصة

حول Stackify Linux Agent Extension

يوفر هذا الملحق مسار تثبيت لعامل Linux لـ Retrace.

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

نظام التشغيل

يمكن تشغيل عامل Retrace مقابل توزيعات Linux هذه

التوزيع	إصدار
Ubuntu	16.04 LTS
Debian	9
Red Hat	6.10, 7.1+
CentOS	6.10, 7.0+

هام

ضع في اعتبارك Red Hat Enterprise Linux 6.X بالفعل EOL. RHEL 6.10 لديه دعم ELS المتوفر، والذي سينتهي في 06/2024.

الاتصال بالإنترنت

يتطلب ملحق عامل Stackify لنظام Linux أن يكون الجهاز الظاهري المستهدف متصلاً بالإنترنت.

قد تحتاج إلى ضبط تكوين الشبكة الخاصة بك للسماح بالاتصالات إلى Stackify، راجع https://support.stackify.com/hc/en-us/articles/207891903-Adding-Exceptions-to-a-Firewall.

مخطط الملحق

---

يُظهر JSON التالي مخطط لملحق Stackify Retrace Agent. يتطلب الملحق environment وactivationKey.

    {
      "type": "extensions",
      "name": "StackifyExtension",
      "apiVersion": "[variables('apiVersion')]",
      "location": "[resourceGroup().location]",
      "dependsOn": [
        "[resourceId('Microsoft.Compute/virtualMachines',variables('vmName'))]"
      ],
      "properties": {
        "publisher": "Stackify.LinuxAgent.Extension",
        "type": "StackifyLinuxAgentExtension",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
          "environment": "myEnvironment"
        },
        "protectedSettings": {
          "activationKey": "myActivationKey"
        }
      }
    }

توزيع قالب

يمكن توزيع ملحقات جهاز Azure الظاهري باستخدام قوالب Azure Resource Manager. يمكنك استخدام مخطط JSON المفصل في القسم السابق في قالب Azure Resource Manager لتشغيل ملحق Stackify Retrace Linux Agent أثناء توزيع قالب Azure Resource Manager.

يمكن تداخل ملحق جهاز ظاهري داخل مورد الجهاز الظاهري، أو وضعه في الجذر أو المستوى الأعلى لقالب Resource Manager JSON. يؤثر موضع JSON على قيمة اسم المورد ونوعه. لمزيد من المعلومات، راجع تعيين اسم ونوع الموارد التابعة.

يفترض المثال التالي أن ملحق Stackify Retrace Linux متداخل داخل مورد الجهاز الظاهري. عند تداخل مورد الملحق، يتم وضع JSON في عنصر "resources": [] للجهاز الظاهري.

يتطلب الملحق environment وactivationKey.

    {
      "type": "extensions",
      "name": "StackifyExtension",
      "apiVersion": "[variables('apiVersion')]",
      "location": "[resourceGroup().location]",
      "dependsOn": [
        "[resourceId('Microsoft.Compute/virtualMachines',variables('vmName'))]"
      ],
      "properties": {
        "publisher": "Stackify.LinuxAgent.Extension",
        "type": "StackifyLinuxAgentExtension",
        "typeHandlerVersion": "1.0",
        "autoUpgradeMinorVersion": true,
        "settings": {
          "environment": "myEnvironment"
        },
        "protectedSettings": {
          "activationKey": "myActivationKey"
        }
      }
    }

عند وضع الملحق JSON في جذر القالب، يتضمن اسم المورد مرجعاً للجهاز الظاهري الأصلي، ويعكس النوع التكوين المتداخل.

    {
        "type": "Microsoft.Compute/virtualMachines/extensions",
        "name": "<parentVmResource>/StackifyExtension",
        "apiVersion": "[variables('apiVersion')]",
        "location": "[resourceGroup().location]",
        "dependsOn": [
            "[concat('Microsoft.Compute/virtualMachines/', variables('vmName'))]"
        ],
        "properties": {
            "publisher": "Stackify.LinuxAgent.Extension",
            "type": "StackifyLinuxAgentExtension",
            "typeHandlerVersion": "1.0",
            "autoUpgradeMinorVersion": true,
            "settings": {
              "environment": "myEnvironment"
            },
            "protectedSettings": {
              "activationKey": "myActivationKey"
            }
        }
    }

توزيع PowerShell

يمكن استخدام الأمر Set-AzVMExtension لتوزيع ملحق الجهاز الظاهري لـ Stackify Retrace Linux Agent إلى جهاز ظاهري موجود. قبل تشغيل الأمر، يجب تخزين التكوينات العامة والخاصة في جدول التجزئة لـ PowerShell.

يتطلب الملحق environment وactivationKey.

$PublicSettings = @{"environment" = "myEnvironment"}
$ProtectedSettings = @{"activationKey" = "myActivationKey"}

Set-AzVMExtension -ExtensionName "Stackify.LinuxAgent.Extension" `
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Publisher "Stackify.LinuxAgent.Extension" `
    -ExtensionType "StackifyLinuxAgentExtension" `
    -TypeHandlerVersion 1.0 `
    -Settings $PublicSettings `
    -ProtectedSettings $ProtectedSettings `
    -Location WestUS `

توزيع Azure CLI

يمكن استخدام الأداة Azure CLI لتوزيع ملحق الجهاز الظاهري لـ Stackify Retrace Linux Agent إلى جهاز ظاهري موجود.

يتطلب الملحق environment وactivationKey.

az vm extension set --publisher 'Stackify.LinuxAgent.Extension' --version 1.0 --name 'StackifyLinuxAgentExtension' --protected-settings '{"activationKey":"myActivationKey"}' --settings '{"environment":"myEnvironment"}'  --resource-group 'myResourceGroup' --vm-name 'myVmName'

استكشاف الأخطاء وإصلاحها والدعم

رموز الخطأ

رمز الخطأ	المعنى	الإجراء الممكن اتخاذه
10	خطأ في التثبيت	wget مطلوب
20	خطأ في التثبيت	Python مطلوب
30	خطأ في التثبيت	sudo مطلوب
40	خطأ في التثبيت	activationKey مطلوب
51	خطأ في التثبيت	توزيع نظام التشغيل غير مدعوم
60	خطأ في التثبيت	البيئة مطلوبة
70	خطأ في التثبيت	‏‏غير معروف
80	تمكين الخطأ	فشل إعداد الخدمة
90	تمكين الخطأ	فشل بدء تشغيل الخدمة
100	تعطيل الخطأ	فشل إيقاف الخدمة
110	تعطيل الخطأ	فشل إزالة الخدمة
120	خطأ في إلغاء التثبيت	فشل إيقاف الخدمة

إذا كنت بحاجة إلى مزيد من المساعدة، فيمكنك الاتصال بدعم Stackify على https://support.stackify.com.