How to monitor UNIFI UBIQUITI devices in zabbix - Part 1

View Comments (40)

• Boa noite amigo.
  Implantei com sucesso os passos deste tutorial, mas faltam detalhes de como configurar no Zabbix. Eu devo adicionar um Host com o IP do Unifi Controller utilizando o Template?

  • Boa noite Pablo!
    Primeiro você deve importar o template.
    Após isso, criar um novo host com o IP do AP UNIFI e não esquecer de fixar este mesmo IP na configuração do AP.
    Durante a criação do host, basta ir em templates e selecionar o template Unifi clicar em add, e depois salvar a configuração.
    Após cerca de 1 minuto você já será capaz de ver o resultado das coletas.
    Caso não esteja coletando, você pode fazer um teste a partir do seu servidor zabbix utilizando o comando:
    snmpwalk -v1 -c public ipdoapubiquiti

    • NÃO FUNCIONA NO UniFi AP-AC-Pro?

      • Vai depender da versão do seu firmware. Mas, eu acho que algumas funções não vão funcionar por eu não ter implementado.

    • Boa tarde... quando vc fala ipdoubiquiti é o IP da máquina que tem o console instalado?

      • IP do AP, não é preciso a controller para fazer as coletas

  • Ah. vou fazer esta parte esta semana, estava focado em desenvolver as outras partes do template para diagnosticar uns problemas nas redes que gerencio.

• Boa noite Amigo
  Funciona com um zabbix proxy coletando as informações?
  Pois pelo que entendi esse zabbix proxy teria ter as MIBs que mencionou

  • Boa noite Tiago!
    Funciona com zabbix proxy, sem problemas.
    Só precisa das Mibs para depuração e apenas no servidor zabbix.
    Depois que eu conclui os artigos, eu mudei a direção e refiz todo o template usando as OIDs sem tradução.
    Forte abraço e sucesso

• Boa Tarde Alex, vc saberia dizer para qual arquivo no ZABBIX devo importar as MIBS do UNIFI?

  • As MIBs não são importadas para o zabbix, elas são parte do protocolo client snmp do sistema operacional.

    Este link deve te ajudar a encontrar o caminho
    https://www.vivaolinux.com.br/topico/Redes/Importar-MIB
    Abraços
    Alex Moura

• Obg pela resposta, mas fiquei um pouco confuso, pelo que você detalhou no item 3 deste artigo as mibs do Unifi devem estar instaladas no zabbix, para eu realizar as coletas dos itens conforme o seu template eu preciso dessas mibs instaladas no zabbix?

  • Olá Fabrício!
    Depois que eu completei o template, eu o refiz usando os números das OIDs ao invés das traduções das MIBs.
    As MIBs referentes ao UNIFI não deverão fazer falta. Elas servem para debugar ou implementar novas funções de dispositivos UNIFI.
    Eu deixei a informação, pois, alguém pode querer melhorar o template e não vai conseguir sem as MIBs.
    Abraços
    Alex Moura

    Segue a resposta em inglês que eu dei para uma outra pessoa que fez uma pergunta semelhante.
    Em resposta a Glenn

    Hello Glenn!
    In fact, I developed this template using these MIBs, but, these requirements are to troubleshooting.
    I changed my direction, and only using the OID numbers to create the template and used the OID names to identify the MIBs correspondent names.
    Despite my system have these MIBs, in theory, perhaps not necessary for troubleshooting.
    MIBs are files to translate the OID numbers to human readable information.
    So let’s go to solve your problem.

    Follow these steps to fix your AP.
    1 – The SNMP protocol must be enabled at the Acess Point set in services SNMP session in controller. For troubleshooting use “public” community.
    2 – Use ping to test the physical connection to the Access point.
    3 – On zabbix server use NetCat to test the port connectivity;
    EX: nc -vu 192.168.0.200 161
    this will be a correct response. Connection to 192.168.0.200 port [udp/snmp] succeeded!
    4 – test snmp response with this command:
    snmpwalk -v2c -c public 192.168.0.200
    5 – looking if the correct port is configured in the host settings in zabbix.

    This is a easy part, if this not enough to solve your problem, then let me know more detailed information.
    If you solved then let me know too.
    Best Regards
    Alex Moura

• Muito obrigado por compartilhar seu conhecimento! Funcionou!
  Não encontrei no template um gráfico que mostrasse todos os usuários/quantidade de todos os SSIDs.
  Seria legal pra eu ter uma ideia do uso geral.
  Tem alguma dica de como posso implementar esse gráfico?
  Mais uma vez, obrigado por compartilhar!

  • Olá Fernando!
    Isto é uma limitação tanto do zabbix, quanto do Unifi.
    O fato de que eu faço as coletas dinamicamente de acordo com as redes configuradas, impede que eu faça este somatório com as funções padrão do zabbix.
    Andei pesquisando em alguns fóruns sobre isto, e descobri que isto é uma característica muito solicitada aos desenvolvedores do zabbix para tratar valores SNMP gerados dinamicamente.
    Do lado do Unifi, não há uma "OID" contendo o somatório de clientes conectados.
    Caso tenha alguma idéia de como implementar um script de coleta e queira compartilhar, terei o maior prazer em testar e implementar na solução.
    Um grande abraço!
    Alex Moura

• Boa Tarde

  Quais são as macros por favor?

  Tenho uma UNIFI GATEWAY

  • Boa tarde Cleiton.
    Não entendi a sua pergunta.

• Primeiramente obrigado pela contribuição...

  Estou tentando criar o Host.. mas no momento de adiciona-lo recebo essa msg do

  Zabbix Details Cannot add host

  Cannot find host interface on "AP_RP_Contabilidade" for item key "unifiVapEssId".

  O que eu devo fazer?
  At,
  Xico

  • Bom dia!
    Provavelmente você já tem o item configurado em sua instalação zabbix.
    Acredito que o primeiro passo seja identificar esta duplicidade e removê-la.
    Os ítens referentes ao wifi são gerados dinamicamente e não precisam serem configurados.
    Mande mais detalhes e talvez eu consiga te ajudar melhor.
    Atenciosamente
    Alex Moura

• amigos, como faço pra criar no template um item que eu faça o cálculo do total de usuários(dispositivos) ativos no AP, estou tentando criar um protótipo de item pra que depois que descubra o unifiVapNumStations ele já me informe o total por AP

  • Olá Joel!
    Até a versão 4.0 do zabbix não é possível.
    Em breve atualizarei para a versão 4.4 do zabbix, onde pelo que li pode ser que seja possível.
    Assim que fizer atualizo o template.

    Vou reproduzir a resposta que dei a outro colega mais abaixo.
    Isto é uma limitação tanto do zabbix, quanto do Unifi.
    O fato de que eu faço as coletas dinamicamente de acordo com as redes configuradas, impede que eu faça este somatório com as funções padrão do zabbix.
    Andei pesquisando em alguns fóruns sobre isto, e descobri que isto é uma característica muito solicitada aos desenvolvedores do zabbix para tratar valores SNMP gerados dinamicamente.
    Do lado do Unifi, não há uma “OID” contendo o somatório de clientes conectados.
    Caso tenha alguma idéia de como implementar um script de coleta e queira compartilhar, terei o maior prazer em testar e implementar na solução.
    Um grande abraço!
    Alex Moura

• Bom dia mestre,
  Estou entrando nesta onda de zabbix agora.
  possuo uma nanobeam m5 e não consigo adicioná-la no zabbix. da erro de porta.

  como configuro a porta ?

  • Boa tarde Moreno!
    Você precisa garantir que no software controlador estes parâmetros estão ativados e setados.

    Services / SNMP / SNMPv1, SNMPv2c/ Enabled
    Community = Nome que você gostaria de utilizar. Pode deixar a public para efeitos de teste. Mas, não recomendo deixar a community como public.
    Sugiro que você leia também este artigo
    https://duvidaonline.com.br/blog/2019/01/03/como-monitorar-dispositivos-unifi-ubiquiti-no-zabbix-parte-3-atualizando-firmware-e-habilitando-o-protocolo-snmp/
    Um forte abraço!
    Alex Moura

• Boa tarde Alex Moura, tudo bem?

  Tem alguma novidade sobre a questão de total de usuários conectados no AP invés de retornar o total por SSID/Frequência?

  Abraços

  • Bom dia Rodrigo!
    Eu recém instalei a versão 4.4 no meu ambiente de produção.
    Vou testar e em breve darei um retorno.
    Forte abraço
    Alex Moura

    • Boa tarde alex, consegui isso atráves do unifi_miner/unifi_proxy. Tem no github... Aliás, consegue-se muito mais informação. Abraço

      • Boa tarde Rodrigo!
        Este era o cara que falei para alguém nos comentários que davam vários problemas e por isto desisti.
        Quero fazer todas as funções sem depender de scripts externos.
        Abraços
        Alex Moura