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

Edge para nube privada v. 4.17.05

Requisitos del sistema

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

Puedes instalar apigee-grafana en un nodo independiente o volver a usar uno de los nodos perimetrales existentes, como el nodo de IU de Edge o Management Server.

Para apigee-influxdb, puedes instalarlo en un nodo perimetral existente, como el nodo de Management Server o el nodo de IU de Edge, sin cambios en los requisitos del sistema.

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

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

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

Requisitos de puerto para apigee-influxdb

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

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 de “apigee”, como /opt/apigee/customer/application, y haz que sean propiedad del usuario de “apigee”.

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, configúralas en un archivo de texto llamado sa_telegraf.txt:

Propiedad

Descripción

INFLUXDB_URL

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

Por ejemplo:

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ú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 de 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 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 perimetral o nodo independiente

En un nodo independiente o un nodo de Edge que ejecuta 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
  3. Inicia apigee-influxdb:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Instala apigee-telegraf en cada nodo perimetral

En cada nodo de la 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 de “apigee”, como /opt/apigee/customer/application, y haces que sea propiedad del usuario de “apigee”.

    Configura 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 reinicia
  6. Repite este proceso en todos los nodos perimetrales.

Instala 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, almacenas este archivo en un directorio al que puede acceder el usuario de “apigee”, como /opt/apigee/customer/application, y haces que sea propiedad del usuario de “apigee”.

    Configura las siguientes propiedades en el archivo. Estas propiedades se describieron anteriormente:
    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 mediante 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 que se muestra arriba, el nombre de usuario y la contraseña son admin/admin.

Soluciona problemas de instalación

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

  1. Para garantizar que apigee-telegraf recopile los datos, haz lo siguiente:
    1. Ejecutar la configuración de apigee-service apigee-telegraf es idempotente, verificar si hay errores y dependencias faltantes, y resolverlos.
    2. Reinicia apigee-telegraf y marca /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log para detectar cualquier error.
  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 "mostrar bases de datos".
        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 nodos apigee-influxdb.
  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 que se muestran.
    2. Selecciona el ícono para cada fuente de datos.
    3. En la página de detalles de la fuente de datos, selecciona el botón Save & Test.
    4. Si la fuente de datos se configuró correctamente, deberías ver un mensaje con el siguiente formato:
      Listo
      La fuente de datos está en funcionamiento

Actualiza el panel de supervisió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.01 usan el mismo procedimiento
  • 4.16.05 requiere que desinstales apigee-collectd como parte de la actualización.

Actualización desde las versiones 4.16.09 o 4.17.01

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

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

  1. Actualiza Edge a la versión 4.17.05 como se describe en Actualiza Apigee Edge 4.17.01 a 4.17.05, Actualiza Apigee Edge 4.16.09 a la versión 4.17.05 y Actualiza Apigee Edge 4.16.01/4.16.05 a la versión 4.17.05.
  2. Actualiza apigee-influxdb en el nodo de Management Server:
    > /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 actualizará 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-service/bin/grafservice
  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 usaba apigee-collectd en lugar de apigee-telegraf. Como parte de la actualización a la versión 4.17.05, desinstala apigee-collectd y, luego, instala apigee-telegraf.

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

  1. Actualiza Edge a la versión 4.17.05 como se describe en Actualiza Apigee Edge 4.17.01 a 4.17.05, Actualiza Apigee Edge 4.16.09 a la versión 4.17.05 y Actualiza Apigee Edge 4.16.01/4.16.05 a la versión 4.17.05.
  2. Actualiza apigee-influxdb en el nodo de Management Server:
    > /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 actualizará 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. Instalar apigee-telegraf en el nodo 1:
    apigee-telegraf

    configFile
  5. Repite el paso 4 para cada nodo.