====== Установка Grafana в Debian ======

Исходные данные
  * Debian 12 (Bookworm)
  * nginx/1.22.1
  * MariaDB 10.11
  * Версия Grafana 10.0.3 (август 2023)

===== Установка =====

Делаем всё [[https://grafana.com/docs/grafana/latest/installation/debian/|по инструкции]] с сайта Grafana

<code bash>
apt-get install -y apt-transport-https
apt-get install -y software-properties-common wget
wget -q -O /usr/share/keyrings/grafana.key https://apt.grafana.com/gpg.key
</code>

Добавляем ([[https://grafana.com/docs/grafana/latest/introduction/oss-details/|OSS]]) репозиторий

<code bash>
echo "deb [signed-by=/usr/share/keyrings/grafana.key] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list
</code>

Устанавливаем

<code bash>
apt-get update
apt-get install grafana
</code>

Смотрим версию Grafana

<code bash>grafana-server -v</code>

===== Настройка =====

Конфигурационный файл ''/etc/grafana/grafana.ini''

Указываем IP и порт

<code bash>
[server]
http_addr = 127.0.0.1
http_port = 3000
</code>

Данные для MySQL

<code bash>
[database]
type = mysql
host = 127.0.0.1:3306
name = grafana
user = grafana
password = CoolPassword1337
</code>

<WRAP tip round box 75%>
//**Обратите внимание**//\\
If the password contains # or ; you have to wrap it with triple quotes. For example """#password;"""
</WRAP>

Отключаем самостоятельную регистрацию пользователей

<code>
[users]
allow_sign_up = false
</code>

===== MySQL =====

<WRAP round info box 75%>
//**По-умолчанию sqlite3**//\\
Grafana by default uses sqlite3 as a local database to hold the configuration information (such as users, dashboards, alerts, etc.). But did you know you can also use other databases for this purpose? [[https://grafana.com/blog/2020/01/13/how-to-migrate-your-configuration-database/|via]]
</WRAP>

Создаём базу и пользователя

<code sql>
mysql -u root -p
create database grafana;
grant all privileges on grafana.* to grafana@localhost identified by "CoolPassword1337";
flush privileges;
exit
</code>

===== PostgreSQL =====

//Для примера//. Создаём базу и пользователя

<code sql>
CREATE DATABASE grafana;
CREATE USER grafana WITH PASSWORD 'CoolPassword1337';
GRANT USAGE ON SCHEMA schema TO grafana;
GRANT SELECT ON schema.table TO grafana;
</code>

<code bash>
[database]
type = postgres
host = 127.0.0.1:5432
name = grafana
user = grafana
password = CoolPassword1337
</code>

===== Проксируем через nginx =====

Создаём файл ''/etc/nginx/sites-available/grafana.conf''

<code>
server {
  listen 80;
  server_name grafana.foobar.com;
  location / {
    return 301 https://grafana.foobar.com$request_uri;
  }
}

server {
  listen 443 ssl;
  server_name grafana.foobar.com;
  access_log /var/log/nginx/grafana.access.log json;
  error_log /var/log/nginx/grafana.error.log;
  
  location / {
   proxy_pass http://127.0.0.1:3000/;
   proxy_set_header Host $host;
   proxy_set_header X-Real-IP $remote_addr;
   proxy_set_header X-Forwarded-Host $host;
   proxy_set_header X-Forwarded-Server $host;
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  }
}
</code>

Делаем symbolic link

<code bash>
ln -s /etc/nginx/sites-available/grafana.conf /etc/nginx/sites-enabled/grafana.conf
</code>

Проверяем конфиг

<code bash># nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
</code>

Перезапускаем nginx

<code bash>
systemctl restart nginx
</code>

Примеры здесь - [[https://grafana.com/tutorials/run-grafana-behind-a-proxy/|Run Grafana behind a reverse proxy]]

===== Проверка =====

Запускаем, смотрим статус, добавляем в автозагрузку

<code bash>
systemctl daemon-reload
systemctl start grafana-server
systemctl status grafana-server
systemctl enable grafana-server.service
</code>

Без nginx Grafana доступна по адресу ''https://IP_ADDRESS:3000''

В нашем случае переходим по адресу https://grafana.foobar.com

{{:linux:grafana:grafana_welcome_1.png?direct|}}

Логин и пароль по-умолчанию **admin/admin**.

{{:linux:grafana:grafana_welcome_2.png?direct|}}

Cбросить пароль admin можно через Grafana CLI
	
<code bash>grafana-cli admin reset-admin-password CoolPassword1337</code>

===== Удалить Grafana =====

Удаляем пакет из системы

<code bash>apt-get --purge remove grafana</code>

Удаляем systemd сервис

<code bash>
systemctl grafana-server stop
systemctl disable grafana-server
systemctl daemon-reload
systemctl reset-failed
</code>

Удаляем GPG key и репозиторий

<code bash>
rm -rf /etc/apt/trusted.gpg.d/grafana.asc
rm -rf /etc/apt/sources.list.d/grafana.list
</code>

Удаляем пользователя Grafana

<code bash>deluser grafana</code>

Удаляем данные, логи и конфигурационные файлы Grafana

<code bash>
rm -rf /var/lib/grafana
rm -rf /var/log/grafana
rm -rf /etc/grafana
rm -rf /run/grafana
</code>

===== Zabbix источник =====

Добавляем Zabbix в качестве источника данных.

Нужен плагин [[https://github.com/alexanderzobnin/grafana-zabbix|Grafana-Zabbix]]

<code bash>
# grafana-cli plugins install alexanderzobnin-zabbix-app
✔ Downloaded and extracted alexanderzobnin-zabbix-app v4.3.1 zip successfully to /var/lib/grafana/plugins/alexanderzobnin-zabbix-app

Please restart Grafana after installing or removing plugins. Refer to Grafana documentation for instructions if necessary.
</code>

Перезапускаем Grafana

<code bash>
systemctl restart grafana-server
</code>

В Grafana: Administration → Plugins

Включаем плагин

{{:linux:grafana:grafana_zabbix_enable.png?direct|}}

Настройка плагина

{{:linux:grafana:grafana_zabbix_configure.png?direct|}}

Немного про плагин. Разрабатывает его Александр Зобнин ([[https://github.com/alexanderzobnin|github]], [[https://twitter.com/alexanderzobnin|twitter]], который внезапно 😱 работает в Grafana Labs.

Документация [[https://alexanderzobnin.github.io/grafana-zabbix/|здесь]].

EOM

{{tag>linux debian grafana zabbix}}