Edge per Private Cloud v4.18.01
Requisiti di sistema
Devi installare apigee-telegraf
su tutti i nodi perimetrali per raccogliere i dati della dashboard. Pertanto, i requisiti di sistema per apigee-telegraf
sono gli stessi di quelli per il nodo Edge su cui lo stai installando.
Puoi installare apigee-grafana
su un nodo separato o riutilizzare uno dei nodi periferici esistenti, ad esempio il server di gestione o il nodo
UI perimetrale.
Per apigee-influxdb
, puoi
installarlo su un nodo perimetrale esistente, ad esempio il nodo del server di gestione o dell'interfaccia utente perimetrale, senza
modificare i requisiti di sistema.
Se decidi di installare apigee-influxdb
sul proprio nodo per motivi di prestazioni, il nodo deve avere i seguenti requisiti:
- CPU a 2 core
- 4 GB di RAM
- 250 GB di spazio su disco (monitoraggio dei dati eliminati definitivamente dopo 1 mese)
- 1000 o più IOPS
Per ulteriori informazioni, consulta il documento InfluxData.
Requisiti di porta per apigee-influxdb
Le porte 8086 e 8183 devono essere aperte sui nodi di dati apigee-influxdb
affinché il nodo che esegue apigee-grafana
e apigee-telegraf
possa accedervi.
File di configurazione per l'installazione dei componenti della dashboard
Per installare i componenti apigee-telegraf
e apigee-grafana
, devi passare un file di configurazione all'utilità apigee-service
. Archivia questi file in una directory accessibile dall 'utente apigee', come /opt/apigee/customer/application
, e rendili di proprietà dell 'utente apigee'.
Parametri di configurazione per apigee-telegraf
Imposta queste proprietà in un file di testo che passi al comando apigee-telegraf setup
. Ad esempio, impostale in un file di testo denominato sa_telegraf.txt
:
Proprietà |
Descrizione |
---|---|
|
Specifica l'URL del nodo apigee-influxdb, inclusa la porta 8086. Ad esempio: http://192.168.0.1:8086 |
Parametri di configurazione per apigee-grafana
Imposta queste proprietà in un file di testo che passi al comando apigee-grafana setup
. Ad esempio, impostale in un file di testo denominato sa_grafana.txt
:
Proprietà |
Descrizione |
---|---|
|
Specifica l'indirizzo IP o il nome DNS del nodo InfluxDB. Ad esempio: 192.168.0.1 |
|
Porta dell'API InfluxDB utilizzata dall'origine dati Grafana. Specifica 8086. |
|
Nome utente Grafana per accedere all'interfaccia utente della dashboard. |
|
Password Grafana per accedere all'interfaccia utente della dashboard. |
Istruzioni sull'installazione
Segui le istruzioni riportate di seguito per installare i componenti della dashboard in questa sequenza:
apigee-influxdb
(su un nodo centrale)apigee-telegraf
(su ciascun nodo)apigee-grafana
(su un server centrale)
Installa apigee-influxdb su un singolo nodo Edge o un nodo autonomo
Su un nodo autonomo o su un nodo perimetrale che esegue il server di gestione o la UI perimetrale:
- Installa
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- Configura il database
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
- Inizio
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
Installa apigee-telegraf su ogni nodo Edge
Su ogni nodo dell'installazione Edge:
- Sul primo nodo Edge, installa
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
- Crea un file di configurazione per
apigee-telegraf
denominatosa_telegraf.txt
. In genere, questo file viene archiviato in una directory accessibile dall'utente 'apigee' , ad esempio/opt/apigee/customer/application
, e reso di proprietà dell'utente apigee'.Imposta la seguente proprietà nel file per specificare l'URL del nodo apigee-influxdb, inclusa la porta 8086:
INFLUXDB_URL=http://influx_IP:8086
- Cambia il proprietario in '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
- Riavvia
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- Ripeti questa procedura su tutti i nodi perimetrali.
Installa apigee-grafana su un singolo nodo Edge
Su un singolo nodo dell'installazione Edge, ad esempio il nodo UI Edge:
- Sul primo nodo Edge, installa
apigee-grafana
:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
- Crea un file di configurazione per
apigee-grafana
denominatosa_grafana.txt
. In genere, questo file viene archiviato in una directory accessibile dall 'utente apigee', come/opt/apigee/customer/application
, e lo si rende di proprietà dell 'utente apigee'.Imposta le seguenti proprietà nel file. Queste proprietà sono descritte sopra:
INFLUXDB_HOST=192.168.56.101 INFLUXDB_PORT=8086 GRAFANA_USERNAME=admin GRAFANA_PASSWORD=admin
- Cambia il proprietario in 'apigee':
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
- Configura
apigee-grafana
utilizzando il file di configurazione:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
- Riavvia
apigee-grafana
:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart
Per accedere alla dashboard, apri il seguente URL in un browser:
http://grafana_IP_or_DNS:3000
Accedi utilizzando le credenziali specificate nel file di configurazione per
apigee-grafana
. Nell'esempio sopra riportato, nome utente e password sono amministratore/amministratore.
Risoluzione dei problemi di installazione
Se nella dashboard non vengono visualizzati dati, utilizza la seguente procedura per risolvere i problemi di installazione:
- Per garantire che
apigee-telegraf
stia raccogliendo i dati- Esegui
apigee-service apigee-telegraf setup
, è idempotente, verifica la presenza di errori, eventuali dipendenze mancanti e risolvile. - Riavvia
apigee-telegraf
e controlla se in/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log
sono presenti errori
- Esegui
- Per assicurarti che
apigee-influxdb
riceva dati:- Assicurati che le seguenti porte TCP siano aperte sui nodi di dati
apigee-influxdb
: 8086 e 8183. - Usa il seguente URL per aprire l'interfaccia utente di influxdb in un browser:
http://influxdb_IP_or_DNS:8183
- Nel campo Query, inserisci "mostra database". Assicurati che siano stati creati i seguenti database:
system, application, events, _internal
. - Nel campo Query, inserisci "mostra server". Assicurati che siano elencati
i nodi
apigee-influxdb
.
- Nel campo Query, inserisci "mostra database". Assicurati che siano stati creati i seguenti database:
- Assicurati che le seguenti porte TCP siano aperte sui nodi di dati
- Controlla le origini dati nella dashboard:
- Seleziona Origini dati nel menu principale. Dovresti visualizzare le icone per tre origini dati.
- Seleziona l'icona per ogni origine dati.
- Nella pagina dei dettagli dell'origine dati, seleziona il pulsante Salva e testa.
- Se l'origine dati è configurata correttamente, dovresti visualizzare un messaggio nel seguente formato:
Operazione riuscita
L'origine dati funziona
Aggiornamento della dashboard di monitoraggio beta
Utilizza una delle due procedure seguenti in base alla versione Edge da cui stai eseguendo l'upgrade:
- 4.16.09 e 4.17.0x utilizzano la stessa procedura
- 4.16.05 richiede la disinstallazione di
apigee-collectd
come parte dell'aggiornamento.
Aggiorna dalla versione 4.16.09 o 4.17.0x
Se hai installato la versione beta della dashboard di monitoraggio di Apigee in 4.16.09 o 4.17.0x, puoi aggiornarla alla versione beta per 4.18.01.
Per aggiornare la dashboard di monitoraggio beta:
- Aggiorna Edge alla versione 4.18.01 come descritto in Aggiornare Apigee Edge 4.17.01/4.17.05 alla 4.17.09, Aggiornare Apigee Edge dalla 4.16.09 alla 4.17.09 e Aggiornare Apigee Edge 4.16.01/4.16.05 alla 9.17.
- Aggiorna
apigee-influxdb
sul nodo del server di gestione:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
dove configFile è il file di configurazione che hai utilizzato per installare
apigee-influx
.Se hai installato anche
apigee-grafana
sul nodo del server di gestione, questo passaggio aggiornerà ancheapigee-grafana
. In caso contrario, aggiornaapigee-granfana
come mostrato nel passaggio seguente. - Se non hai installato
apigee-grafana
sul nodo del server di gestione, aggiornaapigee-grafana
sul nodo in cui l'hai installato:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- Aggiorna
apigee-telegraf
sul 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
- Ripeti il passaggio 4 per ogni nodo.
Aggiornamento dalla versione 4.16.05
La versione 4.16.05 della dashboard utilizzava apigee-collectd
anziché
apigee-telegraf
. Nell'ambito dell'aggiornamento alla versione 4.18.01, disinstalli apigee-collectd
e installi apigee-telegraf
.
Per aggiornare la dashboard di monitoraggio beta:
- Aggiorna Edge alla versione 4.18.01 come descritto in Aggiornare Apigee Edge 4.16.01/4.16.05 alla versione 4.17.01 e aggiornare Apigee Edge dalla versione 4.16.09 alla versione 4.17.01.
- Aggiorna
apigee-influxdb
sul nodo del server di gestione:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
dove configFile è il file di configurazione che hai utilizzato per installare
apigee-influx
.Se hai installato anche
apigee-grafana
sul nodo del server di gestione, questo passaggio aggiornerà ancheapigee-grafana
. In caso contrario, aggiornaapigee-granfana
come mostrato nel passaggio seguente. - Se non hai installato
apigee-grafana
sul nodo del server di gestione, aggiornaapigee-grafana
sul nodo in cui l'hai installato:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- Installa
apigee-telegraf
sul 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
- Ripeti il passaggio 4 per ogni nodo.