[Contexto]

A família InterSystems IRIS tem um ótimo utilitário ^SystemPerformance (conhecido como ^pButtons no Caché e no Ensemble) que gera as informações de desempenho do banco de dados em um arquivo HTML legível. Ao executar ^SystemPerformance no IRIS para Windows, um arquivo HTML é criado onde nosso próprio log de desempenho mgstat e o log de desempenho do Windows são incluídos.

^SystemPeformance gera um ótimo relatório, mas você precisa extrair seções de log manualmente de um arquivo HTML e colá-las em um editor de planilha como o Excel para criar um gráfico visual de desempenho. Vários desenvolvedores já compartilham dicas e utilitários úteis para fazer isso aqui (Este é um ótimo artigo no Developer Community, de  @Murray Oldfield )

Agora, apresento o novo utilitário ^mypButtons!

 

[O que há de novo em relação a outras ferramentas]

Baixe mypButtons.mac no OpenExchange.

• ^mypButtons combina o mgstat e o log de desempenho do Windows em uma linha. Por exemplo, você pode criar um gráfico incluindo "PhyWrs" (mgstat) e "Disk Writes/sec" (Win perfmon) no mesmo período.
• ^mypButtons lê vários arquivos HTML ao mesmo tempo e gera um único arquivo CSV combinado.
• ^mypButtons gera um único arquivo CSV no seu laptop, então é muito mais fácil criar seu gráfico como quiser.
• ^mypButtons gera um CSV e inclui colunas que recomendo muito conferir como o primeiro passo para ver o desempenho do produto da InterSystems. Assim, todo mundo pode aproveitar um gráfico de desempenho com esse utilitário facilmente!

Observação! Se você quiser reproduzir mypButtons.csv, carregue os arquivos HTML SystemPerformance com o perfil "a cada 1 segundo".

 

[Como executar]

do readone^mypButtons("C:\temp\dir\myserver_IRIS_20230522_130000_8hours.html","^||naka")

Ele lê um arquivo HTML SystemPerformance e armazena as informações em um determinado global. Nessa amostra, ele lê myserver_IRIS_20230522_130000_8hours.html e armazena-o em ^||naka.

do readdir^mypButtons("C:\temp\dir","^||naka")

Ele lê todos os arquivos HTML SystemPerformance HTML em uma pasta específica e armazena as informações em um determinado global. Nessa amostra, ele lê todos os arquivos HTML em C:\temp\dir e armazena-os em ^||naka.

do writecsv^mypButtons("C:\temp\csv","^||naka")

Ele gera os três arquivos csv a seguir em uma pasta específica a partir de um determinado global.

• mgstat.csv
• perfmon.csv
• mypButtons.csv

Aqui, mypButtons.csv inclui as seguintes colunas por padrão, que recomendo muito verificar primeiro para ver o desempenho:

• mgstat: Glorefs, PhyRds, Gloupds, PhyWrs, WDQsz, WDphase
• perfmon: Available MBytes, Disk Reads/sec, Disk Writes/sec, % Processor Time

Esse utilitário funciona para o InterSystems IRIS, InterSystems IRIS for Health, Caché e Ensemble para Windows.

 

[Etapas de exemplo para criar o gráfico de desempenho do seu servidor IRIS com ^mypButtons]

(1) Primeiro, execute ^SystemPerformance para registrar nossa própria ferramenta de desempenho mgstat e o monitor de desempenho do Windows perfmon. Por padrão, o InterSystems IRIS possui alguns perfis, então você pode aproveitá-los logo. Tente isto no terminal IRIS.

%SYS> do ^SystemPerformance
Current log directory: c:\intersystems\iris\mgr\
Windows Perfmon data will be left in raw format.
Available profiles:
　　1 12hours - 12-hour run sampling every 10 seconds
　　2 24hours - 24-hour run sampling every 10 seconds
　　3 30mins - 30-minute run sampling every 1 second
　　4 4hours - 4-hour run sampling every 5 seconds
　　5 8hours - 8-hour run sampling every 10 seconds
　　6 test - 5-minute TEST run sampling every 30 seconds
select profile number to run: 3

Observação! Se você quiser reproduzir mypButtons.csv, use o perfil "a cada 1 segundo". Por padrão, você verá um perfil de "30 mins" que faz a amostragem a cada 1 segundo. Se quiser criar outros perfis, veja nossa documentação para mais detalhes.

(2) Depois da amostragem, um HTML será gerado em irisdir\mgr, cujo nome é parecido com JP7320NAKAHASH_IRIS_20231115_100708_30mins.html. Abra um HTML gerado, e você verá muitos dados de desempenho separados por vírgulas nas seções mgstat e na seção perfmon. 

 

(3) Carregue-o com ^mypButtons conforme abaixo.

USER> do readone^mypButtons("C:\InterSystems\IRIS\mgr\JP7320NAKAHASH_IRIS_20231115_100708_30mins.html","^||naka")

Isso carregará o HTML no primeiro parâmetro e salvará os dados de desempenho no global no segundo parâmetro.

(4) Gere o CSV com ^mypButtons conforme abaixo.

USER> do writecsv^mypButtons("C:\temp","^||naka")

Isso gerará três arquivos CSV na pasta no primeiro parâmetro do global no segundo parâmetro. Abra mypButtons.csv no excel, e você pode ver mgstat e perfmon na mesma linha a cada segundo. Veja esta captura de tela - as colunas destacadas em amarelo são mgstat, e as em azul são perfmon.

 

(5) Vamos criar um gráfico simples com esse CSV. É muito fácil. Escolha a coluna B Time  e a coluna C Glorefs, selecione o menu Insert (Inserir), gráficos de linhas 2D, conforme abaixo. 

 

Esse gráfico mostrará informações de "Números de referência do global por segundo". Infelizmente, houve muito poucas atividades em minha instância IRIS, então meu gráfico de amostra não animará você, mas acredito que este gráfico do servidor de produção traz muitas informações úteis!

 

(6) mypButtons.csv inclui colunas selecionadas que acredito que você deve verificar primeiro. A série de artigos de Murray fala sobre a importância dessas colunas para ver o desempenho.

 

[Editar ^mypButtons para as colunas relatadas]

Se você quiser mudar as colunas relatadas no mypButtons.csv, modifique o rótulo writecsv manualmente. Ele relata as colunas definidas nessa área. 

 

 

Espero que meu artigo e utilitário incentivem você a conferir o desempenho do InterSystems IRIS. Feliz SystemPeformance 😆