Edge for Private Cloud v. 4.17.05
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:
- Instala apigee-influxdb:
 > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- Configura la base de datos apigee-influxdb:
 > Configuración de /opt/apigee/apigee-service/bin/apigee-service de apigee-influxdb
- 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:
- En tu primer nodo de Edge, instala apigee-telegraf:
 > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
- 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
- Cambia el propietario a “apigee”:
 > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
- 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
- Reinicia apigee-telegraf:
 > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- 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:
- En tu primer nodo de Edge, instala apigee-grafana:
 > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
- 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
- Cambia el propietario a “apigee”:
 > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
- 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
- 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:
- Para garantizar apigee-telegraf
    es recopilar los datos
      - Ejecuta el servicio apigee-service Configuración de apigee-telegraf, es idempotente, verifica si hay errores y si faltan dependencias y resolverlos.
- Reinicia apigee-telegraf y marca /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log en busca de errores
 
- Para garantizar apigee-influxdb
    recibe datos:
      - Asegúrate de que los siguientes puertos TCP estén abiertos en los nodos de datos de apigee-influxdb: 8086 y 8,183.
- Utiliza la siguiente URL para abrir la IU de influxdb en un navegador: 
 http://influxdb_IP_or_DNS:8183- En el campo Consulta, ingresa “show databases”. 
 Asegúrate de que se hayan creado las siguientes bases de datos: sistema, aplicación, eventos, _internal.
- En el campo Consulta, ingresa “mostrar servidores”. 
 Asegúrese de que los nodos de apigee-influxdb estén en la lista.
 
- En el campo Consulta, ingresa “show databases”. 
 
- Verifica las fuentes de datos en el panel:
      - Selecciona Fuentes de datos en el menú principal. Deberías ver íconos de tres fuentes de datos mostradas.
- Para cada fuente de datos, selecciona el ícono.
- En la página de detalles de la fuente de datos, selecciona el botón Guardar y Probar .
- 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.01 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.01
Si instalaste la versión beta del panel de Apigee Monitoring en 4.16.09 o 4.17.01, sigue estos pasos: puedes actualizarla a la versión beta 4.17.05.
Para actualizar el panel de supervisión de Beta, haz lo siguiente:
- Actualiza Edge a la versión 4.17.05 como se describe en Actualización Apigee Edge 4.17.01 a 4.17.05, Actualizar Apigee Edge 4.16.09 a 4.17.05 y Actualizar Apigee Edge 4.16.01/4.16.05 a 4.17.05.
- 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.
- 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
- 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
- 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.05 Si desinstalas apigee-collectd y, además, instalas apigee-telegraf.
Para actualizar el panel de supervisión de Beta, haz lo siguiente:
- Actualiza Edge a la versión 4.17.05 como se describe en Actualización Apigee Edge 4.17.01 a 4.17.05, Actualizar Apigee Edge 4.16.09 a 4.17.05 y Actualizar Apigee Edge 4.16.01/4.16.05 a 4.17.05.
- 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.
- 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
- 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
- Repite el paso 4 para cada nodo.