Autocicatrización con Apigee Monit

Apigee Edge para nube privada incluye apigee-monit, una herramienta basada en la utilidad monit de código abierto. apigee-monit sondea periódicamente los servicios perimetrales; si un servicio no está disponible, entonces apigee-monit intenta reiniciarlo.

Para usar apigee-monit, debes instalarlo manualmente. No es parte de la instalación estándar.

De forma predeterminada, apigee-monit verifica el estado de los servicios perimetrales cada 60 segundos.

Inicio rápido

En esta sección, se muestra cómo comenzar a utilizar apigee-monit rápidamente.

Si usas Amazon Linux, primero debes instalar Fedora. De lo contrario, omite este paso.

sudo yum install -y https://kojipkgs.fedoraproject.org/packages/monit/5.25.1/1.el6/x86_64/monit-5.25.1-1.el6.x86_64.rpm

Para instalar apigee-monit, sigue estos pasos:

  Instalar apigee-monit
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Esto instala apigee-monit y comienza a supervisar todos los componentes del nodo de forma predeterminada.

  Detén los componentes de supervisión
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
  Comenzar a supervisar los componentes
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
  Obtén información resumida sobre el estado
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
  Consulta los archivos de registro apigee-monit
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

Cada uno de estos temas y otros se describen en detalle en las siguientes secciones.

Acerca de apigee-monit

apigee-monit ayuda a garantizar que todos los componentes de un nodo permanezcan en funcionamiento. Para ello, ofrece una variedad de servicios, incluidos los siguientes:

  • Reinicia los servicios con errores
  • Cómo mostrar información resumida
  • Estado de supervisión de registros
  • Envía notificaciones
  • Supervisa servicios no perimetrales

Apigee recomienda que supervises apigee-monit para asegurarte de que esté en ejecución. Para obtener más información, consulta Supervisa apigee-monit.

Arquitectura de apigee-monit

Durante la instalación y configuración de Apigee Edge for Private Cloud, tienes la opción de instalar una instancia independiente de apigee-monit en cada nodo del clúster. Estas instancias apigee-monit separadas operan de manera independiente unas de otras: no comunican el estado de sus componentes a los otros nodos ni comunican fallas de la utilidad de supervisión a ningún servicio central.

En la siguiente imagen, se muestra la arquitectura apigee-monit en un clúster de 5 nodos:

Figura 1: Una instancia separada de apigee-monit se ejecuta de forma aislada en cada nodo de un clúster.

Plataformas compatibles

apigee-monit admite las siguientes plataformas para tu clúster de nube privada. (El SO compatible con apigee-monit depende de la versión de la nube privada).

Sistema operativo Versión de nube privada
v4.50.00 v4.51.00 v4.52.00
CentOS 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8
RedHat Enterprise Linux (RHEL) 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8, 7.9 y 8.0 7.5, 7.6, 7.7, 7.8, 7.9 y 8.0
Oracle Linux 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8
* Si bien no es técnicamente compatible, puedes instalar y usar apigee-monit en la versión 6.9 de CentOS/RHEL/Oracle para Apigee Edge para nube privada versión 4.19.01.

Configuraciones de componentes

apigee-monit usa la configuración de los componentes para determinar qué componentes se deben supervisar, qué aspectos del componente se deben verificar y qué medidas se deben tomar en caso de falla.

De forma predeterminada, apigee-monit supervisa todos los componentes de Edge de un nodo mediante las opciones de configuración predefinidas de los componentes. Para ver la configuración predeterminada, puedes consultar los archivos de configuración del componente apigee-monit. No puedes cambiar las configuraciones predeterminadas de los componentes.

apigee-monit verifica diferentes aspectos de un componente, según el que esté verificando. En la siguiente tabla, se muestra lo que apigee-monit verifica para cada componente y se muestra dónde está la configuración de cada componente. Ten en cuenta que algunos componentes se definen en un solo archivo de configuración, y otros tienen sus propias configuraciones.

Componente Ubicación de la configuración Qué se supervisa
Servidor de administración /opt/apigee/edge-management-server/monit/default.conf Verificaciones de apigee-monit:
  • Los puertos especificados están abiertos y aceptan solicitudes
  • Se admiten los protocolos especificados
  • Estado de la respuesta

Además, apigee-monit para estos componentes:

  • Requiere varias fallas en una cantidad determinada de ciclos antes de tomar medidas.
  • Establece una ruta de solicitud personalizada.
Message Processor /opt/apigee/edge-message-processor/monit/default.conf
Servidor Postgres /opt/apigee/edge-postgres-server/monit/default.conf
Servidor Qpid /opt/apigee/edge-qpid-server/monit/default.conf
Router /opt/apigee/edge-router/monit/default.conf
Cassandra
Edge UI
OpenLDAP
Postgres
Qpid
Zookeeper
/opt/apigee/data/apigee-monit/monit.conf Verificaciones de apigee-monit:
  • El servicio se está ejecutando

En el siguiente ejemplo, se muestra la configuración predeterminada del componente edge-router:

check host edge-router with address localhost
  restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart"
  if failed host 10.1.1.0 port 8081 and protocol http
    and request "/v1/servers/self/uuid"
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

  if failed port 15999 and protocol http
    and request "/v1/servers/self"
    and status < 600
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

En el siguiente ejemplo, se muestra la configuración predeterminada del componente de IU clásica (edge-ui):

check process edge-ui
 with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid
 start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds
 stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"

Esto se aplica a la IU clásica, no a la nueva IU de Edge, cuyo nombre de componente es edge-management-ui.

No puedes cambiar la configuración predeterminada de los componentes de ningún componente de Apigee Edge para nube privada. Sin embargo, puedes agregar tus propias configuraciones de componentes para los servicios externos, como tu extremo de destino o el servicio httpd. Para obtener más información, consulta Configuraciones de componentes que no son de Apigee.

De forma predeterminada, apigee-monit supervisa todos los componentes de un nodo en el que se está ejecutando. Puedes habilitarlo o inhabilitarlo para todos los componentes o para componentes individuales. Para obtener más información, consulta:

Instala apigee-monit

apigee-monit no está instalado de forma predeterminada. Puedes instalarlo de forma manual después de actualizar o instalar la versión 4.19.01 o posterior de Apigee Edge para la nube privada.

En esta sección, se describe cómo instalar apigee-monit en las plataformas compatibles.

Para obtener información sobre cómo uninstalling apigee-monit, consulta Cómo desinstalar apigee-monit.

Instala apigee-monit en una plataforma compatible

En esta sección, se describe cómo instalar apigee-monit en una plataforma compatible.

Para instalar apigee-monit en una plataforma compatible, haz lo siguiente:

  1. Instala apigee-monit con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
    .
  2. Configura apigee-monit con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. Inicia apigee-monit con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit start
    .
  4. Repite este procedimiento en cada nodo del clúster.

Detén y comienza a supervisar componentes

Cuando un servicio se detiene por algún motivo, apigee-monit intenta reiniciarlo.

Esto puede causar un problema si deseas detener un componente a propósito. Por ejemplo, es posible que desees detener un componente cuando necesites crear una copia de seguridad o actualizarlo. Si apigee-monit reinicia el servicio durante la copia de seguridad o la actualización, el procedimiento de mantenimiento puede interrumpirse, lo que puede provocar que falle.

En las siguientes secciones, se muestran las opciones para detener la supervisión de los componentes.

Detener un componente y dejar de supervisarlo

Para detener un componente y dejar de supervisarlo, ejecuta el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
component_name puede ser una de las siguientes opciones:
  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (base de datos de PostgreSQL)
  • apigee-qpidd (trinquete)
  • apigee-sso (SSO de Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (servidor de administración)
  • edge-management-ui (nueva IU de Edge)
  • edge-message-processor (Procesador de mensajes)
  • edge-postgres-server (servidor de Postgres)
  • edge-qpid-server (servidor Qpid)
  • edge-router (router perimetral)
  • edge-ui (IU clásica)

Ten en cuenta que "todos" no es una opción válida para stop-component. Puedes detener y dejar de supervisar solo un componente a la vez con stop-component.

Para reiniciar el componente y reanudar la supervisión, ejecuta el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name

Ten en cuenta que "todos" no es una opción válida para start-component.

Si deseas obtener instrucciones para detener y dejar de supervisar todos los componentes, consulta Cómo detener todos los componentes y dejar de supervisarlos.

Dejar de supervisar un componente (pero no detenerlo)

Para dejar de supervisar un componente (pero no detenerlo), ejecuta el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
component_name puede ser una de las siguientes opciones:
  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (base de datos de PostgreSQL)
  • apigee-qpidd (trinquete)
  • apigee-sso (SSO de Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (servidor de administración)
  • edge-management-ui (nueva IU de Edge)
  • edge-message-processor (Procesador de mensajes)
  • edge-postgres-server (servidor de Postgres)
  • edge-qpid-server (servidor Qpid)
  • edge-router (router perimetral)
  • edge-ui (IU clásica)

Para reanudar la supervisión del componente, ejecuta el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

Dejar de supervisar todos los componentes (pero no detenerlos)

Para dejar de supervisar todos los componentes (pero no detenerlos), ejecuta el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Para reanudar la supervisión de todos los componentes, ejecuta el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Detener todos los componentes y dejar de supervisarlos

Para detener todos los componentes y dejar de supervisarlos, ejecuta los siguientes comandos:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop

Para reiniciar todos los componentes y reanudar la supervisión, ejecuta los siguientes comandos:

/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Para detener la supervisión de todos los componentes, también puedes inhabilitar apigee-monit, como se describe en Detén, inicia y, luego, inhabilita apigee-monit.

Detener, iniciar e inhabilitar Apigee-monit

Al igual que con cualquier servicio, puedes iniciar y detener apigee-monit con el comando apigee-service. Además, apigee-monit admite el comando unmonitor, que te permite detener temporalmente los componentes de supervisión.

Detener apigee-monit

Para detener apigee-monit, usa el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

Iniciar apigee-monit

Para iniciar apigee-monit, usa el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Inhabilitar apigee-monit

Puedes suspender la supervisión de todos los componentes en el nodo mediante el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Como alternativa, puedes inhabilitar apigee-monit de forma permanente si desinstálalo del nodo, como se describe en Cómo desinstalar apigee-monit.

Desinstala apigee-monit

Para desinstalar apigee-monit, haz lo siguiente:

  1. Si configuras un trabajo cron para supervisar apigee-monit, quita el trabajo cron antes de desinstalar apigee-monit:
    sudo rm /etc/cron.d/apigee-monit.cron
  2. Detén apigee-monit con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
    .
  3. Desinstala apigee-monit con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. Repite este procedimiento en cada nodo del clúster.

Supervisa un componente recién instalado

Si instalas un componente nuevo en un nodo que ejecuta apigee-monit, puedes comenzar a supervisarlo mediante la ejecución del comando restart de apigee-monit. Esto genera un archivo monit.conf nuevo que incluirá el componente nuevo en las configuraciones de sus componentes.

En el siguiente ejemplo, se reinicia apigee-monit:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart

Personalizar apigee-monit

Puedes personalizar varios parámetros de configuración de apigee-monit, incluidos los siguientes:

  1. Configuración predeterminada de los controles de apigee-monit
  2. Configuración global
  3. Configuraciones de componentes que no son de Apigee

Configuración predeterminada del control de Apigee-monit

Puedes personalizar la configuración de control predeterminada de apigee-monit, como la frecuencia de las verificaciones de estado y las ubicaciones de los archivos apigee-monit. Para ello, edita un archivo de propiedades con la técnica de código con configuración. Los archivos de propiedades se conservarán incluso después de que actualices Apigee Edge para la nube privada.

En la siguiente tabla, se describe la configuración predeterminada del control apigee-monit que puedes personalizar:

Propiedad Descripción
conf_monit_httpd_port El puerto del daemon httpd. apigee-monit usa httpd para su app de panel y para habilitar informes o resúmenes. El valor predeterminado es 2812.
conf_monit_httpd_allow Restricciones de las solicitudes al daemon httpd. apigee-monit usa httpd para ejecutar su app de panel y habilitar informes o resúmenes. Este valor debe apuntar al localhost (el host en el que se ejecuta httpd.

Para exigir que las solicitudes incluyan un nombre de usuario y una contraseña, usa la siguiente sintaxis:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

Cuando agregues un nombre de usuario y una contraseña, inserta un signo "\n" entre cada restricción. No insertes saltos de línea ni retornos de carro reales en el valor.

conf_monit_monit_datadir Es el directorio en el que se almacenan los detalles del evento.
conf_monit_monit_delay_time Es la cantidad de tiempo que espera apigee-monit después de cargarse por primera vez en la memoria antes de ejecutarse. Esto afecta a apigee-monit solo la primera verificación del proceso.
conf_monit_monit_logdir La ubicación del archivo de registro apigee-monit.
conf_monit_monit_retry_time La frecuencia con la que apigee-monit intenta verificar cada proceso. El valor predeterminado es de 60 segundos.
conf_monit_monit_rundir La ubicación de los archivos de estado y PID, que apigee-monit usa para verificar los procesos.

Para personalizar la configuración de control predeterminada de apigee-monit, haz lo siguiente:

  1. Edita el siguiente archivo:
    /opt/apigee/customer/application/monit.properties

    Si el archivo no existe, créalo y configura el propietario como el usuario de “apigee”:

    chown apigee:apigee /opt/apigee/customer/application/monit.properties

    Ten en cuenta que, si el archivo ya existe, puede haber propiedades de configuración adicionales definidas además de las que se muestran en la tabla anterior. No debes modificar otras propiedades que no sean las que se mencionaron anteriormente.

  2. Establece o reemplaza los valores de la propiedad con tus valores nuevos.

    Por ejemplo, para cambiar la ubicación del archivo de registro a /tmp, agrega o edita la siguiente propiedad:

    conf_monit_monit_logdir=/tmp/apigee-monit.log

  3. Guarda los cambios en el archivo monit.properties.
  4. Vuelve a configurar apigee-monit con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. Vuelve a cargar apigee-monit con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Si no puedes reiniciar apigee-monit, comprueba el archivo de registro en busca de errores como se describe en Cómo acceder a los archivos de registro de apigee-monit.

  6. Repite este procedimiento para cada nodo en tu clúster.

Configuración global

Puedes definir la configuración global de apigee-monit; por ejemplo, puedes agregar notificaciones por correo electrónico para las alertas. Para ello, crea un archivo de configuración en el directorio /opt/apigee/data/apigee-monit y, luego, reinicia apigee-monit.

Para definir los parámetros de configuración global de apigee-monit, haz lo siguiente:

  1. Crea un archivo de configuración de componentes nuevo en la siguiente ubicación:
    /opt/apigee/data/apigee-monit/filename.conf

    Donde filename puede ser cualquier nombre de archivo válido, excepto "monit".

  2. Cambia el propietario del archivo de configuración nuevo por el usuario de “apigee”, como se muestra en el siguiente ejemplo:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
  3. Agrega tus parámetros de configuración global al archivo nuevo. En el siguiente ejemplo, se configura un servidor de correo electrónico y los destinatarios de la alerta:
    SET MAILSERVER smtp.gmail.com PORT 465
      USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD"
      USING SSL, WITH TIMEOUT 15 SECONDS
    
    SET MAIL-FORMAT {
      from: edge-alerts@example.com
      subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST
    }
    SET ALERT fred@example.com
    SET ALERT nancy@example.com

    Para obtener una lista completa de las opciones de configuración global, consulta la documentación de monetización.

  4. Guarda los cambios en el archivo de configuración del componente.
  5. Vuelve a cargar apigee-monit con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Si apigee-monit no se reinicia, comprueba el archivo de registro en busca de errores como se describe en Cómo acceder a los archivos de registro de apigee-monit.

  6. Repite este procedimiento para cada nodo en tu clúster.

Configuraciones de componentes que no son de Apigee

Puedes agregar tus propias configuraciones a apigee-monit para que verifique los servicios que no forman parte de Apigee Edge for Private Cloud. Por ejemplo, puedes usar apigee-monit para verificar que tus APIs estén en ejecución mediante el envío de solicitudes al extremo de destino.

Para agregar una configuración de componentes que no sea de Apigee, haz lo siguiente:

  1. Crea un archivo de configuración de componentes nuevo en la siguiente ubicación:
    /opt/apigee/data/apigee-monit/filename.conf

    Donde filename puede ser cualquier nombre de archivo válido, excepto "monit".

    Puedes crear tantos archivos de configuración de componentes como sea necesario. Por ejemplo, puedes crear un archivo de configuración separado para cada componente que no sea de Apigee que desees supervisar en el nodo.

  2. Cambia el propietario del archivo de configuración nuevo por el usuario de “apigee”, como se muestra en el siguiente ejemplo:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
  3. Agrega tus configuraciones personalizadas al archivo nuevo. En el siguiente ejemplo, se verifica el extremo de destino en el servidor local:
    CHECK HOST localhost_validate_test WITH ADDRESS localhost
      IF FAILED
        PORT 15999
        PROTOCOL http
        REQUEST "/validate__test"
        CONTENT = "Server Ready"
        FOR 2 times WITHIN 3 cycles
      THEN alert

    Para obtener una lista completa de los parámetros de configuración posibles, consulta la documentación de monetización.

  4. Guarda los cambios en el archivo .
  5. Vuelve a cargar apigee-monit con el siguiente comando:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Si apigee-monit no se reinicia, comprueba el archivo de registro en busca de errores como se describe en Cómo acceder a los archivos de registro de apigee-monit.

  6. Repite este procedimiento para cada nodo en tu clúster.

Ten en cuenta que esto es solo para componentes que no son de Edge. No puedes personalizar las configuraciones de los componentes de Edge.

Accede a los archivos de registro de Apigee-monit

apigee-monit registra toda la actividad, incluidos los eventos, los reinicios, los cambios de configuración y las alertas en un archivo de registro.

La ubicación predeterminada del archivo de registro es:

/opt/apigee/var/log/apigee-monit/apigee-monit.log
.

Puedes cambiar la ubicación predeterminada si personalizas la configuración de control de apigee-monit.

Las entradas del archivo de registro tienen el siguiente formato:

'edge-message-processor' trying to restart
[UTC Dec 14 16:20:42] info     : 'edge-message-processor' trying to restart
'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'

No puedes personalizar el formato de las entradas del archivo de registro apigee-monit.

Ve el estado agregado con apigee-monit

apigee-monit incluye los siguientes comandos que te brindan información de estado agregada sobre los componentes de un nodo:

Comando Uso
report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
summary
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

Cada uno de estos comandos se explica con más detalle en las siguientes secciones.

denuncia

El comando report te brinda un resumen completo de cuántos componentes están activos, inactivos, se están inicializando o no se supervisan en un nodo en este momento. En el siguiente ejemplo, se invoca el comando report:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

En el siguiente ejemplo, se muestra el resultado de report en una configuración AIO (todo en uno):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
up:            11 (100.0%)
down:           0 (0.0%)
initialising:   0 (0.0%)
unmonitored:    1 (8.3%)
total:         12 services

En este ejemplo, apigee-monit informa que 11 de los 12 servicios están en ascenso. Hay un servicio que no se supervisa actualmente.

Es posible que recibas un error Connection refused la primera vez que ejecutes el comando report. En este caso, espera el tiempo que dure la propiedad conf_monit_monit_delay_time y, luego, vuelve a intentarlo.

resumen

El comando summary enumera cada componente y proporciona su estado. En el siguiente ejemplo, se invoca el comando summary:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

En el siguiente ejemplo, se muestra el resultado de summary en una configuración AIO (todo en uno):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Monit 5.25.1 uptime: 4h 20m
 Service Name                     Status                      Type
 host_name                        OK                          System
 apigee-zookeeper                 OK                          Process
 apigee-cassandra                 OK                          Process
 apigee-openldap                  OK                          Process
 apigee-qpidd                     OK                          Process
 apigee-postgresql                OK                          Process
 edge-ui                          OK                          Process
 edge-qpid-server                 OK                          Remote Host
 edge-postgres-server             OK                          Remote Host
 edge-management-server           OK                          Remote Host
 edge-router                      OK                          Remote Host
 edge-message-processor           OK                          Remote Host

Si recibes un error Connection refused cuando ejecutas el comando summary por primera vez, espera la duración de la propiedad conf_monit_monit_delay_time y vuelve a intentarlo.

Supervisión de apigee-monit

Se recomienda verificar con regularidad que apigee-monit se ejecute en cada nodo.

Para verificar que apigee-monit se esté ejecutando, usa el siguiente comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

Apigee recomienda que emitas este comando de forma periódica en cada nodo que ejecute apigee-monit. Una forma de hacerlo es con una utilidad como cron, que ejecuta tareas programadas a intervalos predefinidos.

Para usar cron y supervisar apigee-monit, haz lo siguiente:

  1. Para agregar compatibilidad con cron, copia el directorio apigee-monit.cron en /etc/cron.d, como se muestra en el siguiente ejemplo:
    cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
  2. Abre el archivo apigee-monit.cron para editarlo.

    El archivo apigee-monit.cron define el trabajo cron que se ejecutará y la frecuencia con la que se ejecutará. En el siguiente ejemplo, se muestran los valores predeterminados:

    # Cron entry to check if monit process is running. If not start it
    */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

    Este archivo usa la siguiente sintaxis, en la que los primeros cinco campos definen el momento en que apigee-monit ejecuta su acción:

    min hour day_of_month month day_of_week task_to_execute

    Por ejemplo, el tiempo de ejecución predeterminado es */2 * * * *, que le indica a cron que verifique el proceso apigee-monit cada 2 minutos.

    No puedes ejecutar un trabajo cron con una frecuencia mayor que una vez por minuto.

    Para obtener más información sobre el uso de cron, consulta la documentación del SO del servidor o las páginas del manual.

  3. Cambia la configuración de cron para que coincida con las políticas de tu organización. Por ejemplo, para cambiar la frecuencia de ejecución a cada 5 minutos, establece la definición del trabajo de la siguiente manera:
    */5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
  4. Guarda el archivo apigee-monit.cron.
  5. Repite este procedimiento para cada nodo en tu clúster.

Si cron no comienza a mirar apigee-monit, verifica lo siguiente:

  • Hay una línea en blanco después de la definición del trabajo cron.
  • Solo hay un trabajo cron definido en el archivo. (las líneas comentadas no se tienen en cuenta).

Si deseas detener o inhabilitar apigee-monit de forma temporal, también debes inhabilitar este trabajo cron. De lo contrario, cron reiniciará apigee-monit.

Para inhabilitar cron, realiza una de las siguientes acciones:

  • Borra el archivo /etc/cron.d/apigee-monit.cron:
    sudo rm /etc/cron.d/apigee-monit.cron

    Deberás volver a copiarlo si, luego, quieres volver a habilitar cron para mirar apigee-monit.

    OR

  • Edita el archivo /etc/cron.d/apigee-monit.cron y marca como comentario la definición del trabajo. Para ello, agrega “#” al comienzo de la línea, por ejemplo:
    # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
    .