Esta página foi traduzida pela API Cloud Translation.

Como monitorar

Edge para nuvem privada v4.18.01

Este documento descreve as técnicas de monitoramento de componentes compatíveis com uma infraestrutura implantação do Apigee Edge.

Como ativar o JMX

O JMX é ativado por padrão para o Cassandra e desativado por padrão para todos os outros componentes de solução. Portanto, você deve ativar o JMX individualmente para cada componente.

Cada componente aceita JMX em uma porta diferente. A tabela a seguir lista a porta JMX e o arquivo que você modifica para ativar o JMX nessa porta:

Componente	Porta JMX	Arquivo
Servidor de gerenciamento	1099	/opt/apigee/edge-management-server/bin/start
Roteador	1100	/opt/apigee/edge-router/bin/start
processador de mensagens	1101	/opt/apigee/edge-message-processor/bin/start
Qpid	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	1103	/opt/apigee/edge-postgres-server/bin/start

Por exemplo, para ativar o JMX no servidor de gerenciamento, abra /opt/apigee/edge-management-server/bin/start em um editor. A linha a seguir será usada para iniciar o servidor de gerenciamento:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts -Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path 
-Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

Edite essa linha para adicionar o seguinte:

-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

Observe que essa linha especifica o número da porta JMX como 1099 para o servidor de gerenciamento. Defina o o número da porta de cada componente, conforme definido na tabela acima. Exemplo:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts 
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false 
-Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path -Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

Salve o arquivo e reinicie o componente. Por exemplo, para reiniciar o aplicativo Servidor:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Ativar a autenticação JMX e definindo a senha do JMX

O processo de monitoramento do servidor de gerenciamento, do processador de mensagens, do Qpid e do Postgres usam JMX. O JMX é ativado por padrão e o acesso remoto ao JMX não requer senha.

Para ativar a autenticação JMX, cada componente tem uma ação change_jmx_auth que você usa para ativar/desativar a autenticação e definir as credenciais do JMX.

Para ativar a autenticação JMX, use o seguinte comando:

>  /opt/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

em que:

comp pode ser edge-management-server, Edge-message-processor, Edge-qpid-server ou edge-postgres-server.
As opções são:
- -u: nome de usuário
- -p: senha
- -e: y (ativar) ou n (dsiable)
O arquivo de configuração inclui:
- JMX_USERNAME=nome de usuário
- JMX_enabled=y/n
- JMX_PASSWORD=password Se não for definido ou não for transmitido com -p, você receberá uma solicitação.

Por exemplo, para usar opções na linha de comando:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -u foo -p bar -e y

Se você tiver um arquivo de configuração:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -f configFile

Se você estiver executando o Edge em vários nós, execute este comando em todos os nós, especificando os mesmos nome de usuário e senha.

Para desativar a autenticação JMX posteriormente, use o comando:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -e n

Servidor de gerenciamento

Usando JConsole para monitorar a verificação de integridade do sistema e processar informações

Use o JConsole (uma ferramenta compatível com JMX) para gerenciar e monitorar verificações de integridade e processar estatísticas. Com o JConsole, você pode consumir as estatísticas do JMX expostas pelo Management Server (ou qualquer servidor) e exibi-los em uma interface gráfica. Para mais informações sobre o uso do JConsole, consulte http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html.

Use o JConsole e o seguinte URL de serviço para monitorar os atributos do JMX (MBeans) oferecido via JMX.

service:jmx:rmi:///jndi/rmi://<ip address>:<port>/jmxrmi

em que <ip address> é o endereço IP do Management Server (ou respectivo servidor). Por padrão, a porta do servidor de gerenciamento é a 1099.

A tabela a seguir mostra as estatísticas genéricas do JMX:

JMX MBeans (link em inglês)	Atributos JMX
Memória	HeapMemoryUsage
	NonHeapMemoryUsage
	Uso
Observação:os valores dos atributos serão mostrados em quatro valores: commit, "init", "max" e "used".

Como usar a API Edge Application verifica

Você pode executar a verificação de API no servidor de gerenciamento (ou em qualquer servidor) invocando o seguinte Comando CURL:

curl http://<host>:8080/v1/servers/self/up -H "Accept: application/json"

Em que <host> é o endereço IP do Management Server. Você pode especificar o tipo Accept como application/json ou application/xml.

Essa chamada retorna o valor "true" e "false". Se verdadeiro, isso significa que o nó está ativo e o serviço Java está em execução.

Se você não receber uma resposta HTTP 200 (OK), o Edge não poderá responder à porta 8080 solicitações.

Solução de problemas

Faça login no servidor e execute o seguinte comando:
/opt/apigee/apigee-service/bin/apigee-service o status do Edge-management-server
Se o serviço não estiver em execução, inicie-o:
/opt/apigee/apigee-service/bin/apigee-service início do servidor de gerenciamento de borda

Como usar o Edge Aplicativo: verificações de usuários, organização e implantação

O servidor de gerenciamento desempenha um papel vital na manutenção de todos os outros lotes em cada local no local e instalação. Você pode verificar o status do usuário, da organização e da implantação no servidor de gerenciamento executando os seguintes comandos:

curl -u userEmail:password http://localhost:8080/v1/users
curl -u userEmail:password http://localhost:8080/v1/organizations
curl -u userEmail:password http://localhost:8080/v1/organizations/orgname/deployments

O sistema deve exibir "implantado" o status de todas as chamadas. Se eles falharem, faça o seguinte:

Verifique os registros do Management Server (em opt/apigee/var/log/edge-management-server). se há erros.
Fazer uma chamada no Management Server para verificar se ele está funcionando corretamente.
Remova o servidor do ELB e reinicie o servidor de gerenciamento.
/opt/apigee/apigee-service/bin/apigee-service reinicialização do Edge-management-server

Roteador

Você pode executar a verificação de API no roteador (ou em qualquer servidor) invocando o seguinte CURL: comando:

curl http://<host>:8081/v1/servers/self/up

Em que host é o endereço IP do roteador.

Essa chamada retorna o valor "true" e "false". Se verdadeiro, significa que o nó está ativo e o Router quando um serviço está em execução.

Se você não receber uma resposta HTTP 200 (OK), o Edge não poderá responder à porta 8081 solicitações.