Расширение агента Stackify Retrace для Linux

Обзор

Stackify предоставляет продукты, которые отслеживают сведения о приложении, чтобы ускорить поиск и устранение проблем. Для команд разработчиков Retrace представляет собой полностью интегрируемый сверхмощный инструмент отслеживания производительности приложений, совместимый с несколькими средами. Он объединяет в себе функции нескольких инструментов, необходимых любой группе разработки.

Retrace — это единственный инструмент, который обеспечивает приведенные ниже возможности во всех средах на одной платформе.

• Управление производительностью приложений (APM).
• Ведение журнала приложений и серверов.
• Отслеживание ошибок и мониторинг.
• Метрики сервера, приложения и настраиваемые метрики.

О расширении агента Stackify Retrace для Linux

Это расширение предоставляет путь установки агента Retrace для Linux.

Необходимые компоненты

Операционная система

Агент Retrace можно выполнять с использованием следующих дистрибутивов Linux.

Учитывайте, что Red Hat Enterprise Linux 6.X уже является EOL. RHEL 6.10 имеет поддержку ELS, которая завершится 06.2024.

Подключение к Интернету

Для расширения агента Stackify Retrace для Linux требуется, чтобы целевая виртуальная машина была подключена к Интернету.

Может потребоваться настроить параметры сети, чтобы разрешить подключения к Stackify. Ознакомьтесь с разделом https://support.stackify.com/hc/en-us/articles/207891903-Adding-Exceptions-to-a-Firewall.

Схема расширения

В следующем фрагменте JSON показана схема для расширения агента Stackify Retrace. Для работы расширения требуется 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. Для запуска расширения агента Stackify Retrace для Linux во время развертывания шаблона Azure Resource Manager в нем можно использовать схему JSON, описанную в предыдущем разделе.

JSON для расширения виртуальной машины можно вложить в ресурс виртуальной машины или поместить в корень или на верхний уровень JSON-файла шаблона Resource Manager. Размещение JSON влияет на значения имени и типа ресурса. Дополнительные сведения см. в разделе "Указание имени и типа дочернего ресурса в шаблоне Resource Manager".

В следующем примере предполагается, что расширение 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 на существующей виртуальной машине. Перед выполнением команды необходимо сохранить открытые и закрытые конфигурации в хэш-таблице 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 на существующей виртуальной машине.

Для работы расширения требуется 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'

Устранение неполадок и поддержка

Коды ошибок

Если вам нужна дополнительная помощь, обращайтесь в службу поддержки Stackify: https://support.stackify.com.