Edge para la nube privada v4.18.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 el nodo Edge en el que lo instalas.
Puedes instalar apigee-grafana
en otro nodo o volver a usar uno de los nodos perimetrales existentes, como el servidor de administración o el nodo de la IU de Edge.
Para apigee-influxdb
, puedes instalarlo en un nodo Edge existente, como el nodo del servidor de administración o el nodo de la 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 cumplir con 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
acceda a ellos.
Archivos de configuración para instalar componentes del panel
Para instalar los componentes apigee-telegraf
y apigee-grafana
, debes pasar 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 apigee-telegraf setup
. Por ejemplo, configúralas en un archivo de texto llamado sa_telegraf.txt
:
Propiedad |
Descripción |
---|---|
|
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
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 |
---|---|
|
Especifica la dirección IP o el nombre de DNS del nodo de InfluxDB. Por ejemplo: 192.168.0.1 |
|
Puerto de la API de InfluxDB que usa la fuente de datos de Grafana. Especifica 8086. |
|
Nombre de usuario de Grafana para acceder a la IU del panel. |
|
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:
- Instala
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- Configura la base de datos
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
- 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:
- 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
llamadosa_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 lo conviertes en 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
. - Cambia el propietario a “apigee”:
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
- Configura
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /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 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:
- 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
llamadosa_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 lo conviertes en propiedad del usuario de “apigee”.Configura las siguientes propiedades en el archivo. Estas propiedades se describieron antes:
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:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /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 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:
- Para garantizar que
apigee-telegraf
recopile los datos- Ejecuta
apigee-service apigee-telegraf setup
, que es idempotente, comprueba si hay errores y dependencias faltantes y los resuelve. - Reinicia
apigee-telegraf
y comprueba si hay errores en/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log
- Ejecuta
- Para asegurarte de que
apigee-influxdb
reciba datos, haz lo siguiente:- Asegúrate de que los siguientes puertos TCP estén abiertos en nodos de datos
apigee-influxdb
: 8086 y 8183. - Usa la siguiente URL para abrir la IU de Influxdb en un navegador:
http://influxdb_IP_or_DNS:8183
- 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
. - En el campo Consulta, ingresa "mostrar servidores". Asegúrate de que se muestren los nodos
apigee-influxdb
.
- En el campo Consulta, ingresa "mostrar bases de datos". Asegúrate de que se hayan creado las siguientes bases de datos:
- Asegúrate de que los siguientes puertos TCP estén abiertos en nodos de datos
- 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 que se muestran.
- Selecciona el ícono para cada fuente de datos.
- En la página de detalles de la fuente de datos, selecciona el botón Save & Test.
- 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:
- Las versiones 4.16.09 y 4.17.0x usan el mismo procedimiento
- 4.16.05 requiere que desinstales
apigee-collectd
como parte de la actualización.
Actualización desde la versión 4.16.09 o 4.17.0x
Si instalaste la versión Beta del panel de supervisión de Apigee en 4.16.09 o 4.17.0x, puedes actualizarla a la versión beta para 4.18.01.
Para actualizar el panel de supervisión Beta, haz lo siguiente:
- Actualiza Edge a la versión 4.18.01 como se describe en Actualiza Apigee Edge 4.17.01/4.17.05 a 4.17.09, Actualiza Apigee Edge 4.16.09 a 4.17.09 y Actualiza Apigee Edge 4.16.01/4.16.05 a 94.17.
- Actualiza
apigee-influxdb
en el nodo del servidor de administración:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
En el ejemplo anterior, 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, en este paso también se actualizaráapigee-grafana
. De lo contrario, actualizaapigee-granfana
como se muestra en el siguiente paso. - Si no instalaste
apigee-grafana
en el nodo del servidor de administración, actualizaapigee-grafana
en el nodo en el que lo instalaste:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 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/apigee-service/bin/apigee-service apigee-telegraf restart
- 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.18.01, desinstalas apigee-collectd
y, luego, instalas apigee-telegraf
.
Para actualizar el panel de supervisión Beta, haz lo siguiente:
- Actualiza Edge a la versión 4.18.01 como se describe en Actualiza Apigee Edge 4.16.01/4.16.05 a la versión 4.17.01 y Actualiza Apigee Edge 4.16.09 a la versión 4.17.01.
- Actualiza
apigee-influxdb
en el nodo del servidor de administración:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
En el ejemplo anterior, 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, en este paso también se actualizaráapigee-grafana
. De lo contrario, actualizaapigee-granfana
como se muestra en el siguiente paso. - Si no instalaste
apigee-grafana
en el nodo del servidor de administración, actualizaapigee-grafana
en el nodo en el que lo instalaste:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 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 > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall
. - Repite el paso 4 para cada nodo.