Práticas recomendadas de monitoramento

Alertas de monitoramento

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

Definir limites de alerta

Defina um limite após o qual um alerta precisa ser gerado. O que você define depende da sua configuração de hardware. O limite precisa ser definido em relação à capacidade. Por exemplo, o Apigee Edge pode ser muito baixo 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 consecutivas de alertas. 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:

Verificar portas específicas da Apigee e de terceiros

Monitore as seguintes portas para garantir que elas estejam ativas

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

Verifique as seguintes portas de terceiros para garantir que elas estejam ativas:

• Porta Qpid 5672
• Porta Postgres 5432
• Porta Cassandra 7000, 7199, 9042, 9160
• Porta ZooKeeper 2181
• Porta SymasLDAP 10389

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 à mostrada 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 relacionadas ao 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 os componentes do sistema, por exemplo, CPU, memória, disco, carga, processos e assim por diante, antes e depois de atingir um estado de falha. Isso também permite identificar e diagnosticar a origem dos problemas atuais do sistema ou prever possíveis problemas.

Por exemplo, um registro de 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 registro sem precisar reiniciar um servidor. O arquivo logback.xml contém a seguinte propriedade que define a frequência com que o mecanismo de registro verifica o arquivo logback.xml em busca de mudanças de configuração:

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

Por padrão, o mecanismo de registro verifica as mudanças a cada minuto. Se você omitir as unidades de tempo para o atributo scanPeriod, ele será definido como milissegundos.

A tabela a seguir informa o local dos arquivos de registro dos componentes do Apigee Edge Private Cloud.

Ativar registros de depuração para o processador de mensagens

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

1. No nó do processador de mensagens, edite /opt/apigee/customer/application/message-processor.properties. Se o 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

Práticas recomendadas do apigee-monit

Ao usar o apigee-monit, a Apigee recomenda que você:

• Interrompa o monitoramento de um componente antes de realizar qualquer operação que o inicie ou interrompa, como um backup ou uma upgrade.
• Monitore o apigee-monit usando uma ferramenta como cron. Para mais informações, consulte Monitorar o apigee-monit.

Ferramentas de monitoramento

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