Hochladen der AOT-Protokolle von CVAD-Kernkomponenten
Wenn Sie den Protokollserver im HTTPS-Modus https://<LogServerFQDN>:port konfiguriert haben, stellen Sie sicher, dass das erforderliche Zertifikat ordnungsgemäß auf Ihrem System installiert und vertrauenswürdig ist.
-
Hochladen von AOT-Protokollen von Storefront™
#Enable uploading in HTTP Set-STFDiagnosticsLogServer -Server LogServerFQDN:8080 #Or to use HTTPS Set-STFDiagnosticsLogServer -Server https://LogServerFQDN:8443 #Disable Clear-STFDiagnosticsLogServer #The configuration will take effect in one hour. To apply the changes immediately, restart the Citrix Telemetry Service. <!--NeedCopy--> -
Hochladen von AOT-Protokollen von DDC:
#Enable uploadng in HTTP Set-ConfigSite -LogServerEnabled $true -LogServerName LogServerFQDN -LogServerPort 8080 #Or enable HTTPS Set-ConfigSite -LogServerEnabled $true -LogServerName https://LogServerFQDN -LogServerPort 8443 #Disable HTTP Set-ConfigSite -LogServerEnabled $false -LogServerName LogServerFQDN -LogServerPort 8080 #Disable HTTPS Set-ConfigSite -LogServerEnabled $false -LogServerName https://LogServerFQDN -LogServerPort 8443 <!--NeedCopy--> -
AOT auf Windows VDA aktivieren:
Führen Sie auf dem Computer, auf dem Sie DDC installiert haben, die folgenden Befehle aus. Danach müssen Sie den Citrix Desktop Service neu starten, damit die Änderungen sofort wirksam werden.
```bash
#Initiate, run following commands in DDC powershell
$configSlot = New-BrokerConfigurationSlot -Name VdaAotTracing -Description VdaAotTracing -SettingsGroup G=Telemetry
#If using HTTPS, parameter of -Endpoint should be "https://logserverFQDN:8443"
$policy = New-BrokerLogServerAddress -Enabled $true -Endpoint "logserverFQDN:8080"
$mc = New-BrokerMachineConfiguration -ConfigurationSlotUid $configSlot.Uid -LeafName VdaAotTracing -Policy $policy
# Using the real DeliverygroupName of your VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName"
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg
#Restart Citrix Desktop Service in your VDA to make it take effect immediately.
<!--NeedCopy--> ```
Aktualisieren, wenn sich die Protokollserveradresse oder der Port geändert hat:
```bash
#Update, run following commands in DDC powershell
#If using HTTPS, parameter of -Endpoint should be "https://NewLogServerFQDN:8443"
$policy = New-BrokerLogServerAddress -Enabled $true -Endpoint "NewLogServerFQDN:8443"
Set-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing" -Policy $policy
$mc=Get-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing"
# Using the real DeliverygroupName of your VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName"
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg
#Restart Citrix Desktop Service in your VDA to make it take effect immediately.
<!--NeedCopy--> ```
So deaktivieren Sie:
```bash
#Disable, run following commands in DDC powershell
#If using HTTPS, parameter of -Endpoint should be "https://LogServerFQDn:8443"
$policy = New-BrokerLogServerAddress -Enabled $false -Endpoint "LogServerFQDN:8080"
Set-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing" -Policy $policy
$mc=Get-BrokerMachineConfiguration -Name "VdaAotTracing\VdaAotTracing"
# Using the real DeliverygroupName of your VDA.
$dg = Get-BrokerDesktopGroup -Name "DeliverygroupName"
Add-BrokerMachineConfiguration -InputObject $mc -DesktopGroup $dg
#Restart Citrix Desktop Service in your VDA to make it take effect immediately.
<!--NeedCopy--> ```
- AOT direkt auf WindowsVDA aktivieren:
Führen Sie den Befehl direkt auf dem Computer (WindowsVDA) aus, auf dem Sie AOT hochladen möchten. Dies wirkt sich nur auf den Computer aus, auf dem der Befehl angewendet wird.
```bash
# Enable AOT uploading for Windows VDA
#If using HTTPS, parameter of -AotDataStoreEndpoint should be "https://LogServerFQDN:8443"
Enable-CitrixAOTUpload -AotDataStoreEndpoint LogServerFQDN:8443 -Role WVDA
# Disable AOT uploading
Disable-CitrixAOTUpload
<!--NeedCopy--> ```
Anzeigen und Verwenden von AOT-Protokollen
Zugriff auf Protokolle über den Protokollserver
Um Ihre Protokolle zu schützen, benötigen Sie einen AuthKey, bevor Sie sie herunterladen. Gehen Sie wie folgt vor:
- Holen Sie sich Ihren AuthKey – Verwenden Sie Ihren eigenen Rollennamen/Namen, um ihn zu generieren.
- Lokal ausführen – Skripte können nur auf dem Computer ausgeführt werden, auf dem der Docker-Container installiert ist.
- Windows-Benutzer – Verwenden Sie die GetAuthKey.bat-Skripte anstelle von Shell-Skripten.
-
Protokolle herunterladen – Nach der Authentifizierung können Sie Ihre Protokolle sicher abrufen.
For Linux ./GetAuthKey.sh role-name {"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"} For Windows GetAuthKey.bat role-name {"key":"ebac9b7726cb4be597c92c6769134d25","role":"role-name","status":"DONE"} #Save the key: ebac9b7726cb4be597c92c6769134d25 by yourself. It's the only way to get the key. <!--NeedCopy-->
Maschinennamen auflisten, die ihre AOT-Protokolle bereits an den Logserver gesendet haben:
```bash
#The parameter is the key get from GetAuthKey.sh
For linux:
./ListMachines.sh ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
#Empty machines means that there has no log
For Windows:
ListMachines.bat ebac9b7726cb4be597c92c6769134d25
{"machines":["MachineName"]}
#Empty machines means that there has no log
<!--NeedCopy--> ```
Protokolle nach Maschinenname und Zeitbereich herunterladen. Die Zeit ist im UTC-Format.
```bash
#Usage: ./DownloadLogsByTime.sh [AuthKey] [MachineName] [StartTime] [EndTime] [OutputFile]
#Example:
For Linux
./DownloadLogsByTime.sh ebac9b7726cb4be597c92c6769134d25 MachineName 2025-01-01T00:00:00Z 2025-01-02T00:00:00Z logs.csv
For Windows
DownloadLogsByTime.bat ebac9b7726cb4be597c92c6769134d25 MachineName 2025-01-01T00:00:00Z 2025-01-02T00:00:00Z logs.csv
<!--NeedCopy--> ```
Protokolle nach Schlüsselwort(en) filtern herunterladen. Die Zeit ist im UTC-Format:
Hinweis:
- Ein Schlüsselwort kann ein einzelnes Wort oder eine Kombination von Wörtern sein.
- Schlüsselwörter können überall innerhalb der Protokollnachricht übereinstimmen.
- Eine Transaktions-ID kann auch als Schlüsselwort verwendet werden.
```bash
#Usage: ./DownloadLogsByWords.sh [AuthKey] [StartTime] [EndTime] [SearchWords] [OutputFile]
#Example:
For Linux:
./DownloadLogsByWords.sh authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "session launch" logs.csv
For Windows:
DownloadLogsByWords.bat authkey 2025-01-01T00:00:00.000Z 2025-12-31T23:59:59.999Z "failed vda" logs.csv
<!--NeedCopy--> ```