Instalación del panel de Monitoring (beta)

Edge para nube privada v4.18.01

Requisitos del sistema

Debes instalar apigee-telegraf en todos los nodos de Edge para recopilar datos del panel. Por lo tanto, los requisitos del sistema para apigee-telegraf son los mismos que para el nodo de Edge en el que lo instalas.

Puedes instalar apigee-grafana en un nodo independiente o volver a usar uno de los nodos de Edge existentes, como el servidor de administración o el nodo de la IU de Edge.

En el caso de apigee-influxdb, puedes instalarlo en un nodo de Edge existente, como el nodo del servidor de administración o el nodo de la IU de Edge, sin cambiar los requisitos del sistema.

Si decides instalar apigee-influxdb en su propio nodo por motivos de rendimiento, el nodo debe cumplir con los siguientes requisitos:

• CPU de 2 núcleos
• 4 GB de RAM
• 250 GB de espacio en el disco (los datos de supervisión se borran después de 1 mes)
• 1,000 IOPS o más

Consulta el documento de InfluxData para obtener más información.

Requisitos de puertos para apigee-influxdb

Los puertos 8086 y 8183 deben estar abiertos en los nodos de datos de apigee-influxdb para que el nodo que ejecuta apigee-grafana y apigee-telegraf pueda acceder a ellos.

Archivos de configuración para instalar componentes del panel

Para instalar los componentes apigee-telegraf y apigee-grafana, pasa un archivo de configuración a la utilidad apigee-service. Almacena estos archivos en un directorio al que pueda acceder el usuario "apigee", como /opt/apigee/customer/application, y haz que pertenezcan al usuario "apigee".

Parámetros de configuración para apigee-telegraf

Establece estas propiedades en un archivo de texto que pases al comando apigee-telegraf setup. Por ejemplo, configúralos en un archivo de texto llamado sa_telegraf.txt:

http://192.168.0.1:8086

Parámetros de configuración para apigee-grafana

Establece estas propiedades en un archivo de texto que pases al comando apigee-grafana setup. Por ejemplo, configúralos en un archivo de texto llamado sa_grafana.txt:

192.168.0.1

Instrucciones de instalación

Sigue las instrucciones que se indican a continuación para instalar los componentes del panel en esta secuencia:

• apigee-influxdb (en un nodo central)
• apigee-telegraf (en cada nodo)
• apigee-grafana (en un servidor central)

Instala apigee-influxdb en un solo nodo de Edge o en un nodo independiente

En un nodo independiente o un nodo de Edge que ejecute el servidor de administración o la IU de Edge, haz lo siguiente:

1. Instala apigee-influxdb:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install

2. Configura la base de datos apigee-influxdb:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup

3. Inicia apigee-influxdb:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Instala apigee-telegraf en cada nodo de Edge

En cada nodo de tu instalación de Edge, haz lo siguiente:

1. En tu primer nodo de Edge, instala apigee-telegraf:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install

2. Crea un archivo de configuración para apigee-telegraf llamado sa_telegraf.txt. Por lo general, almacenas este archivo en un directorio al que puede acceder el usuario "apigee", como /opt/apigee/customer/application, y lo haces propiedad del usuario "apigee".

   Establece la siguiente propiedad en el archivo para especificar la URL del nodo apigee-influxdb, incluido el puerto 8086:

   INFLUXDB_URL=http://influx_IP:8086

3. Cambia el propietario a "apigee":

   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt

4. Configura apigee-telegraf:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f
       /opt/apigee/customer/application/sa_telegraf.txt

5. Reinicia apigee-telegraf:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart

6. Repite este proceso en todos los nodos de Edge.

Instala apigee-grafana en un solo nodo de Edge

En un solo nodo de tu instalación de Edge, como el nodo de la IU de Edge, haz lo siguiente:

1. En tu primer nodo de Edge, instala apigee-grafana:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install

2. Crea un archivo de configuración para apigee-grafana llamado sa_grafana.txt. Por lo general, almacenas este archivo en un directorio al que puede acceder el usuario "apigee", como /opt/apigee/customer/application, y lo haces propiedad del usuario "apigee".

   Establece las siguientes propiedades en el archivo. Estas propiedades se describen más arriba:

   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin

3. Cambia el propietario a "apigee":

   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt

4. Configura apigee-grafana con el archivo de configuración:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f
       /opt/apigee/customer/application/sa_grafana.txt

5. Reinicia apigee-grafana:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

Para acceder al panel, abre la siguiente URL en un navegador:

http://grafana_IP_or_DNS:3000

Accede con las credenciales que especificaste en el archivo de configuración para apigee-grafana. En el ejemplo anterior, el nombre de usuario y la contraseña son admin/admin.

Soluciona problemas de instalación

Si no ves que aparezcan datos en el panel, usa el siguiente procedimiento para solucionar problemas en la instalación:

1. Para asegurarte de que apigee-telegraf recopile los datos,
   1. Ejecuta apigee-service apigee-telegraf setup, es idempotente, verifica si hay errores o dependencias faltantes y resuélvelos.
   2. Reinicia apigee-telegraf y verifica /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log para detectar errores.
2. Para asegurarte de que apigee-influxdb reciba datos, haz lo siguiente:
   1. Asegúrate de que los siguientes puertos TCP estén abiertos en los nodos de datos de apigee-influxdb: 8086 y 8183.
   2. Usa la siguiente URL para abrir la IU de influxdb en un navegador:

      http://influxdb_IP_or_DNS:8183

      1. En el campo Consulta, ingresa "show databases". Asegúrate de que se hayan creado las siguientes bases de datos: system, application, events, _internal.
      2. En el campo Consulta, ingresa "show servers". Asegúrate de que se muestren los apigee-influxdb nodos.
3. Verifica las fuentes de datos del panel:
   1. Selecciona Fuentes de datos en el menú principal. Deberías ver los íconos de tres fuentes de datos.
   2. Para cada fuente de datos, selecciona el ícono.
   3. En la página de detalles de la fuente de datos, selecciona el botón Guardar y probar.
   4. Si la fuente de datos está configurada correctamente, deberías ver un mensaje con el siguiente formato:
      Success
      Data source is working

Actualiza el panel de supervisión de la versión beta

Usa uno de los dos procedimientos que se indican a continuación según la versión de Edge desde la que actualizas:

• 4.16.09 y 4.17.0x usan el mismo procedimiento
• La versión 4.16.05 requiere que desinstales apigee-collectd como parte de la actualización.

Actualiza desde la versión 4.16.09 o 4.17.0x

Si instalaste la versión beta del panel de supervisión de Apigee en 4.16.09 o 4.17.0x, puedes actualizarla a la versión beta para 4.18.01.

Para actualizar el panel de supervisión de la versión beta, haz lo siguiente:

1. Actualiza Edge a la versión 4.18.01 como se describe en Actualiza Apigee Edge de la versión 4.17.01/4.17.05 a la 4.17.09, Actualiza Apigee Edge de la versión 4.16.09 a la 4.17.09 y Actualiza Apigee Edge de la versión 4.16.01/4.16.05 a la 4.17.09.
2. Actualiza apigee-influxdb en el nodo del servidor de administración:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   donde configFile es el archivo de configuración que usaste para instalar apigee-influx.

   Si también instalaste apigee-grafana en el nodo del servidor de administración, este paso también actualiza apigee-grafana. De lo contrario, actualiza apigee-granfana como se muestra en el siguiente paso.

3. Si no instalaste apigee-grafana en el nodo del servidor de administración, actualiza apigee-grafana en el nodo en el que lo instalaste:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

4. Actualiza apigee-telegraf en el nodo 1:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart

5. Repite el paso 4 para cada nodo.

Actualiza desde la versión 4.16.05

La versión 4.16.05 del panel usó apigee-collectd en lugar de apigee-telegraf. Como parte de la actualización a la versión 4.18.01, desinstala apigee-collectd y, luego, instala apigee-telegraf.

Para actualizar el panel de supervisión de la versión beta, haz lo siguiente:

1. Actualiza Edge a la versión 4.18.01 como se describe en Actualiza Apigee Edge 4.16.01/4.16.05 a 4.17.01 y Actualiza Apigee Edge 4.16.09 a 4.17.01.
2. Actualiza apigee-influxdb en el nodo del servidor de administración:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   donde configFile es el archivo de configuración que usaste para instalar apigee-influx.

   Si también instalaste apigee-grafana en el nodo del servidor de administración, este paso también actualiza apigee-grafana. De lo contrario, actualiza apigee-granfana como se muestra en el siguiente paso.

3. Si no instalaste apigee-grafana en el nodo del servidor de administración, actualiza apigee-grafana en el nodo en el que lo instalaste:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

4. Instala apigee-telegraf en el nodo 1:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall

5. Repite el paso 4 para cada nodo.