Yönlendiricilerde NGINX hata ayıklama günlüklerini etkinleştirme

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Apigee'de Yönlendiriciler varsayılan olarak yalnızca hata günlük dosyalarındaki hata mesajlarını kaydedecek şekilde yapılandırılır. Ancak belirli bir hatanın nedenini belirlemek için daha fazla bilgi toplamanızın gerekebileceği birçok durum olabilir. Bunu yapmanın yollarından biri, yönlendiriciyi hata ayıklama modunda çalışacak şekilde yapılandırmaktır. Böylece, hata ayıklama günlüklerini alabilirsiniz. Böylece, hatayla ilgili daha fazla bilgi edinebilir ve sorunu daha hızlı çözebilirsiniz.

Bu belgede, belirli bir sanal ana makinedeki istekler için Apigee Edge'in Yönlendiricisinde hata ayıklama günlüklerinin nasıl etkinleştirileceği açıklanmaktadır. Kuzey sınırında (istemci uygulaması ile Yönlendirici arasında) hatalı biçimlendirilmiş istek, 400 Hatalı İstek - SSL Sertifika Hatası gibi herhangi bir sorun olduğunda daha fazla bilgi yakalamak için hata ayıklama günlük kaydı etkinleştirilebilir.

Başlamadan önce

  • NGINX hata günlükleri ve günlük kaydı düzeyleri hakkında bilgi sahibi değilseniz lütfen NGINX hata günlüğü dokümanlarına bakın.
  • Hata ayıklama bilgilerini toplamanız gereken API isteklerinin kuruluş, ortam ve sanal ana makine adlarını toplayın.

Yönlendiricilerde NGINX hata ayıklama günlüklerini etkinleştirme

Bu bölümde, Uç Yönlendiricilerde hata ayıklama günlüklerinin nasıl etkinleştirileceği açıklanmaktadır.

İlgili sanal ana makine yapılandırmaları dosyasını tanımlama

Aşağıdaki adımlarda, ilgili sanal ana makine yapılandırma dosyasının Yönlendiricide nasıl bulunacağı açıklanmaktadır:

  1. Hata ayıklamak istediğiniz belirli API isteği için kuruluş adını, ortam adını ve sanal ana makineyi biliyorsanız sanal ana makine yapılandırma dosyasını aşağıdaki gibi belirleyin:
    1. /opt/nginx/conf.d/ dizinine gidin.
    2. Aşağıdaki komutu kullanarak conf.d dizininde ORG_NAME_ENV_NAME_VIRTUALHOST.conf dosyasını arayın: 
      ls -ltrh | grep "ORG_NAME_ENV_NAME_VIRTUALHOST_NAME"

  2. Kuruluş adını bilmiyorsanız API isteğinde kullanılan ana makine takma adını aşağıdaki şekilde kullanarak sanal ana makine yapılandırma dosyasını tanımlayabilirsiniz:

    /opt/nginx/conf.d/ dizinine gidin ve aşağıdaki komutla isteğin yapıldığı hostalias için arama yapın: 

    ls -ltrh | grep -r 'HOST_ALIAS_NAME'

    Örnek çıkış:

    Ana makine takma adının opdk.cert-test.com olduğunu varsayalım. ls -ltrh komutunu çalıştırdığınızda aşağıdaki çıkışı görürsünüz:

Yönlendiricide belirli bir sanal ana makine için hata ayıklama günlüğünü etkinleştirme

Aşağıdaki adımlarda, belirli bir sanal ana makine için Apigee Yönlendiricilerinde hata ayıklama günlüklerinin nasıl etkinleştirileceği açıklanmaktadır.

  1. Yönlendirici makinesinde şu dosyayı bir düzenleyicide açın: /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf. Örneğin: 
    vi /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf
  2. Aşağıdaki satırı değiştirin: 
    error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log error;

    - 

    error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log info;
  3. Değişikliklerinizi kaydedin.
  4. NGINX yeniden yükleme komutunu çalıştırın. Örneğin: 
    sudo /opt/nginx/scripts/apigee-nginx reload
  5. Aşağıdaki dosya artık debug günlüklerini yakalayacaktır: 
    /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
  6. Birden fazla Yönlendirici'de hata ayıklama günlüklerini kaydetmek istiyorsanız tüm yönlendiricilerde bu adımları tekrarlayın.

Hata ayıklama bilgilerinin doğrulanması, NGINX hata günlüğü dosyasına kaydedilir

  1. İstemciler, sanal ana makine yapılandırmasıyla ilişkili ana makine takma adında ve bağlantı noktasında API İstekleri yaptığında hata ayıklama günlükleri aşağıdaki dosyada yakalanır:

    /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log

  2. API istekleri için aşağıdaki örnekte gösterildiği şekilde hata ayıklama bilgilerini gördüğünüzü doğrulayın:

    Örnek hata ayıklama bilgileri:

    2021/01/27 02:48:40 [warn] 27624#27624: *3777 a client request body is buffered to a temporary file /opt/apigee/var/log/edge-router/nginx/client_temp/0000000001, client: XX.XX.XX.XX, server: XX.XX.XX.XX, request: "POST /post-no-target HTTP/1.1", host: "XX.XX.XX.XX:443"

    Yukarıda gösterilen bilgiler, istemci büyük yükü olan bir POST isteği gönderdiğinde yakalanacaktır. Bu günlük, yalnızca hata ayıklama günlüğü etkinleştirildiğinde gösterilir.

  3. Ek hata ayıklama bilgilerini görmüyorsanız Yönlendiricide belirli bir sanal ana makine için hata ayıklama günlüğünü etkinleştirme bölümünde açıklanan tüm adımları doğru şekilde uyguladığınızdan emin olun. Herhangi bir adımı atladıysanız tüm adımları doğru bir şekilde tekrar edin.
  4. Hata ayıklama bilgilerini hâlâ alamıyorsanız lütfen Apigee Edge Destek Ekibi ile iletişime geçin.

Yönlendiricide belirli bir sanal ana makine için hata ayıklama günlüklerini devre dışı bırakma

Bu bölümde, belirli bir sanal ana makine için Yönlendirici'deki hata ayıklama günlüklerinin nasıl devre dışı bırakılacağı açıklanmaktadır.

  1. Yönlendirici makinesinde aşağıdaki dosyayı bir düzenleyicide açın: /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf Örneğin: 
    vi /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf

  2. Aşağıdaki satırı değiştirin: 

    error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log info;

    - 

    error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log error;
  3. Değişikliklerinizi kaydedin.
  4. NGINX yeniden yükleme komutunu çalıştırın. Örneğin: 
    /opt/nginx/scripts/apigee-nginx reload
  5. Aşağıdaki dosya artık yalnızca hata günlüklerini yakalayacaktır: 
    /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
  6. Birden fazla Yönlendiricide hata ayıklama günlüklerini durdurmak istiyorsanız her bir Yönlendiricide bu adımları tekrarlayın.

NGINX hata günlüğü dosyasına yalnızca hata bilgilerinin kaydedildiğini doğrulama işlemi kaydedilir

  1. Belirli bir sanal ana makine yapılandırmasıyla ilişkili ana makine takma adında ve bağlantı noktasında bazı API istekleri yapın veya istemcilerin istekte bulunmasını bekleyin.
  2. Şu dosyayı kontrol edin: /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
  3. Yalnızca hata bilgilerini gördüğünüzü ve hata ayıklama bilgilerinin artık istekler için günlüğe kaydedilmediğini doğrulayın.
  4. Ek hata ayıklama bilgilerinin günlüğe kaydedildiğini görürseniz Yönlendiricide belirli bir sanal ana makine için hata ayıklama günlüklerini devre dışı bırakma bölümünde açıklanan tüm adımları doğru şekilde uyguladığınızdan emin olun. Herhangi bir adımı atladıysanız tüm adımları doğru bir şekilde tekrar edin.
  5. Hata ayıklama bilgilerini hâlâ alamıyorsanız lütfen Apigee Edge Destek Ekibi ile iletişime geçin.