Adicionar dados personalizados ao Insights

Importante:

• For deployments exceeding 75 processes and/or queues with custom data added per tenant, you must either add your desired process and queue tables to an allowlist or Enable Table Grouping.
• A configurable alert is displayed warning you when you are approaching this limit.
• Table grouping may also need to be enabled based upon the total number of such tables across all tenants. Review the Hardware and Software Requirements for additional details.
• O número de colunas em processamento e tabelas de fila é limitado a 40.

Design de fluxo de trabalho para o Insights

Importante:

Unique case-insensitive names must be used for all custom variables (i.e. do not use successfulTransaction and SuccessfulTransaction). If your variables are not unique, you must set Insights to be case insensitive.

Ao projetar seus fluxos de trabalho de automação destinados ao consumo e análise no Insights, há alterações a serem consideradas na abordagem de melhores práticas usada até hoje.

Não é necessário "etiquetar" itens individuais e/ou pontos de dados para garantir sua disponibilidade para análise no Insights. Para todos os processos e/ou filas com campos personalizados, uma tabela personalizada é gerada automaticamente com esses campos disponíveis.

As seguintes atividades podem ser usadas no design de seus fluxos de trabalho de automação para capturar os dados desejados:

• Add Log Fields - all added log fields are ingested as a custom table in Insights. See [here] (doc:adding-custom-data-to-insights#logs) for more details.
• Add Queue Item - all data added via the ItemInformation property are ingested as a custom table in Insights. See here for more details.
• Set Transaction Status - all data added via the Analytics and Output properties are ingested as a custom table in Insights. See here for more details.

For complete details about all data ingested by Insights, see the Insights Data Model page.

Observação:

Para aqueles fluxos de trabalho que você deseja analisar no Insights, é recomendável registrar todos os dados desejados no final de cada fluxo de trabalho.

Where previously you would use the RemoveLogFields activity at the end of any individual sequence to remove logs not needed in the rest of the workflow, removing all custom logs as such results in the process and data not being ingested into the Insights database.

Logs

Existem 2 métodos para utilizar os logs para enviar dados ao Insights:

• Mensagem de log - permite adicionar uma mensagem de string personalizada que é enviada ao Insights, na forma de um evento de log, em caso de erro no fluxo de trabalho.
• Adicionar campos de log - permite adicionar variáveis personalizadas aos painéis do Insights padrão.

Quando o Insights detecta que uma mensagem de log possui campos de log personalizados adicionados por meio da atividade Adicionar Campos de Log, uma nova tabela é criada no Insights contendo esses campos personalizados com o título "Process-<your process name>”. Esses campos personalizados são extraídos da mensagem bruta por meio de um analisador JSON personalizado e adicionados à tabela no formato RawMessage_CustomFieldName.

Os seguintes tipos de dados para campos personalizados são compatíveis: Integer, String, Boolean, Double e Float.

Observação:

As tabelas personalizadas não são associadas ao esquema de dados do OOTB, portanto, widgets de tabela cruzada não serão possíveis, a menos que o relacionamento seja criado. Para essa personalização, entre em contato com o representante da UiPath.

O Insights recebe o último evento de log apenas para processos bem-sucedidos. Se você usar a atividade Remover Campos de Log, o Insights não poderá capturar os campos personalizados, pois eles serão removidos pelo fluxo de trabalho antes da conclusão do processo.

Isso também significa que os processos transacionais que usam logs para capturar dados por transação não enviam os dados para cada log de transação ao Insights. Se você estiver usando um processo que itera por meio de transações e deseja armazenar dados personalizados para cada uma, você deve seguir as melhores práticas da UiPath e usar filas. As Filas suportam o envio de variáveis personalizadas para cada item de fila ao Insights.

Filas

Cada item de fila possui três seções nas quais você pode armazenar variáveis personalizadas. Ao criar um item de fila por meio da atividade Adicionar Item de Fila, um campo chamado ItemInformation fica disponível. Lá, você pode armazenar quaisquer variáveis personalizadas desejadas. Os tipos de dados compatíveis para todos os dados de fila são os mesmos que para logs personalizados: Integer, String, Boolean, Double e Float.

Para adicionar variáveis personalizadas a um item de fila depois de terminar o processamento, utilize a atividade Definir Status de Transação. Ela contém duas entradas nas quais você pode armazenar variáveis: Analytics e Output.

Se campos personalizados forem detectados pelo Insights na fila, uma tabela personalizada é criada no modelo de dados chamado Queue-"your queue name”. Os campos serão identificados por meio da entrada em que foram armazenados em:

• As variáveis armazenadas em Analytics serão nomeadas “AnalyticsData_<yourfieldname>”.
• As variáveis armazenadas em Output serão nomeadas “Output_<yourfieldname>”
• As variáveis armazenadas em ItemInformation serão nomeadas “SpecificData_<yourfieldname>”.

Observação:

As tabelas personalizadas de fila não são associadas ao esquema de dados do OOTB, portanto, widgets de tabela cruzada não serão possíveis, a menos que o relacionamento seja criado. Para essas personalizações, entre em contato com o representante da UiPath.