Kaip paleisti Grafana Docker konteineryje

Grafana - tai pirmaujantis atvirojo kodo įrankis laiko eilučių duomenų vizualizavimui. Grafana plačiai naudojamas duomenims iš įvairių šaltinių - tokių kaip Prometheus, InfluxDB ir Loki – vizualizavimui. Greitas ir lankstus būdas diegti Grafana - naudoti Docker, kuris leidžia ją paleisti konteinerizuotoje aplinkoje. Tai leidžia lengvai ir patogiai įdiegti šį įrankį be didelių operacinės sistemos konfigūracijų.

Šioje pamokoje sužinosite, kaip paleisti Grafana su Docker. Konkrečiai, sužinosite kaip:

Viena paprasta komanda parsisiųsti ir paleisti Grafana Docker konteinerį.
Atidaryti Grafana prievadus, kad pasiekti valdymo panelę per naršyklę.
Išsaugoti Grafana nustatymus ir skydelius tarp konteinerio paleidimų.
Konfigūruoti Grafana naudojant aplinkos kintamuosius arba Dockerfile.
Supaprastinti diegimą naudojant Docker Compose keliems konteineriams orkestruoti.

Pasiruošimas

Prieš pradedant, įsitikinkite, kad sistema atitinka šiuos reikalavimus:

Įdiegtas Docker: jūsų sistemoje turi būti įdiegtas ir veikiantis Docker Engine.
Komandinės eilutės pagrindai: turite mokėti dirbti terminale ir vykdyti Docker komandas.
Sudo teisės: Linux sistemose Docker komandas reikia vykdyti su sudo arba pridėti savo vartotoją prie docker grupės.

Grafana Docker image atsisiuntimas

Pirmiausia reikia atsisiųsti Grafana atvaizdą (image) iš Docker Hub. Šiame atvaizde yra viskas, ko reikia Grafanai įdiegti ir paleisti konteineryje.
Naudokite šią komandą:

docker pull grafana/grafana

Jeigu nenurodysite versijos žymos (tag), Docker automatiškai atsiųs naujausią stabilią versiją. Jei norite konkrečios versijos, pavyzdžiui, 10.3.1:

docker pull grafana/grafana:10.3.1

Visas galimas Grafana versijų žymas rasite Docker Hub.

Paleidus šią komandą bus:

Atsisiųstas oficialus Grafana Docker atvaizdas ir išsaugotas lokaliai.
Užtikrinta, kad Docker galėtų kurti konteinerius iš šio atvaizdo, pridėdamas reikalingas priklausomybes (dependencies).

Grafana konteinerio paleidimas

Atsisiuntus Grafana atvaizdą, konteinerį galite paleisti su viena docker run komanda. Tai greičiausias būdas paleisti konteinerį lokaliai ar serveryje.

Komanda paleidimui:

docker run -d -p 3000:3000 --name=grafana grafana/grafana

Ką daro ši komanda:

docker run - sukuria ir paleidžia naują konteinerį.
-d - paleidžia konteinerį fone (detached mode).
-p 3000:3000 - susieja 3000 prievadą jūsų kompiuteryje su 3000 prievadu konteineryje (numatytasis Grafanos prievadas).
--name=grafana - suteikia konteineriui atpažįstamą pavadinimą.
grafana/grafana - nurodo, kurį atvaizdą naudoti.

Patikrinkite, ar konteineris veikia su šia komanda:

docker ps

Rezultatuose turėtumėte matyti veikiantį konteinerį pavadinimu "grafana".

Šis būdas leidžia per kelias sekundes paleisti Grafana konteinerį - nereikia jokių sudėtingų konfigūracijų.

Grafana valdymo pulto pasiekimas

Paleidus konteinerį, naršyklėje atsidarykite valdymo pultą nurodant jūsų kompiuterio (kuriame paleistas Docker konteineris) IP adresą su Grafana prievadu:

ip-adresas:3000

Prisijungimo ekrane naudokite numatytuosius duomenis:
Vartotojas - admin
Slaptažodis - admin

Po prisijungimo Grafana paprašys pakeisti numatytąjį slaptažodį. Rekomenduojama tai padaryti iš karto, ypač jei konteineris pasiekiamas iš viešo tinklo ar interneto.

Tada pateksite į pagrindinį valdymo pultą, kuriame galėsite pridėti duomenų šaltinius, kurti paneles ir pridėti savo skydelius.

Grafana duomenų išsaugojimas

Pagal numatytuosius nustatymus visi duomenys konteineryje prarandami jį sustabdžius ar pašalinus - įskaitant įskiepius, naudotojo nustatymus ir skydelius. Tai tinka testavimui, bet ne ilgalaikiam naudojimui.
Kad duomenys būtų išsaugomi, reikia primontuoti nuolatinį diską (volume), kad Grafanos duomenys būtų laikomi už konteinerio ribų:
Sukurkite Docker volume:

docker volume create grafana-storage

Šis volume saugos Grafana katalogą /var/lib/grafana konteineryje.

1. Patikrinkite, ar volume sukurtas ir dar nenaudojamas:

docker volume ls -f dangling=true

2. Sustabdykite ir pašalinkite esamą konteinerį:

docker stop grafana
docker rm grafana

3. Paleiskite naują konteinerį, primontuodami volume:

docker run -d \
  -p 3000:3000 \
  --name=grafana \
  --volume grafana-storage:/var/lib/grafana \
  grafana/grafana

4. Patikrinite, ar volume primontuotas:

docker inspect --format '{{json .Mounts}}' grafana

Dabar galite saugiai stabdyti, paleisti ar atnaujinti konteinerį neprarasdami nustatymų. Docker į Grafanos duomenų katalogą įkels failus iš primontuoto volume, o Grafana automatiškai atkurs jūsų būseną.

Grafana konfigūravimas naudojant aplinkos kintamuosius

Grafana palaiko daugybę aplinkos kintamųjų, leidžiančių pritaikyti nustatymus konteinerio paleidimo metu, neredaguojant konfigūracijos failų. Tai ypač naudinga automatizavimui, skriptams ar vienodoms aplinkoms.

Keli dažni kintamieji:
GF_SECURITY_ADMIN_PASSWORD - nustato pradinį administratoriaus slaptažodį.
GF_SERVER_ROOT_URL - apibrėžia šaknies URL, naudinga naudojant reverse proxy.
GF_USERS_ALLOW_SIGN_UP - įjungia arba išjungia naudotojų savarankišką registraciją.
GF_INSTALL_PLUGINS - paleidžiant automatiškai įdiegia įskiepius (kableliais atskirtas sąrašas).

Aplinkos kintamuosius perduokite su -e:

docker run -d \
  -p 3000:3000 \
  --name=grafana \
  -e GF_SECURITY_ADMIN_PASSWORD=Slaptažodis \
  -e GF_SERVER_ROOT_URL=http://grafana.example.com \
  -e GF_USERS_ALLOW_SIGN_UP=false \
  grafana/grafana

Šiame pavyzdyje:

Pakeičiame numatytą slaptažodį į "Slaptažodis".
Nurodome Grafanai, kad root URL yra http://grafana.example.com (už reverse proxy).
Išjungiame savarankišką registraciją.

Tai galima derinti su volume primontavimu visiškai pritaikytai ir išliekamajai konfigūracijai.

Aplinkos kintamieji taikomi kaskart paleidus konteinerį, todėl puikiai tinka versijų valdomiems diegimams ar Docker Compose konfigūracijoms.

Kaip sukurti pritaikytą Grafana Docker atvaizdą

Kuriant savo Grafana Docker atvaizdą, tai leidžia:

Iš anksto įdiegti konkrečius įskiepius
Įtraukti pasirinktinius konfigūracijos failus
Pritaikyti ženklinimą (branding) ar temas
Nurodyti aplinkos specifinius nustatymus
Užuot kiekvieną kart tai konfigūravę konteineryje, galite susikurti savo Grafana atvaizdą su Dockerfile, kuriame viskas numatyta iš anksto.

1. Sukurkite Dockerfile:

FROM grafana/grafana:latest
# Įdiegti vieną ar kelis įskiepius
RUN grafana-cli plugins install grafana-clock-panel
# Pasirinktinai: įkelti savo konfigūraciją
# COPY custom.ini /etc/grafana/grafana.ini

2. Paleiskite atvaizdą:

docker build -t my-grafana-custom .

3. Paleiskite pritaikytą atvaizdą:

docker run -d \
  -p 3000:3000 \
  --name=grafana-custom \
  my-grafana-custom

Toks konteineris veiks kaip įprasta Grafana, bet su jūsų įskiepiais ir pakeitimais. Galite ir toliau montuoti volumes ir perduoti aplinkos kintamuosius. Pritaikyti atvaizdai puikiai tinka komandoms, CI/CD srautams ir kartotiniams diegimams, suteikdami pilną kontrolę su minimaliu pasiruošimu.

Naudokite pritaikytą atvaizdą, jei:

Dažnai diegiate Grafana ir norite vienodos būsenos
Automatizuojate infrastruktūrą ir reikia paprasto sprendimo
Norite įtraukti įskiepius ar konfigūracijas be rankinio įsikišimo

Grafana paleidimas su Docker Compose

Valdyti konteinerius su docker run tinka vienam pavyzdžiui. Tačiau augant aplinkai arba norint švaresnio, kartojamo diegimo, verta naudoti Docker Compose. Jis leidžia visą konfigūraciją aprašyti viename YAML faile ir viską paleisti viena komanda.

Sukurkite docker-compose.yml failą:

version: '3.8'
services:
  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    ports:
      - "3000:3000"
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=Slaptažodis
      - GF_USERS_ALLOW_SIGN_UP=false
    volumes:
      - grafana-storage:/var/lib/grafana
    restart: unless-stopped
volumes:
  grafana-storage:

Paleiskite konteinerį su šia komanda:

docker-compose up -d

Norint sustabdyti konteinerį:

docker-compose down

Ši konfigūracija:

Jei reikia, parsisiunčia atvaizdą.
Paleidžia konteinerį fone (-d).
Automatiškai atkuria konteinerį po perkrovimo (restart: unless-stopped).
Naudoja pavadintą volume grafana-storage duomenims išsaugoti.

Taigi, Grafana yra labai galingas įrankis, o su Docker pagalba galima vos keliomis komandomis paleisti Grafana konteinerį. Jeigu kyla klausimų ar sunkumų, kreipkitės į mūsų gyvąją pagalbą, arba rašykite el. paštu: [email protected]