Installazione della dashboard di monitoraggio beta

Edge per Private Cloud v. 4.17.09

Requisiti di sistema

Devi installare apigee-telegraf su tutti i nodi Edge per per raccogliere i dati della dashboard. Pertanto, i requisiti di sistema per apigee-telegraf sono gli stessi di Edge su cui lo stai installando.

Puoi installare apigee-grafana su un nodo separato oppure riutilizza uno dei nodi periferici esistenti, come Server di gestione o Edge di un nodo UI.

Per apigee-influxdb, puoi installarlo su un nodo perimetrale esistente, ad esempio il nodo del server di gestione o il nodo della UI perimetrale, con nessuna modifica ai requisiti di sistema.

Se decidi di installare apigee-influxdb sul proprio nodo per per motivi legati alle prestazioni, il nodo dovrebbe avere i seguenti requisiti:

• CPU 2 core
• 4 GB di RAM
• 250 GB di spazio su disco (dati di monitoraggio eliminati definitivamente dopo 1 mese)
• 1000 o più IOPS

Consulta documento InfluxData per ulteriori informazioni.

Requisiti per le porte per apigee-influxdb

Le porte 8086 e 8183 devono essere aperte sui nodi di dati igee-influxdb per l'accesso da parte nodo che esegue apigee-grafana apigee-telegraf

File di configurazione per l'installazione della dashboard componenti

Per installare apigee-telegraf e apigee-grafana, passi un file di configurazione all'utilità apigee-service. Archivia questi file in una directory accessibile dall'app 'apigee' ad esempio /opt/apigee/customer/application, e ne diventi di proprietà utente.

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 una file di testo denominato sa_telegraf.txt:

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:

192.168.0.1

Istruzioni sull'installazione

Segui le istruzioni riportate di seguito per installare i componenti della dashboard in questa sequenza:

• apigee-influxdb (su una nodo centrale)
• apigee-telegraf (su ogni )
• apigee-grafana (su una server centrale)

Installa Apigee-influxdb su un singolo nodo Edge o autonomo

Su un nodo autonomo o perimetrale che esegue il server di gestione o la UI Edge:

1. Installa apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
2. Configura il database apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb
3. Avvia apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service Inizio apigee-influxdb

Installa apigee-telegraf su ogni nodo perimetrale

Su ogni nodo della tua installazione Edge:

1. Sul tuo primo nodo Edge, installa apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. Crea un file di configurazione per apigee-telegraf denominato sa_telegraf.txt. In genere, lo archivi in una directory accessibile dall'app 'apigee' ad esempio /opt/apigee/customer/application, e ne diventi di proprietà utente.
   
   Imposta la seguente proprietà nel file per specificare l'URL del nodo apigee-influxdb, inclusa la porta 8086:
   INFLUXDB_URL=http://influx_IP:8086
3. Cambia il proprietario in 'apigee':
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. Configura apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
5. Riavvia apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf reboot
6. Ripeti questo processo su tutti i nodi Edge.

Installa apigee-grafana su in un singolo nodo perimetrale

Su un singolo nodo dell'installazione di Edge, ad esempio il nodo dell'UI Edge:

1. Sul tuo primo nodo Edge, installa apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. Crea un file di configurazione per apigee-grafana denominato sa_grafana.txt. Generalmente, questo file viene archiviato in una directory accessibile dall'app 'apigee' ad esempio /opt/apigee/customer/application, e ne diventi di proprietà utente.
   
   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
3. Cambia il proprietario in 'apigee':
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. 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
5. Riavvia apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana reboot

Per accedere alla dashboard, apri il seguente URL in un browser:

http://grafana_IP_or_DNS:3000

Accedi utilizzando le credenziali che hai specificato nel file di configurazione per apigee-grafana. Nell'esempio mostrato sopra il nome utente e la password sono ammin./admin.

Risoluzione dei problemi di installazione

Se i dati non vengono visualizzati nella dashboard, attieniti alla procedura seguente per risolvere il problema. la tua installazione:

1. Per garantire che apigee-telegraf raccoglie i dati
   .
   1. Esegui apigee-service apigee-telegraf setup è idempotente, controlla se ci sono errori, dipendenze mancanti e risolverli.
   2. Riavvia apigee-telegraf e controlla /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log per rilevare eventuali errori
2. Per garantire apigee-influxdb riceve dati:
   .
   1. Assicurati che le seguenti porte TCP siano aperte sui nodi di dati apigee-influxdb: 8086 e 8183.
   2. Utilizza il seguente URL per aprire l'interfaccia utente di influxdb in un browser:
      http://influxdb_IP_or_DNS:8183
      1. Nel campo Query, inserisci "mostra database".
         Assicurati di aver creato i seguenti database: system, application, events, _internal.
      2. Nel campo Query, inserisci "mostra server".
         Assicurati che i nodi apigee-influxdb siano in elenco.
3. Verifica le origini dati nella dashboard:
   1. Seleziona Origini dati nel menu principale. Dovresti vedere le icone di tre le origini dati visualizzate.
   2. Seleziona l'icona per ogni origine dati.
   3. Nella pagina dei dettagli dell'origine dati, seleziona il pulsante Salva e Prova .
   4. 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 a seconda della versione di Edge da cui esegui 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.

Aggiorna da versione 4.16.09, 4.17.01 o 4.17.05

Se hai installato la versione beta della dashboard di monitoraggio di Apigee nelle versioni 4.16.09, 4.17.01 o 4.17.05 lo puoi aggiornare alla versione Beta per 4.17.09.

Per aggiornare la dashboard di monitoraggio beta:

1. Aggiorna Edge alla versione 4.17.09 come descritto in Aggiornare Apigee Edge 4.17.01/4.17.05 a 4.17.09, aggiorna Apigee Edge 4.16.09 a 17.09.09 e aggiorna Apigee Edge Da 4.16.01/4.16.05 a 4.17.09.
2. Aggiorna apigee-influxdb su il 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 server di gestione questo passaggio aggiorna anche apigee-grafana. Altrimenti, aggiorna apigee-granfana come mostrato in successivo.
3. Se non hai installato apigee-grafana sul nodo del server di gestione, aggiorna apigee-grafana sul nodo in cui installato:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Aggiorna 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/bin/apigee-service apigee-telegraf reboot
5. Ripeti il passaggio 4 per ogni nodo.

Aggiorna dalla versione 4.16.05

La versione 4.16.05 della dashboard utilizzava apigee-collectd al posto di apigee-telegraf. Nell'ambito dell'aggiornamento a 4.17.09 disinstalli apigee-collectd e apigee-telegraf.

Per aggiornare la dashboard di monitoraggio beta:

1. Aggiorna Edge alla versione 4.17.09 come descritto in Aggiornare Apigee Edge 4.17.01/4.17.05 a 4.17.09, aggiorna Apigee Edge 4.16.09 a 17.09.09 e aggiorna Apigee Edge Da 4.16.01/4.16.05 a 4.17.09.
2. Aggiorna apigee-influxdb su il 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 server di gestione questo passaggio aggiorna anche apigee-grafana. Altrimenti, aggiorna apigee-granfana come mostrato in successivo.
3. Se non hai installato apigee-grafana sul nodo del server di gestione, aggiorna apigee-grafana sul nodo in cui installato:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. 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-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf reboot
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd remove
5. Ripeti il passaggio 4 per ogni nodo.