Estensione dell'agente Linux dello Stackify Retrace

Panoramica

Stackify fornisce i prodotti che rilevano i dettagli relativi all'applicazione per individuare e risolvere rapidamente i problemi. Per i team di sviluppatori, Retrace è una super potenza dalle prestazioni delle app completamente integrate e multi-ambiente. Combina diversi strumenti di cui ogni team di sviluppatori ha bisogno.

Retrace è il SOLO strumento che offre tutte le seguenti funzionalità per tutti gli ambienti in una singola piattaforma.

• Gestione delle prestazioni delle applicazioni (APM)
• Applicazione e registrazione del server
• Rilevamento degli errori e monitoraggio
• Server, applicazione e metriche personalizzate

Estensione dell'agente Linux di Stackify

Questa estensione fornisce un percorso di installazione per l'agente Linux per Retrace.

Prerequisiti

Sistema operativo

L'agente di Retrace può essere eseguito in queste distribuzioni di Linux

Tenere presente che Red Hat Enterprise Linux 6.X è già EOL. RHEL 6.10 dispone del supporto ELS disponibile, che terminerà il 06/2024.

Connettività Internet

Per distribuire l'estensione agente Stackify per Linux, è necessario che la macchina virtuale di destinazione sia connessa a Internet.

Potrebbe essere necessario modificare la configurazione di rete per consentire le connessioni a Stackify, vedere https://support.stackify.com/hc/en-us/articles/207891903-Adding-Exceptions-to-a-Firewall.

Schema dell'estensione

Il codice JSON riportato di seguito mostra lo schema dell'estensione dell'agente di Stackify Retrace. L'estensione richiede 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"
        }
      }
    }

Distribuzione del modello

Le estensioni macchina virtuale di Azure possono essere distribuite con i modelli di Azure Resource Manager. Lo schema JSON indicato nella sezione precedente può essere usato in un modello di Azure Resource Manager per eseguire l'estensione agente Linux di Stackify Retrace durante la distribuzione di un modello di Azure Resource Manager.

Il codice JSON per un'estensione della macchina virtuale può essere nidificato nella risorsa della macchina virtuale o posizionato nel livello radice o nel livello superiore di un modello JSON di Resource Manager. Il posizionamento di JSON influisce sul valore del nome e tipo di risorsa. Per altre informazioni, vedere Set name and type for child resources (Impostare il nome e il tipo per le risorse figlio).

L'esempio seguente presuppone che l'estensione Linux di Stackify Retrace sia annidata all'interno della risorsa della macchina virtuale. Quando la risorsa di estensione viene nidificata, JSON viene inserito nell'oggetto "risorse": [] della macchina virtuale.

L'estensione richiede 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"
        }
      }
    }

Quando si posiziona l'estensione JSON nella radice del modello, il nome della risorsa include un riferimento alla macchina virtuale padre e il tipo riflette la configurazione annidata.

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

Distribuzione PowerShell

Il comando Set-AzVMExtension consente di distribuire l'estensione macchina virtuale dell'agente Linux di Stackify Retrace a una macchina virtuale esistente. Prima di eseguire il comando, le configurazioni pubbliche e private devono essere archiviate in una tabella hash di PowerShell.

L'estensione richiede 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 `

Distribuzione dell'interfaccia della riga di comando di Azure

Lo strumento dell'interfaccia della riga di comando di Azure consente di distribuire l'estensione macchina virtuale dell'agente Linux di Stackify Retrace a una macchina virtuale esistente.

L'estensione richiede 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'

Risoluzione dei problemi e supporto

Codici di errore

Se è necessaria ulteriore assistenza è possibile contattare il supporto di Stackify al sito https://support.stackify.com.