Ir para o conteúdo

Aplicativo de Monitoramento Jitterbit

Visão Geral

O Jitterbit fornece o aplicativo de Monitoramento através do Jitterbit Marketplace. Construído com o Jitterbit App Builder, permite que um administrador monitore trabalhos agendados em uma instância do App Builder, envie notificações por e-mail para grupos de usuários quando um trabalho falha e registre como cada falha foi resolvida. Também inclui ferramentas para manutenção de banco de dados e solução de problemas, além de rastrear o uso de CPU e memória do App Server ao longo do tempo.

Você baixa o aplicativo como um pacote de lançamento do App Builder (um arquivo .LP) do Marketplace e o instala em sua própria instância do App Builder, onde configura quais agendamentos monitorar e quem notificar.

Esta página descreve como o aplicativo funciona, suas principais funcionalidades, os pré-requisitos, como baixá-lo e instalá-lo, como configurá-lo para seu ambiente, como usar o aplicativo e etapas comuns de solução de problemas.

Como funciona

O aplicativo monitora os agendamentos que você seleciona. Quando um trabalho monitorado falha, ele notifica o grupo de usuários designado e lista a falha no painel inicial para que um administrador a resolva:

flowchart TD A["Scheduled job runs
in App Builder"] --> B{"Job failed?"} B -->|Yes| C["Monitoring detects
the failure"] C --> D["Email the assigned
user group"] C --> E["Failure listed on
the home dashboard"] E --> F["Administrator reviews
in Job Details"] F --> G["Mark resolved
(kept with notes)"] F --> H["Ignore
(deleted permanently)"]

Principais funcionalidades

  • Notificações de trabalhos falhados: Monitora os agendamentos que você seleciona e envia e-mails para o grupo de usuários designado quando um trabalho falha.

  • Rastreamento de resolução: Marque um trabalho falhado como resolvido com notas para referência futura ou ignore-o. Você também pode resolver ou ignorar em massa para trabalhos que falharam na mesma ação.

  • Painéis: Um painel inicial mostra trabalhos não resolvidos e métricas do servidor, com páginas de detalhes para trabalhos, agendamentos e histórico de métricas de desempenho.

  • Métricas de desempenho do servidor: Rastreia a utilização de CPU e memória do App Server ao longo do tempo.

  • Manutenção de banco de dados: Agendamentos semanais para reorganizar e reconstruir índices, além de ações e relatórios de redução de arquivo e índice sob demanda (maiores tabelas, fragmentação média e consultas mais lentas).

  • Manutenção de logs: Truncar tabelas de log e analisar o histórico de eventos com um gráfico de Gantt dos tempos de execução.

Pré-requisitos

Para usar o Monitoramento, você precisa do seguinte:

  • Uma licença Jitterbit Harmony com acesso ao App Builder. Isso habilita o download do Marketplace; se sua organização não estiver licenciada para o App Builder, a ação Baixar aplicativo é substituída por uma ação de solicitação Obter aplicativo (veja Baixar e instalar).

  • Uma instância do App Builder executando o App Builder 4.56, a versão para a qual o pacote atual foi construído. Cada pacote instala apenas em sua versão exata do App Builder; se sua instância estiver em uma versão diferente, entre em contato com o suporte Jitterbit para solicitar um pacote correspondente.

  • Um banco de dados Microsoft SQL Server para sua instância do App Builder. As ferramentas de manutenção de banco de dados do aplicativo (reduzir arquivo e reconstruir ou reorganizar índice) utilizam operações do SQL Server.

  • Um servidor de e-mail SMTP de saída, usado para enviar notificações de falha.

  • Uma conta de usuário de serviço que você pode adicionar ao grupo Administrador. Veja Configuração e instalação.

  • Para rastreamento de CPU e memória do App Server, um host Windows, pois habilitar as métricas requer uma alteração nas permissões do Windows Performance Monitor. Veja Solução de problemas.

Baixar e instalar

Baixar o aplicativo do Marketplace

  1. Faça login no portal Harmony em https://login.jitterbit.com e abra Marketplace.

  2. Localize o aplicativo chamado Monitoramento. Você pode usar a barra de pesquisa ou, no painel Filtros sob Tipo, selecionar Aplicativo para mostrar apenas aplicativos.

  3. Clique no cartão do aplicativo para abrir o painel Detalhes. Revise os Requisitos do aplicativo (a versão do App Builder e o banco de dados que ele precisa).

  4. Clique no link Ir para a documentação do aplicativo para abrir esta documentação em uma nova aba e mantenha-a aberta para referência.

  5. Faça uma das seguintes ações, dependendo se sua organização possui licença para o App Builder:

    • Baixar aplicativo: Se sua organização possui licença para o App Builder, clique em Baixar aplicativo, no cartão do aplicativo ou no painel Detalhes. Seu navegador salva o arquivo .LP em sua localização de download, e uma notificação Arquivo do App Builder baixado com sucesso confirma o download.

    • Obter aplicativo: Se sua organização não possui licença para o App Builder, a ação é rotulada como Obter aplicativo. O painel Detalhes mostra uma mensagem informando que uma licença do App Builder é necessária, com um botão Enviar. Clique em Enviar para enviar um pedido para que um representante entre em contato com você sobre o App Builder; uma notificação Mensagem enviada com sucesso confirma isso.

Instalar o aplicativo no App Builder

Instale o arquivo .LP baixado em sua instância do App Builder:

  1. Faça login no App Builder e vá para o IDE.

  2. Em Implantar, clique em Instalar Versão.

  3. Clique em + Pacote, depois em Procurar e selecione o arquivo .LP que você baixou.

  4. Clique em Salvar. O painel Versão exibe as informações do pacote, então feche o diálogo Pacote.

  5. Confirme que os detalhes estão corretos e clique em Instalar.

Para visualizar o conteúdo de um pacote antes de instalá-lo, clique no botão Manifesto.

Modificando o aplicativo em um ambiente de desenvolvimento

A fonte de dados do aplicativo é instalada selada. Se você implantar o aplicativo em um ambiente de desenvolvimento e pretender modificá-lo, desele a fonte de dados para que você possa editar os objetos do aplicativo. Mantenha-a selada em QA e produção para preservar a equivalência entre os ambientes. Veja Selar ou deselar uma fonte de dados.

Configuração e instalação

Complete as etapas pós-instalação

  1. Adicione seu usuário de serviço ao grupo Administrador.

  2. Abra o aplicativo de Monitoramento e vá para Configurações > Configuração do Aplicativo, então:

    1. Insira a URL do Servidor Raiz (por exemplo, https://community.zudy.host/Vinyl).

    2. Insira o Endereço de Email Remetente para SMTP.

    3. Defina o Banco de Dados Vinyl e o Banco de Dados Monitor.

    4. Em Ações de Configuração, clique em Importar Usuários, Importar Agendas e Importar Bancos de Dados.

  3. Para rastrear a utilização de CPU e memória do Servidor de Aplicativos, siga os passos em Solução de Problemas para conceder acesso ao App Builder às métricas do Windows.

Configurar notificações

Após a importação, configure os grupos de usuários que receberão notificações:

  1. Em Configurações > Usuários, verifique se todos os usuários que precisam ser notificados estão presentes e selecione a caixa de seleção Notificação por Email para cada usuário que deve receber notificações. Apenas usuários com esta caixa de seleção marcada podem ser adicionados a grupos de usuários na próxima etapa.

    • Se faltarem usuários, eles não têm uma conta de usuário neste ambiente. Adicione-os no IDE e, em seguida, reimporte os usuários para exibi-los aqui.
  2. Em Configurações > Grupos de Usuários, crie grupos e adicione usuários a eles.

  3. Em Configurações > Grupos de Agendas, adicione grupos às agendas que devem notificá-los quando essa agenda tiver um erro.

    • Você também pode adicionar um grupo de notificação a uma agenda a partir da página pop-up da agenda.
  4. Em Configurações > Modelos de Notificação, ajuste o modelo padrão usado para emails de notificação.

  5. Na página Início, selecione as agendas que deseja monitorar.

Configurar manutenção do banco de dados

Duas agendas reconstroem ou reorganizam índices para bancos de dados no servidor de banco de dados. Em Configuração > Bancos de Dados, escolha quais bancos de dados estão incluídos nessas agendas. Após a execução da ação Importar Bancos de Dados, cada banco de dados importado tem suas opções Reconstituir, Reorganizar e Está Ativo selecionadas por padrão, portanto, revise a lista e desmarque qualquer um que você não deseja manter:

Configuração de manutenção do banco de dados

Uma vez configurada, a página inicial mostra as estatísticas atuais. Você pode ativar ou desativar as estatísticas em Config > Estatísticas:

Página inicial de monitoramento

Nota

Você pode não ver nenhum trabalho falhado se não houver nenhum, ou se o cronograma ainda não tiver sido executado.

Usando o aplicativo

Página inicial

A página inicial fornece um painel de estatísticas atuais para trabalhos não resolvidos e métricas do servidor, os cronogramas que são importados e podem ser monitorados, e uma lista de trabalhos não resolvidos. A partir dela, você pode acessar:

  • Detalhes do Trabalho: Informações sobre trabalhos falhados com base em um filtro selecionado.

  • Detalhes do Cronograma: Informações sobre um cronograma, como seus grupos de notificação e trabalhos falhados anteriormente.

  • Histórico de Métricas de Desempenho: Utilização histórica de CPU e memória do Servidor de Aplicativos.

Detalhes do trabalho

A página Detalhes do Trabalho mostra informações sobre um trabalho falhado selecionado. Você pode revisar notas de resolução anteriores, se houver, e marcar o trabalho como resolvido ou ignorá-lo. Marcar um trabalho como resolvido armazena o registro localmente para referência futura.

Cuidado

Ignorar um trabalho falhado o exclui permanentemente.

A opção Resolver/ignorar em massa aplica a mesma ação (resolver ou ignorar) a quaisquer trabalhos falhados que falharam na mesma ação que a selecionada.

Detalhes do trabalho

Cronogramas

  • Monitorar Cronogramas: O cronograma principal que o aplicativo requer para funcionar. Ele percorre cada cronograma definido para ser monitorado, verifica a tabela interna de trabalhos do App Builder em busca de falhas nas últimas 24 horas, registra novas falhas e cronogramas localmente, e atualiza o horário da última execução para cada cronograma monitorado.

  • Monitorar Utilização do Servidor de Aplicativos: Executa um plugin personalizado para coletar a utilização de CPU e memória do Servidor de Aplicativos e armazená-la localmente.

    Nota

    Na maioria dos casos, você deve realizar as ações em Solução de Problemas para que isso funcione.

  • Monitor Reorganize Indexes: Um cronograma semanal que reorganiza índices para os bancos de dados sinalizados para isso.

  • Monitor Rebuild Indexes: Um cronograma semanal que reconstrói índices para os bancos de dados sinalizados para isso.

Tools

O menu da barra de ferramentas inclui procedimentos armazenados para serem executados em bancos de dados específicos e relatórios correspondentes. As abas indicam qual banco de dados os procedimentos visam e quando cada um foi executado pela última vez.

App Builder

  • Truncate logs: Exclui a tabela que armazena os logs (histórico) para uma categoria.

  • Event History Analyzer:

    • Event Details: Uma lista completa de eventos executados, incluindo sucessos, falhas, durações máximas, mínimas e médias, e a última execução.

    • Event History: Um gráfico de Gantt dos tempos de execução dos eventos, filtrável por data e duração, para ajudar a identificar eventos sobrepostos que podem ter causado uma falha.

Database maintenance

  • Database: Um menu suspenso de todos os bancos de dados conectados ao aplicativo, usado para escolher qual deles as ações e relatórios serão executados.

  • Actions:

    • Shrinkfile (1): Reduz o arquivo de dados do banco de dados, recuperando e compactando espaço livre.

    • Shrinkfile (2): Faz o mesmo para o arquivo de log.

    • Reorganizing Indexes: Desfragmenta o nível de folha de índices agrupados e não agrupados e compacta as páginas do índice.

    • Rebuilding Indexes: Remove e recria o índice, eliminando a fragmentação e recuperando espaço em disco.

  • Reports: Executa contra o banco de dados selecionado: as dez maiores tabelas (MB usadas e alocadas), a fragmentação média de todas as tabelas e, em todos os bancos de dados, as 50 consultas mais lentas.

Monitor app

Três ações purgam as métricas de desempenho para diferentes períodos, limpando todos os registros dentro desse período.

History

Mostra a data da última execução de todos os procedimentos do banco de dados (mas não os relatórios).

Troubleshooting

Performance metrics fail with a registry key error

  • Sintoma: Executar as métricas de desempenho retorna o erro Access to the registry key 'Global' is denied.

  • Resolução: Conceda ao usuário do pool de aplicativos acesso aos contadores de desempenho do Windows:

    1. Abra Gerenciamento do Computador > Usuários e Grupos Locais > Grupos > Usuários do Monitor de Desempenho, e adicione a conta de usuário do pool de aplicativos (por exemplo, IIS AppPool\DefaultAppPool).

    2. Repita para o grupo Usuários do Log de Desempenho.

    3. Reinicie o IIS.

Para mais ajuda, revise os logs do seu App Builder e entre em contato com o suporte da Jitterbit.