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

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Apigee'de Yönlendiriciler yalnızca hata günlüğü dosyalarındaki hata mesajlarını günlüğe kaydedecek şekilde yapılandırılır. varsayılandır. Ancak ulaşmak için daha fazla bilgi toplamanızı gerektiren birçok durum olabilir. belirli bir hatanın neden oluştuğunu belirleyebilirsiniz. Bunu yapmanın yollarından biri yönlendiriciyi hata ayıklama modunda çalışmanızı sağlar. Bu şekilde hata ayıklama günlüklerini alabilirsiniz. Bu da daha fazla bilgi edinmenize yardımcı olur ve daha hızlı çözmenizi sağlar.

Bu dokümanda, Apigee Edge'in Yönlendiricisinde hata ayıklama günlüklerinin anlamına gelir. Hata ayıklama günlük kaydı, herhangi bir sorun olduğunda daha fazla bilgi yakalamak için etkinleştirilebilir. hatalı biçimlendirilmiş istek, 400 Hatalı İstek - SSL Sertifika Hatası, Kuzeye (İstemci 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 şuraya bakın: NGINX hata günlüğü dokümanları.
  • Bu API istekleri için kuruluş, ortam ve sanal ana makine adlarını toplayın. hata ayıklama bilgilerini toplamanız gerekir.

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ı belirleme

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

  1. İlgili API'nin kuruluş adını, ortam adını ve sanal ana makinesini biliyorsanız hata ayıklamak istediğiniz bir istek seçin, sanal ana makine konfigürasyon dosyasını aşağıdaki şekilde belirleyin:
    1. /opt/nginx/conf.d/ dizinine gidin.
    2. ORG_NAME_ENV_NAME_VIRTUALHOST.conf dosyasını ara dosyasını conf.d dizininde bulabilirsiniz: 
      ls -ltrh | grep "ORG_NAME_ENV_NAME_VIRTUALHOST_NAME"

  2. Kuruluş adını bilmiyorsanız sanal ana makine yapılandırmasını tanımlayabilirsiniz. dosyası oluşturun:

    /opt/nginx/conf.d/ dizinine gidin ve şunu arayın: Aşağıdaki komut kullanılarak isteğin yapıldığı hostalias: 

    ls -ltrh | grep -r 'HOST_ALIAS_NAME'

    Örnek çıkış:

    Barındırıcı takma adının opdk.cert-test.com olduğunu varsayalım. ls -ltrh komutunu kullandığınızda çıkışı aşağıda gösterildiği gibi görürsünüz:

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

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

  1. Yönlendirici makinesinde şu dosyayı bir düzenleyicide açın: /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf Örnek: 
    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. Örnek: 
    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. Hata ayıklama günlüklerini birden fazla Yönlendiricide yakalamak istiyorsanız her yönlendiricide bu adımları tekrar edin: yönlendiriciler.

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

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

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

  2. Aşağıdaki örnekte gösterildiği gibi, API istekleri için 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 tarafından POST isteği gönderildiğinde yakalanacak. sahip olabilir. Bu günlük, yalnızca hata ayıklama günlüğü etkinleştirildiğinde gösterilir.

  3. Ek hata ayıklama bilgileri görmüyorsanız konusunda özetlenen adımlar Yönlendirici üzerindeki belirli bir sanal ana makine için hata ayıklama günlük kaydının doğru şekilde etkinleştirilmesi. Mevcut herhangi bir adımı kaçırdıysanız tüm adımları doğru şekilde tekrarlayın.
  4. Hata ayıklama bilgilerini yine de alamıyorsanız lütfen Apigee Edge Destek Ekibi ile iletişime geçin.

Yönlendirici üzerindeki 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 şu dosyayı bir düzenleyicide açın: /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf. Örnek: 
    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. Örnek: 
    /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. Hata ayıklama günlüklerini birden fazla yönlendiricide durdurmak istiyorsanız yönlendiricinin her bir yönlendiricisinde bu adımları Yönlendiriciler.

NGINX hata günlük dosyasına yalnızca hata bilgilerinin doğrulanması giriliyor

  1. Belirli bir sanal ana makineyle ilişkili ana makine takma adı ve bağlantı noktasında bazı API isteklerinde bulunma yapılandırma veya istemcilerin istekte bulunmasını 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 hata ayıklama bilgilerinin artık görünmediğini doğrulayın. günlüğe kaydedilir.
  4. Hâlâ ek hata ayıklama bilgilerinin günlüğe kaydedildiğini görüyorsanız başlıklı makalede özetlenen tüm adımları uygulayın: Yönlendirici üzerindeki belirli bir sanal ana makine için hata ayıklama günlükleri doğru şekilde devre dışı bırakılıyor. Mevcut herhangi bir adımı kaçırdıysanız tüm adımları doğru şekilde tekrarlayın.
  5. Hata ayıklama bilgilerini yine de alamazsanız lütfen Apigee Edge Desteği.