Algumas Configurações básicas costumam ficar esquecidas:

• Quantidade de Conexões do Fluig com o Banco de Dados (FluigDS, FluigDSRO e Customs)
  

  Não existe uma configuração padrão para o número de conexões com o banco pois cada forma de uso da Plataforma pode demandar mais ou menos conexões, mas para sair da caixinha - ou sair das configurações padrão do instalador - pode-se ajustar inicialmente o max-pool-size para 300 em cada um dos Datasources.
  
  Para casos onde a demanda de uso é grande, pode ser necessário um ajuste fino nestes parâmetros, ou ainda considerar um crescimento horizontal da Infraestrutura. Falaremos sobre Load Balance mais à frente.
  
  O TOTVS Fluig por padrão tem configurados no arquivo domain.xml 3 Datasources para atender às diversas necessidades operacionais. Sendo eles FluigDS e FluigDSRO de uso exclusivo da Plataforma e AppDS que é voltado para uso em customizados. Abaixo um exemplo de configuração sugerida para estes Datasources:
  
  
  

   <datasource jta="true" jndi-name="java:/jdbc/FluigDS" pool-name="FluigDS" enabled="true" use-java-context="false">
        <connection-url>jdbc:mysql://localhost:3306/fluig_mysql?useSSL=false&nullDatabaseMeansCurrent=true</connection-url>
        <driver>mysqlDriver</driver>
        <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
        <pool>
            <min-pool-size>10</min-pool-size>
            <max-pool-size>300</max-pool-size>
 ...
    </datasource>

    <datasource jta="false" jndi-name="java:/jdbc/FluigDSRO" pool-name="FluigDSRO" enabled="true" use-java-context="false">
        <connection-url>jdbc:mysql://localhost:3306/fluig_mysql?useSSL=false&nullDatabaseMeansCurrent=true</connection-url>
        <driver>mysqlDriver</driver>
        <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
        <pool>
            <min-pool-size>5</min-pool-size>
            <max-pool-size>300</max-pool-size>
...
    </datasource>

<datasource enabled="true" jndi-name="java:/jdbc/AppDS" jta="false" pool-name="AppDS" statistics-enabled="true" use-java-context="false">
        <connection-url>jdbc:mysql://localhost:3306/fluig_mysql?useSSL=false&nullDatabaseMeansCurrent=true</connection-url>
        <driver>mysqlDriver</driver>
        <transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
        <pool>
            <min-pool-size>5</min-pool-size>
            <max-pool-size>300</max-pool-size>
...
    </datasource>

           O arquivo domain.xml pode ser encontrado no seguinte caminho: <diretório de instalação do Fluig>\appserver\domain\configuration\domain.xml. A quantidade máxima de conexões pode ser ajustada no parâmetro <max-pool-size>.

Sempre realize um Backup do arquivo domain.xml antes de realizar alterações.
As alterações serão aplicadas somente após a reinicialização da Plataforma.

• Adequação das Filas Assíncronas

Tal como no Banco de Dados, não existe uma configuração padrão para as Filas Assíncronas da Plataforma. Entretanto, alguns ajustes simples podem trazer uma melhor entrega do serviço sem um aumento considerável no consumo de recursos do servidor;
Abaixo, listo uma sugestão de parametrização que costuma atender a maioria dos casos de forma satisfatória:

            	 <pools>
                    <bean-instance-pools>
                        <strict-max-pool instance-acquisition-timeout="30" instance-acquisition-timeout-unit="MINUTES" max-pool-size="50" name="slsb-strict-max-pool"/>
                        <strict-max-pool instance-acquisition-timeout="30" instance-acquisition-timeout-unit="MINUTES" max-pool-size="50" name="permission-ejb-pool"/>
                        <strict-max-pool instance-acquisition-timeout="30" instance-acquisition-timeout-unit="MINUTES" max-pool-size="50" name="mdb-strict-max-pool"/>
                        <strict-max-pool instance-acquisition-timeout="3" instance-acquisition-timeout-unit="MINUTES" max-pool-size="1" name="mdb-strict-single-pool"/>
                        <strict-max-pool instance-acquisition-timeout="30" instance-acquisition-timeout-unit="MINUTES" max-pool-size="1" name="mdb-deploy-max-pool"/>
                        <strict-max-pool instance-acquisition-timeout="30" instance-acquisition-timeout-unit="MINUTES" max-pool-size="60" name="mdb-strict-multi-pool"/>
                        <strict-max-pool instance-acquisition-timeout="5" instance-acquisition-timeout-unit="MINUTES" max-pool-size="5" name="mdb-page-max-pool"/>
                    </bean-instance-pools>
                </pools>

O arquivo domain.xml pode ser encontrado no seguinte caminho: <diretório de instalação do Fluig>\appserver\domain\configuration\domain.xml.
Sempre realize um Backup do arquivo domain.xml antes de realizar alterações.
As alterações serão aplicadas somente após a reinicialização da Plataforma.

• Ajuste deMemória (XMX, MetaSpace)

Por padrão. as configurações de memória que o instalador fornece são:

size="2g" (memória inicial de consumo)

max-size="4g" (máximo a ser consumido)

Para um ambiente de desenvolvimento local, muitas vezes estes parâmetros são suficientes. Porém, para um ambiente de homologação ou produção, é necessário alterar esses valores.

Esta alteração é feita no arquivo host.xml, que pode ser localizado em: <diretório de instalação do Fluig>\appserver\domain\configuration\host.xml.

Não é recomendado alterar a quantidade inicial (mínima) de memória alocada (size="2g"), pois a plataforma alocará memória de acordo com a necessidade sem que ultrapasse o valor máximo declarado em max-size, podendo retornar até o valor mínimo sempre que a demanda de uso da plataforma diminuir.

Portanto, na tag <heap> o parâmetro a ser ajustado é o 'max-size'.
Nos testes de performance realizados pela equipe de produto, o melhor valor para este parâmetro é 12g, sendo que acima deste valor não há ganho real de performance. Falaremos mais sobre como ir além deste ponto no tópico seguinte 'Dimensionamento'.

Além disto, recomenda-se também ampliar o valor do parâmetro MaxMetaspaceSize, de 1024m (1g) para 2g, conforme exemplo abaixo:

 <server auto-start="true" group="fluig" name="fluig1">
            <jvm name="default">
                <heap max-size="12g" size="2g"/>
                <jvm-options>
                    <option value="-Dfile.encoding=utf8"/>
                    <option value="-XX:MaxMetaspaceSize=2g"/>
                    <option value="-Djavamelody.disabled=true"/>
...</server>

Esta parametrização sugerida faz um bom uso dos recursos de memória, sem desperdiçar ou alocar recursos que serão utilizadas de forma não otimizada.

É importante garantir que o servidor tenha memória suficiente para suportar esta configuração.
Tenha em mente que o Sistema operacional também consome memória, então para o ajuste sugerido, deve haver pelo menos 18g de memória instalada no servidor (12g + 2g + 4g para o S.O.).
Na documentação Modelo de dimensionamento podem ser encontrados mais detalhes e recomendações sobre o assunto.

Sempre realize um Backup do arquivo host.xml antes de realizar alterações.
As alterações serão aplicadas somente após a reinicialização da Plataforma.

• Limite de Arquivos do Linux e parametrizações que dependem do Sistema Operacional, como permissões e liberações de Firewall

A instalação do Fluig depende diretamente do comportamento de das parametrizações do S.O. e da Topologia de Rede em que esteja sendo executado, portanto alguns detalhes devem ser verificados, listamos alguns abaixo:

-Permissionamento no sistema de arquivos:
Garanta que o serviço Fluig seja Owner do diretório da instalação, bem como do Volume da plataforma;

-Liberação em Firewall:
Por se tratar de uma aplicação onLine, é imprescindível garantir que as portas e endereços envolvidos estejam com a correta liberação. Consulte Portas e endereços para mais detalhes;

-Caso o servidor seja Linux, recomendamos visitar a documentação de Configurações sugeridas em ambientes Linux para o perfeito funcionamento neste S.O.

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">2</span>
        Dimensionamento
    </h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px;">Observar as demandas e responsabilidades atribuídas à Plataforma, e trabalhar com uma entrega coerente de disponibilidade de serviço</h3>
</div>

• Crescimento Horizontal x Vertical

Após atingir o limite de memória no ajuste das parametrizações padrão, que vimos no tópico anterior, o Crescimento da entrega de disponibilidade de serviço deve ser planejado de forma Horizontal.

Ou seja, se a demanda aumenta, ao invés de ultrapassar o limite recomendado de máximo de memória para o serviço Fluig devem ser disponibilizados mais servidores em paralelo, implementando o Balanceamento de Carga.

Para implementar da forma correta, recomendamos avaliar as documentações Modelo de dimensionamento e Alta disponibilidade e Balanceamento de carga, que trazem as diretrizes recomendadas para esta implementação.

• Demanda Uso x Quantidade de Nós

  x Demanda Uso 

  (capacidade de processamento) 

A partir de A partir de 100 usuários acessando a plataforma em paralelo já é recomendada a implementação do Balanceamento de Carga com pelo menos dois Servidores Fluig. 
Mesmo com menos usuários, é uma boa prática projetar este crescimento, avaliando possíveis projetos futuros e pavimentando o caminho para que a implementação do Balanceamento seja realizada.

Além do Balanceamento de Carga, ferramentas como o Apache e NGinx podem atuar como um Proxy Reverso, atuando como uma camada extra de segurança, e ampliando a maturidade da sua topologia de rede.
Para mais dicas de segurança, visite também Técnicas para dar mais segurança à sua plataforma TOTVS Fluig: 5 dicas práticas

• Avaliar as Demandas de

  Integração

  integração para adequar a entrega de disponibilidade

Muitas vezes observamos o acesso realizado por usuários físicos, mas desconsideramos que as integrações de entrada (ERP e sistemas terceiros) e integrações de saída (Datasets sincronizados, Chamadas de webservices, etc) também demandam recursos computacionais.
Sempre considere estas demandas ao realizar o dimensionamento da Plataforma, para evitar impactos aos usuários físicos e garantir uma entrega de qualidade no serviço da Plataforma.

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">3</span>
Otimização dedos Dados da Plataforma
</h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px;">Ferramentas nativas do Fluig para uso rotineiro< rotineiro, e algumas dicas extras</h3>
</div>

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">4</span>
Chamadas de Serviço Padronizadas
</h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px;">A interface de integração da Plataforma é completa e segura</h3>
</div>

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">5</span>
Controles de logs
</h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px;">Um dos Maiores Aliados do desenvolvedor</h3>
</div>

• Limpeza de Notificações, Limpeza de Lixeira e Compactação de Solicitações

Algumas ações básicas podem ser feitas utilizando a ferramenta nativa embarcada na plataforma, e trazem vantagens para manutenção de dados a longo prazo;
Verifique Plataforma ❙ Agendador de tarefas e avalie como estão suas configurações de Limpeza de Notificações, limpeza de Lixeira e Compactação de Solicitações.

Estas ações visam otimizar dados das tabelas e expurgar informações que não precisam mais ocupar espaço em Banco de Dados. Mais detalhes sobre cada um dos tópicos podem ser encontrados na documentação oficial.

• Avaliar documentos  nunca acessados

/* Anexos de processos nunca acessados */

SELECT nr_versao, nr_documento, nm_arquivo_fisico, num_tam_arq_fisic FROM documento d WHERE nr_acessos = 0 AND tp_documento=7 OR (tp_documento=2 AND EXISTS(SELECT ap.NR_DOCUMENTO FROM anexo_proces ap WHERE ap.NR_DOCUMENTO = d.NR_DOCUMENTO) ) ORDER BY num_tam_arq_fisic DESC, nr_documento DESC

/* Documentos que não são anexos de processos, nunca acessados */

SELECT nr_versao, nr_documento, nm_arquivo_fisico, num_tam_arq_fisic FROM documento d WHERE nr_acessos = 0 AND tp_documento=2 AND not EXISTS(SELECT ap.NR_DOCUMENTO FROM anexo_proces ap WHERE ap.NR_DOCUMENTO = d.NR_DOCUMENTO ) ORDER BY num_tam_arq_fisic DESC, nr_documento DESC

Nunca elimine informações diretamente das tabelas da plataforma.

Os documentos que forem identificados para eliminação devem ser eliminados através da Navegação de Documentos, ou das APIs Públicas de manutenção de Documentos.

• Avaliar documentos com validade expirada
  
  

/* documentos com a data de expiração menor do que a data atual */
SELECT distinct(nr_documento) FROM documento WHERE dt_expiracao < CURDATE() 

Nunca elimine informações diretamente das tabelas da plataforma.

Os documentos que forem identificados para eliminação devem ser eliminados através da Navegação de Documentos, ou das APIs Públicas de manutenção de Documentos.

• Expurgo da tabela fdn_accesslog

A tabela fdn_accesslog registra todas as tentativas de login com erro, com sucesso e logout da Plataforma.
Os dados desta tabela podem servir para auditoria de acesso, mas após extraídos relatórios e informações relevantes, as informações podem ser apagadas da tabela para diminuir o volume de dados do Banco de Dados.

/*
 log_type:
0 - LOGIN, 
1 - LOGINERROR, 
2 - LOGOUT

access_date
Data no formato 'YYYY-MM-DD HH:mm:ss'
*/
SELECT * FROM fdn_accesslog

Diferente de outras tabelas da plataforma, a tabela fdn_accesslog pode ter dados eliminados diretamente no banco de dados.

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">4</span>
Chamadas de Serviço Padronizadas
</h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px;">A interface de integração da Plataforma é completa e segura</h3>
</div>

• Sempre consumir APIs documentadas

Nas integrações com aplicações externas e APIs da Plataforma, é importante garantir que ocorram de forma segura e confiável.

As APIs documentadas são uma forma de 'contrato', onde a documentação da API garante que a assinatura seguirá coerente ao longo das atualizações das Plataformas. 

• Usar o Cadastro de Serviços como Interface de Integração 

O Cadastro de Serviços da Plataforma traz diversas vantagens, como por exemplo a rastreabilidade do número total de chamadas, bem como a diferenciação das chamadas com sucesso e as que retornaram erro, em cada API cadastrada.

Além disso, nas APIs configuradas é possível consultar um Log detalhado destas tentativas de integração.
Consulte a documentação Plataforma ❙ Serviços para avaliar todas as funcionalidades.

Image Added

• Tirar proveito da Modernização e Evolução constantes da interface da Plataforma

Utilizar as interfaces da Plataforma para implementar suas integrações garante que, caso surjam novas ferramentas, Melhorias e correções, você seja contemplado sem maiores esforços.

Uma recomendação é sempre complementar o seu desenvolvimento de integrações avaliando a performance de APIs fora do contexto da Plataforma, utilizando ferramentas como PostMan para observar o comportamento das APIs isoladamente.

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">5</span>
Controles de logs
</h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px;">Um dos Maiores Aliados do desenvolvedor</h3>
</div>

• Log de chamadas de Serviço - Request x Response

Tão importante quanto fazer um desenvolvimento bem feito, é ter um acompanhamento dessas chamadas.
O Log das chamadas de Serviço é uma interface complementar ao Log Principal da plataforma, Nichado para rastrear as interações com algum serviço específico cadastrado na Plataforma.

• Log Principal - server.log

Tempos e Detalhes de execução de Serviços, Dataset e Eventos da Plataforma. Confira também Plataforma ❙ Controle de log

• Log Por Usuário

Log específico para as ações realizadas na Sessão de um usuário específico. Muito útil para isolar e avaliar comportamentos inesperados reportados por usuários da plataforma. Confira também Controle de Log

• API de monitoramento de tempos de Execução

API com a listagem dos tempos médios em Milissegundos de execuções das APIs e ferramentas internas da Plataforma. 
Acessar a URL abaixo com um usuário Administrador:

[URL Flig]/api/public/wcm/chronos/meanTimes

Image Added

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">6</span>
Cuidados durante a construção de Processos
</h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px;">Quando pequenos detalhes mudam tudo</h3>
</div>

• Integrações no lugar certo - preferencialmente em atividade de serviço, evitar eventos do tipo ‘After’ (ex.: AfterTaskComplete)
  
  Os eventos de processo devem ser evitados para execução de integração. Atividades de Serviço foram implementadas para trazer maior garantia de que as transações de integração e operações com maior tempo de processamento ocorram em segundo plano, sem congelar as ações dos usuários.
  Apesar de não recomendado, ainda é possível utilizar os eventos de Processo para realizar este tipo de chamada.
  Caso seja indispensável realizar integrações em eventos entre tarefas, priorize eventos do tipo ‘Before’, onde a transação ainda não foi concluída, em detrimento dos eventos do tipo ‘After’, onde a transação já foi concluída e as informações de formulário e decisões do processo já foram consolidadas em banco de dados.
  
  
• Atividade de Serviço - Execução Imediata x Execução Agendada
  
  Além disso, é importante observar se as integrações precisam ocorrer no momento em que o usuário envia a solicitação, ou se podem ser executadas em um segundo momento, por exemplo após o expediente, evitando concorrência de recursos com os usuários.
  
  
• Dimensionar ‘Tempo de Transação x Desempenho da Integração’ para prevenir o estouro das transações
  Outro ponto que vale destacar, é observar o desempenho de cada integração que será realizada dentro de um processo, afim de dimensionar corretamente os tempos de execução de tarefas de serviço, e avaliar quais possíveis impactos nas transações da plataforma.
  
  
• Evitar looping entre tentativas de integração, capturas de erros e fluxos automáticos
  
  Por fim, é de extrema importância avaliar também um limite para as tentativas de integração em tarefas de serviço, caso haja fluxo automático de saída para a tarefa de contenção.
  
  Image Added
  Se uma integração já foi executada por 100 tentativas, e ainda não teve sucesso, é pouco provável que na 101 ela vá funcionar. Então criar um mecanismo de escape para evitar um loop eterno é a melhor prática.

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">7<>8</span>
PáginaIntegração HomeAssíncrona
</h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px; margin: 20px auto; margin-top: 5px;">Uma boa experiência na Plataforma inicia com um bom primeiro passo;
A página inicial deve ser leve, rápida e objetiva</h3>
</div>">A Maioria das Integrações pode ocorrer enquanto o usuário se ocupa com outras tarefas</h3>
</div>

Em um universo de plataformas cada vez mais integradas, é imprescindível entender quais integrações precisam ocorrer enquanto o usuário aguarda, e quais podem ser executadas enquanto o usuário realiza outra tarefa;

Integrações de negócio Geralmente podem ocorrer do lado do servidor, garantindo uma maior fluidez das atividades dos usuários em tela e liberando recursos computacionais;

Cada vez que um usuário aguarda uma integração em tela, também estão comprometidas as Threads do Browser e topologia de rede envolvida.

Destacamos alguns motivos para priorizar integrações assíncronas:

• Evita o bloqueio das operações do usuário
  Image Added
  
• Múltiplas tentativas sem impacto direto para a operação
• Pode ser executada em horário de menor demanda, não competindo diretamente com os usuários.

Para evitar 

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">8<>9</span>
Integração AssíncronaDatasets
</h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px;">A Maioria das Integrações pode ocorrer enquanto o usuário se ocupa com outras tarefas</h3>
</div> auto; margin-top: 5px;">Boas práticas garantem que este grande aliado não se torne uma dor de cabeça</h3>
</div>

Na Implementação ou Consumo dos seus Datasets, considere:

• Trafegar somente o necessário - Observe o uso de Fields, SQLLimit e PKs nas chamadas
• Centralização para reaproveitamento - menos chamadas em tela
• Observar o tempo total de execução em sincronizações
• Cuidado com o agendamento e o intervalo de execução
• Captura e tratamento de erros (try / catch)
• Liberação de recursos de Integração (Stream, Connection, Statement, ResultSet)

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">9<>10</span>
DatasetsGestão do Banco de Dados
</h1> 
    <h3 style="width: 90%; margin: 20px auto; margin-top: 5px;">Boas>Preocupações práticasem garantemtempo quede esteProjeto, grandeAções aliadode nãoRotina see torne uma dor de cabeça</h3>
</div>manutenções básicas</h3>
</div>

Tarefas que podem ser realizadas pelo DBA de forma preventiva:

• Análise de eficiência dos Índices Padrão
• Manutenção de MetaListas - Criação de índices e otimização conforme uso das tabelas de formulário
• ‘Optimize tables’ em tabelas mais movimentadas
• Avaliação recorrente do comportamento do BD

<div style="margin-top: 50px;">
     <h1 style="position: relative;">
        <span style="float: left; margin-right: 10px; width: 30px; height: 30px; border-radius: 50%; background-color: #6b48ff; color: white; text-align: center; line-height: 30px;">10</span>
Gestão do Banco de Dados
</h1> 
    <h3 style="width: 90%; margin: 20px autocenter; marginline-topheight: 5px30px;">Preocupações em tempo>+</span>
Bônus: Percepção de Projeto, Ações de Rotina e manutenções básicas</h3>Lentidão </h1> 

</div>

É importante saber diferenciar o que é lentidão do que são processos lentos;

Aproveite estas dicas para tirar do usuário a Percepção da Lentidão

Nem todo processo lento precisa prender o usuário

 Image Added