O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Como monitorar

Edge para nuvem privada v. 4.16.09

Neste documento, descrevemos as técnicas de monitoramento de componentes compatíveis com uma implantação no local do Apigee Edge.

Ativar o JMX

O JMX é ativado por padrão para o Cassandra e desativado por padrão para todos os outros componentes do Edge. Portanto, é necessário ativar o JMX individualmente para cada componente.

Cada componente é compatível com 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
processador de mensagens	1101	/opt/apigee/edge-mesage-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 Management Server, abra /opt/apigee/edge-management-server/bin/start em um editor. A seguinte linha será usada para iniciar o Management Server:

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 Management Server. Defina o número da porta para 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 servidor de gerenciamento:

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

Ativar a autenticação JMX e definir a senha JMX

O processo de monitoramento do servidor de gerenciamento, do processador de mensagens, do Qpid e do Postgres usa JMX. O JMX é ativado por padrão, e o acesso remoto ao JMX não exige 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 JMX.

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

>  /<inst_root>/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

em que:

comp é 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 (desativar)
O arquivo de configuração inclui:
- JMX_USERNAME=username
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (se não for definido ou transmitido com -p, você receberá uma solicitação)

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

> /<inst_root>/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:

> /<inst_root>/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 esse comando em todos os nós, especificando o mesmo nome de usuário e senha.

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

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

Servidor de gerenciamento

Como usar o 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 a verificação de integridade e as estatísticas de processo. Com o JConsole, é possível consumir estatísticas de JMX expostas pelo Management Server (ou qualquer servidor) e exibi-las 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 URL de serviço a seguir para monitorar os atributos JMX (MBeans) oferecidos pelo JMX.

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

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

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

MBeans JMX	Atributos JMX
Memória	HeapMemoryUsage
	NonHeapMemoryUsage
	Uso
Observação:os valores do atributo serão exibidos em quatro valores: confirmado, inicial, máximo e usado.

Como usar as verificações da API Edge Application

É possível realizar a verificação da API no servidor de gerenciamento (ou em qualquer servidor) invocando o seguinte comando CURL:

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

Em que <host> é o endereço IP do servidor de gerenciamento.

Essa chamada retorna "true" e "false". Se for verdadeiro, 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 às solicitações da porta 8080.

Solução de problemas

Faça login no servidor e execute o seguinte comando:
/<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server status
Se o serviço não estiver em execução, inicie-o:
/<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server start

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

O servidor de gerenciamento desempenha um papel fundamental na união de todas as outras parcelas em cada instalação no local. Para verificar o status do usuário, da organização e da implantação no servidor de gerenciamento, emita 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 vai mostrar o status "implantado" para todas as chamadas. Se isso falhar, faça o seguinte:

Verifique se há erros nos registros do servidor de gerenciamento (em <inst_root>/apigee/var/log/edge-management-server).
Faça uma chamada para o servidor de gerenciamento para verificar se ele está funcionando corretamente.
Remova o servidor do ELB e reinicie o Management Server.
/<inst_root>/apigee/apigee-service/bin/apigee-service edge-management-server restart

Roteador

É possível realizar a verificação da API no roteador (ou em qualquer servidor) invocando o seguinte comando CURL:

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

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

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

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