Jak zainstalować Grafanę na Ubuntu: Kompletny przewodnik konfiguracji i instalacji

Grafana to jedna z najpotężniejszych otwartych platform do wizualizacji danych i monitorowania infrastruktury. Niezależnie od tego, czy śledzisz wydajność serwera, metryki aplikacji czy wskaźniki KPI biznesu, elastyczne dashboardy Grafany i szerokie wsparcie źródeł danych czynią ją niezbędnym narzędziem dla każdego administratora systemów lub inżyniera DevOps.

Ten kompleksowy przewodnik przeprowadzi Cię przez każdy krok instalacji Grafany na Ubuntu — od przygotowania systemu na początek, przez konfigurację źródeł danych, budowanie pierwszego dashboardu, konfigurowanie alertów, aż po zabezpieczenie wdrożenia.

> Wymagania wstępne: Działający serwer Ubuntu (zalecane 20.04 lub 22.04 LTS), uprawnienia sudo i stabilne połączenie internetowe. Jeśli potrzebujesz niezawodnego serwera do hostowania instancji Grafany, rozważ VPS Hosting od AlexHost — zoptymalizowany dla obciążeń monitorowania krytycznych dla wydajności.

Krok 1: Aktualizacja pakietów systemowych

Przed zainstalowaniem nowego oprogramowania konieczne jest zsynchronizowanie indeksu pakietów i zastosowanie wszystkich dostępnych aktualizacji. Zapewnia to kompatybilność i zmniejsza ryzyko konfliktów zależności.

sudo apt update && sudo apt upgrade -y

Pozwól procesowi na ukończenie przed przejściem dalej. Na nowo aprowizowanym serwerze może to potrwać kilka minut.

Krok 2: Zainstaluj Grafanę z oficjalnego repozytorium APT

Grafana utrzymuje oficjalne repozytorium APT dla systemów opartych na Debianie, w tym Ubuntu. Korzystanie z oficjalnego repozytorium zapewnia, że zawsze masz dostęp do najnowszych stabilnych wydań i poprawek bezpieczeństwa.

Krok 2a: Zainstaluj wymagane zależności

Najpierw zainstaluj pakiet software-properties-common, który zapewnia narzędzie add-apt-repository:

sudo apt install -y software-properties-common apt-transport-https wget gnupg2

Krok 2b: Zaimportuj klucz podpisywania GPG Grafany

Dodanie klucza GPG pozwala systemowi zweryfikować autentyczność pakietów pobranych z repozytorium Grafany:

wget -q -O - https://packages.grafana.com/gpg.key | sudo apt-key add -

Krok 2c: Dodaj oficjalne repozytorium APT Grafany

sudo add-apt-repository "deb https://packages.grafana.com/oss/deb stable main"

Krok 2d: Zaktualizuj listę pakietów i zainstaluj Grafanę

sudo apt update
sudo apt install grafana -y

Po zakończeniu instalacji zweryfikuj zainstalowaną wersję:

grafana-server -v

Krok 3: Uruchomienie i włączenie usługi Grafana

Po instalacji uruchom demon serwera Grafana i skonfiguruj go do automatycznego uruchomienia przy starcie systemu:

sudo systemctl start grafana-server
sudo systemctl enable grafana-server

Sprawdź, czy usługa działa prawidłowo:

sudo systemctl status grafana-server

Powinieneś zobaczyć dane wyjściowe podobne do poniższych, potwierdzające, że usługa jest aktywna (uruchomiona):

● grafana-server.service - Grafana instance
     Loaded: loaded (/lib/systemd/system/grafana-server.service; enabled)
     Active: active (running) since ...

Jeśli usługa nie uruchomi się, sprawdź dzienniki błędów:

sudo journalctl -u grafana-server -f

Krok 4: Dostęp do interfejsu sieciowego Grafana

Domyślnie Grafana nasłuchuje na porcie 3000. Otwórz przeglądarkę internetową i przejdź do:

http://your_server_ip:3000

Zastąp your_server_ip rzeczywistym adresem IP lub nazwą hosta serwera.

Domyślne dane logowania

Przy pierwszym logowaniu Grafana natychmiast poprosi Cię o ustawienie nowego, bezpiecznego hasła. Nie pomijaj tego kroku — pozostawienie domyślnych danych logowania stanowi znaczące zagrożenie bezpieczeństwa.

> Uwaga dotycząca zapory sieciowej: Jeśli używasz UFW lub innej zapory sieciowej, otwórz port 3000, aby umożliwić dostęp przeglądarki:

> “`bash

> sudo ufw allow 3000/tcp

> sudo ufw reload

> “`

Krok 5: Konfiguracja źródeł danych

Grafana jest warstwą wizualizacji — nie przechowuje samych metryk. Zamiast tego łączy się z zewnętrznymi źródłami danych, takimi jak Prometheus, InfluxDB, Elasticsearch, MySQL, PostgreSQL i wiele innych. Konfiguracja źródła danych jest niezbędnym pierwszym krokiem, zanim będziesz mógł zbudować jakikolwiek pulpit nawigacyjny.

Krok 5a: Przejdź do źródeł danych

1. Na lewym pasku bocznym kliknij ikonę koła zębatego (⚙), aby otworzyć menu Konfiguracja.
2. Wybierz Źródła danych.

Krok 5b: Dodaj nowe źródło danych

1. Kliknij Dodaj źródło danych.
2. Przeglądaj listę i wybierz żądany typ źródła danych (np. Prometheus, InfluxDB, MySQL).

Krok 5c: Wprowadź szczegóły połączenia

Wypełnij parametry połączenia dla wybranego źródła danych. Na przykład, jeśli łączysz się z instancją Prometheus działającą lokalnie:

• URL: http://localhost:9090
• Dostęp: Server (default)
• Interwał skrobania: 15s (dopasuj do konfiguracji skrobania Prometheus)

W przypadku zdalnej instancji InfluxDB podasz adres URL hosta, nazwę bazy danych i poświadczenia uwierzytelniania.

Krok 5d: Zapisz i przetestuj połączenie

Kliknij Zapisz i testuj. Grafana spróbuje połączyć się ze źródłem danych i wyświetli komunikat o powodzeniu lub błędzie. Zielone potwierdzenie „Źródło danych działa” oznacza, że jesteś gotów do budowania pulpitów nawigacyjnych.

Krok 6: Utwórz swój pierwszy pulpit nawigacyjny Grafana

Po połączeniu źródła danych możesz teraz tworzyć pulpity nawigacyjne do wizualizacji metryk w czasie rzeczywistym.

Krok 6a: Utwórz nowy pulpit nawigacyjny

1. Na pasku bocznym po lewej stronie kliknij ikonę + (plus).
2. Wybierz Dashboard.
3. Kliknij Add new panel.

Krok 6b: Skonfiguruj panel

Edytor panelu się otwiera, dając ci pełną kontrolę nad tym, jakie dane są wyświetlane i jak są wizualizowane.

• Data Source: Wybierz źródło danych skonfigurowane w Kroku 5.
• Query: Napisz zapytanie metryki. Dla Prometheus użyj PromQL. Na przykład, aby wizualizować użycie CPU:

  100 - (avg by(instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)

• Visualization Type: Wybierz spośród Time series, Gauge, Bar chart, Table, Stat, Heatmap i innych — w zależności od charakteru twoich danych.
• Panel Title: Nadaj panelowi opisową nazwę (np. „CPU Usage — Last 1 Hour”).

Krok 6c: Dostosuj i zapisz

Użyj opcji panelu po prawej stronie, aby skonfigurować progi, schematy kolorów, etykiety osi i legendy. Po zakończeniu:

1. Kliknij Apply, aby dodać panel do pulpitu nawigacyjnego.
2. Powtórz proces, aby dodać wiele paneli — każdy śledzący inną metrykę.
3. Kliknij ikonę Save dashboard (dyskietka) w prawym górnym rogu, nadaj pulpitowi nawigacyjnemu nazwę i kliknij Save.

> Pro Tip: Oficjalna biblioteka pulpitów nawigacyjnych Grafana oferuje setki wstępnie skonfigurowanych, tworzone przez społeczność pulpitów dla popularnych stosów, takich jak Node Exporter, Kubernetes, MySQL i NGINX. Możesz je importować bezpośrednio, używając identyfikatora pulpitu nawigacyjnego.

Krok 7: Konfiguracja alertów

Wbudowany silnik alertów Grafana umożliwia definiowanie reguł opartych na progach i otrzymywanie powiadomień, gdy metryki przekroczą krytyczne poziomy — informując Cię zanim małe problemy staną się poważnymi awariami.

Krok 7a: Utwórz regułę alertu

1. Otwórz panel, który chcesz monitorować, i kliknij Edytuj.
2. Przejdź do karty Alert w edytorze panelu.
3. Kliknij Utwórz alert.

Krok 7b: Zdefiniuj warunki alertu

Skonfiguruj warunki wyzwalające alert. Na przykład:

• Warunek: WHEN avg() OF query(A, 5m, now) IS ABOVE 90
• To wyzwala alert, gdy średnia wartość Twojej metryki przekroczy 90 w ciągu ostatnich 5 minut.

Ustaw pola Oceniaj co i Przez, aby kontrolować, jak często reguła jest oceniana i jak długo warunek musi utrzymywać się przed wyzwoleniem.

Krok 7c: Skonfiguruj kanały powiadomień

1. Przejdź do Alerting → Kanały powiadomień na lewym pasku bocznym.
2. Kliknij Dodaj kanał i wybierz preferowaną metodę:

• Email — wymaga konfiguracji SMTP w grafana.ini
• Slack — wymaga adresu URL webhook Slack
• PagerDuty, OpsGenie, Webhook i inne

Przypisz kanał powiadomień do reguły alertu, aby odpowiednie osoby zostały powiadomione, gdy progi zostaną przekroczone.

Krok 8: Zabezpiecz Grafanę za pomocą HTTPS i kontroli dostępu

Uruchamianie Grafany w środowisku produkcyjnym bez odpowiedniego wzmocnienia bezpieczeństwa stanowi poważne ryzyko. Postępuj zgodnie z tymi najlepszymi praktykami, aby chronić infrastrukturę monitorowania.

8a: Włącz HTTPS z certyfikatem SSL

Szyfrowanie ruchu do instancji Grafany jest niezbędne, zwłaszcza jeśli jest dostępna przez publiczny internet. Będziesz potrzebować ważnego certyfikatu SSL — AlexHost oferuje niedrogie Certyfikaty SSL, które są łatwe do wdrożenia.

Gdy masz już certyfikat i klucz prywatny, edytuj plik konfiguracyjny Grafany:

sudo nano /etc/grafana/grafana.ini

Zlokalizuj sekcję [server] i zaktualizuj następujące parametry:

[server]
protocol = https
http_port = 3000
cert_file = /etc/grafana/ssl/grafana.crt
cert_key = /etc/grafana/ssl/grafana.key

Zapisz plik i uruchom ponownie Grafanę:

sudo systemctl restart grafana-server

Grafana będzie teraz dostępna przez HTTPS na porcie 3000.

> Zalecana alternatywa: Umieść Grafanę za odwrotnym proxy (np. Nginx lub Apache) i zakończ SSL na poziomie proxy. To jest bardziej elastyczne i powszechnie przyjęte podejście w środowiskach produkcyjnych.

8b: Ogranicź dostęp administratora i zarządzaj użytkownikami

1. Przejdź do Server Admin → Users w interfejsie użytkownika Grafany.
2. Przejrzyj i dostosuj role użytkowników:

• Admin — pełny dostęp
• Editor — może tworzyć i edytować dashboardy
• Viewer — dostęp tylko do odczytu

1. Wyłącz lub usuń nieużywane konta.
2. Rozważ włączenie LDAP lub OAuth (Google, GitHub, GitLab) do scentralizowanego uwierzytelniania.

8c: Dodatkowe rekomendacje wzmocnienia

• Wyłącz dostęp anonimowy w grafana.ini:

  [auth.anonymous]
  enabled = false

• Zmień domyślny port HTTP, jeśli Grafana jest publicznie dostępna.
• Ogranicz połączenia wychodzące z serwera Grafany za pomocą reguł zapory.
• Włącz rejestrowanie audytu, aby śledzić aktywność użytkownika.

Krok 9: Zarządzanie i aktualizacja Grafana

Utrzymywanie Grafana w aktualnym stanie jest krytyczne dla bezpieczeństwa i dostępu do nowych funkcji. Ponieważ zainstalowałeś Grafana z oficjalnego repozytorium APT, aktualizacje są proste.

Aktualizacja Grafana

sudo apt update
sudo apt upgrade grafana -y

Typowe komendy zarządzania usługą

Kopia zapasowa danych Grafana

Grafana przechowuje swoją konfigurację, pulpity nawigacyjne i dane użytkownika w bazie danych SQLite domyślnie, zlokalizowanej w:

/var/lib/grafana/grafana.db

Regularnie twórz kopię zapasową tego pliku, szczególnie przed wykonaniem aktualizacji:

sudo cp /var/lib/grafana/grafana.db /var/lib/grafana/grafana.db.backup-$(date +%F)

W przypadku większych wdrożeń rozważ migrację do dedykowanego backendu MySQL lub PostgreSQL w celu poprawy niezawodności i łatwiejszego zarządzania kopiami zapasowymi.

Rozwiązywanie typowych problemów

Wybór odpowiedniego hostingu dla Twojego stosu Grafana

Wydajność Twojego wdrożenia Grafana zależy w dużej mierze od podstawowej infrastruktury. Oto krótki przewodnik do wyboru odpowiedniego poziomu hostingu:

• Małe zespoły / projekty osobiste: Hosting współdzielony może działać w przypadku lekkich konfiguracji, choć VPS jest generalnie zalecany dla Grafany.
• Stosy monitorowania produkcji: Plan VPS Hosting zapewnia dedykowane zasoby, dostęp root i elastyczność do uruchamiania Grafany wraz z Prometheus, InfluxDB lub innymi komponentami.
• Pozyskiwanie danych o dużej objętości / obserwowalność napędzana ML: Rozważ GPU Hosting dla obciążeń obejmujących przetwarzanie danych na dużą skalę lub wykrywanie anomalii zasilane sztuczną inteligencją.
• Wdrożenia klasy korporacyjnej: Serwery dedykowane zapewniają maksymalną wydajność, izolację i bezpieczeństwo dla krytycznej infrastruktury monitorowania.

Podsumowanie

Instalacja i konfiguracja Grafana na Ubuntu to prosty proces, który odblokowuje potężną, rzeczywistą widoczność Twoich systemów i aplikacji. Postępując zgodnie z tym przewodnikiem, nauczyłeś się jak:

• Zainstalować Grafana z oficjalnego repozytorium na Ubuntu
• Uruchomić, włączyć i zweryfikować usługę Grafana
• Połączyć źródła danych takie jak Prometheus, InfluxDB i MySQL
• Budować interaktywne dashboardy z niestandardowymi panelami i wizualizacjami
• Konfigurować alerty oparte na progach z powiadomieniami wielokanałowymi
• Zabezpieczyć instancję Grafana za pomocą HTTPS i kontroli dostępu opartej na rolach
• Utrzymywać i aktualizować Grafana za pomocą standardowych poleceń APT

Niezależnie od tego, czy monitorujesz pojedynczy VPS czy złożoną infrastrukturę wielowęzłową, Grafana zapewnia fundament obserwacyjności, którego potrzebujesz, aby być o krok przed problemami wydajności i podejmować decyzje oparte na danych. Połącz to z niezawodnym środowiskiem hostingowym od AlexHost, a będziesz mieć wszystko, czego potrzebujesz, aby zbudować światowej klasy stos monitorowania.