Execução da ferramenta do pacote de suporte

A ferramenta de pacote de suporte do Automation Suite coleta logs no nível do aplicativo de serviços da UiPath® e outros componentes de software, como Istio, ArgoCD, etc. A ferramenta de pacote de suporte do Automation Suite também contém registros históricos que você pode usar para analisar padrões ao solucionar um problema. Logs detalhados são especialmente úteis quando a possível causa raiz de um problema não é evidente apenas examinando o estado do cluster.

A ferramenta de pacote de suporte do Automation Suite também é necessária ao pedir orientação ou uma correção da equipe de suporte da UiPath®, pois ela precisa dessa ferramenta para fins de análise.

Observação:

A ferramenta de pacote de suporte do Automation Suite não coleta nem armazena quaisquer PII ou dados confidenciais de você, seu usuário ou sua automação. Os aplicativos da UiPath® não vazam nem registram quaisquer informações confidenciais em seus registros. No nível da plataforma, o coletor de logs foi projetado para mascarar essas informações críticas.

A telemetria de uso resumida de alto nível também é exportada com essa ferramenta gerando um arquivo XML. Essa telemetria inclui:

• Duração da execução do robô por mês por tipo de robô.

• Concorrência de robôs - o número máximo de robôs que foram executados ao mesmo tempo.

• Métricas sobre trabalhos executados, processos executados, itens de fila, taxa de falha de trabalho e usuários.

• Informações do ambiente.

Você pode carregar o arquivo XML no Customer Portal para compartilhar sua telemetria de uso auto-hospedada de alto nível com a equipe de suporte da UiPath.

Você pode optar por não gerar essa telemetria resumida listando service-metrics na lista de excluídos no Automation Suite 2024.10 e superior.

Gerar o pacote de suporte

Para gerar o pacote de suporte, execute o seguinte comando:

./uipathctl health bundle input.json --versions version.json

Essa ferramenta leva algum tempo para coletar e armazenar todos os logs em um local temporário em sua máquina local/de gerenciamento.

A tabela a seguir lista os sinalizadores opcionais compatíveis com a ferramenta do pacote de suporte:

Bandeiras	Description
--output-dir string	Especifique o diretório para armazenar o pacote de suporte.
--namespace string	Especifique o namespace no qual o UiPath Automation Suite é implantado.
--include string	Especifique componentes adicionais (separados por vírgula) a serem incluídos no pacote (como --include=historical-logs).
--exclude string	Especifique os componentes (separados por vírgula) a serem excluídos do pacote (como service-metrics ).
--from YYYY-MM-DD	A data de início para coletar os logs históricos no formato AAAA-MM-DD.
--days int	O número de dias a partir da data de início para os quais coletar os logs históricos.
--limit-bytes int	Limita o tamanho dos logs de pods em execução fornecendo o valor inteiro em bytes.

Observação:

• Por padrão, se o sinalizador --from não for especificado, os logs históricos serão coletados dos últimos 2 dias a partir de hoje, independentemente do --days especificado.
• Se o --from for especificado e o --days não for especificado, então os logs históricos serão coletados por 2 dias a partir da data de início especificada.

Estrutura do pacote de suporte do Automation Suite

O arquivamento .tar.gz contém os seguintes arquivos e pastas:

Arquivo/Pasta	Description
current-logs	Contém os logs ao vivo (como logs para a instância atual e anterior de pods).
events.json	Contém as descrições de eventos de todos os namespaces.
alerts	Contém os alertas do prometheus ativos no cluster.
namespace/resource/object.yaml	Contém as descrições do objeto para o namespace servidor preferido/personalizado e recursos com escopo de cluster.
service-metrics	Contém a telemetria de uso de alto nível armazenada em arquivos XML individuais.