Edge per Private Cloud v. 4.17.09
Requisiti di sistema
Devi installare apigee-telegraf su tutti i nodi Edge per raccogliere i dati della dashboard. Pertanto, i requisiti di sistema per apigee-telegraf sono gli stessi del 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 il nodo della UI 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 di InfluxData.
Requisiti di porta per apigee-influxdb
Le porte 8086 e 8183 devono essere aperte sui nodi dati apigee-influxdb per l'accesso da parte del nodo in esecuzione apigee-grafana e apigee-telegraf.
File di configurazione per l'installazione dei componenti della dashboard
Per installare i componenti apigee-telegraf e apigee-grafana, è sufficiente passare un file di configurazione all'utilità apigee-service. Archivia questi file in una directory accessibile dall'utente gmail, ad esempio /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 da passare al comando apigee-telegraf setup. Ad esempio, impostali in un file di testo denominato sa_telegraf.txt:
Proprietà |
Descrizione |
---|---|
INFLUXDB_URL |
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 da passare al comando apigee-grafana setup. Ad esempio, impostali in un file di testo denominato sa_grafana.txt:
Proprietà |
Descrizione |
---|---|
INFLUXDB_HOST |
Specifica l'indirizzo IP o il nome DNS del nodo InfluxDB. Ad esempio: 192.168.0.1 |
INFLUXDB_PORT |
Porta dell'API InfluxDB utilizzata dall'origine dati Grafana. Specifica 8086. |
GRAFANA_USERNAME |
Nome utente Grafana per accedere all'interfaccia utente della dashboard. |
GRAFANA_PASSWORD |
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 - Inizia 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 denominato sa_telegraf.txt.
In genere, questo file viene archiviato in una directory accessibile dall'utente apigee', ad esempio /opt/apigee/customer/application, e lo si rende 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 concern - 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 denominato sa_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-grafanajournal
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 la configurazione di apigee-service apigee-telegraf è idempotente, verifica l'eventuale presenza di errori, le dipendenze mancanti e risolvili.
- Riavvia apigee-telegraf e verifica la presenza di eventuali errori su /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log.
- Per assicurarti che apigee-influxdb riceva i dati:
- Assicurati che le seguenti porte TCP siano aperte su nodi 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 di aver creato 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".
- 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, 4.17.01 e 4.17.05 utilizzano la stessa procedura
- 4.16.05 richiede la disinstallazione di apigee-collectd come parte dell'aggiornamento.
Esegui l'aggiornamento dalla versione 4.16.09, 4.17.01 o 4.17.05
Se hai installato la versione beta della dashboard di monitoraggio di Apigee in 4.16.09, 4.17.01 o 4.17.05, puoi aggiornarla alla versione beta per 4.17.09.
Per aggiornare la dashboard di monitoraggio beta:
- Aggiorna Edge alla versione 4.17.09 come descritto in Aggiornamento di Apigee Edge 4.17.01/4.17.05 alla 4.17.09, Aggiornamento di Apigee Edge dalla versione 4.16.09 alla versione 4.17.09 e Aggiornamento di Apigee Edge 4.16.01/4.16.05 alla versione 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 anche installato apigee-grafana sul nodo del server di gestione, questo passaggio aggiorna anche apigee-grafana. In caso contrario, aggiorna apigee-granfana come mostrato nel passaggio seguente. - Se non hai installato apigee-grafana sul nodo del server di gestione, aggiorna apigee-grafana sul nodo in cui l'hai installato:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile - Aggiornamento apigee-telegraf su
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/bintele/apigee-service apigee- - Ripeti il passaggio 4 per ogni nodo.
Aggiorna 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.17.09, disinstalli apigee-collectd e installa apigee-telegraf.
Per aggiornare la dashboard di monitoraggio beta:
- Aggiorna Edge alla versione 4.17.09 come descritto in Aggiornamento di Apigee Edge 4.17.01/4.17.05 alla 4.17.09, Aggiornamento di Apigee Edge dalla versione 4.16.09 alla versione 4.17.09 e Aggiornamento di Apigee Edge 4.16.01/4.16.05 alla versione 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 anche installato apigee-grafana sul nodo del server di gestione, questo passaggio aggiorna anche apigee-grafana. In caso contrario, aggiorna apigee-granfana come mostrato nel passaggio seguente. - Se non hai installato apigee-grafana sul nodo del server di gestione, aggiorna apigee-grafana sul nodo in cui l'hai installato:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile - Installa apigee-telegraf su 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-opttelegraf configurazione -fapigee-service apigee-apigeed stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
> /opt/apigee/apigee-service/bin/apigee-service apigee-opttelegraf setup -fapigee-service/apigee-apigeeconfigFile - Ripeti il passaggio 4 per ogni nodo.