Instalação do painel de monitoramento Beta

Edge for Private Cloud v. 4.17.09

Requisitos do sistema

Instale o apigee-telegraf em todos os nós do Edge para coletar dados do painel. Portanto, os requisitos do sistema para o apigee-telegraf são os mesmos do Edge. no qual ele está sendo instalado.

Você pode instalar o apigee-grafana em um nó separado ou reutilize um dos nós de borda atuais, como o servidor de gerenciamento ou de borda Nó da interface.

Em apigee-influxdb, você pode instalá-lo em um nó de borda atual, como o nó do servidor de gerenciamento ou o nó da interface de usuário de borda, com nenhuma mudança nos requisitos do sistema.

Se você decidir instalar o apigee-influxdb no próprio nó para por motivos de desempenho, o nó precisa ter os seguintes requisitos:

  • CPU de 2 núcleos
  • 4 GB de RAM
  • 250 GB de espaço em disco (os dados de monitoramento são limpos após um mês)
  • 1.000 ou mais IOPS

Consulte a Documento do InfluxData (em inglês) 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 serem acessadas pelo nó que executa o apigee-grafana e apigee-telegraf (em inglês).

Arquivos de configuração para instalar o painel componentes

Para instalar o apigee-telegraf e apigee-grafana, você transmite um arquivo de configuração para o utilitário apigee-service. Armazenar esses arquivos em em um diretório acessível pelo usuário, como /opt/apigee/customer/application, e torná-los propriedade da Apigee usuário.

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

Defina essas propriedades em um arquivo de texto que você transmite para o comando setup da apigee-telegraf. 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 transmitido 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 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 uma nó central)
  • apigee-telegraf (em cada nó)
  • apigee-grafana (em uma central)
.

Instalar apigee-influxdb em um único nó do Edge ou nó autônomo

Em um nó independente ou em um nó de borda executando o servidor de gerenciamento ou a interface de borda:

  1. Instale 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 o apigee-influxdb:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

Instale 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 o apigee-telegraf com o nome sa_telegraf.txt. Normalmente, você armazena esse arquivo em um diretório acessível pela biblioteca 'apigee' usuário, por exemplo, como /opt/apigee/customer/application, e torná-lo propriedade da Apigee usuário.

    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. Altere o proprietário para "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
  4. Configure o 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 explicar
  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 sua instalação do Edge, como o nó da interface 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 o apigee-grafana chamado sa_grafana.txt. Normalmente, você armazena esse arquivo em um diretório acessível pela biblioteca 'apigee' usuário, como /opt/apigee/customer/application, e torná-lo propriedade da Apigee usuário.

    Defina as seguintes propriedades no arquivo. Essas propriedades estão descritas acima:
    INFLUXDB_HOST=192.168.56.101
    INFLUXDB_PORT=8086
    GRAFANA_USERNAME=admin
    GRAFANA_PASSWORD=admin
  3. Altere o proprietário para "apigee":
    > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
  4. Configurar 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
  5. Reinicie o apigee-grafana:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana explicar

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 do apigee-grafana. No exemplo 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. sua instalação:

  1. Para garantir que o apigee-telegraf está coletando os dados
    1. Execute o comando apigee-service configuração do apigee-telegraf, é idempotente, verifica se há erros, faltam dependências e resolvê-los.
    2. Reinicie o apigee-telegraf. e marque /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log em busca de erros
  2. Para garantir que o apigee-influxdb está recebendo dados:
    1. Verifique se as portas TCP a seguir 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 "mostrar bancos de dados".
        Certifique-se de que os seguintes bancos de dados foram criados: sistema, aplicativo, eventos, _internal.
      2. No campo "Consulta", insira "mostrar servidores".
        Verifique se os nós do apigee-influxdb estão listados.
  3. Verifique as fontes de dados no painel:
    1. Selecione Fontes de dados no menu principal. Você verá ícones para três fontes de dados exibidas.
    2. Para cada fonte de dados, selecione o ícone.
    3. Na página de detalhes da fonte de dados, selecione a opção Salvar e teste .
    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 de onde você está fazendo upgrade:

  • 4.16.09, 4.17.01 e 4.17.05 usam o mesmo procedimento
  • A versão 4.16.05 exige que você desinstale o apigee-collectd como parte da atualização.

Atualizar de versão 4.16.09, 4.17.01 ou 4.17.05

Se você instalou a versão Beta do painel de monitoramento da Apigee nas versões 4.16.09, 4.17.01 ou 4.17.05, você poderá atualizá-lo para a versão Beta para 4.17.09.

Para atualizar o painel de monitoramento Beta:

  1. Atualizar o Edge para a versão 4.17.09 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 Atualize o Apigee Edge 4.16.01/4.16.05 para 4.17.09.
  2. Atualize o apigee-influxdb em 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 a instalação. apigee-influx.

    Se você também instalou o apigee-grafana na seção "Gerenciamento Nó do servidor, esta etapa também vai atualizar o apigee-grafana. Caso contrário, atualize apigee-granfana, conforme mostrado no etapa seguinte.
  3. Se você não instalou o apigee-grafana no Nó do servidor de gerenciamento, atualize apigee-grafana no nó em que você instalou:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f arquivo de configuração
  4. Atualize o apigee-telegraf em 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 explicar
  5. Repita a etapa 4 para cada nó.

Atualizar da versão 4.16.05

A versão 4.16.05 do painel usava apigee-collectd em vez do apigee-telegraf. Como parte da atualização para 4.17.09, você desinstala o apigee-collectd e instala o apigee-telegraf.

Para atualizar o painel de monitoramento Beta:

  1. Atualizar o Edge para a versão 4.17.09 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 Atualize o Apigee Edge 4.16.01/4.16.05 para 4.17.09.
  2. Atualize o apigee-influxdb em 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 a instalação. apigee-influx.

    Se você também instalou o apigee-grafana na seção "Gerenciamento Nó do servidor, esta etapa também vai atualizar o apigee-grafana. Caso contrário, atualize apigee-granfana, conforme mostrado no etapa seguinte.
  3. Se você não instalou o apigee-grafana no Nó do servidor de gerenciamento, atualize apigee-grafana no nó em que você instalou:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f arquivo de configuração
  4. Instale o 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 reinicialização
    > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd desinstalação
  5. Repita a etapa 4 para cada nó.