Aktivieren und Konfigurieren des Automation Action Script-Sensors

Bevor Sie diesen Sensor aktivieren, führen Sie die folgenden Schritte aus:

1. Überprüfen Sie die Informationen in Securely mit Hilfe des Automatisierungsrahmens.
2. Wenn der Sensor in einer selbst gehosteten Umgebung (vor Ort) verwendet wird, stellen Sie sicher, dass die Automatisierungsfunktion aktiviert ist.

In der Standardeinstellung ist der Sensor deaktiviert. Um den Sensor zu aktivieren, aktualisieren Sie die Konfigurationsdatei des Agenten wie im folgenden Beispiel gezeigt:

com.instana.plugin.action.script:
  enabled: true # by default is false
 

Standardmäßig erstellt der Aktionsskriptsensor die Skripte im temporären Standardverzeichnis des Agenten *instanaAgentDir*/data/tmp und führt sie dort aus. Um diesen Ort zu ändern, fügen Sie die Attribute scriptExecutionHome zur Skriptsensorkonfiguration in der Agentenkonfigurationsdatei hinzu. Der Wert scriptExecutionHome darf kein Leerzeichen enthalten. Wenn das temporäre Standardverzeichnis für den Agenten *instanaAgentDir*/data/tmp ein Leerzeichen enthält, müssen Sie einen Wert für scriptExecutionHome angeben.

com.instana.plugin.action.script:
  enabled: true
  scriptExecutionHome: '/myExecutionDir' # The path used for action script executions.
 

Standardmäßig führt der Aktionsskript-Sensor die Skripte als der Benutzer aus, der den Instana-Agenten gestartet hat. Auf den Betriebssystemen Linux, AIX und Solaris können die Aktionsskripte nicht als root ausgeführt werden. Ebenso können die Aktionsskripte unter Windows nicht als Administrator ausgeführt werden. Um den Aktionsskriptsensor so zu konfigurieren, dass die Aktionsskripts mit alternativen Anmeldeinformationen ausgeführt werden, fügen Sie die Attribute runAs und scriptExecutionHome zur Skriptsensorkonfiguration in der Agentenkonfigurationsdatei hinzu. Der Benutzer runAs benötigt die Berechtigungen read, write und execute im Verzeichnis scriptExecutionHome . Unter Windows müssen Sie auch das Passwort für den Benutzer runAs im Attribut runAsUserPassword angeben. Verwenden Sie den Tresor für runAsUserPassword wie in der folgenden YAML-Konfiguration gezeigt. Bevor Sie sich für einen Benutzernamen für runAs entscheiden, lesen Sie die Informationen unter Erstellen eines speziellen Benutzers für Skriptaktionen.

com.instana.plugin.action.script:
  enabled: true
  runAs: 'aUser'
  scriptExecutionHome: '/myExecutionDir' # The path used for action script executions.
  runAsUserPassword: # Required on Windows operating system.
    configuration_from:
      type: vault
      secret_key:
        path: <secret_path>
        key: <secret_key>
 

Standardmäßig führt der Skriptsensor maximal 10 gleichzeitige Skriptaktionen aus. Wenn Sie die maximale Anzahl gleichzeitiger Skriptaktionen ändern möchten, fügen Sie das Attribut maxConcurrentActions zum Abschnitt für die Skriptsensorkonfiguration in der Agentenkonfigurationsdatei wie folgt hinzu:

com.instana.plugin.action.script:
  enabled: true
  maxConcurrentActions: 5  # optional, default value is 10
 

Wenn Sie eine Skriptaktion erstellen, können Sie die maximale Zeit in Sekunden festlegen, die bis zum Abschluss der Skriptaktion gewartet werden soll. Wenn Sie die Zeitüberschreitung für Skriptaktionen bei der Erstellung von Skriptaktionen nicht festlegen, wird eine Skriptaktion standardmäßig nach 300 Sekunden beendet. Wenn Sie diese Standardzeitüberschreitung für die Ausführung von Aktionsskripten ändern möchten, fügen Sie das Attribut defaultTimeout zum Konfigurationsabschnitt des Skriptsensors in der Konfigurationsdatei des Agenten wie folgt hinzu:

com.instana.plugin.action.script:
  enabled: true
  defaultTimeout: 600 # optional, default timeout is 300 seconds
 

chroot wird verwendet, um eine begrenzte Sandbox zu schaffen, in der das Aktionsskript ausgeführt werden kann. Daher kann das Skript keine Daten außerhalb des scriptExecutionHome Verzeichnisbaums böswillig verändern. Action Script-Unterstützung für chroot ist für Agenten verfügbar, die auf den Betriebssystemen AIX, Linux und Solaris laufen. Wenn chroot aktiviert ist, wird scriptExecutionHome als Stammverzeichnis für den Aktionsskriptprozess verwendet. Sie müssen alle Systembefehle, Interpreter, Binärdateien, Bibliotheken und ausführbaren Dateien, die für den Aufruf des Aktionsskripts erforderlich sind, in das Verzeichnis scriptExecutionHome kopieren. Zumindest müssen Sie den Befehl su kopieren, der intern vom Sensor verwendet wird, um den Benutzer zu ersetzen. Um das chroot für das Aktionsskript zu aktivieren, aktualisieren Sie die Konfigurationsdatei des Agenten wie im folgenden Beispiel gezeigt:

com.instana.plugin.action.script:
  enabled: true
  chrootEnabled: true # by default, chroot support is disabled
  scriptExecutionHome: '/home/test' # The path used for action script executions
 

Wenn die Skriptaktion in Ihrem Aktionskatalog Vault-Parameter verwendet, müssen Sie den Host-Agenten mit einem Secret Manager integrieren.

Wenn Sie die Skriptaktionen auf Windows-Betriebssystemen ausführen, müssen Sie die folgenden Voraussetzungen und Einschränkungen beachten.