Extensão do Agente Linux de Stackify Retrace

Visão geral

O Stackify fornece produtos que acompanham os detalhes sobre o seu aplicativo para ajudar a localizar e corrigir problemas rapidamente. Para as equipes de desenvolvedores, o Retrace é uma potência de super de desempenho do aplicativo totalmente integrada, com vários ambientes. Ele combina várias ferramentas que cada equipe de desenvolvimento precisa.

O Retrace é a ÚNICA ferramenta que fornece todos os recursos a seguir em todos os ambientes em uma única plataforma.

• Gerenciamento de desempenho do aplicativo (APM)
• Aplicativo e registro de log do servidor
• Monitoramento e controle de erro
• Servidor, aplicativo e métricas personalizadas

Sobre a Extensão do Agente Linux de Stackify

Esta extensão fornece um caminho de instalação para o agente Linux para Retrace.

Pré-requisitos

Sistema operacional

O agente do Retrace pode ser executada com essas distribuições Linux

Lembre-se de que o Red Hat Enterprise Linux 6.X já é EOL. O RHEL 6.10 tem disponível o suporte ao ELS , que terminará em 06/2024.

Conectividade com a Internet

A extensão do Agente do Stackify para Linux requer que a máquina virtual de destino esteja conectada à Internet.

Você talvez precise ajustar sua configuração de rede para permitir conexões com Stackify, consulte https://support.stackify.com/hc/en-us/articles/207891903-Adding-Exceptions-to-a-Firewall.

Esquema de extensão

O JSON a seguir mostra o esquema para a extensão do Agente Stackify Retrace. A extensão requer environment e 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"
        }
      }
    }

Implantação de modelo

Extensões de VM do Azure podem ser implantadas com modelos do Azure Resource Manager. O esquema JSON detalhado na seção anterior pode ser usado em um modelo do Azure Resource Manager para executar a extensão do Agente do Linux para o Stackify Retrace durante uma implantação de modelo do Azure Resource Manager.

O JSON para uma extensão da máquina virtual pode ser aninhado dentro do recurso de máquina virtual ou localizado no nível de raiz ou superior de um modelo JSON do Resource Manager. O posicionamento do JSON afeta o valor do tipo e nome do recurso. Para obter mais informações, consulte Definir o nome e o tipo de recursos filho.

O exemplo a seguir pressupõe que a extensão do Linux Stackify Retrace está aninhada dentro do recurso de máquina virtual. Ao aninhar o recurso de extensão, o JSON é colocado no objeto “recursos”: [] objeto da máquina virtual.

A extensão requer environment e 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"
        }
      }
    }

Ao inserir o JSON da extensão na raiz do modelo, o nome do recurso inclui uma referência na máquina virtual pai e o tipo reflete a configuração aninhada.

    {
        "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"
            }
        }
    }

Implantação do PowerShell

O comando Set-AzVMExtension pode ser usado para implantar a extensão da máquina virtual do agente Linux do Stackify Retrace para uma máquina virtual existente. Antes de executar o comando, as configurações públicas e privadas precisam ser armazenadas em uma tabela de hash do PowerShell.

A extensão requer environment e 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 `

Implantação da CLI do Azure

A ferramenta da CLI do Azure pode ser usada para implantar a extensão da máquina virtual do Agente Linux do Stackify Retrace.

A extensão requer environment e 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'

Solução de problemas e suporte

Códigos do Erro

Se precisar de mais ajuda, entre em contato com a Stackify em https://support.stackify.com.