Skip to main content

Telemetria gerenciada pelo cliente

Esse recurso permite que você gere um arquivo de log de telemetria de fluxo de trabalho depois da atualização para o Alteryx Designer 2021.4 (ou posterior). Ele possibilita às empresas melhorarem a coleta e o registro dos dados de uso do Designer, até a execução individual de fluxos de trabalho por um usuário. Você pode usar os dados para realizar análises internas de uso do produto.

Nota

Os arquivos XML de telemetria não incluem informações da janela "Resultados". Informações como tempo de execução do fluxo de trabalho, registros lidos e gravados em arquivos e quaisquer erros, avisos ou outras mensagens são incluídos apenas nos logs do motor. Para configurar o diretório de log para produzir logs que incluem essas informações, acesse Opções > Configurações de usuário > Editar configurações de usuário > Geral.

Starter Kit do utilitário empresarial de governança

Está agora disponível um novo utilitário empresarial que trata da telemetria gerenciada pelo cliente. Esse utilitário permite a você processar os dados de telemetria coletados usando este novo recurso no Designer. O utilitário também inclui dois exemplos de painéis que são automaticamente preenchidos com seus dados para agilizar a obtenção de insights.

Para baixar o utilitário, vá para o Alteryx Marketplace.

A Alteryx protege a privacidade dos dados

Os arquivos de log resultantes exportados pelo recurso de telemetria gerenciada pelo cliente não são enviados nem consumidos pela Alteryx de forma alguma. Você pode implantar a telemetria gerenciada pelo cliente editando os arquivos de administrador como parte de uma instalação do Alteryx. O uso desse recurso pode sujeitar os administradores às exigências das leis de privacidade locais. Por exemplo, a responsabilidade de divulgar a coleta de dados pessoais. A Alteryx não exige que esse recurso seja ativado nem controla o uso dele.

Configuração de telemetria

  1. Abra o arquivo RuntimeSettings, normalmente localizado nos seguintes diretórios. Observe que os caminhos de arquivo abaixo são os caminhos padrão para instalações do Alteryx. Sua versão do Alteryx pode ser instalada em um local diferente.

    • Versão de administrador: %ProgramFiles%\Alteryx\bin\RuntimeData\RuntimeSettings.xml

    • Versão de não administrador*: %LocalAppData%\Alteryx\bin\RuntimeData\RuntimeSettings.xml

      *A reinstalação de uma versão de não administrador do Designer pode substituir essas configurações.

  2. Certifique-se de que você tenha permissão de edição para o arquivo "RuntimeSettings".

  3. Adicione o código abaixo ao arquivo XML RuntimeSettings. Certifique-se de que a tag de telemetria esteja aninhada em SystemSettings, mas não contida em qualquer outra tag dentro de SystemSettings.

    Observe como a tag <Telemetry> nesta imagem é uma entrada independente aninhada em <SystemSettings>, mas não aninhada na tag <Engine>. Este é um exemplo de posicionamento correto.

    Image showing an example Telemetry entry inside of the SystemSettings tag.
    • Você pode definir o caminho do arquivo até qualquer caminho existente em que você queira armazenar o XML. O exemplo abaixo salva os arquivos em uma pasta de log dentro de C:/ProgramData/Alteryx/Engine.

    • Além disso, observe que a tag EnableCustomerManagedTelemetry e o caminho do arquivo associado devem estar em uma linha. Não coloque a tag em outra seção.

    <Telemetry>
    <EnableCustomerManagedTelemetry>C:\ProgramData\Alteryx\Engine\Logs</EnableCustomerManagedTelemetry> 
    </Telemetry>
  4. Salve as edições feitas no arquivo "RuntimeSettings" e reinicie o computador.

Quando os usuários executarem um fluxo de trabalho, um registro XML completo será capturado e armazenado no caminho de arquivo que você definiu.

Informações capturadas

A telemetria gerenciada pelo cliente foi projetada para ser flexível e compatível com uma variedade de casos de uso. Para fornecer informações de uso, você pode configurar o Alteryx para registrar em log o arquivo XML subjacente de um fluxo de trabalho em um caminho de arquivo local ou de rede.

Observe que os arquivos XML de telemetria não incluem informações da janela Resultados. Informações como tempo de execução do fluxo de trabalho, registros lidos e gravados em arquivos e quaisquer erros, avisos ou outras mensagens são incluídos apenas nos logs do motor. Você precisa configurar o diretório de log em Opções > Configurações de usuário > Editar configurações de usuário > Geral para produzir logs que incluem essas informações.

Estas tags XML do cabeçalho são representadas na parte superior do arquivo de log:

Tag XML

Descrição

TimeStamp

Carimbo de data/hora que identifica quando o fluxo de trabalho foi executado. O carimbo de data/hora está em UTC com o seguinte formato: yyyy-MM-dd'T'HH:mm:ss'Z'.

UserEmail

O e-mail do usuário enviado no momento da ativação do produto.

MachineName

O nome de host da máquina.

AlteryxGlobalUID

ID de execução exclusivo.

WorkflowFilePath

Caminho totalmente qualificado para o arquivo que foi executado.

LicenseKey

A chave de licença usada para ativar o produto.

Observações adicionais

  • A tag WorkflowFilePath não registra um valor até que um fluxo de trabalho seja salvo.

  • Verifique se você tem acesso de gravação ao caminho do arquivo especificado nas configurações de tempo de execução para ativar esse recurso com sucesso.