Installazione della dashboard di monitoraggio (beta)

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:

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 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:

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 setup

3. 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:

1. Sul 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, 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

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 restart

6. 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:

1. Sul 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. 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

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 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:

1. Per garantire che apigee-telegraf stia raccogliendo i dati
   1. Esegui apigee-service apigee-telegraf setup, è idempotente, verifica la presenza di errori, eventuali dipendenze mancanti e risolvile.
   2. Riavvia apigee-telegraf e controlla se in /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log sono presenti errori
2. Per assicurarti che apigee-influxdb riceva dati:
   1. Assicurati che le seguenti porte TCP siano aperte sui nodi di dati apigee-influxdb: 8086 e 8183.
   2. Usa 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 che siano stati creati i seguenti database: system, application, events, _internal.
      2. Nel campo Query, inserisci "mostra server". Assicurati che siano elencati i nodi apigee-influxdb.
3. Controlla le origini dati nella dashboard:
   1. Seleziona Origini dati nel menu principale. Dovresti visualizzare le icone per tre origini dati.
   2. Seleziona l'icona per ogni origine dati.
   3. Nella pagina dei dettagli dell'origine dati, seleziona il pulsante Salva e testa.
   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 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:

1. 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.
2. 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à anche apigee-grafana. In caso contrario, aggiorna apigee-granfana come mostrato nel passaggio seguente.

3. 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

4. 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

5. 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:

1. 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.
2. 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à anche apigee-grafana. In caso contrario, aggiorna apigee-granfana come mostrato nel passaggio seguente.

3. 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

4. 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

5. Ripeti il passaggio 4 per ogni nodo.