Masalah umum pada Apigee Edge

Anda sedang melihat dokumentasi Apigee Edge.
Lihat dokumentasi Apigee X.

Bagian berikut menjelaskan masalah umum pada Apigee Edge. Pada umumnya, masalah yang tercantum akan diperbaiki dalam rilis mendatang.

Masalah umum Miscellaneous Edge

Bagian berikut menjelaskan masalah umum lainnya terkait Edge.

Luas Masalah umum
Masa berlaku cache menyebabkan nilai cachehit yang salah

Jika variabel alur cachehit digunakan setelah kebijakan LookupCache, karena cara titik debug dikirim untuk perilaku asinkron, LookupPolicy akan mengisi objek DebugInfo sebelum panggilan kembali dijalankan, sehingga menghasilkan error.

Solusi: Ulangi proses ini (lakukan panggilan kedua) lagi tepat setelah panggilan pertama.

Menetapkan Kebijakan InvalidateCache PurgeChildEntries ke true tidak berfungsi dengan benar

Menetapkan PurgeChildEntries dalam kebijakan InvalidateCache hanya akan menghapus nilai elemen KeyFragment, tetapi seluruh cache akan dihapus.

Solusi: Gunakan kebijakan KeyValueMapOperations untuk melakukan iterasi pembuatan versi cache dan mengabaikan kebutuhan untuk pembatalan validasi cache.

Masalah umum pada UI Edge

Bagian berikut menjelaskan masalah umum pada UI Edge.

Luas Masalah umum
Tidak dapat mengakses halaman Administrasi Zona SSO Edge dari menu navigasi setelah organisasi dipetakan ke zona identitas Saat menghubungkan organisasi ke zona identitas, Anda tidak dapat lagi mengakses halaman Administrasi Zona SSO SSO dari menu navigasi sebelah kiri dengan memilih Admin > SSO. Sebagai solusinya, buka halaman secara langsung menggunakan URL berikut: https://apigee.com/sso

Masalah umum pada portal terintegrasi

Bagian berikut menjelaskan masalah umum pada portal terintegrasi.

Luas Masalah umum
SmartDokumen
  • Apigee Edge mendukung Spesifikasi OpenAPI 3.0 saat Anda membuat spesifikasi menggunakan editor spesifikasi dan memublikasikan API menggunakan SmartDocs di portal, meskipun sebagian fitur belum didukung.

    Misalnya, fitur berikut dari Spesifikasi OpenAPI 3.0 belum didukung:

    • Properti allOf untuk menggabungkan dan memperluas skema
    • Referensi jarak jauh

    Jika fitur yang tidak didukung direferensikan dalam Spesifikasi OpenAPI Anda, dalam beberapa kasus, alat akan mengabaikan fitur tersebut, tetapi tetap merender dokumentasi referensi API. Dalam kasus lain, fitur yang tidak didukung akan menyebabkan error yang mencegah keberhasilan dokumentasi referensi API. Dalam kedua kasus tersebut, Anda harus memodifikasi Spesifikasi OpenAPI untuk menghindari penggunaan fitur yang tidak didukung hingga fitur tersebut didukung dalam rilis mendatang.

    Catatan: Karena editor spesifikasi kurang ketat dibandingkan SmartDocs saat merender dokumentasi referensi API, Anda mungkin mengalami hasil yang berbeda antar-alat.

  • Saat menggunakan Coba API ini di portal, header Accept disetel ke application/json terlepas dari nilai yang ditetapkan untuk consumes di Spesifikasi OpenAPI.
Penyedia identitas SAML Single logout (SLO) dengan penyedia identitas SAML tidak didukung untuk domain kustom. Untuk mengaktifkan domain kustom dengan penyedia identitas SAML, kosongkan kolom URL logout saat Anda mengonfigurasi setelan SAML.
Admin portal
  • Update portal simultan (seperti halaman, tema, CSS, atau pengeditan skrip) oleh beberapa pengguna tidak didukung untuk saat ini.
  • Jika Anda menghapus halaman dokumentasi referensi API dari portal, tidak ada cara untuk membuatnya kembali. Anda harus menghapus dan menambahkan kembali produk API, dan membuat kembali dokumentasi referensi API.
  • Saat mengonfigurasi kebijakan keamanan konten, mungkin diperlukan waktu hingga 15 menit agar perubahan dapat diterapkan sepenuhnya.
  • Saat menyesuaikan tema portal, mungkin perlu waktu hingga 5 menit agar perubahan dapat diterapkan sepenuhnya.
Fitur portal
  • Penelusuran akan diintegrasikan ke portal terintegrasi di rilis mendatang.

Masalah umum pada Edge untuk Private Cloud

Bagian berikut menjelaskan masalah umum pada Edge untuk Private Cloud.

Luas Masalah umum
Upgrade Postgresql saat mengupdate ke versi 4.52

Apigee-postgresql mengalami masalah saat mengupgrade dari Edge untuk Private Cloud versi 4.50 atau 4.51 ke versi 4.52. Masalah ini terutama terjadi jika jumlah tabel lebih dari 500.

Anda dapat memeriksa jumlah total tabel di Postgres dengan menjalankan kueri SQL di bawah:

select count(*) from information_schema.tables

Solusi: Saat Mengupdate Apigee Edge 4.50.00 atau 4.51.00 ke 4.52.00, pastikan Anda melakukan langkah awal sebelum mengupgrade Apigee-postgresql.
apigee-mirror pada RHEL 8.0

apigee-mirror tidak berfungsi di Red Hat Enterprise Linux (RHEL) 8.0.

Solusi: Sebagai solusinya, instal apigee-mirror di server yang menjalankan versi lebih rendah dari RHEL atau sistem operasi yang didukung untuk Apigee. Anda kemudian dapat menggunakan mirror untuk menambahkan paket meskipun Anda menginstal Apigee di server RHEL 8.0.

Kebijakan LDAP

149245401: Setelan kumpulan koneksi LDAP untuk JNDI yang dikonfigurasi melalui resource LDAP tidak ditampilkan, dan default JNDI menyebabkan koneksi sekali pakai setiap waktu. Akibatnya, koneksi akan dibuka dan ditutup setiap kali untuk satu kali penggunaan, sehingga menghasilkan koneksi dalam jumlah besar per jam ke server LDAP.

Solusi:

Untuk mengubah properti kumpulan koneksi LDAP, lakukan langkah-langkah berikut untuk menetapkan perubahan global di semua kebijakan LDAP.

  1. Buat file properti konfigurasi jika belum ada: 
    /opt/apigee/customer/application/message-processor.properties
  2. Tambahkan kode berikut ke file (ganti nilai properti Java Naming dan Directory Interface (JNDI) berdasarkan persyaratan konfigurasi resource LDAP Anda). 
    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. Pastikan file /opt/apigee/customer/application/message-processor.properties adalah milik apigee:apigee.
  4. Mulai ulang setiap pemroses pesan.

Untuk memverifikasi bahwa properti JNDI kumpulan koneksi Anda diterapkan, Anda dapat melakukan tcpdump untuk mengamati perilaku kumpulan koneksi LDAP dari waktu ke waktu.
Latensi Pemrosesan Permintaan Tinggi

139051927: Latensi pemrosesan proxy yang tinggi ditemukan di Message Processor memengaruhi semua Proxy API. Gejala mencakup penundaan 200-300 md waktu pemrosesan dibandingkan waktu respons API normal dan dapat terjadi secara acak bahkan dengan TPS rendah. Hal ini dapat terjadi jika lebih dari 50 server target tempat prosesor pesan membuat koneksi.

Penyebab utama: Pemroses pesan menyimpan cache yang memetakan URL server target ke objek HTTPClient untuk koneksi keluar ke server target. Secara default, setelan ini ditetapkan ke 50 yang mungkin terlalu rendah untuk sebagian besar deployment. Jika deployment memiliki beberapa kombinasi org/env dalam satu penyiapan, dan memiliki banyak server target yang melebihi 50, URL server target akan terus dikeluarkan dari cache, sehingga menyebabkan latensi.

Validasi: Untuk menentukan apakah penghapusan URL server target menyebabkan masalah latensi, telusuri kata kunci "onEvict" atau "Eviction" di Sistem Pemroses Pesan. Keberadaannya dalam log menunjukkan bahwa URL server target dikeluarkan dari cache HTTPClient karena ukuran cache terlalu kecil.

Solusi: Untuk Edge untuk Private Cloud versi 19.01 dan 19.06, Anda dapat mengedit dan mengonfigurasi cache HTTPClient, /opt/apigee/customer/application/message-processor.properties:

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

Kemudian, mulai ulang pemroses pesan. Buat perubahan yang sama untuk semua pemroses pesan.

Nilai 500 adalah contohnya. Nilai optimal untuk penyiapan Anda harus lebih besar dari jumlah server target yang akan dihubungkan oleh pemroses pesan. Tidak ada efek samping dari menyetel properti ini lebih tinggi, dan satu-satunya pengaruhnya adalah waktu pemrosesan permintaan proxy pemroses pesan yang lebih baik.

Catatan: Edge untuk Private Cloud versi 50.00 memiliki setelan default 500.
Beberapa entri untuk peta nilai kunci

157933959: Penyisipan dan pembaruan serentak ke peta nilai kunci (KVM) yang sama yang dicakupkan ke tingkat organisasi atau lingkungan menyebabkan data yang tidak konsisten dan update yang hilang.

Catatan: Batasan ini hanya berlaku untuk Edge untuk Private Cloud. Edge untuk Public Cloud dan Hybrid tidak memiliki batasan ini.

Untuk solusi di Edge untuk Private Cloud, buat KVM di cakupan apiproxy.