Beta İzleme Kontrol Paneli Kurulumu

Edge for Private Cloud 4.17.01 sürümü

Sistem gereksinimleri

Kontrol paneli verilerini toplamak için tüm Edge düğümlerine apigee-telegraf yüklemeniz gerekir. Bu nedenle, apigee-telegraf için sistem gereksinimleri, yüklediğiniz Edge düğümüyle aynıdır.

apigee-grafana'yı ayrı bir düğüme yükleyebilir veya Yönetim Sunucusu ya da Edge kullanıcı arayüzü düğümü gibi mevcut Edge düğümlerinden birini yeniden kullanabilirsiniz.

apigee-influxdb'yi, sistem gereksinimlerinde değişiklik yapmadan Yönetim Sunucusu düğümü veya Edge kullanıcı arayüzü düğümü gibi mevcut bir Edge düğümüne yükleyebilirsiniz.

Performans nedeniyle apigee-influxdb'yi kendi düğümüne yüklemeye karar verirseniz düğümün aşağıdaki koşulları karşılaması gerekir:

  • 2 çekirdekli CPU
  • 4 GB RAM
  • 250 GB disk alanı (izleme verileri 1 ay sonra silinir)
  • 1.000 veya daha fazla IOPS

Daha fazla bilgi için InfluxData belgesine bakın.

apigee-influxdb için bağlantı noktası gereksinimleri

apigee-grafana ve apigee-telegraf çalıştıran düğümün erişebilmesi için apigee-influxdb veri düğümlerinde 8086 ve 8183 numaralı bağlantı noktaları açık olmalıdır.

Kontrol paneli bileşenlerini yüklemek için yapılandırma dosyaları

apigee-telegraf ve apigee-grafana bileşenlerini yüklemek için apigee-service yardımcı programına bir yapılandırma dosyası iletirsiniz. Bu dosyaları, "apigee" kullanıcısının erişebileceği bir dizinde (ör. /opt/apigee/customer/application) depolayın ve "apigee" kullanıcısının bu dosyaların sahibi olmasını sağlayın.

apigee-telegraf için yapılandırma parametreleri

Bu özellikleri, apigee-telegraf setup komutuna ilettiğiniz bir metin dosyasında ayarlayın. Örneğin, bunları sa_telegraf.txt adlı bir metin dosyasına kaydedin:

Özellik

Açıklama

INFLUXDB_URL

8086 numaralı bağlantı noktası dahil olmak üzere apigee-influxdb düğümünün URL'sini belirtin.

Örneğin:

http://192.168.0.1:8086

apigee-grafana için yapılandırma parametreleri

Bu özellikleri, apigee-grafana setup komutuna ilettiğiniz bir metin dosyasında ayarlayın. Örneğin, bunları sa_grafana.txt adlı bir metin dosyasına ekleyin:

Özellik

Açıklama

INFLUXDB_HOST

InfluxDB düğümünün IP adresini veya DNS adını belirtin.

Örnek:

192.168.0.1

INFLUXDB_PORT

Grafana veri kaynağı tarafından kullanılan InfluxDB API bağlantı noktası. 8086'yı belirtin.

GRAFANA_USERNAME

Kontrol paneli kullanıcı arayüzüne giriş yapmak için kullanılan Grafana kullanıcı adı.

GRAFANA_PASSWORD

Kontrol paneli kullanıcı arayüzüne giriş yapmak için Grafana şifresi.

Yükleme talimatları

Kontrol paneli bileşenlerini aşağıdaki sırayla yüklemek için aşağıdaki talimatları uygulayın:

  • apigee-influxdb (merkezi bir düğümde)
  • apigee-telegraf (her düğümde)
  • apigee-grafana (merkezi bir sunucuda)

apigee-influxdb'yi tek bir Edge düğümüne veya bağımsız düğüme yükleme

Bağımsız bir düğümde veya Yönetim Sunucusu ya da Edge kullanıcı arayüzünü çalıştıran bir Edge düğümünde:

  1. apigee-influxdb'yi yükleyin:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
  2. apigee-influxdb veritabanını yapılandırın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
  3. apigee-influxdb'yi başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

apigee-telegraf'ı her Edge düğümüne yükleme

Edge kurulumunuzun her düğümünde:

  1. İlk Edge düğümünüze apigee-telegraf'ı yükleyin:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
  2. apigee-telegraf için bir yapılandırma dosyası oluşturun. Genellikle bu dosyayı "apigee" kullanıcısının erişebileceği bir dizinde (ör. /opt/apigee/customer/application) saklar ve "apigee" kullanıcısına ait olmasını sağlarsınız.

    8086 numaralı bağlantı noktası dahil olmak üzere apigee-influxdb düğümünün URL'sini belirtmek için dosyada aşağıdaki özelliği ayarlayın:
    INFLUXDB_URL=http://influx_IP:8086
  3. Sahibi "apigee" olarak değiştirin:
    > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
  4. apigee-telegraf'ı yapılandırın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
  5. apigee-telegraf'ı yeniden başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  6. Bu işlemi tüm Edge düğümlerinde tekrarlayın.

apigee-grafana'yı tek bir Edge düğümüne yükleme

Edge kurulumunuzun tek bir düğümünde (ör. Edge kullanıcı arayüzü düğümü):

  1. İlk Edge düğümünüze apigee-grafana'yı yükleyin:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
  2. apigee-grafana için bir yapılandırma dosyası oluşturun. Genellikle bu dosyayı, "apigee" kullanıcısının erişebileceği bir dizinde (ör. /opt/apigee/customer/application) saklar ve "apigee" kullanıcısına ait olmasını sağlarsınız.

    Dosyada aşağıdaki özellikleri ayarlayın. Bu özellikler yukarıda açıklanmıştır:
    INFLUXDB_HOST=192.168.56.101
    INFLUXDB_PORT=8086
    GRAFANA_USERNAME=admin
    GRAFANA_PASSWORD=admin
  3. Sahibi "apigee" olarak değiştirin:
    > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
  4. Yapılandırma dosyasını kullanarak apigee-grafana'yı yapılandırın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
  5. apigee-grafana'yı yeniden başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

Kontrol paneline erişmek için aşağıdaki URL'yi bir tarayıcıda açın:

http://grafana_IP_or_DNS:3000

apigee-grafana için yapılandırma dosyasında belirttiğiniz kimlik bilgilerini kullanarak giriş yapın. Yukarıdaki örnekte kullanıcı adı/şifre admin/admin şeklindedir.

Yükleme sorunlarını giderme

Kontrol panelinde veri görmüyorsanız yükleme işleminizle ilgili sorunları gidermek için aşağıdaki prosedürü uygulayın:

  1. apigee-telegraf'ın verileri topladığından emin olmak için
    1. apigee-service apigee-telegraf setup komutunu çalıştırın. Bu komut, idempotenttir. Hataları ve eksik bağımlılıkları kontrol edip çözün.
    2. apigee-telegraf'ı yeniden başlatın ve hata olup olmadığını görmek için /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log dosyasını kontrol edin.
  2. apigee-influxdb'nin veri aldığından emin olmak için:
    1. apigee-influxdb veri düğümlerinde şu TCP bağlantı noktalarının açık olduğundan emin olun: 8086 ve 8183.
    2. Influxdb kullanıcı arayüzünü bir tarayıcıda açmak için aşağıdaki URL'yi kullanın:
      http://influxdb_IP_or_DNS:8183
      1. Sorgu alanına "show databases" yazın.
        Şu veritabanlarının oluşturulduğundan emin olun: system, application, events, _internal.
      2. Sorgu alanına "show servers" yazın.
        apigee-influxdb düğümlerinin listelendiğinden emin olun.
  3. Kontrol panelindeki veri kaynaklarını kontrol edin:
    1. Ana menüden Veri Kaynakları'nı seçin. Üç veri kaynağının simgelerini göreceksiniz.
    2. Her veri kaynağı için simgeyi seçin.
    3. Veri kaynağının ayrıntılar sayfasında Kaydet ve Test Et düğmesini seçin.
    4. Veri kaynağı doğru şekilde yapılandırılmışsa şu biçimde bir mesaj görürsünüz:
      Başarılı
      Veri kaynağı çalışıyor

Beta izleme kontrol panelini güncelleme

Apigee İzleme Kontrol Paneli'nin beta sürümünü 4.16.09'da yüklediyseniz 4.17.01 için beta sürümüne güncelleyebilirsiniz.

Kontrol paneli bileşenlerini aşağıdaki sırayla güncellemeniz gerekir:

  • apigee-influxdb
  • Her düğümde apigee-telegraf
  • apigee-grafana

Beta izleme kontrol panelini güncellemek için:

  1. Edge'i, Apigee Edge 4.16.01/4.16.05'i 4.17.01'e güncelleme ve Apigee Edge 4.16.09'u 4.17.01'e güncelleme bölümlerinde açıklandığı şekilde 4.17.01'e güncelleyin.
  2. apigee-influxdb'yi güncelleyin:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb restart
  3. Düğüm 1'de apigee-telegraf'ı güncelleyin:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  4. Her düğüm için 3. adımı tekrarlayın.
  5. apigee-grafana'yı güncelleyin:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart