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.