Relatando estatísticas do recurso em arquivos

É possível configurar um servidor ou nó de integração para enviar estatísticas de recursos diretamente para arquivos no sistema de arquivos.

Configure um servidor de integração para gravar estatísticas do recurso em arquivos, concluindo as etapas a seguir:

1. Abra o arquivo de configuração para o seu servidor de integração (server.conf.yaml) usando um editor YAML.

   Você pode editar o arquivo usando o editor YAML integrado fornecido no Kit de Ferramentas do IBM® App Connect Enterprise, seja clicando duas vezes no arquivo na visualização Desenvolvimento de Aplicativos, seja clicando com o botão direito do mouse no arquivo e selecionando Abrir com > Editor YAML. Se você optar por editar o arquivo usando um editor de texto simples, certise-se de não incluir quaisquer caracteres de guia (que não são válidos no YAML) e use uma ferramenta de validação YAML para validar o conteúdo do seu arquivo.

   As propriedades que precisam ser configuradas estão na seção Statistics do arquivo de configuração .yaml:

   
   Statistics:
      # Application message flows will by default inherit Snapshot and Archive values set here
        ...
        Resource:
           reportingOn: true            # choose 1 of : true|false. Explicitly set to 'true' by default. If unset, defaults to 'false'.
           outputFormat: 'csvFile'      # choose 'csvFile' or 'file' (for IIB v10 compatibility). If unset, defaults to ''.

2. Configure as propriedades a seguir:
   1. Configure a propriedade reportingOn para true.
   2. Configure a propriedade outputFormat para csvFile ou file:

      csvFile

      Os dados CSV são organizados em linhas, com colunas para as métricas relatadas. A primeira coluna contém o nome do recurso e as demais colunas contêm as propriedades relatadas para o recurso em questão. Para os gerentes de recursos que produzem dados de subrecurso, linhas extras são escritas para o resumo e para cada subrecurso. Exemplo:

      • O gerenciador de recursos Parsers emite uma linha para o Summary e para cada fluxo de mensagens.parser subrecurso.
      • O gerenciador de recursos JVM emite uma linha para as Summary e linhas para os subrecursos Heap Memory, Non-Heap Memory, Garbage Collection - scavengee Garbage Collection - global .

      Arquivo

      O formato file é suportado para compatibilidade com IBM Integration Bus Versão 10. Cada gerenciador de recurso emite uma única linha para cada intervalo de relatório.

      Para os gerentes de recursos que produzem dados de subrecurso, colunas adicionais são adicionadas. Os títulos das colunas são formados prefixando o nome da métrica com o nome do recurso. Por exemplo, o gerenciador de recursos Parsers emite colunas Summary_metric_name, e para cada subrecurso outro conjunto de colunas é emitido no formato flow flow.analisador_metric_name.

      Apenas a primeira linha em cada arquivo gerenciador de recursos contém os títulos da coluna, portanto, os títulos são mostrados apenas para o resumo e subrecursos que existem quando o novo arquivo é escrito. Colunas adicionais com subrecursos extras podem aparecer no arquivo sem serem escritas na primeira linha do título. A partir do App Connect Enterprise Versão 11 em diante, os componentes não são atribuídos UUIDs, portanto, estas colunas são preenchidas com zeros.

   Servidores de integração independentes por padrão gravam os dados em arquivos no seguinte local:

   serverWorkDirectory/config/common/resourceStats/ResourceStats_integration_server_serverName_resource.txt.n

   em que:

   • serverWorkDirectory é o valor do parâmetro --work-dir.
   • serverName é o valor do parâmetro --name.
   • resource é o nome do recurso relatado, como JVM ou JDBCConnectionPools.

   Servidores do nó de integração por padrão gravam os dados em arquivos no seguinte local:

   MQSI_WORKPATH/common/resourceStats/

   onde MQSI_WORKPATH é o caminho de trabalho comum. Por exemplo, C:\ProgramData\IBM\MQSI\ (Windows) ou /var/mqsi/ (sistemasLinux® e UNIX )
3. Opcional: Opcionalmente, você pode especificar o local onde os arquivos são gravados, o número de arquivos, o tamanho dos arquivos e gravar médias nos arquivos atualizando mais configurações na seção Statistics do arquivo de configuração .yaml :

   
   Statistics:
      # Application message flows will by default inherit Snapshot and Archive values set here
        ...
        Resource:
           ...
           filePath: ''
           numberOfFiles: 4
           sizeOfFile: 25
           averages: true

   • filePath: O caminho de arquivo absoluto de onde os arquivos de estatísticas são escritos.
   • numberOfFiles: O número de arquivos de log rotatáveis que são produzidos (padrão é 4).
   • sizeOfFile: O tamanho de cada arquivo de log rotatável em MB (padrão é 25)
   • averages: Indica se as médias são gravadas no arquivo. Configure o valor para true ou false.
4. Reinicie o servidor de integração para que as mudanças entrem em vigor.
   Para obter mais informações sobre como iniciar um servidor de integração, consulte Iniciando um servidor de integração..