# Verwenden von dynctl zur Problembehebung in Dynamic Engine

Verwenden Sie dynctl, um einen Dynamic Engine-Cluster sowie die darin ausgeführten Dienste zu überwachen, zu debuggen und Fehler zu beheben.

Mithilfe der dynctl-Befehle können Sie:

* die dynctl-Version überprüfen.
* Shell-Vervollständigungsskripte generieren.
* Cluster-Details abrufen.
* Logs ausgeführter Dienste im Dynamic Engine-Cluster anzeigen.

## Die dynctl-Syntax

Die allgemeine Syntax für dynctl-Befehle lautet:

```
dynctl [command] [params] [flags]
```

In dieser Syntax:

- command
    - Gibt den auszuführenden Vorgang an, z. B. das Erfassen von Protokollen oder Auflisten von Umgebungen.
- params
    - Stellt zusätzliche Details bereit, die für den Befehl erforderlich sind, z. B. Ressourcen-IDs.
- flags
    - Legt zusätzliche Anweisungen fest, z. B. --kubeconfig zum Überschreiben der Kubeconfig-Standarddatei.

InformationshinweisWichtig: Befehlszeilen-Flags haben Vorrang vor Standardwerten, Konfigurationsdateieinstellungen und Umgebungsvariablen. Die Vorrangreihenfolge für Konfigurationswerte ist:

1. Befehlszeilen-Flags (höchste Priorität)
2. Umgebungsvariablen
3. Konfiguration in YAML-Datei (niedrigste Priorität)

## Die dynctl-Befehle

| Befehl | Syntax | Beschreibung |
| --- | --- | --- |
| Version | dynctl version | Zeigt die aktuelle dynctl-Version. |
| completion | dynctl completion [shell] | Erstellt shell-spezifische Vervollständigungsskripte (Bash, Zsh, PowerShell und Fish). Weitere Informationen finden Sie unter [Optional: Installieren der automatischen Vervollständigungsfunktion von dynctl](https://help.qlik.com/talend/de-DE/dynamic-engine-configuration-guide/Cloud/ctl-troubleshooting-for-dynamic-engine "Durch die Einrichtung der automatischen Vervollständigung lässt sich dynctl leichter verwenden, da das Tool Befehlsvorschläge in Echtzeit zurückgibt."). |
| get | dynctl get [flags] | Ruft Dynamic Engine-Details aus dem Cluster ab. |
| get environment | dynctl get environment &lt;name&gt; [flags]<br><br>dynctl get env &lt;name&gt; [flags]<br><br><ul> <li><span>name</span>: Der Name der <span> Dynamic Engine</span>-Umgebung, deren Details gedruckt werden sollen. Wenn er ausgelassen wird, werden alle Umgebungen aufgelistet.</li> </ul> | Listet Dynamic Engine-Umgebungen auf oder gibt Details zu einer spezifischen Umgebung an. |
| help | dynctl help &lt;command&gt; | Ruft Hilfe für einen bestimmten Befehl auf. |
| logs | dynctl logs [flags] | Zeigt Logs ausgeführter Dynamic Engine-Dienste im Cluster an. |
| logs environment | dynctl logs environment &lt;name&gt; [flags]<br><br>dynctl logs env &lt;name&gt; [flags]<br><br><ul> <li><span>name</span>: Der Name der <span> Dynamic Engine</span>-Umgebung, deren Details gedruckt werden sollen. Wenn er ausgelassen wird, werden alle Umgebungen aufgelistet.</li> </ul> | Zeigt Logs ausgeführter Dienste für die angegebene Dynamic Engine-Umgebung an. |

## Die dynctl-Befehls-Flags

Flags verändern das Befehlsverhalten, indem Standardeinstellungen überschrieben werden. Sie sind in zwei Kategorien unterteilt:

1. Globale Flags: Gelten für alle Befehle.
2. Befehlsspezifische Flags: Gelten nur für die entsprechenden Befehle.

Befehlszeilen-Flags haben Vorrang vor Standardwerten in der Konfigurationsdatei und Umgebungsvariablen. Die Vorrangreihenfolge für Konfigurationswerte ist:

1. Befehlszeilen-Flags wie oben erläutert (höchste Priorität)
2. Umgebungsvariablen
3. Konfiguration in YAML-Datei (niedrigste Priorität)

- **Globale Flags**
    - 
- --config
    - Überschreibt die dynctl-Standardkonfigurationsdatei $HOME/.dynctl/config.
- --kubeconfig
    - Überschreibt die kubectl-Standardkonfiguration für die Cluster-Verbindung.
- --kubecontext
    - Überschreibt den Kubernetes-Kontext, der standardmäßig default-context in der kubeconfig-Datei ist.
- -d, --debug
    - Aktiviert den Debug-Modus und konvertiert dynctl-Logs aus JSON in ein für Personen lesbares Format.
- -v, --verbose
    - Aktiviert den Modus „verbose“ und protokolliert alle dynctl-Log-Stufen.
- -h, --help
    - Zeigt Hilfeinformationen für den Befehl an.

- **Befehlsspezifische Flags für logs und logs environment**
    - 
- --follow, -f
    - Streamt Protokolle fortlaufend, während sie generiert werden. Standard: false.
- --output, -o
    - Gibt das Log-Ausgabeformat an, entweder stdout oder zip. Standard: stdout.
- --output-file
    - Legt den Pfad für die Ausgabedatei fest. Standard: autogenerated.
- --service, -s
    - Filtert Logs nach dem angegebenen Dienst. Sie können dieses Flag mehrmals verwenden, um nach verschiedenen Diensten zu filtern.
- --since
    - Zeigt Log-Ausgaben an, die innerhalb eines bestimmten Zeitraums generiert wurden, z. B. 300ms, -1.5h, 2h45m. Gültige Zeiteinheiten sind ns, us (oder µs), ms, s, m, h. Standard: alle Logs.
- --tail
    - Gibt die Anzahl der anzuzeigenden Log-Ausgabezeilen an. Standard: alle Zeilen.

## Die dynctl-Konfigurationsmethoden

Das dynctl-Tool kann mithilfe verschiedener Methoden konfiguriert werden, die nach Vorrang aufgelistet werden:

1. Befehlszeilen-Flags wie oben erläutert (höchste Priorität)
2. Umgebungsvariablen
3. Standardwerte in YAML-Datei (niedrigste Priorität).

KonfigurationsmethodenzuordnungKonfigurationsmethodenzuordnung

| Flag | Umgebungsvariable | YAML-Schlüssel | Standard | Beschreibung |
| --- | --- | --- | --- | --- |
| --config | DYNCTL\_CONFIG | config | $HOME/.dynctl/config | Der dynctl-Konfigurationsdateipfad |
| --kubeconfig | DYNCTL\_KUBECONFIG | k8s.config | kubectl-Standard | Kubernetes-Konfigurationsdatei(en) für dynctl |
| --kubecontext | DYNCTL\_KUBECONTEXT | k8s.context | aktueller Kontext von kubectl | Kubernetes-Kontext für dynctl |
| --debug | DYNCTL\_DEBUG | debug | false | Debug-Modus |
| --verbose | DYNCTL\_VERBOSE | verbose | false | Modus „verbose“ |