Instalación del panel de la versión beta de Monitoring

Edge for Private Cloud v. 4.17.09

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

Para apigee-influxdb, puedes 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 para 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 el documento 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 puedan acceder que ejecuta apigee-grafana y apigee-telegraf

Archivos de configuración para instalar el panel componentes

Para instalar apigee-telegraf y apigee-grafana, debes pasar 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

Configura estas propiedades en un archivo de texto que pases al comando setup de apigee-telegraf. Por ejemplo, colócalos en una archivo de texto llamado sa_telegraf.txt:

Propiedad

Descripción

INFLUXDB_URL

Especifica la URL del nodo de apigee-influxdb, incluido el puerto 8086.

Por ejemplo:

http://192.168.0.1:8086

Parámetros de configuración para Apigee-grafana

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

Propiedad

Descripción

INFLUXDB_HOST

Especifica la dirección IP o el nombre de DNS del nodo de InfluxDB.

Por ejemplo:

192.168.0.1

INFLUXDB_PORT

Puerto de la API de InfluxDB que usa la fuente de datos Grafana. Especifica 8086.

GRAFANA_USERNAME

Nombre de usuario de Grafana para acceder a la IU del panel.

GRAFANA_PASSWORD

Contraseña de Grafana para acceder a la IU del panel.

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:
    > Configuración de /opt/apigee/apigee-service/bin/apigee-service de apigee-influxdb
  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. Crea un archivo de configuración para apigee-telegraf llamado sa_telegraf.txt. Por lo general, se almacena este archivo en un directorio al que se puede acceder mediante el servicio de usuario, como 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:
    > Configuración de /opt/apigee/apigee-service/bin/apigee-service: configuración de apigee-telegraf /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. Normalmente, almacena este archivo en un directorio al que pueda acceder el servicio usuario, como /opt/apigee/customer/application, y hacer que sea propiedad del servicio de seguridad 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. Configura apigee-grafana. con el archivo de configuración:
    > Configuración de /opt/apigee/apigee-service/bin/apigee-service: configuración de apigee-grafana /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 apigee-telegraf es recopilar los datos
    1. Ejecuta el servicio apigee-service Configuración de apigee-telegraf, es idempotente, verifica si hay errores y si faltan dependencias y resolverlos.
    2. Reinicia apigee-telegraf y marca /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log en busca de errores
  2. Para garantizar apigee-influxdb recibe datos:
    1. Asegúrate de que los siguientes puertos TCP estén abiertos en los nodos de datos de apigee-influxdb: 8086 y 8,183.
    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 se hayan creado las siguientes bases de datos: sistema, aplicación, eventos, _internal.
      2. En el campo Consulta, ingresa “mostrar servidores”.
        Asegúrese de que los nodos de apigee-influxdb estén en la lista.
  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, 4.17.01 y 4.17.05 usan el mismo procedimiento
  • 4.16.05 requiere que desinstales apigee-collectd como parte de la actualización.

Actualización desde versión 4.16.09, 4.17.01 o 4.17.05

Si instalaste la versión beta del panel de Apigee Monitoring en las versiones 4.16.09, 4.17.01 o 4.17.05, puedes actualizarla a la versión beta para la versión 4.17.09.

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

  1. Actualiza Edge a 4.17.09 como se describe en Actualiza Apigee Edge de 4.17.01/4.17.05 a 4.17.09. Actualizar Apigee Edge 4.16.09 a 4.17.09 y Actualiza Apigee Edge 4.16.01/4.16.05 a 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

    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 de administración Nodo del servidor, en este paso también se actualiza apigee-grafana. De lo contrario, actualiza apigee-granfana como se muestra en el paso siguiente.
  3. Si no instaló apigee-grafana en el Management Server, actualiza apigee-grafana en el nodo en el que lo instaló:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f archivo de configuración
  4. Actualiza apigee-telegraf en nodo 1:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
    > Configuración de /opt/apigee/apigee-service/bin/apigee-service: configuración de apigee-telegraf configFile
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  5. Repite el paso 4 para cada nodo.

Actualizar 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 4.17.09 Desinstala apigee-collectd y, además, instala apigee-telegraf.

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

  1. Actualiza Edge a 4.17.09 como se describe en Actualiza Apigee Edge de 4.17.01/4.17.05 a 4.17.09. Actualizar Apigee Edge 4.16.09 a 4.17.09 y Actualiza Apigee Edge 4.16.01/4.16.05 a 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

    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 de administración Nodo del servidor, en este paso también se actualiza apigee-grafana. De lo contrario, actualiza apigee-granfana como se muestra en el paso siguiente.
  3. Si no instaló apigee-grafana en el Management Server, actualiza apigee-grafana en el nodo en el que lo instaló:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f archivo de configuración
  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
    > Configuración de /opt/apigee/apigee-service/bin/apigee-service: configuración de apigee-telegraf configFile
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
    > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd desinstala
  5. Repite el paso 4 para cada nodo.