Edge per Private Cloud v. 4.17.01
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. 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 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. 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
Se hai installato la versione beta della dashboard di monitoraggio di Apigee in 4.16.09, puoi aggiornarla alla versione beta per 4.17.01.
Devi aggiornare i componenti della dashboard nel seguente ordine:
- apigee-influxdb
- apigee-telegraf su ciascun nodo
- apigee-grafana
Per aggiornare la dashboard di monitoraggio beta:
- Aggiorna Edge alla versione 4.17.01 come descritto in Aggiornare la versione di 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.
- Aggiornamento apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb aggiornamento
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxapigee - 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 /opt/apigee/customer/application/sa_telegraf.txt
> /opt/apigee-apigee/apigee/apigee/apigee/apigee - Ripeti il passaggio 3 per ogni nodo.
- Aggiornamento apigee-grafana:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana aggiornamento
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
> /opt/apigee/apigee-service/bin/apigee