Prácticas recomendadas de supervisión

Alertas de supervisión

Apigee Edge te permite reenviar alertas a syslogs o sistemas/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.

Cómo establecer umbrales de alertas

Establece un umbral después del cual se debe generar una alerta. Lo que establezcas dependerá de tu configuración de hardware. El umbral debe establecerse 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 dos generaciones de alertas consecutivas. Puedes usar la opción horas/minutos/segundos.

Criterios para establecer alertas a nivel del sistema

En la siguiente tabla, se describen los criterios:

Verificación de 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 Message Processors
• Puerto 8080 en el servidor de administración

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

• Puerto Qpid 5672
• Puerto Postgres 5432
• Puertos Cassandra 7000, 7199, 9042 y 9160
• Puerto ZooKeeper 2181
• Puerto SymasLDAP 10389

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 suele estar 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. La sección http.management.port proporciona 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 hacen 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. Si visualizas los archivos de registro, puedes obtener información sobre los componentes del sistema, por ejemplo, CPU, memoria, disco, carga, procesos, etcétera, antes y después de alcanzar un estado fallido. Esto también te permite identificar y diagnosticar la fuente 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 para detectar cambios de configuración:

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

De forma predeterminada, el mecanismo de registro verifica los cambios cada minuto. Si omites las unidades de tiempo en el atributo scanPeriod, se establece 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.

Cómo habilitar los registros de depuración para el Message Processor

Para habilitar los registros de depuración para el Message Processor, haz lo siguiente:

1. En el nodo Message Processor, edita /opt/apigee/customer/application/message-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

Prácticas recomendadas de apigee-monit

Cuando usas apigee-monit, Apigee te recomienda lo siguiente:

• Detén la supervisión de un componente antes de realizar cualquier operación que lo inicie o detenga, como una copia de seguridad o una actualización.
• Supervisa apigee-monit con una herramienta como cron. Para obtener más información, consulta Supervisa apigee-monit.

Herramientas de supervisión

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