Skip to main content

Relatório de rastreamento de automação do Server

Use o Relatório de rastreamento de automação do Server (SATR) para obter o total de créditos de automação usados no Alteryx Server (versões 24.2 e anteriores). Esse utilitário só é necessário quando sua conta está na nova estrutura de preços e pacotes do Alteryx One, enquanto o Server é executado em uma versão anterior à 25.1. Conecte-se ao servidor do MongoDB ou MSSQL para extrair os dados de execução do Server. O fluxo de trabalho empacotado inclui várias opções de configuração que atendem a vários cenários, desde execução diária até trimestral.

Desempacotar o SATR e instalar as dependências

Etapa 1: desempacote o fluxo de trabalho empacotado do SATR

  1. Baixe o Server Automation Tracking Report_vX.X.X.yxzp no Alteryx Marketplace.

  2. Clique duas vezes no arquivo YXZP para descompactar e abra o fluxo de trabalho no Alteryx Designer.

  3. Uma vez aberto, o fluxo de trabalho tem vários contêineres desabilitados. Escolha o contêiner que melhor se adapta às suas necessidades e o habilite. Se você não tiver certeza, comece com o contêiner habilitado como padrão.

Etapa 2: instale o driver do Simba para MongoDB

  1. Baixe o driver do Simba no Portal de Licenças da Alteryx.

  2. Role até a parte inferior da seção Downloads de produtos e selecione Baixar à direita da entrada Drivers.

  3. Na lista de versões, selecione MongoDB e clique em Próximo.

  4. Selecione Baixar à direita da entrada Simba MongoDB 2.04.3.1003 de 64 bits. A versão no portal pode ser diferente. Isso é esperado.

  5. Clique duas vezes no arquivo MSI para instalar o driver na sua máquina. O driver agora estará acessível no utilitário de administrador do ODBC.

Etapa 3a (usa o MongoDB como Back-end): crie conexões do DCM para o MongoDB

Como as tabelas acessadas têm uma estrutura simples, a opção "Conexão rápida do MongoDB" é eficaz. Não há necessidade de configurar uma entrada DSN, pois ela não requer o acesso a estruturas aninhadas para ser executada corretamente.

  1. Abra o Gerenciador de Conexões de Dados (DCM). No Designer, vá para Arquivo > Gerenciar conexões.

  2. Na guia Fontes de dados, selecione + Novo e escolha o bloco MongoDB.

  3. No menu suspenso Tecnologia, selecione Conexão rápida ODBC do MongoDB com Simba.

    1. Nome da fonte de dados: insira o nome da fonte de dados do AlteryxService do Mongo que você deseja usar.

    2. Server: insira o nome do servidor do MongoDB para o AlteryxService. Se estiver configurando isso em um Alteryx Server usando o Mongo integrado, você pode usar localhost.

    3. Porta: insira a porta do MongoDB. O padrão usado para o Mongo integrado é 27018.

    4. Banco de dados: insira AlteryxService.

    5. Driver: use o valor padrão Simba MongoDB ODBC Driver.

  4. Selecione Salvar e Conectar credencial.

  5. Preencha estes campos:

    • Método de autenticação: nome de usuário e senha do MongoDB

    • Credencial: crie uma nova credencial

    • Nome da credencial: nome de sua escolha (por exemplo, MongoDB_AlteryxService_Local).

    • Cofre: DCM

    • Nome de usuário: seu nome de usuário (o padrão para o banco de dados do integrado é "user").

    • Senha: sua senha.

    • Mecanismo de autenticação: SCRAM-SHA-256

    • Fonte da autenticação: AlteryxService

    • Permitir conexão para SDK: desmarcado

  6. Clique em Testar conexão. Se o teste for bem-sucedido, selecione Criar e vincular.

  7. Repita essas etapas para criar uma conexão para o banco de dados AlteryxGallery. Use as mesmas configurações, exceto para estes campos:

    • Nome da fonte de dados: insira o nome da fonte de dados do AlteryxGallery que você deseja usar.

    • Banco de dados: insira AlteryxGallery.

    • Nome da credencial: insira um nome para a credencial (por exemplo, MongoDB_AlteryxGallery_Local).

    • Fonte de autenticação: insira AlteryxGallery.

    Todas as outras configurações de conexão e credencial permanecem as mesmas.

Etapa 3b (usa MSSQL como Back-end): crie conexões do DCM para MSSQL

  1. Abra o DCM. No Designer, vá para Arquivo > Gerenciar conexões.

  2. Na guia Fontes de dados, selecione + Novo e escolha o bloco Microsoft SQL Server.

  3. No menu suspenso Tecnologia, selecione ODBC do Microsoft SQL Server sem DSN.

    1. Nome da fonte de dados: insira o nome da fonte de dados do AlteryxService do MSSQL que você deseja usar.

    2. Driver: use o valor padrão ODBC Driver 17 for SQL Server.

    3. Server: insira o nome do servidor do MSSQL para o AlteryxService.

    4. Banco de dados: insira AlteryxService.

  4. Selecione Salvar e Conectar credencial.

  5. Preencha estes campos (ajuste para seus tipos de credencial do Server):

    1. Método: o nome de usuário e a senha

    2. Nome da credencial: nome de sua escolha (por exemplo, MSSQL_AlteryxService_Local).

    3. Cofre: DCM

    4. Nome de usuário: seu nome de usuário.

    5. Senha: sua senha.

  6. Clique em Testar conexão. Se o teste for bem-sucedido, selecione Criar e vincular.

  7. Repita essas etapas para criar uma conexão para o banco de dados AlteryxGallery. Use as mesmas configurações, exceto para estes campos:

    • Nome da fonte de dados: insira o nome da fonte de dados do AlteryxGallery do MSSQL que você deseja usar.

    • Banco de dados: insira AlteryxGallery.

    • Nome da credencial: insira um nome para a credencial (por exemplo, MSSQL_AlteryxGallery_Local).

    Todas as outras configurações de conexão e credencial permanecem as mesmas.

Executar o Relatório de rastreamento de automação do Server

  1. Na macro PullServerExecutions, insira as credenciais criadas nas etapas anteriores e escolha as opções aplicáveis.

    1. Selecione o back-end do MongoDB ou MSSQL.

      1. Alteryx Gallery: conexão do DCM ao banco de dados do AlteryxGallery.

      2. Alteryx Service: conexão do DCM ao banco de dados do AlteryxService.

    2. Filtrar execuções por data: restringe as consultas das tabelas "AS_Queue" (trabalhos) e "AS_Results" (mensagens de resultados) para que elas extraiam apenas até uma data especificada.

      • Filtrar por intervalo de datas (botão de opção):

        • Data de início: selecione a data para começar a extrair dados (incluindo a data selecionada).

        • Data de término: selecione a data para encerrar a extração dos dados (incluindo a data selecionada).

      • Filtrar por data relativa (botão de opção):

        • Filtrar por últimos: selecione o número de dias/meses de extração a partir da data de execução atual.

        • Unidades: selecione "Dias" ou "Meses".

        • Excluir período atual: opção para excluir o dia ou mês atual, dependendo da unidade selecionada acima.

  2. Na macro SummarizeAutomationUsage, selecione uma das opções disponíveis.

    • Incluir resumo do centro de custo: para resumir contagens de automação por centro de custo, conecte uma tabela de consulta à âncora de entrada opcional que contém o e-mail do usuário e o centro de custo correspondente. Mapeie os campos usando os 2 menus suspensos.

    • Incluir resumo do e-mail: marque a caixa de seleção para gerar uma tabela de resumo que classifica o número total de execuções de automação por usuário, por e-mail.

    • Escolher caminho do arquivo de saída: escolha um caminho completo do arquivo para o qual o relatório será enviado. O padrão é um arquivo chamado "AutomationSummary.pdf", gravado na pasta %temp%.

  3. Execute o fluxo de trabalho.

  4. Verifique a janela de resultados para obter links para o arquivo PDF temporário criado na macro SummarizeAutomationUsage.

Perguntas frequentes

1.

O que é o Relatório de rastreamento de automação do Server (SATR)?

O SATR é um utilitário de fluxo de trabalho leve para o Alteryx Server versões 24.1 e 24.2. Ele fornece visibilidade do seu uso de automação, permitindo que você compartilhe estatísticas de uso com Executivos de contas (AEs) para fins de faturamento e conformidade. O objetivo é ser uma solução temporária para clientes que ainda não atualizaram para a versão 25.1 ou mais recente.

2.

Por que o SATR é necessário?

Muitos clientes não conseguem atualizar imediatamente devido a políticas de TI ou ao tempo do seu ciclo de atualização. O SATR fornece a visibilidade necessária para renovações de contratos e conformidade. Ele serve como uma solução provisória até que os clientes possam mudar para a versão 25.1 ou mais recente, que possui geração de relatórios nativos.

3.

Quem precisa usar o SATR?

O SATR é necessário para clientes que executam versões compatíveis do Alteryx Server anteriores à 25.1 (24.1 e 24.2) enquanto estão sob um contrato do Alteryx One.

O SATR não é necessário para...

  • Clientes que utilizam o Alteryx Server 25.1 e versões mais recentes: os dados de telemetria já são enviados para a plataforma na nuvem.

  • Clientes que não estão sob um contrato do Alteryx One.

4.

O que o SATR faz?

O SATR...

  • Conecta-se ao banco de dados MongoDB do Alteryx Server.

  • Conta execuções automatizadas e o total de execuções diárias dentro de um intervalo de datas especificado pelo usuário.

  • Agrega resultados em sumários mensais.

  • Saídas:

    • Relatório em PDF: totais mensais de execuções automatizadas e detalhes da conta do cliente.

    • Arquivo YXDB: contagens diárias automatizadas e totais de execuções, com informações do servidor e carimbos de data/hora.

5.

Que dados são coletados durante a execução das macros?

Os registros de execução são recuperados das tabelas "AS_Queue" e "AS_Results" para determinar atributos relevantes, como o tipo de execução e se algum erro foi encontrado. Isso ajuda a identificar se a execução conta para um crédito de automação. A tabela "Usuários" é extraída para acrescentar e-mails aos registros de execução. Isso permite que o usuário divida posteriormente os créditos de automação por centro de custo ou por usuário.

Nenhum dado sai do ambiente enquanto o fluxo de trabalho está em execução. Os arquivos de sumário precisam ser transferidos manualmente para o Executivo de contas relevante para a geração de relatórios do uso de crédito.

6.

Como uso o SATR se eu tiver múltiplos controladores de servidor?

Cada macro pode extrair dados do banco de dados back-end de um único controlador. Você pode usar múltiplas macros em um único fluxo de trabalho para extrair dados de 2 ou mais controladores, desde que esses bancos de dados estejam acessíveis a partir da máquina que executa o fluxo de trabalho. Para gerar relatórios, execute a macro para cada controlador do Server e envie relatórios separados. Se você desejar uma exibição combinada, a consolidação manual será necessária.

7.

O SATR se integrará ao serviço de uso do Alteryx One?

Não. O SATR é uma ferramenta de geração de relatórios independente, gerenciada pelo cliente. A ingestão automatizada no serviço de uso do Alteryx One não está planejada. Se a ingestão automatizada for necessária, atualize para o Alteryx Server 25.1 ou versão mais recente.

8.

O SATR rastreia execuções na nuvem (por exemplo, Execução no Cloud para o Desktop, Plans)?

Não. O SATR relata apenas execuções automatizadas no Server local. Para obter uma visualização completa dos créditos de automação usados, combine os resultados do SATR com quaisquer dados de execução encontrados no portal do Alteryx One.

9.

E se minha organização fizer uma limpeza no seu banco de dados para higiene de dados?

Se os resultados e os logs da fila forem regularmente removidos do banco de dados back-end, você deve executar o fluxo de trabalho com mais frequência para capturar os logs diários e armazená-los em um banco de dados separado. Em seguida, esses logs podem ser sumarizados para geração de relatórios de uso total posteriormente com a macro de relatório.

10.

Como posso baixar e instalar o SATR?

  • Distribuído como um utilitário empresarial (YXZP) por meio do Alteryx Marketplace.

  • O SATR é configurado e agendado pelo administrador do Server.

  • A documentação e os guias de instalação estão disponíveis nesta página de ajuda.

11.

Executei o relatório. O que devo fazer agora?

Entre em contato com seu executivo de contas para determinar a melhor maneira de transferir o relatório que melhor atenda ao seu contrato.

12.

Os créditos de automação do SATR serão refletidos no console de administração da conta após o envio do relatório para o meu AE?

Não. A saída do SATR enviada é anotada apenas na conta e não está integrada à Plataforma Alteryx One. O total de créditos de automação no console de administração será sub-relatado até que os Servers sejam atualizados para a versão 25.1 ou mais recente.