Stackify Retrace-Agent-Erweiterung für Linux
Achtung
Dieser Artikel bezieht sich auf CentOS, eine Linux-Distribution, deren Dienstende (End-of-Life, EOL) ansteht. Sie sollten Ihre Nutzung entsprechend planen. Weitere Informationen finden Sie im CentOS End-of-Life-Leitfaden.
Übersicht
Stackify stellt Produkte bereit, die Details zu Ihrer Anwendung ermitteln, um rasch Probleme aufdecken und beheben zu können. Für Entwicklerteams ist Retrace ein äußerst nützliches Tool zur Steigerung der App-Leistung mit vollständiger Integration für verschiedene Umgebungen. Es vereint Tools, die für jedes Entwicklungsteam unerlässlich sind.
Retrace ist das EINZIGE Tool, das für alle Umgebungen sämtliche der folgenden Funktionen über eine zentrale Plattform bereitstellt.
- Steuerung der Anwendungsleistung (Application Performance Management, APM)
- Anwendungs- und Serverprotokollierung
- Nachverfolgen und Überwachen von Fehlern
- Server, Anwendung und benutzerdefinierte Metriken
Informationen zur Stackify-Agent-Erweiterung für Linux
Diese Erweiterung stellt einen Installationspfad für den Retrace-Agent für Linux zur Verfügung.
Voraussetzungen
Betriebssystem
Der Retrace-Agent kann für folgende Linux-Distributionen ausgeführt werden:
Distribution | Version |
---|---|
Ubuntu | 16.04 LTS |
Debian | 9 |
Red Hat | 6.10, 7.1 oder höher |
CentOS | 6.10, 7.0 oder höher |
Wichtig
Beachten Sie, dass Red Hat Enterprise Linux 6.X bereits das EOL erreicht hat. Für RHEL 6.10 ist ELS-Support verfügbar, der im Juni 2024 endet.
Internetkonnektivität
Um die Stackify-Agent-Erweiterung für Linux verwenden zu können, muss der virtuelle Zielcomputer mit dem Internet verbunden sein.
Eventuell müssen Sie Ihre Netzwerkkonfiguration dahingehend anpassen, dass Verbindungen mit Stackify zugelassen werden. Informationen hierzu finden Sie unter https://support.stackify.com/hc/en-us/articles/207891903-Adding-Exceptions-to-a-Firewall.
Erweiterungsschema
Der folgende JSON-Code zeigt das Schema für die Stackify Retrace-Agent-Erweiterung. Für die Erweiterung sind environment
und activationKey
erforderlich.
{
"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"
}
}
}
Bereitstellung von Vorlagen
Azure-VM-Erweiterungen können mithilfe von Azure Resource Manager-Vorlagen bereitgestellt werden. Das im vorherigen Abschnitt erläuterte JSON-Schema kann in einer Azure Resource Manager-Vorlage verwendet werden, um die Stackify Retrace-Agent-Erweiterung für Linux während einer Bereitstellung über eine Azure Resource Manager-Vorlage auszuführen.
Der JSON-Code für eine Erweiterung des virtuellen Computers kann innerhalb der VM-Ressource geschachtelt oder im Stamm bzw. auf der obersten Ebene einer Resource Manager-JSON-Vorlage platziert werden. Die Platzierung des JSON-Codes wirkt sich auf den Wert von Name und Typ der Ressource aus. Weitere Informationen finden Sie unter „Festlegen von Name und Typ für untergeordnete Ressourcen“.
Im folgenden Beispiel wird davon ausgegangen, dass die Stackify Retrace-Erweiterung für Linux in der VM-Ressource geschachtelt ist. Beim Schachteln der Ressource für die Erweiterung wird der JSON-Code im "resources": []-Objekt des virtuellen Computers platziert.
Für die Erweiterung sind environment
und activationKey
erforderlich.
{
"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"
}
}
}
Beim Platzieren des JSON-Codes für die Erweiterung im Stamm der Vorlage enthält der Name der Ressource einen Verweis auf die übergeordnete VM, und der Typ spiegelt die geschachtelte Konfiguration wider.
{
"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"
}
}
}
PowerShell-Bereitstellung
Mit dem Befehl Set-AzVMExtension
können Sie die Stackify Retrace-Agent-VM-Erweiterung für Linux auf einem vorhandenen virtuellen Computer bereitstellen. Vor dem Ausführen des Befehls müssen die öffentliche und die private Konfiguration in einer PowerShell-Hashtabelle gespeichert werden.
Für die Erweiterung sind environment
und activationKey
erforderlich.
$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 `
Bereitstellung mithilfe der Azure-Befehlszeilenschnittstelle
Mit dem Azure CLI-Tool können Sie die Stackify Retrace-VM-Agent-Erweiterung für Linux auf einem vorhandenen virtuellen Computer bereitstellen.
Für die Erweiterung sind environment
und activationKey
erforderlich.
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'
Problembehandlung und Support
Fehlercodes
Fehlercode | Bedeutung | Mögliche Aktion |
---|---|---|
10 | Installationsfehler | wget ist erforderlich. |
20 | Installationsfehler | Python ist erforderlich. |
30 | Installationsfehler | sudo ist erforderlich. |
40 | Installationsfehler | activationKey ist erforderlich. |
51 | Installationsfehler | Betriebssystemverteilung wird nicht unterstützt. |
60 | Installationsfehler | Umgebung ist erforderlich. |
70 | Installationsfehler | Unbekannt |
80 | Fehler beim Aktivieren | Fehler bei der Einrichtung des Diensts |
90 | Fehler beim Aktivieren | Fehler beim Starten des Diensts |
100 | Fehler beim Deaktivieren | Fehler beim Beenden des Diensts |
110 | Fehler beim Deaktivieren | Fehler beim Entfernen des Diensts |
120 | Fehler bei der Deinstallation | Fehler beim Beenden des Diensts |
Wenn Sie weitere Unterstützung benötigen, wenden Sie sich unter https://support.stackify.com an den Stackify-Support.