01. INTRODUÇÃO

O que são as métricas?

Métricas são medidas quantificáveis usadas para analisar o resultado de um processo, ação ou estratégia específica. De maneira geral, são medidas de desempenho.

A coleta de métricas nos sistemas da Totvs é centralizada e recebida pelo LS (License Server).

Dentre as métricas existentes, foi criada a funcionalidade de coleta de Métricas Adicionais no License Server, que permite que os produtos gerem informações a respeito do uso de rotinas do sistema, que permitirão dar uma visão mais real do uso das aplicações TOTVS e permitirão implementar ações e até gerar novas necessidades para os produtos.

A métrica adicional sempre está ligada a uma rotina/programa do produto, ou seja, não existe métrica adicional sem uma rotina principal.

Toda métrica somente é considerada válida quando cadastrada e aprovada pelo time de License Server antes de ser enviada, sendo ignoradas as métricas enviadas e não aprovadas previamente.

Disponivel a partir da versão License Server 3.2.0 

02. Como realizar envio de métricas a partir de rotinas no produto Logix?

Após cadastro e aprovação de métrica que deseja coletar em uma ou mais rotinas do Logix, para fazer o devido envio de métricas para o License Server foi desenvolvida uma nova função chamada LICENSE_addMetric() que receberá as seguintes informações para registro de métricas:

• Nome da subrotina de controle de métrica do programa
• Código de identificação da métrica (previamente aprovada)
• Valor da métrica

• Tempo (em segundos) que a métrica consumiu de tempo (OPCIONAL)

#---------------------------------#
 FUNCTION license_addmetric_test()
#---------------------------------#
   #Registrando a métrica METRICA0101 para a SUBROTINA01, com o valor 100. 
   #Neste caso não existe definição do tempo de uso para registro na métrica, visto que se trata de uma informação opcional,
   CALL _ADVPL_LICENSE_addMetric('subrotina01','metrica0101',100)

   #Registrando a métrica METRICA0103 para a SUBROTINA01, com o valor 250 e tempo de uso de 367 segundos.
   CALL _ADVPL_LICENSE_addMetric('subrotina01','metrica0103',250,367)
 END FUNCTION

 Para mais informações relacionadas aos parâmetros e forma de uso da função LICENSE_addMetric() acesse LICENSE_addmetric.

03. Quando as métricas registradas em uma rotina são enviadas para o License Server?

No ato em que uma rotina do Logix é finalizada (programa finalizado), se existirem métricas registradas em memória durante o processamento da rotina, estas serão então remetidas para o License Server no formato de uma mensagem identificada pelo ID LS006.

Para mais detalhes relacionados a conceitos relacionados a questão das Métricas Adicionais acesse a documentação Métricas Adicionais.