Edge para la nube privada v. 4.17.01
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:
- 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 - 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. 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 reinicia - 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. 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 anteriormente:
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 mediante 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, haz lo siguiente:
- Ejecutar la configuración de apigee-service apigee-telegraf es idempotente, verificar si hay errores y dependencias faltantes, y resolverlos.
- Reinicia apigee-telegraf y marca /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log para detectar cualquier error.
- Para asegurarte de que apigee-influxdb reciba datos, haz lo siguiente:
- Asegúrate de que los siguientes puertos TCP estén abiertos en los nodos de datos de 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 “show servers”.
Asegúrate de que se muestren los nodos apigee-influxdb.
- En el campo Consulta, ingresa "mostrar bases 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
Si instalaste la versión Beta del panel de supervisión de Apigee en 4.16.09, puedes actualizarla a la versión beta para 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 Beta, haz lo siguiente:
- Actualiza Edge a la versión 4.17.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:
> /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 - 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 /opt/apigee/customer/application/sa_telegraf.gigabr>> - Repite el paso 3 para cada nodo.
- Actualiza apigee-grafana:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
/opt/apigee/grafanaservice/apigee-service/