Carga de los registros AOT desde los componentes principales de CVAD

Si ha configurado el servidor de registros en modo HTTPS https://<LogServerFQDN>:port, asegúrese de que el certificado necesario esté correctamente instalado y sea de confianza en su sistema.

  1. Carga de registros AOT desde 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-->
    
  2. Carga de registros AOT desde 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-->
    
  3. Habilitar AOT en Windows VDA:

Desde la máquina donde instaló DDC, ejecute los siguientes comandos y, después de esto, deberá reiniciar el Servicio de escritorio de Citrix para que surta efecto de inmediato.

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

Actualizar cuando la dirección o el puerto del servidor de registros hayan cambiado:

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

Cómo deshabilitar:

```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--> ```
  1. Habilitar AOT directamente en WindowsVDA:

Ejecute el comando directamente en la máquina (WindowsVDA) donde desea cargar AOT. Esto solo tendrá efecto en la máquina donde se aplique el comando.

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

Visualización y uso de los registros AOT

Acceso a los registros a través del servidor de registros

Para mantener sus registros seguros, necesitará una AuthKey antes de descargarlos. Esto es lo que debe hacer:

  1. Obtenga su AuthKey – Utilice su propio nombre de rol/nombre para generarla.
  2. Ejecutar localmente – Los scripts solo se pueden ejecutar en la máquina donde está instalado el contenedor de Docker.
  3. Usuarios de Windows: utilice los scripts GetAuthKey.bat en lugar de los scripts de shell.
  4. Descargar registros: una vez autenticado, puede recuperar sus registros de forma segura.

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

Enumere los nombres de las máquinas que ya han enviado sus registros AOT al servidor de registros:

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

Descargue los registros por nombre de máquina y rango de tiempo. La hora está en formato UTC.

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

Descargue los registros por filtro de palabra clave/s. La hora está en formato UTC:

Nota:

  • Una palabra clave puede ser una sola palabra o una combinación de palabras.
  • Las palabras clave pueden coincidir en cualquier parte del mensaje de registro.
  • También se puede usar un ID de transacción como palabra clave.
```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--> ```
Carga de los registros AOT desde los componentes principales de CVAD