Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
titleAtenção

Esta página foi revisada para considerar as novas configurações de server do fluig para a da atualização 1.6.2.

Caso possua uma atualização anterior a versão 1.6, acesse: Monitor de Serviços fluigclique aqui.

Para versões 1.5.13 e anteriores, acesse: ARQ 062 - Monitor de Serviços fluig clique aqui.

Índice

Índice
outlinetrue
exclude.*ndice
stylenone

...

O objetivo deste guia é explicar como obter informações de monitoramento de serviços do fluig. Estas APIs permitem que clientes monitorem e realizem consultas de diversos relatórios referente a serviços consumidos pelo fluig, além de fornecer um acesso via Web aos dados publicados via JMX.

Nota
titleAtenção

Para acessar as APIs de Monitoramento de Serviços do fluig, deve-se obrigatoriamente realizar autenticação com o usuário "wcmadmin".

Caso o acesso seja feito em um ambiente de alta disponibilidade com autenticação integrada, a autenticação do wcmadmin deve ser realizada através do endereço: [protocolo]://[endereço_ip]:[porta]/portal/home?dologin.

Em seguida acessar a URL: http://[servidor_fluig]:[porta]/monitoring/api/v1/monitors/report

...

O módulo de monitoramento permite a consulta de uma série de relatórios referente a serviços em uso pelo fluig. Estas informação são úteis para monitorar desenvolvimentos sobre a plataforma para evoluí-los. O acesso aos relatórios pode ser feito através de API REST (que retorna um JSON) e via JMX. Primeiramente vamos resumir cada um dos serviços monitorados. 

Serviços Monitorados

Os monitores podem ser observados através de duas consultas REST diferentes. Você pode consultar diretamente o monitoramento que desejar incluindo o parâmetro na URL. Abaixo são apresentados as APIs com a relação de nomes e parâmetros de todos os monitores e seus serviços monitorados.

...

Deck of Cards
idAcesso REST
Card
labelExemplo de consulta consolidada
Figura 1 - Exemplo de consulta consolidada
Onde:
  • FAILURE: Falha na resposta do serviço;
  • NONE: Não foi utilizado até o momento;
  • OK: Em funcionamento e/ou ativado.
Card
labelExemplo de consulta parametrizada
Figura 2 - Exemplo de consulta parametrizada

 

Acesso JMX

Deck of Cards
idJMX
Card
labelPasso 1

 

  • Para acessar os monitores via JMX é utilizada a seguinte interface:
Bloco de código
languagejava
@MXBean
public interface FluigServiceMonitor {
    /**
     * 
     * Generates the report for this monitor with given parameters. The parameter syntax is:
     * 
     * paramenterName1=value1 parameterName2=value2
     * 
     * Example: "tenantId=10 forceSearch=true maxResults=15"
     * 
     * @param parameter for the monitor report
     * @return report result
     * @throws UnsupportedOperationException if this monitor doesn't support parameters.
     */
    String report(String parameter) throws UnsupportedOperationException;
    /**
     * Generates the report for this monitor.
     * 
     * @return report result.
     */
    String report();
    /**
     * Returns the name of this monitor, usually the class name without the "Monitor" suffix
     * 
     * @return name of this monitor.
     */
    String getName();
}
Card
labelPasso 2

 

  • Os MXBeans são registrados com o seguinte nome na mesma JVM do servidor de aplicações: com.fluig.monitor.jmx.bean:type=<PARÂMETRO>
Bloco de código
titleExemplo
com.fluig.monitor.jmx.bean:type=CONNECTED_USERS
Card
labelPasso 3

 

  • Com essas informações, basta acessar os JMXBeans, sem precisar utilizar uma biblioteca externa com a interface. Como os retornos e parâmetros são OpenTypes (Strings), não é necessário nenhuma dependência externa.

Image Removed

Exemplo de acesso aos JMX Beans através do Java VisualVM.