Compartilhar via

Extensão do agente Linux Stackify Retrace

  • Artigo

Atenção

Este artigo faz referência ao CentOS, uma distribuição Linux com status de Fim de Vida (EOL). Por favor, considere o seu uso e planeje de acordo. Para obter mais informações, consulte as diretrizes de Fim da Vida Útil do CentOS.

Descrição geral

A Stackify fornece produtos que rastreiam detalhes sobre seu aplicativo para ajudar a encontrar e corrigir problemas rapidamente. Para as equipes de desenvolvedores, o Retrace é uma superpotência de desempenho de aplicativos totalmente integrada e em vários ambientes. Ele combina várias ferramentas que toda equipe de desenvolvimento precisa.

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

  • Gerenciamento de desempenho de aplicativos (APM)
  • Registro em log de aplicativos e servidores
  • Rastreamento e monitoramento de erros
  • Servidor, aplicativo e métricas personalizadas

Sobre o Stackify Linux Agent Extension

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

Pré-requisitos

Sistema operativo

O agente Retrace pode ser executado nessas distribuições Linux

Distribuição Versão
Ubuntu 16,04 LTS
Debian 9
Red Hat 6.10, 7.1+
CentOS 6.10, 7.0+

Importante

Tenha em consideração o Red Hat Enterprise Linux 6.X já é EOL. O RHEL 6.10 tem suporte disponível ao ELS, que terminará em 06/2024.

Ligação à Internet

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

Talvez seja necessário ajustar a configuração de rede para permitir conexões com o 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 Stackify Retrace Agent. A extensão requer o 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"
        }
      }
    }

Implementação de modelos

As 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 Stackify Retrace Linux Agent durante uma implantação de modelo do Azure Resource Manager.

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

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

A extensão requer o 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 colocar a extensão JSON na raiz do modelo, o nome do recurso inclui uma referência à 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"
            }
        }
    }

Implementação do PowerShell

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

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

Implementação da CLI do Azure

A ferramenta CLI do Azure pode ser usada para implantar a extensão de máquina virtual Stackify Retrace Linux Agent em uma máquina virtual existente.

A extensão requer o 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 de erro

Código de erro Significado Ação possível
10 Erro de instalação wget é obrigatório
20 Erro de instalação Python é necessário
30 Erro de instalação sudo é obrigatório
40 Erro de instalação activationKey é necessário
51 Erro de instalação Distribuição de SO não suportada
60 Erro de instalação ambiente é necessário
70 Erro de instalação Desconhecido
80 Ativar erro Falha na configuração do serviço
90 Ativar erro Falha na inicialização do serviço
100 Erro de desativação Falha na parada de serviço
110 Erro de desativação Falha na remoção do serviço
120 Erro de desinstalação Falha na parada de serviço

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