Prácticas recomendadas de supervisión

Edge para nube privada v. 4.17.09

Alertas de Monitoring

Apigee Edge te permite reenviar alertas a syslogs o sistemas o herramientas de supervisión externos cuando se produce un error o una falla debido a la falla de un evento. Estas alertas pueden ser alertas o eventos a nivel del sistema o de la aplicación. Las alertas a nivel de la aplicación son, en su mayoría, alertas personalizadas que se crean en función de los eventos generados. Por lo general, el administrador de red configura las condiciones personalizadas. Para obtener más información sobre las alertas, comunícate con el equipo de asistencia de Apigee.

Establece umbrales de alertas

Establece un umbral después del cual se debe generar una alerta. Lo que configures dependerá de la configuración de tu hardware. El umbral se debe establecer en relación con tu capacidad. Por ejemplo, Apigee Edge podría ser demasiado bajo si solo tienes 6 GB de capacidad. Puedes asignar un umbral con el criterio igual a (=) o mayor que (>). También puedes especificar un intervalo de tiempo entre la generación de dos alertas consecutivas. Puedes usar la opción de horas, minutos o segundos.

Criterios para configurar alertas a nivel del sistema

En la siguiente tabla, se describen los criterios:

Verifica los puertos específicos de Apigee y de terceros

Supervisa los siguientes puertos para asegurarte de que estén activos:

• Puertos 4526, 4527 y 4528 en el servidor de administración, el router y el Message Processor
• Puertos 1099, 1100 y 1101 en el servidor de administración, el router y el Message Processor
• Puertos 8081 y 15999 en routers
• Puertos 8082 y 8998 en los Message Processors
• Puerto 8080 en el servidor de administración

Verifica que los siguientes puertos de terceros estén activos:

• Puerto 5672 de Qpid
• Puerto 5432 de Postgres
• Puerto de Cassandra 7000, 7199, 9042, 9160
• Puerto 2181 de ZooKeeper
• Puerto 10389 de OpenLDAP

Para determinar en qué puerto escucha cada componente de Apigee las llamadas a la API, emite las siguientes llamadas a la API al servidor de administración (que, por lo general, se encuentra en el puerto 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

El resultado de estos comandos contendrá secciones similares a las que se muestran a continuación. En la sección "http.management.port", se indica el número de puerto del 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"
}

Visualice los registros

Los archivos de registro realizan un seguimiento de los mensajes relacionados con el evento o la operación del sistema. Los mensajes aparecen en el registro cuando los procesos comienzan y se completan, o cuando se produce una condición de error. Cuando visualizas los archivos de registro, puedes obtener información sobre los componentes del sistema, por ejemplo, la CPU, la memoria, el disco, la carga, los procesos, etcétera, antes y después de alcanzar un estado de falla. Esto también te permite identificar y diagnosticar el origen de los problemas actuales del sistema o ayudarte a predecir posibles problemas del sistema.

Por ejemplo, un registro del sistema típico de un componente contiene las siguientes entradas, como se muestra a continuación:

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 ;

Puedes editar el archivo /opt/apigee/conf/logback.xml para controlar el mecanismo de registro sin tener que reiniciar un servidor. El archivo logback.xml contiene la siguiente propiedad que establece la frecuencia con la que el mecanismo de registro verifica el archivo logback.xml en busca de cambios de configuración:

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

De forma predeterminada, el mecanismo de registro verifica si hay cambios cada minuto. Si omites las unidades de tiempo en el atributo scanPeriod, se establecerá de forma predeterminada en milisegundos.

En la siguiente tabla, se indica la ubicación de los archivos de registro de los componentes de Apigee Edge para la nube privada.

Habilita los registros de depuración para el Message Processor y la IU de Edge

Para habilitar los registros de depuración del Message Processor, sigue estos pasos:

1. En el nodo Message Processor, edita /opt/apigee/customer/application/messsage-processor.properties. Si ese archivo no existe, créalo.
2. Agrega la siguiente propiedad al archivo:
   conf_system_log.level=DEBUG
3. Reinicia el Message Processor:
   > /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Para habilitar los registros de depuración de la IU de Edge, haz lo siguiente:

1. En el nodo de la IU de Edge, edita /opt/apigee/customer/application/ui.properties. Si ese archivo no existe, créalo.
2. Agrega la siguiente propiedad al archivo:
   conf_application_logger.application=DEBUG
3. Reinicia la IU de Edge:
   > /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Herramientas de supervisión

Las herramientas de supervisión, como Nagios, Collectd, Graphite, Splunk, Sumologic y Monit, pueden ayudarte a supervisar todo el entorno empresarial y los procesos empresariales.