Edge para nuvem privada v. 4.17.05
Requisitos do sistema
É necessário 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ó de borda em que você o está instalando.
É possível instalar o apigee-grafana em um nó separado ou reutilizar um dos nós de Borda atuais, como o Servidor de gerenciamento ou o nó de IU de borda.
O apigee-influxdb pode ser instalado em um nó de borda atual, como o nó do servidor de gerenciamento ou da interface do Edge, sem alterar os requisitos do sistema.
Se você decidir instalar o apigee-influxdb no próprio nó por motivos de desempenho, ele terá os seguintes requisitos:
- CPU de 2 núcleos
- 4 GB de RAM
- 250 GB de espaço em disco (dados de monitoramento limpos após um 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 apigee-influxdb para acesso pelo nó que executa apigee-grafana e 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 faça com que eles pertençam ao usuário "apigee".
Parâmetros de configuração para apigee-telegraf
Defina essas propriedades em um arquivo de texto que será transmitido para o comando apigee-telegraf setup. Por exemplo, defina-as em um arquivo de texto chamado sa_telegraf.txt:
Propriedade |
Descrição |
---|---|
INFLUXDB_URL |
Especifique o URL do nó apigee-influxdb, incluindo a porta 8086. Exemplo: http://192.168.0.1:8086 |
Parâmetros de configuração para apigee-grafana
Defina essas propriedades em um arquivo de texto que você vai transmitir para o comando apigee-grafana setup. Por exemplo, defina-as em um arquivo de texto chamado sa_grafana.txt:
Propriedade |
Descrição |
---|---|
INFLUXDB_HOST |
Especifique o endereço IP ou o nome DNS do nó do InfluxDB. Por exemplo: 192.168.0.1 |
INFLUXDB_PORT |
Porta da API InfluxDB usada pela fonte de dados Grafana. Especifique 8086. |
GRAFANA_USERNAME |
Nome de usuário do Grafana para fazer login na interface do painel. |
GRAFANA_PASSWORD |
Senha do Grafana para fazer login na interface do painel. |
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)
Instalar o apigee-influxdb em um único nó do Edge ou autônomo
Em um nó independente ou de borda que executa o servidor de gerenciamento ou a interface do usuário de borda:
- Instalar o apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install - Configure o banco de dados apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service configuração da apigee-influxdb - Inicie apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start (em inglês).
Instalar o apigee-telegraf em cada nó do Edge
Em cada nó da instalação do Edge:
- No primeiro nó do Edge, instale o apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install - Crie um arquivo de configuração para apigee-telegraf com o nome 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 deixa pertencente ao 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 - Mude o proprietário para "apigee":
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt - Configurar apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt - Reinicie o apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart - Repita o processo em todos os nós de borda.
Instalar o apigee-grafana em um único nó do Edge
Em um único nó da instalação do Edge, como o nó da IU do Edge:
- No primeiro nó do Edge, instale o apigee-grafana:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install - Crie um arquivo de configuração para apigee-grafana com o nome 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 deixa pertencer ao usuário "apigee".
Defina as propriedades a seguir no arquivo. Estas propriedades estão descritas acima:
INFLUXDB_HOST=192.168.56.101
INFLUXDB_PORT=8086
GRAFANA_USERNAME=admin
GRAFANA_PASSWORD=admin - Mude o proprietário para "apigee":
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt - Configure o 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 (em inglês) - Reinicie o 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 com as credenciais especificadas no arquivo de configuração do 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 da instalação:
- Para garantir que o apigee-telegraf
esteja coletando os dados:
- Execute a configuração do apigee-telegraf da Apigee, que está idempotente, verifique se há erros e as dependências ausentes e resolva-as.
- Reinicie o apigee-telegraf e verifique se há erros em /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log (em inglês)
- Para garantir que o apigee-influxdb
esteja recebendo dados:
- Verifique se as seguintes portas TCP estão abertas nos nós de dados apigee-influxdb: 8086 e 8183.
- Use o seguinte URL para abrir a interface do influxdb em um navegador:
http://influxdb_IP_or_DNS:8183- No campo Consulta, digite "mostrar bancos de dados".
Verifique se os seguintes bancos de dados foram criados: system, application, events, _internal. - No campo "Consulta", digite "mostrar servidores".
Verifique se os nós apigee-influxdb estão listados.
- No campo Consulta, digite "mostrar bancos de dados".
- Verifique as fontes de dados no painel:
- Selecione Fontes de dados no menu principal. Serão exibidos os ícones das três fontes de dados.
- Para cada fonte de dados, selecione o ícone.
- Na página de detalhes da fonte de dados, selecione o botão Salvar e testar.
- 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 de acordo com a versão do Edge que está sendo atualizada:
- 4.16.09 e 4.17.01 usam o mesmo procedimento
- Na versão 4.16.05, é necessário desinstalar o apigee-collectd como parte da atualização.
Atualização da versão 4.16.09 ou 4.17.01
Se você instalou a versão Beta do painel de monitoramento da Apigee em 4.16.09 ou 4.17.01, é possível atualizá-la para a versão Beta para 4.17.05.
Para atualizar o painel de monitoramento Beta:
- Atualize o Edge para 4.17.05 conforme descrito em Atualizar o Apigee Edge 4.17.01 a 4.17.05, Atualizar Apigee Edge 4.16.09 a 4.17.05 e Atualizar o Apigee Edge 4.16.01/4.16.05 para 4.17.05.
- 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 o apigee-influx.
Se você também instalou apigee-grafana no nó "Servidor de gerenciamento", esta etapa também vai atualizar o apigee-grafana. Caso contrário, atualize o apigee-granfana conforme mostrado na etapa a seguir. - 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 - Atualizar apigee-telegraf no nó 1:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf atualização
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -fgraf configFile
> apigee/apigee/apigee-servicebin/tele-service (apigee/apigee/apigee-servicebin/tele-serviço) - 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.17.05, você desinstala o apigee-collectd e instala o apigee-telegraf.
Para atualizar o painel de monitoramento Beta:
- Atualize o Edge para 4.17.05 conforme descrito em Atualizar o Apigee Edge 4.17.01 a 4.17.05, Atualizar Apigee Edge 4.16.09 a 4.17.05 e Atualizar o Apigee Edge 4.16.01/4.16.05 para 4.17.05.
- 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 o apigee-influx.
Se você também instalou apigee-grafana no nó "Servidor de gerenciamento", esta etapa também vai atualizar o apigee-grafana. Caso contrário, atualize o apigee-granfana conforme mostrado na etapa a seguir. - 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 - apigee-telegraf
configFile - Repita a etapa 4 para cada nó.