Table of Contents

Metabase - ghid de inițiere

Metabase este o platformă open-source de business intelligence care vă permite să explorați date, să construiți dashboard-uri și să partajați informații – fără a scrie SQL. Conectați bazele de date (PostgreSQL, MySQL, MongoDB și altele), puneți întrebări printr-un constructor vizual de interogări și transformați răspunsurile în grafice și dashboard-uri interactive.


Pasul 1 – Verificați funcționarea Metabase

Adresa IP și parola root a serverului sunt afișate pe pagina Server Details din panoul clientului. Deschideți browserul și accesați:

http://your.server.ip

Pornirea Metabase poate dura 30-60 de secunde după pornirea serverului. Dacă vedeți o eroare de conectare sau „502 Bad Gateway”, așteptați puțin și reîmprospătați pagina. După încărcare, veți vedea asistentul de configurare.

Dacă ați plasat serverul în spatele unui router VyOS într-o rețea privată, configurați redirecționarea porturilor (80 și 443) pentru a accesa Metabase de pe internet sau conectați-vă prin VPN și accesați-l pe IP-ul privat al serverului.


Pasul 2 – Finalizarea asistentului de configurare

Asistentul de configurare vă va ghida prin configurarea inițială:

Language

Selectați limba preferată și faceți clic pe Next.

Admin Account

Creați contul de administrator – introduceți prenumele, numele, e-mailul, numele companiei (opțional) și parola. Acestea sunt datele cu care vă veți autentifica în Metabase.

Usage Info

Metabase vă întreabă pentru ce plănuiți să-l folosiți. Selectați o opțiune sau săriți peste.

Add Your Data

Conectați o bază de date existentă pe care doriți să o analizați (PostgreSQL, MySQL, MongoDB etc.). Dacă nu aveți încă una, săriți peste acest pas – Metabase va oferi o bază de date de exemplu. Puteți adăuga bazele de date ulterior.

Usage Data Preferences

Alegeți dacă trimiteți statistici anonime de utilizare către Metabase.

All Set Up

Configurarea este finalizată. Faceți clic pe Take me to Metabase pentru a deschide dashboard-ul.

Autentificați-vă cu e-mailul și parola create la pasul Admin Account.


Pasul 3 – Configurarea domeniului și SSL (opțional)

Pentru a folosi Metabase cu domeniul propriu și HTTPS:

  1. Creați o înregistrare A în setările DNS care direcționează domeniul către IP-ul serverului
  2. Așteptați propagarea DNS (de obicei câteva minute până la câteva ore)
  3. Conectați-vă prin SSH și actualizați configurația Nginx:
ssh root@your.server.ip

# Update Nginx server_name with your domain
sed -i 's/server_name _;/server_name your-domain.com;/' /etc/nginx/sites-available/metabase
nginx -t && systemctl reload nginx

# Obtain a free Let's Encrypt SSL certificate
certbot --nginx -d your-domain.com

Certbot va configura automat Nginx pentru HTTPS și reînnoirea automată a certificatului.


După instalare

Conectarea bazelor de date

Pentru a adăuga o sursă de date după configurarea inițială:

  1. Faceți clic pe butonul pictograma roată dințată (dreapta sus) → Admin settings → Databases → Add database
  2. Selectați tipul bazei de date (PostgreSQL, MySQL, MongoDB, SQLite etc.)
  3. Introduceți datele de conectare (host, port, numele bazei de date, datele de acces)
  4. Faceți clic pe Salvare – Metabase va sincroniza automat schema

Pentru baze de date pe servere externe, asigurați-vă că firewall-ul permite conexiuni de la IP-ul serverului Metabase.

Fail2Ban – protecție împotriva atacurilor brute-force

Serverul dumneavoastră include Fail2Ban preconfigurat pentru a proteja SSH împotriva atacurilor brute-force.

Regulă Încercări maxime Durata blocării
SSH5 autentificări eșuate10 minute

Comenzi utile:

# Check banned IPs
fail2ban-client status sshd

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Dacă vă blocați accidental, conectați-vă prin consola VNC din panoul clientului și deblocați-vă IP-ul.

Administrarea serviciilor

Metabase rulează ca serviciu systemd. Comenzi utile:

# Check service status
systemctl status metabase

# Restart Metabase
systemctl restart metabase

# View logs
journalctl -u metabase -f

# Nginx reverse proxy
systemctl status nginx
systemctl reload nginx

Actualizări

Pentru a actualiza Metabase la cea mai recentă versiune:

# Stop the service
systemctl stop metabase

# Download the latest JAR (backup the current one first)
cd /opt/metabase
cp metabase.jar metabase.jar.bak
curl -L -o metabase.jar https://downloads.metabase.com/latest/metabase.jar

# Start the service
systemctl start metabase

Pentru a actualiza pachetele sistemului prin SSH:

apt update && apt upgrade -y

Backup-uri

Metabase stochează toate datele (întrebări, dashboard-uri, setări) într-o bază de date H2. Pentru backup:

# Stop Metabase before backing up
systemctl stop metabase

# Copy the database file
cp /opt/metabase/metabase.db.mv.db /root/metabase-backup-$(date +%F).db

# Start Metabase again
systemctl start metabase

Pentru utilizare în producție cu seturi mari de date, luați în considerare migrarea de la H2 la PostgreSQL.


Software inclus

Componentă Versiune
Ubuntu24.04 LTS
Metabase0.52.5
Java21
Nginx1.24
Certbot2.9.0
Fail2Ban1.0.2

Depanare

Problemă Soluție
Pagina nu se încarcă după pornire Pornirea Metabase durează 30-60 de secunde. Așteptați și reîmprospătați. Verificați starea: systemctl status metabase
502 Bad Gateway în browser Metabase nu rulează. Reporniți-l: systemctl restart metabase. Verificarea logurilor: journalctl -u metabase --no-pager -n 50
Erori de lipsă de memorie Metabase necesită cel puțin 2 GB RAM. Verificați cu free -h. Luați în considerare un plan de server mai mare
Nu se poate conecta la baza de date externă Verificați host-ul, portul și datele de acces ale bazei de date. Asigurați-vă că firewall-ul bazei de date la distanță permite conexiuni de la IP-ul serverului
Ați uitat parola de administrator Metabase Resetare prin SSH: java -jar /opt/metabase/metabase.jar reset-password EMAIL
Blocat de Fail2Ban Deblocați-vă IP-ul prin consola VNC din panoul clientului
Ați uitat parola root Resetați-o prin consola VNC din panoul clientului