Grafana

קבצים מוכנים להפעלה

רמת תמיכה נתמך

תבנית Compose מהמקורות הרשמיים; עוד לא נבדקה בהרצה.

צור docker-compose

אפשרויות שמשנות משאבים

database

מנוע מסד הנתונים. ‏SQLite (ברירת המחדל) הוא קובץ ב-/var/lib/grafana ומתאים למופעים קטנים; התיעוד לא ממליץ עליו לייצור וקובע שהוא לא מתאים משכבת Medium והלאה. ‏PostgreSQL מוסיף container נפרד.

ברירת מחדל: sqlite

• כשהערך postgres: PostgreSQL +1 vCPU · +1 GiB RAM · +6.5 GiB דיסק [4][11][31][32][33][34][35][36][37]

שדרוג וחזרה לאחור

איך עוברים לגרסה חדשה בבטחה, ואיך חוזרים אחורה אם משהו נכשל.

קודם גיבוי

עצרו את Grafana והעתיקו את ה-volume של /var/lib/grafana ‏(grafana.db וה-plugins); עם database=postgres, קחו pg_dump של מסד הנתונים grafana. שמרו איתו את .env: ‏GRAFANA_SECRET_KEY נחוץ כדי לקרוא את הסודות השמורים של מקורות הנתונים. [10][22]

שלבי השדרוג

1. קראו את מדריך השדרוג ואת ה-breaking changes של כל גרסה שאתם מדלגים עליה. לפני שדרוג major (למשל מ-12.x ל-13), עברו קודם ל-patch האחרון של הקו שלכם ועדכנו את כל ה-plugins, לפי הסדר שבמדריך של v13. [17][18][21]
2. גבו (ראו למטה), הגדירו בקובץ ה-Compose את ה-tag המוצמד החדש grafana/grafana:X.Y.Z, ואז הריצו docker compose pull ו-docker compose up -d. ההגדרות נמצאות במשתני GF_*, ולכן אין ב-container שום דבר שצריך לשמור. [2][20]
3. ‏Grafana מריץ migrations על מסד הנתונים בעלייה (‏13.0 גם מעביר דשבורדים ותיקיות ל-unified storage). עקבו אחרי docker compose logs grafana ו-/api/health, ואז הריצו docker compose exec grafana grafana cli plugins update-all והפעילו מחדש. [9][18][20]

חזרה לאחור

עצרו את Grafana, שחזרו את העותק של /var/lib/grafana מלפני השדרוג (או את ה-pg_dump), הצמידו את ה-tag הקודם והריצו docker compose up -d. אל תפעילו גרסה ישנה על מסד נתונים שעבר migration: אחרי 13.0 היא קוראת טבלאות legacy לא מעודכנות. [18][22]

שינויים שוברים ידועים

• בגרסה 13.1.0: ‏Zipkin הוסר ממקורות הנתונים המובנים, ואימות Azure ו-SigV4 הוסרו ממקור הנתונים המובנה של Prometheus. בדקו את מקורות הנתונים האלה לפני השדרוג. [17]
• בגרסה 13.0.0: דשבורדים ותיקיות עוברים פעם אחת ל-unified storage בעלייה; גרסה ישנה קוראת אחר כך טבלאות לא מעודכנות, ולכן downgrade דורש את הגיבוי מלפני השדרוג. ב-SQLite ה-migration עלול להיתקל ב-'database is locked'; המדריך מפרט הגדרות [unified_storage] למקרה הזה. [18]
• בגרסה 13.0.0: ‏APIs של מקורות נתונים לפי id מספרי כבויים (משתמשים ב-uid), ה-Image Renderer רץ רק כשירות נפרד, ‏grafana-cli ו-grafana-server הוסרו (משתמשים ב-grafana cli וב-grafana server), ו-Elasticsearch יצא ממקורות הנתונים המובנים. [17][18]
• בגרסה 12.4.0: תהליכי plugins כבר לא מקבלים כברירת מחדל את משתני הסביבה של המארח; ‏plugin עם backend שקרא הגדרות מהסביבה צריך לקבל אותן בדרך אחרת. [17]
• בגרסה 12.0.0: התמיכה ב-AngularJS הוסרה, ולכן plugins ופאנלים מבוססי Angular מפסיקים לעבוד; ‏UID של מקור נתונים חייב להתאים לפורמט המתועד; מ-11.x טבלת ה-annotations נכתבת מחדש, וזה דורש פנוי בדיסק פי 2-3 מהגודל שלה. [17][19]

מגבלות

• ‏SQLite (ברירת המחדל) מתאים למופעים קטנים; התיעוד לא ממליץ עליו לייצור וקובע שהוא לא מתאים משכבת Medium והלאה: השתמשו ב-database=postgres. זמינות גבוהה (כמה מופעים ו-session store משותף) לא נכללת בתבנית, והעברת נתונים מ-SQLite למסד אחר בהמשך היא באחריותכם. [11]
• המספרים האלה מכסים רק את שרת Grafana. ל-Prometheus, ל-Loki ולמקורות נתונים אחרים יש sizing משלהם, וה-Image Renderer ‏(כ-1 GB לכל worker, שירות נפרד מאז 13.0) לא נכלל. [11][18]
• בקובץ שנוצר Grafana לא מגיע ל-Prometheus או ל-Loki כמו שהוא: לכל אפליקציה רשת משלה (grafana-internal, ‏prometheus-internal, ‏loki-internal), ושמות נפתרים רק ברשת משותפת. מוסיפים את prometheus-internal ו/או loki-internal לרשתות של השירות grafana, ואז מוסיפים מקורות נתונים ב-Connections > Data sources ככתובות http://prometheus:9090 ו-http://loki:3100. לא localhost, שבתוך ה-container הוא Grafana עצמו. [25][26][27]
• ‏plugins מותקנים בעלייה מ-GF_PLUGINS_PREINSTALL (רשימה מופרדת בפסיקים, plugin@version כדי להצמיד גרסה) לתוך /var/lib/grafana/plugins; ‏GF_INSTALL_PLUGINS מיושן. התבנית לא מגדירה אף אחד, ו-plugin מריץ את הקוד שלו בתוך Grafana. [2][3][7]
• התבנית משתמשת ב-grafana/grafana, מהדורת הקוד הפתוח ברישיון AGPLv3. הדוגמאות בתיעוד משתמשות כברירת מחדל ב-grafana/grafana-enterprise, ‏image נפרד ברישיון אחר שפותח יכולות Enterprise עם מפתח רישיון. [2][3][16]

אבטחה

• חשבון המנהל נוצר מ-GRAFANA_ADMIN_USER ומ-GRAFANA_ADMIN_PASSWORD רק בהפעלה הראשונה; שינוי מאוחר ב-.env לא משפיע. משנים את הסיסמה בממשק, או משחזרים אותה עם docker compose exec grafana grafana cli admin reset-admin-password. [4][24]
• הרשמה עצמית וגישה אנונימית כבויות כברירת מחדל; השאירו אותן כבויות בשרת שנגיש מהאינטרנט. עם גישה אנונימית, כל אחד יכול לראות את רשימת הדשבורדים ומקורות הנתונים ולשלוח שאילתות כלשהן לכל מקור נתונים. [5][23]
• סיסמאות ו-tokens של מקורות נתונים מוצפנים במפתחות שעטופים ב-GF_SECURITY_SECRET_KEY. ברירת המחדל המובנית ציבורית ב-defaults.ini, ולכן התבנית קובעת GRAFANA_SECRET_KEY מ-.env; שינוי שלו בהמשך מחייב הצפנה מחדש של הסודות השמורים. [4][5][10]
• משתמשי Viewer יכולים לשלוח כל שאילתה למקורות הנתונים של הארגון שלהם, וה-data source proxy יכול להגיע לשירותים אחרים ברשת של השרת. תנו למקורות הנתונים פרטי גישה עם הרשאות מינימליות, והגבילו את יעדי ה-proxy עם data_source_proxy_whitelist או חומת אש. [4][23]
• פרטיות: כברירת מחדל Grafana שולח מוני שימוש אנונימיים ל-stats.grafana.org כל 24 שעות ובודק ב-grafana.com אם יש גרסה חדשה כל 10 דקות. האפשרות disable-reporting מכבה את המונים. [4][5]

גיבוי

• גבו את ה-volume של /var/lib/grafana כש-Grafana עצור: ‏grafana.db ‏(SQLite) מחזיק משתמשים, דשבורדים, כללי התראה וסודות מוצפנים של מקורות נתונים, ו-plugins/ מחזיק את ה-plugins המותקנים. עם database=postgres, הוסיפו pg_dump של מסד הנתונים grafana. [3][22]
• שמרו את GRAFANA_SECRET_KEY מ-.env יחד עם הגיבוי (מוצפן, מחוץ לשרת): מסד נתונים משוחזר עם מפתח אחר לא יכול לפענח את הסודות של מקורות הנתונים וההתראות. [10][22]

גרסה אחרונה

הגרסה האחרונה של הפרויקט

Grafana 13.2.4 [14][15]

הפרופיל נבדק מול

Grafana 13.2.4

הפרופיל נבדק מול הגרסה האחרונה.

נבדק ב-

14 באוק׳ 2026

מצב

נבדק ב-90 הימים האחרונים

איפה הגרסאות מתפרסמות

תגיות ב-Docker Hub

הגרסאות האחרונות של כל האפליקציות

גרסה

סטטוס הפרופיל

פורסם

נבדק מול גרסה

Grafana 13.2.4

גרסת הפרופיל

1.0.0

המספרים אומתו

14 באוק׳ 2026

גרסת הקטלוג

2026.10.10

מדיניות sizing

2026.10.0

קובץ Compose

לא אומת

הפרויקט וחלופות

האתר הרשמי

grafana.com/oss/grafana/

קוד מקור

github.com/grafana/grafana

מקורות

1. Docker Docs: Control startup order in Compose (pg_isready healthcheck, service_healthy) (תיעוד רשמי · נקרא 11 באוק׳ 2026)
2. Grafana docs at v13.2.4: Run Grafana Docker image (compose: restart unless-stopped, '3000:3000', named volume at /var/lib/grafana, GF_SERVER_ROOT_URL, GF_PLUGINS_PREINSTALL) (Compose רשמי · נקרא 14 באוק׳ 2026)
3. Grafana docs at v13.2.4: Configure a Grafana Docker image (grafana/grafana is OSS; Alpine recommended; GF_PATHS_DATA /var/lib/grafana; config only through environment variables) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
4. Grafana docs at v13.2.4: Configure Grafana (GF_<SECTION>_<KEY> overrides; root_url, database, max_open_conn, reporting_enabled, admin_password set once on first run, secret_key, cookie_secure) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
5. conf/defaults.ini at v13.2.4: http_port 3000, sqlite3 grafana.db, max_open_conn unset, reporting_enabled true, sign-up and anonymous off, public default secret_key, annotations kept forever (מאגר רשמי · נקרא 14 באוק׳ 2026)
6. Dockerfile at v13.2.4: Alpine image with curl, GF_UID 472 and GF_GID 0, /var/lib/grafana owned by grafana and mode 777, EXPOSE 3000, USER 472, no HEALTHCHECK, no VOLUME (מאגר רשמי · נקרא 14 באוק׳ 2026)
7. packaging/docker/run.sh at v13.2.4: checks that GF_PATHS_DATA is writable, GF_*__FILE secrets, GF_INSTALL_PLUGINS deprecated for GF_PLUGINS_PREINSTALL, exec grafana server with log mode console (מאגר רשמי · נקרא 14 באוק׳ 2026)
8. Registry config of grafana/grafana:13.2.4 (linux/amd64): User 472, ExposedPorts 3000/tcp, no Volumes, no Healthcheck, Entrypoint /run.sh, Alpine 3.24.2 base (מדידה · נקרא 14 באוק׳ 2026)
9. Grafana docs: HTTP API, Other (GET /api/health returns commit, database ok and version) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
10. Grafana docs at v13.2.4: Configure database encryption (data source and notifier secrets encrypted with keys wrapped by secret_key; change it when you set up a new instance) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
11. Grafana docs at v13.2.4: Install Grafana (minimum 512 MB and 1 core; Small/Medium/Large tiers; SQLite not recommended for production; MySQL 8.0+, PostgreSQL 12+) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
12. Docker Hub tag grafana/grafana:13.2.4 (linux/amd64): 482,587,117 B compressed; 11 layers decompressed and counted: 1,426,266,112 B (מדידה · נקרא 14 באוק׳ 2026)
13. Docker: the containerd image store keeps image layers both compressed and uncompressed (תיעוד רשמי · נקרא 14 באוק׳ 2026)
14. Docker Hub tags of grafana/grafana (13.2.4 newest stable on 2026-10-14, pushed 2026-10-13; 13.1.8, 13.0.11 and 12.4.13 are maintained lines; nightly tags are unreleased builds) (מאגר רשמי · נקרא 14 באוק׳ 2026)
15. grafana.com versions API: stable channel 13.2.4, released 2026-10-13, license AGPLv3, not LTS (מאגר רשמי · נקרא 14 באוק׳ 2026)
16. Grafana LICENSE at v13.2.4: GNU Affero General Public License v3 (מאגר רשמי · נקרא 14 באוק׳ 2026)
17. CHANGELOG.md at v13.2.4: breaking changes of 13.1.0 (Zipkin, Prometheus Azure/SigV4 auth), 13.0.0 (Elasticsearch core data source, grafana-cli), 12.4.0 (plugin env) and 12.0.0 (Angular removed) (Release notes · נקרא 14 באוק׳ 2026)
18. Grafana docs at v13.2.4: Upgrade to Grafana v13.0 (unified storage migration, downgrade needs the backup, numeric id data source APIs off, Image Renderer plugin removed) (Release notes · נקרא 14 באוק׳ 2026)
19. Grafana docs at v13.2.4: Upgrade to Grafana v12.0 (data source UID format enforced, stricter plugin version checks, annotation table rewrite from 11.x) (Release notes · נקרא 14 באוק׳ 2026)
20. Grafana docs at v13.2.4: Upgrade guide common tasks (Docker: keep settings in environment variables, pull the new image, recreate the container; then grafana cli plugins update-all) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
21. Grafana docs at v13.2.4: Upgrade strategies (minor release every other month, major once a year, monthly patches for supported versions; 13.3 planned for 2026-10-20) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
22. Grafana docs at v13.2.4: Back up Grafana (plugin data, SQLite grafana.db copied with Grafana stopped, pg_dump for PostgreSQL) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
23. Grafana docs at v13.2.4: Configure security (data source proxy can reach internal services; Viewers can send any query to a data source; risks of anonymous access) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
24. Grafana docs at v13.2.4: Grafana CLI (admin reset-admin-password, plugins install and update-all) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
25. Grafana docs: Configure the Prometheus data source (server URL; in separate containers localhost is the Grafana container, use the Compose service name) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
26. Grafana docs: Configure the Loki data source (built in, base URL only, Loki listens on port 3100 by default) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
27. Docker Docs: Networking in Compose (containers on the same network reach each other by service name; services can join several networks) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
28. Grafana Labs: Grafana Cloud plans (Free, Pro, Enterprise) (תיעוד רשמי · נקרא 14 באוק׳ 2026)
29. docker-library/postgres 18/trixie Dockerfile (postgres user 999:999, VOLUME /var/lib/postgresql) (מאגר רשמי · נקרא 14 באוק׳ 2026)
30. docker-library/postgres 18/trixie docker-entrypoint.sh (chown, then gosu postgres) (מאגר רשמי · נקרא 14 באוק׳ 2026)
31. PostgreSQL 18 documentation: 19.4 Resource Consumption (תיעוד רשמי · נקרא 10 באוק׳ 2026)
32. PostgreSQL 18 documentation: 19.3 Connections and Authentication (תיעוד רשמי · נקרא 10 באוק׳ 2026)
33. PostgreSQL 18 documentation: 19.10 Vacuuming (autovacuum settings) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
34. PostgreSQL 18 documentation: 19.5 Write Ahead Log (max_wal_size) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
35. PostgreSQL 18 documentation: 51.2 How Connections Are Established (תיעוד רשמי · נקרא 10 באוק׳ 2026)
36. Docker Official Image postgres: documentation (docker-library/docs) (תיעוד רשמי · נקרא 10 באוק׳ 2026)
37. Docker Hub: library/postgres tag 18.6 (compressed image sizes) (מאגר רשמי · נקרא 10 באוק׳ 2026)