معرفی Grafana
Grafana یک برنامه وب متنباز برای مصورسازی و observability است. این برنامه به منابع داده متنوعی (از جمله Prometheus، Loki، InfluxDB، PostgreSQL، MySQL و Elasticsearch) وصل میشود تا داشبورد بسازد و هشدار تعریف کند. تیمهای DevOps، مدیران سیستم و کسبوکارهای کوچکی که میخواهند سرورها، برنامهها یا شاخصهای کسبوکار خود را پایش کنند از آن استفاده میکنند.
هنگام تحویل VPS، دستورالعمل cloud-init ابتدا Docker را با اسکریپت رسمی get.docker.com نصب میکند و سپس با Docker Compose از مسیر /opt/grafana دو کانتینر اجرا میکند: Grafana (ایمیج grafana/grafana:latest) و Caddy 2. Grafana فقط بهصورت محلی روی 127.0.0.1:3000 گوش میدهد. Caddy رابط کاربری را روی پورت 443 با HTTPS منتشر میکند، با یک گواهی خودامضا (tls internal) که به آدرس IP عمومی سرور وابسته است.
ثبتنام آزاد غیرفعال است (GF_USERS_ALLOW_SIGN_UP=false). دادههای Grafana در یک ولوم Docker با نام grafana_data ذخیره میشوند و بنابراین با ریاستارت یا ساخت دوباره کانتینر از بین نمیروند. هر دو سرویس با restart: always پیکربندی شدهاند.
با Grafana چه کارهایی میتوانید انجام دهید
Grafana آماده از لحظه تحویل
کانتینر راهاندازی شده و بدون نصب دستی از طریق HTTPS روی IP سرور در دسترس است. فقط کافی است وارد شوید و منابع داده خود را اضافه کنید.
HTTPS از طریق Caddy بهعنوان reverse proxy
Caddy روی پورت 443 گوش میدهد و ترافیک را به Grafana روی 127.0.0.1:3000 هدایت میکند. گواهی در ابتدا خودامضا است، بنابراین تا زمانی که دامنهای پیکربندی نکنید، مرورگر یک هشدار نشان میدهد.
دادههای ماندگار در یک ولوم
پایگاه داده و داشبوردهای Grafana در ولوم Docker با نام
grafana_dataذخیره میشوند. گواهیها و پیکربندی Caddy هم ولومهای مخصوص خود را دارند.ثبتنام عمومی غیرفعال
گزینه
GF_USERS_ALLOW_SIGN_UP=falseاز ساخت هر حساب کاربری از صفحه ورود جلوگیری میکند. کاربران از بخش مدیریت Grafana اضافه میشوند.استک خوانای Docker Compose
کل پیکربندی در
/opt/grafana/docker-compose.ymlو/opt/grafana/Caddyfileجا میگیرد. بهروزرسانی یا تغییر یک پارامتر با دستورهای معمول Compose انجام میشود.
شروع کار با Grafana
از سفارش تا راهاندازی نهایی، در چند دقیقه.
- 1
سفارش VPS همراه با Grafana
یک VPS لینوکسی در پاریس یا فرانکفورت انتخاب کنید (Debian 12 یا 13، Ubuntu 20.04، 22.04 یا 24.04) و سپس در تب «Applications» فرم سفارش، Grafana را تیک بزنید.
- 2
ورود به رابط کاربری
پس از تحویل سرور، چند دقیقه صبر کنید تا Docker و کانتینرها نصب شوند. سپس https://SERVER_IP را در مرورگر باز کنید و هشدار گواهی خودامضا را بپذیرید. حساب اولیه admin / admin است و Grafana در اولین ورود از شما میخواهد رمز عبور آن را تغییر دهید.
Bashssh root@SERVER_IP cd /opt/grafana && docker compose ps - 3
افزودن یک منبع داده
در Grafana به Connections و سپس Data sources بروید، منبع خود (Prometheus، Loki، PostgreSQL و...) را اضافه کنید و اتصال را آزمایش کنید. سپس اولین داشبورد را بسازید یا یکی را از کاتالوگ جامعه کاربری grafana.com وارد کنید.
- 4
امنسازی برای محیط عملیاتی
یک نام دامنه را به سرور اشاره دهید، سپس IP را در Caddyfile (بدون خط
tls internal، Caddy یک گواهی عمومی دریافت میکند) و در GF_SERVER_ROOT_URL و GF_SERVER_DOMAIN فایل docker-compose.yml با دامنه خود جایگزین کنید. فراموش نکنید پورتهای 80 و 443 را در فایروال خود باز کنید و از ولوم grafana_data بکاپ بگیرید.Bashcd /opt/grafana nano Caddyfile nano docker-compose.yml docker compose up -d
کاربردهای Grafana
پایش سرورها و VPSها
در کنار Prometheus و node_exporter، Grafana بار CPU، حافظه، دیسک و شبکه ماشینهای شما را در یک صفحه نمایش میدهد.
داشبوردهای برنامهها
متریکهای برنامهها، لاگها با Loki یا زمانهای پاسخ را مصور کنید و هشدارها را به ایمیل یا پیامرسان ارسال کنید.
گزارشگیری از پایگاههای SQL
PostgreSQL یا MySQL را وصل کنید تا شاخصهای کسبوکار (فروش، ثبتنامها، موجودی) را بهصورت نمودارهایی که با تیم خود به اشتراک میگذارید دنبال کنید.
پیگیری دادههای معاملاتی
یک پایگاه داده سری زمانی مانند InfluxDB در کنار Grafana امکان ترسیم عملکردها یا پوزیشنها را میدهد. یک [VPS برای معاملهگری](/vps-forex) برای این نوع جمعآوری مداوم مناسب است.
پرسشهای متداول درباره Grafana
حساب اولیه admin با رمز عبور admin است. Grafana در اولین ورود از شما میخواهد آن را تغییر دهید. این کار را بلافاصله انجام دهید، چون رابط کاربری از اینترنت در دسترس است.
درباره Grafana بیشتر بدانید
فایلها کجا هستند
همهچیز در /opt/grafana است: اسکریپت نصب install-grafana.sh، فایل docker-compose.yml و Caddyfile. دادهها در ولومهای نامدار Docker قرار دارند، نه در این پوشه.
Bashcd /opt/grafana docker compose ps docker compose logs -f grafana
بهروزرسانی Grafana
ایمیج از تگ latest استفاده میکند. برای رفتن به آخرین نسخه، ایمیج را دریافت کنید و سپس کانتینر را دوباره بسازید. پیش از یک بهروزرسانی اصلی، از ولوم بکاپ بگیرید. همچنین میتوانید در فایل Compose یک تگ مشخص تعیین کنید تا کنترل نسخهها در دست شما بماند.
Bashcd /opt/grafana docker compose pull docker compose up -d
بکاپگیری از دادهها
ولوم grafana_data شامل پایگاه داده SQLite مربوط به Grafana است، با داشبوردها، کاربران و منابع داده شما. برای یک کپی ساده، یک آرشیو از طریق یک کانتینر موقت کافی است. نام واقعی ولوم با نام پروژه Compose پیشوند میگیرد، آن را با docker volume ls بررسی کنید.
Bashdocker volume ls docker run --rm -v grafana_grafana_data:/data -v $(pwd):/backup alpine tar czf /backup/grafana-backup.tar.gz -C /data .
گواهی و نام دامنه
تا زمانی که Caddyfile از tls internal استفاده میکند، گواهی خودامضا است و مرورگر شما درباره آن هشدار میدهد. اگر دامنهای دارید که رکورد DNS آن به سرور اشاره میکند، Caddy میتواند یک گواهی عمومی دریافت کند، به شرط اینکه پورتهای 80 و 443 در دسترس باشند. میتوانید یک دامنه را در صفحه دامنهها ثبت کنید.

