Práticas recomendadas de monitoramento

Edge para nuvem privada v4.18.05

Alertas de monitoramento

A Apigee Edge permite encaminhar alertas para syslogs ou sistemas/ferramentas de monitoramento externos quando ocorre um erro ou uma falha devido à falha de um evento. Esses alertas podem ser alertas/eventos no nível do sistema ou do aplicativo. Os alertas no nível do aplicativo são, em sua maioria, alertas personalizados criados com base em eventos gerados. O administrador da rede geralmente configura as condições personalizadas. Para mais informações sobre alertas, entre em contato com o suporte da Apigee.

Como definir limites de alerta

Defina um limite para a geração de um alerta. O que você define depende da configuração do hardware. O limite precisa ser definido em relação à sua capacidade. Por exemplo, a Apigee Edge pode ser muito baixa se você tiver apenas 6 GB de capacidade. É possível atribuir um limite com o critério igual a (=) ou maior que (>). Também é possível especificar um intervalo de tempo entre duas gerações de alertas consecutivas. Você pode usar a opção de horas/minutos/segundos.

Critérios para definir alertas no nível do sistema

A tabela a seguir descreve os critérios:

Como verificar portas específicas da Apigee e de terceiros

Monitore as seguintes portas para garantir que estejam ativas:

• Portas 4526, 4527 e 4528 no servidor de gerenciamento, no roteador e no processador de mensagens
• Portas 1099, 1100 e 1101 no servidor de gerenciamento, no roteador e no processador de mensagens
• Portas 8081 e 15999 nos roteadores
• Portas 8082 e 8998 nos processadores de mensagens
• Porta 8080 no servidor de gerenciamento

Verifique se as seguintes portas de terceiros estão ativas:

• Porta Qpid 5672
• Porta 5432 do Postgres
• Portas do Cassandra 7000, 7199, 9042, 9160
• Porta 2181 do ZooKeeper
• Porta 10389 do OpenLDAP

Para determinar em qual porta cada componente da Apigee está detectando chamadas de API, emita as seguintes chamadas de API para o servidor de gerenciamento (que geralmente está na porta 8080):

curl -v -u username:password http://host:port/v1/servers?pod=gateway&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=central&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=analytics&region=dc-1

A saída desses comandos vai conter seções semelhantes às mostradas abaixo. A seção http.management.port fornece o número da porta do componente especificado.

{
  "externalHostName" : "localhost",
  "externalIP" : "111.222.333.444",
  "internalHostName" : "localhost",
  "internalIP" : "111.222.333.444",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "default",
  "tags" : {
    "property" : [ {
      "name" : "Profile",
      "value" : "Router"
    }, {
      "name" : "rpc.port",
      "value" : "4527"
    }, {
      "name" : "http.management.port",
      "value" : "8081"
    }, {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    } ]
  },
  "type" : [ "router" ],
  "uUID" : "2d4ec885-e20a-4173-ae87-10be38b35750"
}

Como visualizar os registros

Os arquivos de registro acompanham as mensagens sobre o evento/operação do sistema. As mensagens aparecem no registro quando os processos começam e terminam ou quando ocorre uma condição de erro. Ao visualizar arquivos de registro, é possível receber informações sobre componentes do sistema, como CPU, memória, disco, carga, processos etc., antes e depois de atingir um estado de falha. Isso também permite identificar e diagnosticar a origem dos problemas atuais do sistema ou ajuda a prever possíveis problemas do sistema.

Por exemplo, um registro do sistema típico de um componente contém as seguintes entradas, conforme mostrado abaixo:

TimeStamp = 25/01/13 19:25 ; NextDelay = 30
Memory
HeapMemoryUsage = {used = 29086176}{max = 64880640} ;
NonHeapMemoryUsage = {init = 24313856}{committed = 57278464} ;
Threading
PeakThreadCount = 53 ; ThreadCount = 53 ;
OperatingSystem
SystemLoadAverage = 0.25 ;

É possível editar o arquivo /opt/apigee/conf/logback.xml para controlar o mecanismo de geração de registros sem precisar reiniciar um servidor. O arquivo logback.xml contém a seguinte propriedade que define a frequência com que o mecanismo de geração de registros verifica se há mudanças de configuração no arquivo logback.xml:

<configuration scan="true" scanPeriod="30 seconds" >

Por padrão, o mecanismo de geração de registros verifica se há mudanças a cada minuto. Se você omitir as unidades de tempo no atributo scanPeriod, o padrão será milissegundos.

A tabela a seguir mostra o local dos arquivos de registro dos componentes da nuvem privada do Apigee Edge.

Como ativar registros de depuração para o processador de mensagens e a interface do Edge

Para ativar os registros de depuração do processador de mensagens:

1. No nó do processador de mensagens, edite /opt/apigee/customer/application/messsage-processor.properties. Se esse arquivo não existir, crie-o.
2. Adicione a seguinte propriedade ao arquivo:

   conf_system_log.level=DEBUG

3. Reinicie o processador de mensagens:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Para ativar os registros de depuração da interface do Edge:

1. No nó da interface do Edge, edite /opt/apigee/customer/application/ui.properties. Se esse arquivo não existir, crie-o.
2. Adicione a seguinte propriedade ao arquivo:

   conf_application_logger.application=DEBUG

3. Reinicie a IU do Edge:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Ferramentas de monitoramento

Ferramentas de monitoramento como Nagios, Collectd, Graphite, Splunk, Sumologic e Monit podem ajudar você a monitorar todo o ambiente empresarial e os processos de negócios.