Stackify Retrace Linux Agent Extension

Upozornění

Tento článek odkazuje na CentOS, což je linuxová distribuce se stavem Konec životnosti (EOL). Zvažte své použití a odpovídajícím způsobem naplánujte. Další informace najdete v doprovodných materiálech CentOS End Of Life.

Přehled

Stackify poskytuje produkty, které sledují podrobnosti o vaší aplikaci, aby vám pomohly rychle najít a opravit problémy. Pro vývojářské týmy je Retrace plně integrovaný supervýkonný výkon aplikací s více prostředími. Kombinuje několik nástrojů, které každý vývojový tým potřebuje.

Retrace je jediný nástroj, který poskytuje všechny následující funkce ve všech prostředích na jedné platformě.

• Správa výkonu aplikací (APM)
• Protokolování aplikací a serverů
• Sledování a monitorování chyb
• Server, aplikace a vlastní metriky

Informace o rozšíření stackify linuxových agentů

Toto rozšíření poskytuje instalační cestu pro agenta Linuxu pro Retrace.

Požadavky

Operační systém

Na těchto linuxových distribucích je možné spustit agenta Retrace.

Distribuce	Verze
Ubuntu	16.04 LTS
Debian	9
Red Hat	6.10, 7.1+
CentOS	6.10, 7.0+

Důležité

Mějte na zřeteli, že Red Hat Enterprise Linux 6.X už je EOL. RHEL 6.10 má k dispozici podporu ELS, která skončí 6. 6. 2024.

Připojení k internetu

Rozšíření Stackify Agent pro Linux vyžaduje, aby cílový virtuální počítač byl připojený k internetu.

Možná budete muset upravit konfiguraci sítě tak, aby umožňovala připojení ke Službě Stackify, viz https://support.stackify.com/hc/en-us/articles/207891903-Adding-Exceptions-to-a-Firewall.

Schéma rozšíření

---

Následující JSON ukazuje schéma pro rozšíření Stackify Retrace Agent. Rozšíření vyžaduje 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"
        }
      }
    }

Nasazení šablon

Rozšíření virtuálních počítačů Azure je možné nasadit pomocí šablon Azure Resource Manageru. Schéma JSON podrobně popsané v předchozí části můžete použít v šabloně Azure Resource Manageru ke spuštění rozšíření Stackify Retrace Linux Agent během nasazení šablony Azure Resource Manageru.

Json pro rozšíření virtuálního počítače je možné vnořit do prostředku virtuálního počítače nebo umístit na kořenovou nebo nejvyšší úroveň šablony JSON Resource Manageru. Umístění JSON má vliv na hodnotu názvu a typu prostředku. Další informace naleznete v tématu Nastavení názvu a typu pro podřízené prostředky.

Následující příklad předpokládá, že rozšíření Stackify Retrace Linux je vnořené do prostředku virtuálního počítače. Při vnoření prostředku rozšíření se JSON umístí do objektu "resources": [] virtuálního počítače.

Rozšíření vyžaduje 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"
        }
      }
    }

Při umístění kódu JSON rozšíření do kořenového adresáře šablony obsahuje název prostředku odkaz na nadřazený virtuální počítač a typ odráží vnořenou konfiguraci.

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

Nasazení PowerShellu

Tento Set-AzVMExtension příkaz lze použít k nasazení rozšíření Stackify Retrace Linux Agenta do existujícího virtuálního počítače. Před spuštěním příkazu musí být veřejné a privátní konfigurace uložené v tabulce hodnot hash PowerShellu.

Rozšíření vyžaduje 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 `

Nasazení v Azure CLI

Nástroj Azure CLI se dá použít k nasazení rozšíření Stackify Retrace Linux Agenta do existujícího virtuálního počítače.

Rozšíření vyžaduje 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'

Řešení potíží a podpora

Kódy chyb

Kód chyby	Význam	Možná akce
10	Chyba instalace	Vyžaduje se wget.
20	Chyba instalace	Vyžaduje se Python.
30	Chyba instalace	vyžaduje se sudo.
40	Chyba instalace	aktivační klíč je povinný.
51	Chyba instalace	Distribuce operačního systému není podporována.
60	Chyba instalace	vyžaduje se prostředí.
70	Chyba instalace	Neznámý
80	Chyba povolení	Instalace služby se nezdařila.
90	Chyba povolení	Spuštění služby se nezdařilo.
100	Zakázat chybu	Selhání zastavení služby
110	Zakázat chybu	Odebrání služby se nezdařilo.
120	Chyba odinstalace	Selhání zastavení služby

Pokud potřebujete další pomoc, můžete kontaktovat podporu Stackify na adrese https://support.stackify.com.