Docker Compose ile Grafana Kurulumu
Tags: grafana, snmp, docker
Published: 2023-04-07 06:58:51

**:bangbang:** İlgili makinede prometheus kurulu varsayılarak anlatım gerçekleştirilmiştir. Eğer kurulu değilse, ilk adım olarak kurulumlarını gerçekleştirmeniz gerekmektedir. [Bu](https://dev.to/aciklab/docker-compose-ile-prometheus-kurulumu-5dpg) kaynaktan yararlanılabilir.

##**1. Grafana Nedir?**

Grafana, veri görselleştirme ve analizi yapmak için kullanılan açık kaynaklı bir platformdur. Grafana, verilerinizi Prometheus da dahil olmak üzere birçok farklı veri kaynağından alabilir ve bu verileri gerçek zamanlı olarak görselleştirerek kullanıcıların daha iyi bir görünürlük ve anlayış elde etmelerine yardımcı olur.

Grafana, sistem yöneticileri, veri bilimcileri, iş zekası uzmanları ve diğer teknik kullanıcılar gibi farklı kullanıcı grupları tarafından kullanılabilir.


##**2. Konfigürasyon**

**2.1 grafana/config.monitoring**

Prometheus kurulumu sonrası bir başlangıç şifresi belirleyecek ve yeni kullanıcıların kaydolmasını önleyecek bir Grafana yapılandırılması yapılır.

- İlk olarak şu komut ile ana dizinde _grafana_ isimli bir dosya oluşturulur:

```bash
 mkdir grafana
```
- Daha sonra config.monitoring isimli dosyanın içine girilir:

```bash
 nano config.monitoring
```
- Açılan dosyanın içine şu satırlar eklenir ve kaydedilip çıkılır:

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/0ui7889jz40yknge89eh.png)

**2.2 Docker Compose: docker-compose.yml**

- İlk olarak ana dizine gidiyoruz:

```bash
 cd ..
```

- Daha sonra docker-compose.yml dosyasının içine giriyoruz:

```bash
 nano docker-compose.yml
```

- Grafana için gerekli olan satırları ve path'leri ekliyoruz, ardından kaydedip çıkıyoruz:

```
   grafana:
    image: grafana/grafana
    user: "472"
    depends_on:
      - prometheus
    ports:
      - 3000:3000
    volumes:
      - grafana_data:/var/lib/grafana
      - ./grafana/provisioning/:/etc/grafana/provisioning/
    env_file:
      - ./grafana/config.monitoring
    networks:
      - back-tier
      - front-tier
    restart: always
```
docker-compose dosyası yerel /grafana/provisioning dizinini Grafana konteynırının /etc/grafana/provising dizinine monte ediyor.

**2.3 <u>Datasource Konfigürasyonu:</u> grafana/provisioning/datasources/datasource.yml**

- Ardından prometheus veri kaynağını yapılandırılır.

- grafana dizinine gidilir ve _provisioning_ ve _datasources _isimli dosyalar oluşturulur:

```bash
 cd grafana
```

```bash
 mkdir -p provisioning/datasources
```

- Daha sonra şu komut ile /grafana/provisioning/datasources/datasource.yml dosyasının içine girilir:

```bash
 nano /grafana/provisioning/datasources/datasource.yml
```

- Aşağıdaki bilgiler dosyaya girilir, kaydedilip çıkılır:

```
 # config file version
apiVersion: 1

# list of datasources that should be deleted from the database
deleteDatasources:
  - name: Prometheus
    orgId: 1

# list of datasources to insert/update depending
# whats available in the database
datasources:
  # <string, required> name of the datasource. Required
- name: Prometheus
  # <string, required> datasource type. Required
  type: prometheus
  # <string, required> access mode. direct or proxy. Required
  access: proxy
  # <int> org id. will default to orgId 1 if not specified
  orgId: 1
  # <string> url
  url: http://prometheus:9090
  # <string> database password, if used
  password:
  # <string> database user, if used
  user:
  # <string> database name, if used
  database:
  # <bool> enable/disable basic auth
  basicAuth: false
  # <string> basic auth username, if used
  basicAuthUser:
  # <string> basic auth password, if used
  basicAuthPassword:
  # <bool> enable/disable with credentials headers
  withCredentials:
  # <bool> mark as default datasource. Max one per org
  isDefault: true
  # <map> fields that will be converted to json and stored in json_data
  jsonData:
     graphiteVersion: "1.1"
     tlsAuth: false
     tlsAuthWithCACert: false
  # <string> json object of data that will be encrypted.
  secureJsonData:
    tlsCACert: "..."
    tlsClientCert: "..."
    tlsClientKey: "..."
  version: 1
  # <bool> allow users to edit datasources from the UI.
  editable: true
```

**2.4 <u>Dashboard Konfigürasyonu:</u> grafana/provisioning/dashboards/dashboard.yml**

- Veri kaynağı kullanılabilir olduğunda, panolar sağlanabilir.

- Grafana herhangi bir yapılandırma dosyası olmadan çalışabilir. Ancak, Prometheus'u bir veri kaynağı olarak yapılandırmak için grafana/provisioning/datasources/datasource.yml oluşturulur.

- grafana dizinine gidilir ve _dasboards _isimli dosya oluşturulur:

```bash
 cd grafana
```

```bash
 mkdir provisioning/dashboards
```

- Daha sonra şu komut ile /grafana/provisioning/dashboards/dashboard.yml dosyasının içine girilir:

```bash
 nano /grafana/provisioning/dashboards/dashboard.yml
```

- Bu yapılandırma dosyasında, içe aktarmak için kullanılan panoların yolunu gösteriyoruz.

- Aşağıdaki bilgiler dosyaya girilir, kaydedilip çıkılır:

```
apiVersion: 1

providers:
- name: 'Prometheus'
  orgId: 1
  folder: ''
  type: file
  disableDeletion: false
  editable: true
  options:
    path: /etc/grafana/provisioning/dashboards
```

##**3. Grafana Başlat**

- Son olarak dosyalarda değişiklikler olduğu için docker-compose down edilir:

```bash
 docker-compose down
```
- Tekrar up edilir ve Grafana'nın da UP olduğu gözlemlenir:

```bash
 docker-compose up -d
```
- Ardından tarayıcıya "http://IP:3000" girilir ve Grafana arayüzüne erişilir:

> Grafana yüklü olan makinenin IP'si girilir.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/lsnqdjuprwdcu92u4doy.png)

> **username =** admin
> **password =** foobar (Şifre `/grafana/config.monitoring` env dosyasında yazılı)

- Kullanıcı adı ve şifre girildikten sonra giriş başarılı şekilde yapılır:


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/d3ewwgrdn01gxsiuhoux.png)

- Örnek olarak, tarayıcıya "http://IP:3000/dashboard" yolu girilir ve çıkan ekranda **New Dashboard** butonuna tıklanarak data source olarak Prometheus seçilir. Daha sonra SNMP metirkleri seçilip görselleştirilir:


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/7hlenxzsvx8qfv54yadv.png)

- Sayfanın sol üstünde bulunan **Apply** butonuna tıklanır ve dashboard eklenir:


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ptx7asl14c50wbun2frq.png)