Compartilhar via


Configurar o Grafana para visualizar métricas emitidas do cluster de instância gerenciada

Quando você implanta um cluster do Instância Gerenciada do Azure para Apache Cassandra, o serviço provisiona o coletor de métricas para o software do agente do Coletor de Métrica para Apache Cassandra em cada nó de dados. As métricas podem ser consumidas pelo Prometheus e visualizadas por meio do Grafana. Este artigo descreve como configurar o Prometheus e o Grafana para visualizar as métricas emitidas do cluster de instância gerenciada.

As seguintes tarefas são necessárias para visualizar métricas:

  • Implante uma Máquina Virtual do Ubuntu na Rede Virtual do Azure que hospeda a instância gerenciada.
  • Instale os Painéis do Prometheus na VM.

Aviso

O Prometheus e o Grafana são softwares de código aberto e não têm suporte como parte do serviço da Instância Gerenciada do Azure para Apache Cassandra. Para visualizar as métricas da maneira descrita abaixo, você precisará hospedar e manter uma máquina virtual como servidor para o Prometheus e o Grafana. As instruções abaixo foram testadas apenas no Ubuntu Server 18.04 e não há garantia de que funcionarão com outras distribuições Linux. Seguir essa abordagem implica no suporte relativo a problemas que possam surgir, como ficar sem espaço ou disponibilidade do servidor. Para ter uma experiência de métricas com suporte e hospedagem completos, considere usar métricas do Azure Monitor ou, como alternativa, integrações de parceiros do Azure Monitor.

Implantar um servidor Ubuntu

  1. Entre no portal do Azure.

  2. Navegue até o grupo de recursos onde está o cluster de instância gerenciada. Selecione Adicionar e pesquise a imagem Ubuntu Server 18.04 LTS:

    Localize a imagem do servidor Ubuntu no portal do Azure.

  3. Escolha a imagem e selecione Criar.

  4. Na folha Criar uma máquina virtual, insira valores para os campos seguintes. Você pode deixar os valores padrão nos outros campos:

    • Nome da máquina virtual – insira um nome para a nova VM.
    • Região – selecione a mesma região em que a Rede Virtual foi implantada.

    Preencher o formulário para criar a VM com a imagem do servidor Ubuntu.

  5. Na guia Rede, selecione a Rede virtual onde a instância gerenciada está implantada:

    Definir configurações de rede do servidor Ubuntu.

  6. Por fim, selecione Examinar + Criar para criar o servidor de Métricas.

Instalar Painéis do Prometheus

  1. Primeiro, verifique se as configurações de rede para o servidor Ubuntu recém-implantado têm regras de porta de entrada que permitem as portas 9090 e 3000. Eles serão necessários posteriormente para Prometheus e Grafana, respectivamente.

    Permitir portas

  2. Conecte-se ao servidor Ubuntu usando a CLI do Azure ou sua ferramenta de cliente preferencial para se conectar via SSH.

  3. Depois de se conectar à VM, você precisa instalar o software coletor de métricas. Primeiro, baixe e descompacte os arquivos:

     #install unzip utility (if not already installed)
     sudo apt install unzip
    
     #get dashboards
     wget https://github.com/datastax/metric-collector-for-apache-cassandra/releases/download/v0.3.0/datastax-mcac-dashboards-0.3.0.zip -O temp.zip
     unzip temp.zip
    
  4. Em seguida, navegue até o diretório do prometheus e use o VI para editar o arquivo tg_mcac.json:

     cd */prometheus
     vi tg_mcac.json    
    
  5. Adicione os endereços IP de cada nó do seu cluster em targets, cada um com a porta 9443. Seu arquivo tg_mcac.json deverá ser semelhante ao que se vê abaixo:

     [
       {
         "targets": [
           "10.9.0.6:9443","10.9.0.7:9443","10.9.0.8:9443"
         ],
         "labels": {
    
         }
       }
     ]  
    
  6. Salve o arquivo. Em seguida, edite o arquivo prometheus.yaml no mesmo diretório. Localize a seguinte seção:

     file_sd_configs:
       - files:
         - 'tg_mcac.json'
    
  7. Diretamente abaixo desta seção, adicione o que vem a seguir. Isso é necessário porque as métricas são expostas por meio de https.

     scheme: https
     tls_config:
             insecure_skip_verify: true
    
  8. Agora, o arquivo deve ter a aparência a seguir. Verifique se as guias de cada linha estão como abaixo.

     file_sd_configs:
       - files:
         - 'tg_mcac.json'
     scheme: https
     tls_config:
             insecure_skip_verify: true
    
  9. Salve o arquivo. Agora você está pronto para iniciar o Prometheus e o Grafana. Primeiro, instale o Docker:

    sudo apt install apt-transport-https ca-certificates curl software-properties-common
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
    sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu `lsb_release -cs` test"
    sudo apt update
    sudo apt install docker-ce
    
  10. Em seguida, instale o Docker Compose:

    sudo apt install docker-compose
    
  11. Agora, navegue até o diretório de nível superior em que docker-compose.yaml está localizado e inicie o aplicativo:

    cd ..
    sudo docker-compose up
    
  12. O Prometheus deve estar disponível na porta 9090 e os painéis do Grafana na porta 3000 do seu servidor de métricas:

    Ver as métricas de instância gerenciada do Cassandra no painel.

Próximas etapas

Neste artigo, você aprendeu a configurar painéis para ver métricas no Prometheus usando o Grafana. Saiba mais sobre a Instância Gerenciada do Azure para Apache Cassandra com os seguintes artigos: