Instalação do painel de monitoramento Beta

Edge para nuvem privada v. 4.17.01

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:

  1. Instalar o 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 configuração da apigee-influxdb
  3. 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:

  1. No primeiro nó do Edge, instale o apigee-telegraf:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
  2. Crie um arquivo de configuração para apigee-telegraf. 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
  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. Reinicie o apigee-telegraf:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  6. 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:

  1. No primeiro nó do Edge, instale o apigee-grafana:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
  2. Crie um arquivo de configuração para apigee-grafana. 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
  3. Mude o proprietário para "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
  4. 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)
  5. 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:

  1. Para garantir que o apigee-telegraf esteja coletando os dados:
    1. Execute a configuração do apigee-telegraf da Apigee, que está idempotente, verifique se há erros e as dependências ausentes e resolva-as.
    2. Reinicie o apigee-telegraf e verifique se há erros em /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log (em inglês)
  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 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 "mostrar bancos de dados".
        Verifique se os seguintes bancos de dados foram criados: system, application, events, _internal.
      2. No campo "Consulta", digite "mostrar servidores".
        Verifique se os nós apigee-influxdb estão listados.
  3. Verifique as fontes de dados no painel:
    1. Selecione Fontes de dados no menu principal. Serão exibidos os ícones das 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

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

Atualize os componentes do painel na seguinte ordem:

  • apigee-influxdb
  • apigee-telegraf em cada nó
  • apigee-grafana

Para atualizar o painel de monitoramento Beta:

  1. Atualize o Edge para 4.17.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. Atualizar apigee-influxdb:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb"
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb concluída"
  3. Atualizar > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf atualização
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -fgraf /opt/apigee/application/application/sa_apigee-apigee-mqopt/apigee/application/apigee-apigee- /apigee-telegraf


  4. Repita a etapa 3 para cada nó.
  5. Atualizar apigee-grafana:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana atualização
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
    > /opt/apigee-apigee-service/bin