{"canonical_url":"https://engineer.company/uk/glossary/grafana/","content_markdown":"# Grafana\n\n## Що це таке\n\nGrafana перетворює числа, що зберігаються в інших системах, на дашборди. Вона\nнадсилає запит до джерела даних — Prometheus, Loki, PostgreSQL чи MySQL, —\nмалює відповідь як графік часового ряду, таблицю, шкалу чи теплову карту і\nнадсилає сповіщення, коли значення перетинає поріг, який хтось задав. Власна\nдокументація описує Grafana як засіб, що дає змогу робити запити, візуалізувати,\nсповіщати й досліджувати метрики, журнали й трасування, хоч би де вони\nзберігалися, і саме на цих останніх словах тримається весь її задум.\n\nТе, що видно на екрані, лишається там, де його зібрали. Кожна панель забирає\nсвій зріз із джерела даних, коли дашборд завантажується чи оновлюється, через\nодин із понад 150 плагінів джерел даних, а сама Grafana зберігає лише власну\nконфігурацію: дашборди, теки, користувачів, права доступу й правила сповіщень.\nУсе це лежить у невеликій базі даних. За замовчуванням це SQLite, вбудована в\nсам виконуваний файл, а для продакшну рекомендують MySQL або PostgreSQL. Кожен\nдашборд є JSON-документом: панелі, розкладені рядами, де кожна панель — це\nзапит плюс спосіб його показати, і змінні вгорі, що дають одному дашборду\nперемикатися між хостами, середовищами чи сервісами зі спадного списку.\n\nGrafana розробляє компанія Grafana Labs, а поряд із нею — Loki для журналів,\nTempo для трасувань і Mimir для довгого зберігання даних Prometheus; цей набір\nчасто називають стеком Grafana. 20 квітня 2021 року Grafana, Loki і Tempo\nперейшли з ліцензії Apache 2.0 на AGPLv3. Grafana існує як версія з відкритим\nкодом, як Grafana Enterprise за комерційною ліцензією і як Grafana Cloud, яку\nрозміщує й обслуговує сама Grafana Labs.\n\nЇї зазвичай порівнюють із Kibana, що відіграє ту саму роль перед Elasticsearch,\nіз вбудованим у Prometheus переглядачем виразів і з хмарними\nobservability-сервісами, які продають зберігання й екрани як один продукт.\nBI-інструменти на кшталт Metabase чи Power BI можуть читати ті самі бази даних,\nале вони створені для звітів, які людина уважно вивчає, а Grafana — для екранів,\nщо оновлюються кожні кілька секунд.\n\n## Чому це важливо\n\nВстановити Grafana — найпростіша частина. Вона працює на невеликій машині, і її\nможна націлити на базу даних, яка в команди вже є. Рішення, від яких залежить її\nцінність, приходять згодом: для кого кожен екран, як тримати лад у дашбордах,\nколи їх уже десятки, і де все це працюватиме.\n\nОскільки Grafana лише показує, її впровадження не переносить даних. Команда може\nзалишити Prometheus, PostgreSQL і своє сховище журналів там, де вони є, і згодом\nзамінити шар відображення, не мігруючи жодного ряду, тож і прив'язка до\nпостачальника, і рахунок лишаються на боці джерел даних. Сервіси, що продають\nзберігання й відображення разом, пропонують зворотний обмін: один рахунок і один\nвхід, а дані важче забрати деінде.\n\nАудиторія формує дашборд сильніше, ніж інструмент. Інженерові на чергуванні\nпотрібна сторінка, що з першого погляду відповідає на питання «чи щось зламалося\nі де», з посиланнями на подробиці. Кімнаті людей із різними обов'язками потрібно\nменше панелей, але більших, прості заголовки й порогова лінія, яка підказує,\nколи час хвилюватися. Та сама Grafana обслуговує обидві аудиторії різними\nдашбордами, а сторінка, зроблена для обох одразу, зазвичай не влаштовує\nжодну.\n\nЯк зберігати дашборди — друге рішення. Grafana вміє завантажувати їх із\nJSON-файлів на диску й стежити за змінами в теці; документація називає це\nprovisioning. У системі контролю версій дашборд отримує рев'ю, історію і шлях\nназад, а нове середовище отримує ті самі екрани без того, щоб хтось збирав їх\nкліками. Ціна в тому, що редагування в браузері перестає бути способом вносити\nзміни, і з цим має погодитися вся команда.\n\nЛіцензія й розміщення — наостанок. За AGPLv3 той, хто змінює Grafana і дає іншим\nкористуватися зміненою версією через мережу, мусить запропонувати їм її вихідний\nкод. Команда, що запускає незмінену Grafana для власних працівників, перебуває\nзовсім в іншому становищі, ніж постачальник, який вбудовує доопрацьовану версію\nу свій продукт, і такому постачальникові варто прочитати ліцензію разом із\nюристом. Самостійне розміщення — це один виконуваний файл, доки не знадобиться\nдругий інстанс. Відтоді інстанси ділять спільну базу MySQL чи PostgreSQL, а\nGrafana Cloud — спосіб передати цю роботу Grafana Labs.\n\n## Як це виглядає на практиці\n\nОбидва рази, коли Grafana з'являється в роботі компанії, вона — та частина, на\nяку дивилися люди, а за нею стоїть Prometheus.\n\nУ 2022–2024 роках, на інфраструктурній посаді, вихідною точкою була команда, яка\nпомічала проблеми вже після того, як вони зачіпали користувачів, бо єдиного\nогляду стану систем не існувало.\n[Дашборд моніторингу на Grafana і Prometheus](/uk/portfolio/cut-operational-risk-with-grafana-and-prometheus/)\nдав такий огляд. Ключові сервіси інструментували, метрики обирали за те, що\nвони щось означають, а не просто створюють враження активності, а порогові значення\nсповіщень налаштували на цих метриках і вивели туди, де команда справді їх\nбачила, поки ще був час діяти. Проблеми почали виловлювати до того, як вони\nрозросталися, надійність зросла, а команда перейшла від гасіння пожеж до роботи\nна випередження.\n\nДругий випадок будували для змішаної аудиторії.\n[Дашборд на великому телевізорі в офісі](/uk/portfolio/built-the-companys-first-observability-dashboard/)\nпризначався і для технічних, і для нетехнічних колег. Його друга версія, на\nGrafana і Prometheus, показувала метрики, обрані разом із командами DevOps та\nрозробки; їх подавали пайплайни даних, що збирали показники продуктивності з\nкількох систем, а в разі перевищення порогу надходили сповіщення. Команди почали\nвиявляти й усувати інциденти на 40% швидше, а з числами перед очима всього\nофісу стан систем став спільною відповідальністю.\n\nТакий настінний екран читають із протилежного кінця кімнати люди, які ніколи не\nредагуватимуть запит. На ньому найкраще працюють кілька великих панелей, одиниці виміру в\nзаголовках і кольори, що змінюються лише тоді, коли комусь час діяти, і кожен із\nцих виборів Grafana залишає тому, хто будує дашборд.\n\n## Де виникають проблеми\n\n**Дашборд розростається, доки його ніхто не читає.** Кожен інцидент додає\nпанель, а прибирати їх ніхто не береться, тож за рік на сторінці сорок дрібних\nграфіків, а той, що важить, опиняється далеко внизу, куди ніхто не гортає.\nДайте кожному дашборду одну аудиторію й одне питання, відповідь на «чи все\nгаразд» покладіть у верхній ряд, а подробиці перенесіть у дашборди, на які\nзвідти ведуть посилання. Панель, яку ніхто в команді не може пояснити, — це\nпанель, яку час видалити.\n\n**Виправлення, зроблене в браузері, зникає.** Дашборд надходить із файлу через\nprovisioning. Коли `allowUiUpdates` має значення за замовчуванням false, Grafana\nвідмовляється зберігати й показує діалог «Cannot save provisioned dashboard».\nЯкщо ж там true, Grafana зберігає зміну у своїй базі, а потім перезаписує її\nвмістом файлу, щойно той зміниться. Редагуйте файл або експортуйте JSON із\nдіалогу збереження й додайте його в репозиторій, а налаштування провайдера\nпропишіть явно:\n\n```yaml\napiVersion: 1\nproviders:\n    - name: operations\n      type: file\n      allowUiUpdates: false\n      options:\n          path: /var/lib/grafana/dashboards\n```\n\n**Настінний екран сповільнює систему, за якою стежить.** Кожен відкритий\nбраузер, телевізор теж, заново виконує запит кожної панелі під час кожного\nоновлення, а п'ять секунд — найкоротший інтервал оновлення, який Grafana\nдозволяє за замовчуванням. Двадцять панелей із п'ятисекундним оновленням — це\nчотири запити на секунду від одного екрана. Оновлюйте в темпі, в якому\nзмінюються дані (для Prometheus це інтервал опитування або довше), підніміть\nмінімум для всіх і заздалегідь обчислюйте важкі вирази правилами запису\n(recording rules) у джерелі даних:\n\n```ini\n[dashboards]\nmin_refresh_interval = 30s\n```\n\n**Той самий інцидент піднімає людей двічі.** Правило живе в Prometheus і йде\nчерез Alertmanager, а ще раз — у Grafana Alerting. Або два інстанси Grafana\nкожен окремо обчислюють усі правила, бо про сповіщення забули, коли додавали\nдругий. Дайте кожному правилу одне місце й пройдіть кроки Grafana з високої\nдоступності для сповіщень, перш ніж другий інстанс запрацює.\n\n**Дашборди й користувачі змінюються залежно від того, який сервер відповів.**\nДва інстанси Grafana за балансувальником навантаження мають кожен свій файл\nSQLite, тож дашборд, збережений на одному, відсутній на другому, а користувач\nіснує лише на одному з них. Власна інструкція Grafana робить спільну базу MySQL\nчи PostgreSQL обов'язковою умовою високої доступності.\n\n## Що почитати далі\n\n- [About Grafana](https://grafana.com/docs/grafana/latest/introduction/) —\n  власний огляд проєкту: що робить Grafana, які в неї редакції і які проєкти з\n  відкритим кодом її оточують.\n- [Data sources](https://grafana.com/docs/grafana/latest/datasources/) —\n  системи, до яких Grafana може робити запити, і як кожну з них додати та\n  налаштувати.\n- [Dashboards](https://grafana.com/docs/grafana/latest/visualizations/dashboards/)\n  — панелі, ряди, змінні та JSON-модель, у якій зберігається дашборд.\n- [Provision Grafana](https://grafana.com/docs/grafana/latest/administration/provisioning/)\n  — джерела даних і дашборди з файлів і що стається зі змінами, зробленими в\n  браузері.\n- [Set up Grafana for high availability](https://grafana.com/docs/grafana/latest/setup-grafana/set-up-for-high-availability/)\n  — спільна база даних, потрібна другому інстансу, і додаткові кроки для\n  сповіщень.\n- [Licensing](https://grafana.com/licensing/) — сторінка Grafana Labs про\n  перехід з Apache 2.0 на AGPLv3 у 2021 році.\n\n\u003chttps://engineer.company/uk/glossary/grafana/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Звідки Grafana бере дані, чому дашборди варто тримати в системі контролю версій, чого вимагає AGPLv3 і як один настінний екран сповільнює систему.","formats":{"gemtext":"https://engineer.company/uk/glossary/grafana/index.gmi","gopher":"https://engineer.company/uk/glossary/grafana/gophermap","html":"https://engineer.company/uk/glossary/grafana/","json":"https://engineer.company/uk/glossary/grafana/index.json","markdown":"https://engineer.company/uk/glossary/grafana/index.md","pdf":"https://engineer.company/uk/glossary/grafana/index.pdf"},"kind":"page","language":"uk","title":"Що таке Grafana?","url":"https://engineer.company/uk/glossary/grafana/","version":1}