Instalación del panel de Monitoring (beta)

Edge for Private Cloud 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 al igual que en Edge el nodo en el que lo instalarás.

Puedes instalar apigee-grafana en otro nodo o reutilizar uno de los nodos perimetrales existentes, como el servidor de administración o el entorno en el nodo de la IU.

Por apigee-influxdb, puedes hacer lo siguiente: en un nodo de Edge existente, como el nodo del servidor de administración o el nodo de la IU de Edge, en los requisitos del sistema.

Si decides instalar apigee-influxdb en su propio nodo por por motivos de rendimiento, el nodo debería tener los siguientes requisitos:

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

Consulta la 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 apigee-influxdb para que el nodo con apigee-grafana y apigee-telegraf

Archivos de configuración para instalar el panel componentes

Cómo instalar apigee-telegraf y apigee-grafana, pasas un archivo de configuración a la utilidad apigee-service. Almacenar estos archivos en un directorio al que pueda acceder el servicio de usuario, como /opt/apigee/customer/application, y hacer que sean propiedad del servicio de seguridad usuario.

Parámetros de configuración para Apigee-telegraf

Establece estas propiedades en un archivo de texto que pases a apigee-telegraf setup. kubectl. Por ejemplo, configúralas 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 a apigee-grafana setup. kubectl. Por ejemplo, configúralas 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 nodo de Edge único o independiente

En un nodo independiente o en un nodo perimetral que ejecute el servidor de administración o la IU perimetral:

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

Instalar Apigee-telegraf en cada nodo perimetral

En cada nodo de la instalación de Edge:

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

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

2. Crear un archivo de configuración para apigee-telegraf llamado sa_telegraf.txt Por lo general, debes almacenar el archivo en un directorio al que pueda acceder “Apigee” usuario, como /opt/apigee/customer/application, y hacer que sea propiedad del servicio de seguridad usuario.

   Configura la siguiente propiedad en el archivo para especificar la URL del nodo de 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.

Instalar Apigee-grafana en un solo nodo de Edge

En un solo nodo de la 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, se almacena este archivo en un directorio al que se puede acceder mediante el servicio de usuario, como /opt/apigee/customer/application y hacer que sea propiedad del servicio de Apigee usuario.

   Configura 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. Configurar 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 de apigee-grafana En el ejemplo anterior nombre de usuario y contraseña es admin/admin.

Soluciona problemas de instalación

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

1. Para garantizar que apigee-telegraf es recopilar los datos
   1. Ejecuta el apigee-service apigee-telegraf setup; es idempotente, comprueba errores y dependencias faltantes, y resolverlos.
   2. Reinicia apigee-telegraf y verifica /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log para errores
2. Para garantizar 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 apigee-influxdb: 8086 y 8183.
   2. Utiliza 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 las siguientes bases de datos se crearon: system, application, events, _internal.
      2. En el campo Consulta, ingresa “mostrar servidores”. Asegúrate de ver el Se muestra apigee-influxdb nodo.
3. Verifica las fuentes de datos en el panel:
   1. Selecciona Fuentes de datos en el menú principal. Deberías ver íconos de tres fuentes de datos mostradas.
   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 se configuró correctamente, deberías ver un mensaje con este formato:
      Listo
      La fuente de datos funciona

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 estás realizando la actualización:

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

Actualizar desde la versión 4.16.09 o 4.17.0x

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

Para actualizar el panel de supervisión de Beta, haz lo siguiente:

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

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

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

   Si también instalaste apigee-grafana en el panel Nodo del servidor, en este paso también se 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 instaló:

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

4. Actualizar apigee-telegraf en 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.

Actualización 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, desinstalas apigee-collectd e instala apigee-telegraf.

Para actualizar el panel de supervisión de 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. Actualizar apigee-influxdb en el nodo del servidor de administración:

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

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

   Si también instalaste apigee-grafana en el panel Nodo del servidor, en este paso también se 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 instaló:

   > /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.