Estensione dell'agente Linux dello Stackify Retrace

  • Articolo

Attenzione

Questo articolo fa riferimento a CentOS, una distribuzione Linux prossima allo stato EOL (End of Life, fine del ciclo di vita). Prendere in considerazione l'uso e il piano di conseguenza. Per altre informazioni, vedere le linee guida per la fine della vita di CentOS.

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

Distribuzione Versione
Ubuntu 16.04 LTS
Debian 9
Red Hat 6.10, 7.1+
CentOS 6.10, 7.0+

Importante

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 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

Codice errore Significato Azione possibile
10 Errore di installazione wget è obbligatorio
20 Errore di installazione Python è obbligatorio
30 Errore di installazione sudo è obbligatorio
40 Errore di installazione activationKey è obbligatorio
51 Errore di installazione Distribuzione del sistema operativo non supportata
60 Errore di installazione l'ambiente è obbligatorio
70 Errore di installazione Sconosciuto
80 Errore di abilitazione L'installazione del servizio non è riuscita
90 Errore di abilitazione L'avvio del servizio non è riuscito
100 Errore di disabilitazione L'interruzione del servizio non è riuscita
110 Errore di disabilitazione La rimozione del servizio non è riuscita
120 Errore di disinstallazione L'interruzione del servizio non è riuscita

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