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

Edge for Private Cloud v. 4.17.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 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. Por lo general, los almacenas crear un directorio al que pueda acceder el servicio de 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:
    > 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. Por lo general, los almacenas en un directorio al que pueda acceder el servicio de Apigee 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

Si instalaste la versión beta del panel de Apigee Monitoring en la versión 4.16.09, puedes actualízala a la versión beta 4.17.01.

Debes actualizar los componentes del panel en el siguiente orden:

  • apigee-influxdb
  • apigee-telegraf en cada nodo
  • apigee-grafana

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

  1. Actualiza Edge a 4.17.01 como se describe en Actualiza Apigee Edge de 4.16.01/4.16.05 a 4.17.01. y Actualiza Apigee Edge de 4.16.09 a 4.17.01.
  2. Actualiza apigee-influxdb:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb restart
  3. 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 /opt/apigee/customer/application/sa_telegraf.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  4. Repite el paso 3 para cada nodo.
  5. Actualiza apigee-grafana:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
    > Configuración de /opt/apigee/apigee-service/bin/apigee-service: configuración de apigee-grafana /opt/apigee/customer/application/sa_grafana.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart