Instal·lació i configuració de Chronograf a Ubuntu 16.04 LTS

Chronograf és un gràfic de dades de sèries temporals, similar a Grafana, que utilitza InfluxDB com a backend. No obstant això, Chronograf és molt més que una eina de visualització de dades; a través de Kapacitor, es proporciona un backend complet per a alertar i monitoritzar.

Instal·lació

Eines

En aquesta guia s'utilitzen diverses eines amb diferents propòsits, així que assegureu-vos que els paquets següents estiguin instal·lats al vostre sistema.

sudo apt-get install wget curl

InfluxDB

Com que Chronograf es basa en InfluxDB com a font de dades principal, primer hem d'instal·lar la darrera versió. Es pot arxivar simplement baixant i instal·lant el .debfitxer creat prèviament .

wget https://dl.influxdata.com/influxdb/releases/influxdb_1.2.4_amd64.deb
sudo dpkg -i influxdb_1.2.4_amd64.deb

Si la instal·lació té èxit, podem continuar habilitant i iniciant el servei mitjançant systemctl.

sudo systemctl enable influxdb
sudo systemctl start influxdb

Per assegurar-nos que el servei s'executa correctament, podem invocar l'ordre següent, connectant-nos directament al fitxer InfluxDB HTTP API.

curl "http://localhost:8086/query?q=show+databases"

Si tot està en ordre, la sortida hauria de semblar a la següent.

{"results":[{"statement_id":0,"series":[{"name":"databases","columns":["name"]}]}]}

Si esteu experimentant un error mentre executeu l'ordre anterior, assegureu-vos que InfluxDB estigui habilitat i que s'hagi iniciat correctament i torneu-ho a provar.

Kapacitor

Kapacitor proporciona la major part de la funcionalitat de Chronograf. En particular, s'encarrega d'enviar alertes. Les alertes poden enviar usant diversos serveis diferents que van des de SMTPa Slacki HipChat. Aquest paquet també es proporciona mitjançant un .debfitxer preconstruït .

wget https://dl.influxdata.com/kapacitor/releases/kapacitor_1.3.1_amd64.deb
sudo dpkg -i kapacitor_1.3.1_amd64.deb

Habiliteu i inicieu el servei amb systemctl.

sudo systemctl enable kapacitor
sudo systemctl start kapacitor

Per tal de verificar que tot s'ha instal·lat correctament, podem invocar la següent comanda, que normalment retornaria les tasques a la cua actualment.

kapacitor list tasks

Assegureu-vos que la sortida s'assembla a aquest text.

ID Type      Status    Executing Databases and Retention Policies

En cas que es trobi un error, es mostrarà un informe d'error detallat.

Telègraf

Després de la instal·lació InfluxDBi Kapacitorcorrectament, podem continuar amb la instal·lació Telegraf. Telegraf és responsable de reunir totes les mètriques que es visualitzaran a través de Chronograf.

wget https://dl.influxdata.com/telegraf/releases/telegraf_1.3.2-1_amd64.deb
sudo dpkg -i telegraf_1.3.2-1_amd64.deb

Activa i inicia el servei.

sudo systemctl enable telegraf
sudo systemctl start telegraf

Comproveu la configuració inicial proporcionada mitjançant la instal·lació. Obriu /etc/telegraf/telegraf.confi assegureu-vos que les línies de sota reflecteixin la vostra configuració.

urls = ["http://localhost:8086"]
database = "telegraf"

Cronògraf

A continuació, procedirem a instal·lar el paquet bàsic de Chronograf.

wget https://dl.influxdata.com/chronograf/releases/chronograf_1.3.3.0_amd64.deb
sudo dpkg -i chronograf_1.3.3.0_amd64.deb

Després es pot activar i iniciar el servei.

sudo systemctl enable chronograf
sudo systemctl start chronograf

Per verificar que la instal·lació s'ha realitzat correctament, apunteu el vostre navegador a la http://<server-ip>:8888qual es mostra una pàgina de configuració inicial en la qual continuarem.

Configuració inicial

Introduïu els detalls de connexió d'InfluxDB. Ompliu els formularis disponibles tal com s'indica a continuació.

"Connection String" - http://localhost:8086
"Name" - InfluxDB
"Telegraf Database" - telegraf

Assegureu-vos de marcar també la casella etiquetada Make this the default source.

Kapacitor

Feu clic a la icona d'engranatges a la barra de navegació esquerra (l'últim element). Sota la Active Kapacitorcolumna premeu Add config. Ompliu el formulari proporcionat utilitzant els valors següents.

"Kapacitor URL" - http://localhost:9092
"Name" - Kapacitor

Ara podeu continuar afegint punts finals d'alerta mitjançant el formulari proporcionat.

Afegeix altres amfitrions

Per afegir altres amfitrions a Chronograf mitjançant SNMP, hem de fer canvis a la nostra configuració de Telegraf i instal·lar alguns connectors necessaris.

sudo apt-get install snmp snmp-mibs-downloader

Després d'autoritzar l'amfitrió que executa Chronograf en un altre amfitrió, podem afegir aquest amfitrió a la nostra configuració de Telegraf mitjançant les línies següents.

[[inputs.snmp]]
  agents = [ "<ip-address-of-other-host>:161" ]
  version = 2
  community = "<snmp-community>"
  name = "snmp"

 [[inputs.snmp.field]]
    name = "hostname"
    oid = "RFC1213-MIB::sysName.0"
    is_tag = true

  [[inputs.snmp.table]]
    name = "snmp"
    inherit_tags = [ "hostname" ]
    oid = "IF-MIB::ifXTable"

    [[inputs.snmp.table.field]]
      name = "ifName"
      oid = "IF-MIB::ifName"
      is_tag = true

Això, en particular, supervisa totes les mètriques, com ara l'ús de la CPU, l'ús de la memòria i la distribució de l'ús de la xarxa per interfície, amb estadístiques detallades que inclouen valors com ara paquets unicast i errors d'interfície.

Tallafoc

A partir d'ara, Chronograf no proporciona un sistema d'autenticació clàssica com usernamei passwordautenticació. Per tal de mantenir la nostra instal·lació segura, utilitzarem la Vultr Firewallfunció per bloquejar qualsevol port que vagi al port 8888TCP i afegirem una regla d'excepció per a l'adreça IP del nostre client que hauria de poder veure-la.

Com que els altres serveis instal·lats només escolten a l'adreça IP de bucle invertit ( 127.0.0.1) no estem obligats a bloquejar explícitament les sol·licituds que hi arribin.

Conclusió

Chronograf és una eina de visualització mètrica molt flexible i bonica que inclou paquets d'alertes i recollida de dades decents que creen una solució de control decent.