Instalação do painel de monitoramento (Beta)

Edge para nuvem privada v4.18.01

Requisitos do sistema

É preciso instalar o apigee-telegraf em todos os nós do Edge para coletar dados do painel. Portanto, os requisitos do sistema para apigee-telegraf são os mesmos do nó do Edge em que você o está instalando.

É possível instalar o apigee-grafana em um nó separado ou reutilizar um dos nós do Edge, como o servidor de gerenciamento ou o nó da interface do Edge.

Para o apigee-influxdb, é possível instalá-lo em um nó do Edge, como o nó do servidor de gerenciamento ou o nó da IU do Edge, sem alterar os requisitos do sistema.

Se você decidir instalar o apigee-influxdb no próprio nó por motivos de desempenho, o nó precisará atender aos seguintes requisitos:

• CPU de 2 núcleos
• 4 GB de RAM
• 250 GB de espaço em disco (dados de monitoramento excluídos após 1 mês)
• 1.000 ou mais IOPS

Consulte o documento do InfluxData para mais informações.

Requisitos de porta para apigee-influxdb

As portas 8086 e 8183 precisam estar abertas nos nós de dados do apigee-influxdb para acesso pelo nó que executa o apigee-grafana e o apigee-telegraf.

Arquivos de configuração para instalar componentes do painel

Para instalar os componentes apigee-telegraf e apigee-grafana, transmita um arquivo de configuração para o utilitário apigee-service. Armazene esses arquivos em um diretório acessível pelo usuário "apigee", como /opt/apigee/customer/application, e torne-os de propriedade do usuário "apigee".

Parâmetros de configuração para apigee-telegraf

Defina essas propriedades em um arquivo de texto que você transmite para o comando apigee-telegraf setup. Por exemplo, defina-as em um arquivo de texto chamado sa_telegraf.txt:

http://192.168.0.1:8086

Parâmetros de configuração para apigee-grafana

Defina essas propriedades em um arquivo de texto que você transmite para o comando apigee-grafana setup. Por exemplo, defina-as em um arquivo de texto chamado sa_grafana.txt:

192.168.0.1

Instruções para instalação

Siga as instruções abaixo para instalar os componentes do painel nesta sequência:

• apigee-influxdb (em um nó central)
• apigee-telegraf (em cada nó)
• apigee-grafana (em um servidor central)

Instale o apigee-influxdb em um único nó do Edge ou em um nó independente.

Em um nó independente ou em um nó do Edge que executa o servidor de gerenciamento ou a IU do Edge:

1. Instale apigee-influxdb:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install

2. Configure o banco de dados apigee-influxdb:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup

3. Inicialize apigee-influxdb:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Instalar o apigee-telegraf em todos os nós do Edge

Em cada nó da instalação do Edge:

1. No primeiro nó do Edge, instale apigee-telegraf:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install

2. Crie um arquivo de configuração para apigee-telegraf chamado sa_telegraf.txt. Normalmente, você armazena esse arquivo em um diretório acessível pelo usuário "apigee", como /opt/apigee/customer/application, e o torna propriedade do usuário "apigee".

   Defina a seguinte propriedade no arquivo para especificar o URL do nó apigee-influxdb, incluindo a porta 8086:

   INFLUXDB_URL=http://influx_IP:8086

3. Mude o proprietário para "apigee":

   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt

4. Configurar apigee-telegraf:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f
       /opt/apigee/customer/application/sa_telegraf.txt

5. Restart apigee-telegraf:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart

6. Repita esse processo em todos os nós do Edge.

Instalar o apigee-grafana em um único nó do Edge

Em um único nó da instalação do Edge, como o nó da interface do Edge:

1. No primeiro nó do Edge, instale apigee-grafana:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install

2. Crie um arquivo de configuração para apigee-grafana chamado sa_grafana.txt. Normalmente, você armazena esse arquivo em um diretório acessível pelo usuário "apigee", como /opt/apigee/customer/application, e o torna propriedade do usuário "apigee".

   Defina as seguintes propriedades no arquivo. Essas propriedades são descritas acima:

   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin

3. Mude o proprietário para "apigee":

   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt

4. Configure apigee-grafana usando o arquivo de configuração:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f
       /opt/apigee/customer/application/sa_grafana.txt

5. Restart apigee-grafana:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

Para acessar o painel, abra o seguinte URL em um navegador:

http://grafana_IP_or_DNS:3000

Faça login usando as credenciais especificadas no arquivo de configuração para apigee-grafana. No exemplo mostrado acima, o nome de usuário/senha é admin/admin.

Solução de problemas de instalação

Se os dados não aparecerem no painel, use o procedimento a seguir para resolver problemas na instalação:

1. Para garantir que o apigee-telegraf esteja coletando os dados
   1. Execute o apigee-service apigee-telegraf setup, que é idempotente, verifique se há erros e dependências ausentes e resolva-os.
   2. Reinicie o apigee-telegraf e verifique se há erros em /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log.
2. Para garantir que o apigee-influxdb esteja recebendo dados:
   1. Verifique se as seguintes portas TCP estão abertas nos nós de dados do apigee-influxdb: 8086 e 8183.
   2. Use o seguinte URL para abrir a interface do influxdb em um navegador:

      http://influxdb_IP_or_DNS:8183

      1. No campo "Consulta", digite "show databases". Verifique se os seguintes bancos de dados foram criados: system, application, events, _internal.
      2. No campo "Consulta", digite "show servers". Verifique se os nós apigee-influxdb estão listados.
3. Verifique as fontes de dados do painel:
   1. Selecione Fontes de dados no menu principal. Você verá ícones de três fontes de dados.
   2. Para cada fonte de dados, selecione o ícone.
   3. Na página de detalhes da fonte de dados, selecione o botão Salvar e testar.
   4. Se a fonte de dados estiver configurada corretamente, você verá uma mensagem no formato:
      Sucesso
      A fonte de dados está funcionando

Como atualizar o painel de monitoramento Beta

Use um dos dois procedimentos abaixo com base na versão do Edge que você está atualizando:

• As versões 4.16.09 e 4.17.0x usam o mesmo procedimento
• A versão 4.16.05 exige que você desinstale o apigee-collectd como parte da atualização.

Atualizar da versão 4.16.09 ou 4.17.0x

Se você instalou a versão Beta do painel de monitoramento da Apigee na versão 4.16.09 ou 4.17.0x, é possível atualizá-la para a versão Beta da versão 4.18.01.

Para atualizar o painel de monitoramento Beta:

1. Atualize o Edge para a versão 4.18.01, conforme descrito em Atualizar o Apigee Edge 4.17.01/4.17.05 para 4.17.09, Atualizar o Apigee Edge 4.16.09 para 4.17.09 e Atualizar o Apigee Edge 4.16.01/4.16.05 para 4.17.09.
2. Atualize apigee-influxdb no nó do servidor de gerenciamento:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   em que configFile é o arquivo de configuração usado para instalar apigee-influx.

   Se você também instalou o apigee-grafana no nó do servidor de gerenciamento, essa etapa também atualiza o apigee-grafana. Caso contrário, atualize apigee-granfana conforme mostrado na etapa a seguir.

3. Se você não instalou o apigee-grafana no nó do servidor de gerenciamento, atualize o apigee-grafana no nó em que ele foi instalado:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

4. Atualize apigee-telegraf no nó 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. Repita a etapa 4 para cada nó.

Atualização da versão 4.16.05

A versão 4.16.05 do painel usava apigee-collectd em vez de apigee-telegraf. Como parte da atualização para a versão 4.18.01, desinstale apigee-collectd e instale apigee-telegraf.

Para atualizar o painel de monitoramento Beta:

1. Atualize o Edge para a versão 4.18.01, conforme descrito em Atualizar o Apigee Edge 4.16.01/4.16.05 para 4.17.01 e Atualizar o Apigee Edge 4.16.09 para 4.17.01.
2. Atualize apigee-influxdb no nó do servidor de gerenciamento:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   em que configFile é o arquivo de configuração usado para instalar apigee-influx.

   Se você também instalou o apigee-grafana no nó do servidor de gerenciamento, essa etapa também atualiza o apigee-grafana. Caso contrário, atualize apigee-granfana conforme mostrado na etapa a seguir.

3. Se você não instalou o apigee-grafana no nó do servidor de gerenciamento, atualize o apigee-grafana no nó em que ele foi instalado:

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

4. Instale apigee-telegraf no nó 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. Repita a etapa 4 para cada nó.