Liman Uygulama İzleme Eklentisi Kurulumu
Published: 2024-06-14 10:33:56

#Eklenti Kurulum Dokümantasyonu

## İçindekiler
- [Veritabanı Sunucusu Kurulumu](#veritabanı-sunucusu-kurulumu)
  - [PostgreSQL Kurulumu (Varsa Atlayın)](#postgresql-kurulumu-varsa-atlayın)
  - [Veritabanı ve Kullanıcı Oluşturma](#veritabanı-ve-kullanıcı-oluşturma)
- [Backend Servisi Kurulumu](#backend-servisi-kurulumu)
- [Liman Arayüzüne Eklenti Ekleme](#liman-arayüzüne-eklenti-ekleme)
  - [Eklenti Ekleyin](#eklenti-ekleyin)
  - [Eklentinin Sunucuya Eklenmesi](#eklentinin-sunucuya-eklenmesi)
  - [Servis Ekleme](#servis-ekleme)

Bu dökümantasyon, veritabanı sunucusu kurulumu, backend servisi kurulumu, ve Liman arayüzüne eklenti ekleme aşamalarını içermektedir.

##Veritabanı Sunucusu Kurulumu
Veritabanı sunucusunun kurulu olduğu varsayılmaktadır. Eğer PostgreSQL veritabanı sunucusunu henüz kurmadıysanız, aşağıdaki komutlarla kurulum yapabilirsiniz:

### PostgreSQL Kurulumu (Varsa Atlayın)

```bash
sudo apt update
sudo apt install postgresql postgresql-contrib
```

### Veritabanı ve Kullanıcı Oluşturma

- PostgreSQL veritabanı sunucunuza bağlanın:

```bash
sudo -u postgres psql
```

- Veritabanı kullanıcısını oluşturun:

```bash
CREATE USER otel_monitor WITH PASSWORD '1';
```
- Veritabanını oluşturun ve sahibini belirleyin:

```bash
CREATE DATABASE otel_monitor WITH OWNER otel_monitor;
```

> `\q` ile veritabanından çıkış yapabilirsiniz.

# Backend Servisi Kurulumu

- Size verilen "otel-monitor-15-x64.deb" dosyasını sanal makinenize yükleyin ve kurun:

```bash
sudo apt install ./otel-monitor-15-x64.deb
```

- Kurulum dizinine gidin ve gerekli çevre değişkenlerini içeren .env dosyasını oluşturun:

```bash
cd /opt/otel-monitor
sudo nano .env
```

- .env dosyasının içeriğini aşağıdaki gibi doldurun. Burada DB_HOST parametresini, veritabanı sunucunuzun IP adresine veya hostname'ine göre güncelleyin. 

- ELASTICSEARCH_URL parametresini, elasticsearch sunucunuzun IP adresine göre güncelleyin.


```bash
DB_DRIVER="postgres"
DB_HOST="host"
DB_NAME="otel_monitor"
DB_PASS="1"
DB_PORT=5432
DB_USER="otel_monitor"

ELASTICSEARCH_URL=http://<Elasticsearch_URL>
``` 

- Servisi yeniden başlatın:

```bash
sudo systemctl restart otel-monitor
```

> Not: Servisi kurduğunuz sunucuyu Liman Arayüzüne eklemeniz gerekmektedir!

# Liman Arayüzüne Eklenti Ekleme

Liman arayüzüne eklenti eklemek ve eklentiye servis eklemek için aşağıdaki adımları izleyin:

###Eklenti Ekleyin
 1. Liman Arayüzüne giriş yapın.
 2. Menüden "Ayarlar" butonuna tıklayarak genel ayarlara gidin.
 3. Ayarlar sekmesinden "Eklentiler" bölümünü seçin.

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

 - "Yükle" butonuna tıklayın

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


- Size verilen eklenti dosyasını yükleyin.

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

- Eklenti yüklendikten sonra, eklenen eklenti listede görünecektir.

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

### Eklentinin Sunucuya Eklenmesi

1. Sunucunuzu seçin.

2. Sunucunuz için Eklentiler sekmesini seçin.

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

- "Ekle" butonuna tıklayın.


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

- Uygulama izleme eklentisini seçin ve "Ekle" butonuna tıklayın


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


- Eklenti başarıyla eklendiğinde, bunu sunucu eklentileri listesinde görebilirsiniz.

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

- Sunucunuzun alt kısmında eklediğiniz eklentiyi görüntüleyebilirsiniz.

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

###Servis Ekleme

Uygulama izleme eklentisinin yüklü olduğu sunucuyu seçin.

- `Eklentiler` bölümünden `Uygulama İzleme` ve ardından `Servisler` seçeneğine tıklayın.

- `Servis Oluştur` butonuna basın.


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


- Daha önce .env dosyasına eklediğiniz <Elasticsearhc_URL> adreste bir elasticsearch çalıştığını ve izleme verilerini aldığını doğruladıktan sonra. Jaeger ya da Zipkin servisinizde görünen servis ismi ile servis oluşturmanız gerekmektedir.

- Uygulama tipinizi seçin ve bir açıklama girin.

- `Oluştur` butonuna tıklayarak işlemi tamamlayın.


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

- Servisiniz başarıyla eklendi.


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

- Servisinizi seçerek izleme verilerini görebilirsiniz.



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