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 mesajlarını hata günlüğü dosyalarına kaydedecek şekilde yapılandırılır. Ancak, belirli bir hatanın neden oluştuğunu belirlemek için daha fazla bilgi toplamanız gereken birçok durum olabilir. Bunu yapmanın bir yolu, hata ayıklama günlükleri alabilmek için yönlendiriciyi hata ayıklama modunda çalışacak şekilde yapılandırmaktır. Hata ayıklama günlükleri, hata hakkında daha fazla bilgi edinmenize ve hatayı daha hızlı çözmenize yardımcı olabilir.

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. Biçimi bozuk istek gibi sorunlar olduğunda daha fazla bilgi yakalamak için hata ayıklama günlüğü etkinleştirilebilir. 400 Hatalı İstek - SSL Sertifikası Hatası, Northbound (istemci uygulaması ile yönlendirici arasında).

Başlamadan önce

  • NGINX hata günlükleri ve günlük kaydı düzeyleri hakkında bilginiz yoksa 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, Edge yönlendiricilerde hata ayıklama günlüklerinin nasıl etkinleştirileceği açıklanmaktadır.

İlgili sanal ana makine yapılandırma dosyasını belirleme

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ı kullanarak sanal ana makine yapılandırma dosyasını aşağıdaki gibi tanımlayabilirsiniz:

    /opt/nginx/conf.d/ dizinine gidin ve aşağıdaki komutu kullanarak isteğin yapıldığı hostalias öğesini arayı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 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 error;

    to 

    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 hata ayıklama günlüklerini yakalayacak: 
    /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
  6. Hata ayıklama günlüklerini birden fazla yönlendiricide yakalamak istiyorsanız bu adımları her yönlendiricide tekrarlayın.

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

  1. İstemciler, sanal ana makine yapılandırmasıyla ilişkili ana makine takma adı ve bağlantı noktasında API istekleri gönderdikten sonra 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 istekleriyle ilgili hata ayıklama bilgilerini aşağıdaki örnekte gösterildiği gibi 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 bir yükle POST isteği gönderdiğinde yakalanı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 belirtilen tüm adımları doğru şekilde uyguladığınızı doğrulayın. Herhangi bir adımı atladıysanız tüm adımları tekrar doğru şekilde uygulayın.
  4. Hata ayıklama bilgilerini hâlâ alamıyorsanız lütfen Apigee Edge Destek Ekibi ile iletişime geçin.

Yönlendiricideki 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önlendiricide 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;

    to 

    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 yakalayacak: 
    /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
  6. Hata ayıklama günlüklerini birden fazla yönlendiricide durdurmak istiyorsanız bu adımları her yönlendiricide tekrarlayın.

NGINX hata günlük dosyasına yalnızca hata bilgilerinin kaydedildiğini doğrulama

  1. Belirli bir sanal ana makine yapılandırmasıyla ilişkili ana makine takma adı ve bağlantı noktası üzerinde bazı API istekleri gönderin veya istemcilerin istek göndermesini bekleyin.
  2. Aşağıdaki 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 istekler için artık hata ayıklama bilgilerinin kaydedilmediğini doğrulayın.
  4. Hâlâ ek hata ayıklama bilgilerinin kaydedildiğini görüyorsanız Yönlendiricide belirli bir sanal ana makine için hata ayıklama günlüklerini devre dışı bırakma başlıklı makalede belirtilen tüm adımları doğru şekilde uyguladığınızı doğrulayın. Herhangi bir adımı atladıysanız tüm adımları tekrar doğru şekilde uygulayın.
  5. Hata ayıklama bilgilerini hâlâ alamıyorsanız lütfen Apigee Edge Destek Ekibi ile iletişime geçin.