Índice
Índice |
---|
outline | true |
---|
exclude | .*ndice |
---|
style | none |
---|
|
...
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 |
---|
|
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 |
---|
|
Card |
---|
label | Exemplo 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 |
---|
label | Exemplo de consulta parametrizada |
---|
| Figura 2 - Exemplo de consulta parametrizada |
|
Acesso JMX
Deck of Cards |
---|
|
Card |
---|
| - Para acessar os monitores via JMX é utilizada a seguinte interface:
Bloco de código |
---|
| @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 |
---|
| - 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 |
---|
| com.fluig.monitor.jmx.bean:type=CONNECTED_USERS |
|
Card |
---|
| - 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. |
|