Apigee ile ilgili bilinen sorunlar

LookupCache politikasından sonra cachehit akış değişkeni kullanıldığında, hata ayıklama noktalarının eşzamansız davranış için dağıtılma şeklinden dolayı LookupPolicy, geri çağırma yürütülmeden önce DebugInfo nesnesini doldurur ve hataya neden olur.

Geçici çözüm: İlk aramadan hemen sonra işlemi tekrar edin (ikinci çağrıyı yapın).

InValidateCache politikasında PurgeChildEntries politikası ayarlanırsa yalnızca KeyFragment öğesi değerleri kalıcı olarak silinir ancak önbelleğin tamamı temizlenir.

Geçici çözüm: Önbellek sürümü oluşturmayı yinelemek ve önbelleği geçersiz kılma ihtiyacını atlamak için KeyValueMapTransactions politikasını kullanın.

• Apigee Edge, özellik düzenleyicisini kullanarak spesifikasyonlar oluştururken ve portalınızda SmartDokümanlar'ı kullanarak API'ler yayınladığınızda OpenAPI Specification 3.0'ı destekler. Bununla birlikte, özelliklerin bir kısmı henüz desteklenmemektedir.

  Örneğin, OpenAPI Specification 3.0'da yer alan aşağıdaki özellikler henüz desteklenmemektedir:

  • Şemaları birleştirmek ve genişletmek için allOf özellik
  • Uzak referanslar

  OpenAPI Spesifikasyonu'nda desteklenmeyen bir özelliğe referans veriliyorsa bazı durumlarda araçlar bu özelliği yoksayar ancak yine de API referans belgelerini oluşturur. Diğer durumlarda, desteklenmeyen bir özellik, API referans belgelerinin başarılı bir şekilde oluşturulmasını engelleyen hatalara neden olur. Her iki durumda da, gelecekteki bir sürümde desteklenene kadar desteklenmeyen özelliğin kullanılmasını önlemek için OpenAPI Spesifikasyonunuzu değiştirmeniz gerekir.

  Not: API referans belgelerini oluştururken spesifikasyon düzenleyici, SmartDokümanlar'dan daha az kısıtlayıcı olduğundan araçlar arasında farklı sonuçlarla karşılaşabilirsiniz.

• Portalda Experiment this API'yi kullanırken, OpenAPI Specification'da consumes için ayarlanan değerden bağımsız olarak Accept başlığı application/json olarak ayarlanır.

• Birden fazla kullanıcı tarafından eş zamanlı portal güncellemeleri (sayfa, tema, CSS veya komut dosyası düzenlemeleri gibi) şu anda desteklenmemektedir.
• Portaldan API referans belgeleri sayfasını silerseniz bu sayfayı yeniden oluşturmanız mümkün değildir. API ürününü silip yeniden eklemeniz ve API referans belgelerini yeniden oluşturmanız gerekir.
• İçerik güvenliği politikası yapılandırılırken değişikliklerin tam olarak uygulanması 15 dakika kadar sürebilir.
• Portal temanızı özelleştirirken değişikliklerin tam olarak uygulanması 5 dakikayı bulabilir.

• Gelecekteki bir sürümde Arama, entegre portala entegre edilecektir.

Bu sorun yalnızca MINT kullanan veya Private Cloud yüklemeleri için Edge'de MINT'i etkinleştirmiş olan kullanıcıları etkiler.

Etkilenen bileşen: Edge-message-processor

Sorun: Para kazanma özelliği etkinse ve 4.52.01 sürümünü yeni yükleme olarak ya da önceki Private Cloud sürümlerinden yükseltme yapıyorsanız mesaj işlemcileriyle ilgili bir sorunla karşılaşırsınız. Açık iş parçacığı sayısında kademeli bir artış yaşanacak ve bu da kaynakların tükenmesine neden olacak. Aşağıdaki istisna, Edge-message-processor system.log dosyasında görülür:

Error injecting constructor, java.lang.OutOfMemoryError: unable to create new native thread

Yakın zamanda birden fazla sitede Hizmet Reddi (DoS) güvenlik açığı tespit edildi dahil olmak üzere, Private Cloud'a gidin. Güvenlik açığı, Apigee API yönetim işlevi DoS'ına yol açabilir. Daha ayrıntılı bilgi için Apigee Güvenlik Bülteni GCP-2023-032 başlıklı makaleyi inceleyin.

Edge for Private Cloud yönlendirici ve yönetim sunucusu bileşenleri riskli olabilir. HTTP/2 yönetimde etkinleştirilmiş olsa da Edge for Private Cloud'un Edge'e özgü diğer bileşenlerinin bağlantı noktasıdır; bu bileşenlerin hiçbiri maruz kaldığı oluyor. Cassandra, Zookeeper ve diğerleri gibi Edge'in dışındaki bileşenlerde HTTP/2 etkin değil. Şunu yapmanızı öneririz: Özel Bulut için Edge güvenlik açığını gidermek üzere aşağıdaki adımları uygulayın:

• Private Cloud 4.51.00.11 veya daha yeni sürümleri için Edge'e yönelik adımlar
• 4.51.00.11'den eski Private Cloud sürümleri için Edge'e yönelik adımlar

Edge Private Cloud'un 4.51.00.11 veya daha yeni bir sürümünü kullanıyorsanız şu adımları uygulayın:

1. Yönetim sunucusunu güncelleyin:

   1. Her bir yönetim sunucusu düğümünde /opt/apigee/customer/application/management-server.properties dosyasını açın
   2. Şu satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false

   3. Yönetim sunucusu bileşenini yeniden başlatın:

      apigee-service edge-management-server restart

2. Mesaj işlemcisini güncelleme:

   1. Her bir mesaj işlemcisi düğümünde /opt/apigee/customer/application/message-processor.properties öğesini açın.
   2. Şu satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false

   3. Mesaj işlemci bileşenini yeniden başlatın:

      apigee-service edge-message-processor restart

3. Yönlendiriciyi güncelleyin:

   1. Her bir yönlendirici düğümünde /opt/apigee/customer/application/router.properties öğesini açın.
   2. Şu satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false

   3. Mesaj işlemci bileşenini yeniden başlatın:

      apigee-service edge-router restart

4. QPID'yi güncelleme:

   1. Her bir QPID düğümünde /opt/apigee/customer/application/qpid-server.properties öğesini açın
   2. Şu satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false

   3. Mesaj işlemci bileşenini yeniden başlatın:

      apigee-service edge-qpid-server restart

5. Postgre'leri güncelleme:

   1. Her Postgres düğümünde /opt/apigee/customer/application/postgres-server.properties öğesini açın
   2. Şu satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false

   3. Mesaj işlemci bileşenini yeniden başlatın:

      apigee-service edge-postgres-server restart

Edge'i 4.51.00.11'den eski Private Cloud sürümleri için kullanıyorsanız şu adımları uygulayın:

1. Yönetim sunucusunu güncelleyin:

   1. Her bir yönetim sunucusu düğümünde /opt/apigee/customer/application/management-server.properties dosyasını açın
   2. Aşağıdaki iki satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Yönetim sunucusu bileşenini yeniden başlatın:

      apigee-service edge-management-server restart

2. Mesaj işlemcisini güncelleme:

   1. Her bir mesaj işlemcisi düğümünde /opt/apigee/customer/application/message-processor.properties öğesini açın.
   2. Aşağıdaki iki satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Mesaj işlemci bileşenini yeniden başlatın:

      apigee-service edge-message-processor restart

3. Yönlendiriciyi güncelleyin:

   1. Her bir yönlendirici düğümünde /opt/apigee/customer/application/router.properties öğesini açın.
   2. Aşağıdaki iki satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Mesaj işlemci bileşenini yeniden başlatın:

      apigee-service edge-router restart

4. QPID'yi güncelleme:

   1. Her bir QPID düğümünde /opt/apigee/customer/application/qpid-server.properties öğesini açın
   2. Aşağıdaki iki satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Mesaj işlemci bileşenini yeniden başlatın:

      apigee-service edge-qpid-server restart

5. Postgre'leri güncelleme:

   1. Her Postgres düğümünde /opt/apigee/customer/application/postgres-server.properties öğesini açın
   2. Aşağıdaki iki satırı özellikler dosyasına ekleyin:

      conf_webserver_http2.enabled=false
      conf/webserver.properties+http2.enabled=false

   3. Mesaj işlemci bileşenini yeniden başlatın:

      apigee-service edge-postgres-server restart

Apigee-postgresql, Edge for Private Cloud'dan yükseltme yaparken sorun yaşıyor sürümünü 4.50 veya 4.51'den 4.52'ye yükseltin. Temelde sorunlar tablo sayısı 500'den fazla olduğunda ortaya çıkar.

Aşağıdaki SQL sorgusunu çalıştırarak Postgres'teki toplam tablo sayısını kontrol edebilirsiniz:

select count(*) from information_schema.tables

Geçici çözüm: Apigee Edge 4.50.00 veya 4.51.00 sürümüne 4.52.00 güncellemesi yapmak, şunu yaptığınızdan emin olun: hazırlık adımını tamamlayın.

apigee-mirror, Red Hat Enterprise Linux (RHEL) 8.0'da çalışmaz.

Geçici çözüm: Geçici bir çözüm olarak, daha düşük bir sürüm çalıştıran bir sunucuya apigee-mirror uygulamasını yükleyin RHEL veya başka bir destekleniyor işletim sistemi olarak ayarlamanız gerekir. Daha sonra aynayı kullanarak bile Apigee'yi RHEL 8.0 sunucularına yüklemiş olsanız bile paket ekleyebilirsiniz.

149245401: LDAP kaynağı yansıtılmaz ve JNDI varsayılanları her seferinde tek kullanımlık bağlantılara neden olur. Sonuç olarak, bağlantılar açılıyor ve her seferinde tek kullanım için kapanıyor. Bu da, çok sayıda bağlantı sayısı 3'tür.

Geçici çözüm:

LDAP bağlantı havuzu özelliklerini değiştirmek için tüm LDAP politikaları genelinde genel bir değişiklik belirlemek için aşağıdaki adımları uygulayın.

1. Henüz yoksa bir yapılandırma özellikleri dosyası oluşturun:

   /opt/apigee/customer/application/message-processor.properties

2. Dosyaya aşağıdakileri ekleyin ( Java Adlandırma ve Dizin Arayüzü (JNDI) özellikleri (LDAP kaynak yapılandırma ihtiyacınıza göre).

   bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
   -Dcom.sun.jndi.ldap.connect.pool.prefsize=2
   -Dcom.sun.jndi.ldap.connect.pool.initsize=2
   -Dcom.sun.jndi.ldap.connect.pool.timeout=120000
   -Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"

3. Dosya, /opt/apigee/customer/application/message-processor.properties Apigee:Apigee'ye aittir.
4. Tüm mesaj işlemcilerini yeniden başlatın.

Bağlantı havuzunuzun JNDI'sını doğrulamak için etkili olduğunu görmek için LDAP bağlantı havuzunun davranışını gözlemlemek için bir tcpdump uygulama oluşacaktır.

139051927: İleti İşleyen'de yüksek proxy işleme gecikmeleri bulundu etkiliyor tüm API Proxy'leri için kullanılabilir. Semptomlar işleme sürelerinde normalden 200-300 ms gecikmeyi içerir API yanıtı ve düşük TPS'de bile rastgele gerçekleşebilir. Bu durum, 50’den fazla hedeflendiği takdirde ileti işlemcisinin bağlantı kurduğu sunucular.

Temel neden: Mesaj işlemcileri, aşağıdakiler için hedef sunucu URL'sini HTTPClient nesnesiyle eşleyen bir önbellek tutar . Bu ayar varsayılan olarak 50 değerine ayarlıdır. Bu değer, çoğu dağıtım için çok düşük. Bir dağıtımın kurulumda birden fazla kuruluş/ortam kombinasyonu olduğunda, ve toplamda 50'yi aşan çok sayıda hedef sunucuya sahipse hedef sunucu URL'leri sürekli önbellekten çıkarılıyor ve gecikmelere neden oluyor.

Doğrulama: Gecikme sorununa hedef sunucu URL'si çıkarmanın neden olup olmadığını belirlemek için Mesaj İşleyici system.logs "onEvict" anahtar kelimesi için "tahliye" olabilir. Günlüklerdeki bulunmaları, hedef sunucu URL'lerinin ile başlayan bazı URL'ler, önbellek boyutu çok küçük olduğu için HTTPClient önbelleğinden çıkarılıyor.

Geçici çözüm: Edge for Private Cloud'un 19.01 ve 19.06 sürümlerinde HTTPClient'i düzenleyip yapılandırabilirsiniz önbellek, /opt/apigee/customer/application/message-processor.properties:

conf/http.properties+HTTPClient.dynamic.cache.elements.size=500

Ardından mesaj işlemcisini yeniden başlatın. Tüm mesaj işlemcileri için aynı değişiklikleri yapın.

500 değeri örnek olarak verilebilir. Kurulumunuz için optimum değer şundan büyük olmalıdır: ileti işlemcisinin bağlanacağı hedef sunucuların sayısı. Taraf yok efektleri Bu özelliği daha yüksek bir değere ayarladığınızda, tek etki gelişmiş bir mesaj işlemcisi olur. proxy isteği işleme süreleri.

Not: Edge for Private Cloud'un 50.00 sürümünde varsayılan ayar 500'dür.

157933959: verilerin tutarsızlığına ve kaybolan güncellemelere neden olabilir.

Not: Bu sınırlama yalnızca Private Cloud için Edge'de geçerlidir. Herkese Açık Bulut İçin Edge ve Karma modellerde bu sınırlama yoktur.

Edge for Private Cloud'daki geçici bir çözüm için şu konumda KVM'yi oluşturun: apiproxy kapsam.