このページは Cloud Translation API によって翻訳されました。

Apigee Edge の既知の問題

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。

以下のセクションでは、Apigee Edge の既知の問題について説明します。ほとんどの場合、ここに記載されている問題は今後のリリースで修正される予定です。

その他の Edge の既知の問題

以下のセクションでは、Edge に関するその他の既知の問題について説明します。

領域既知の問題

領域	既知の問題
キャッシュの有効期限によって `cachehit` の値が間違っている	`cachehit` フロー変数を LookupCache ポリシーの後に使用すると、非同期動作のためにデバッグポイントがディスパッチされる方法により、コールバックが実行される前に LookupPolicy によって DebugInfo オブジェクトが入力されるため、エラーが発生します。回避策: 最初の呼び出しの直後に、プロセスをもう一度繰り返します（2 回目の呼び出しを行います）。
InvalidateCache ポリシー `PurgeChildEntries` を true に設定しても、正しく機能しない	InvalidateCache ポリシーで `PurgeChildEntries` を設定すると、`KeyFragment` 要素の値のみがパージされますが、キャッシュ全体がクリアされます。回避策: KeyValueMapOperations ポリシーを使用してキャッシュバージョニングを繰り返し、キャッシュ無効化の必要性を回避します。

キャッシュの有効期限によって cachehit の値が間違っている

cachehit フロー変数を LookupCache ポリシーの後に使用すると、非同期動作のためにデバッグポイントがディスパッチされる方法により、コールバックが実行される前に LookupPolicy によって DebugInfo オブジェクトが入力されるため、エラーが発生します。

回避策: 最初の呼び出しの直後に、プロセスをもう一度繰り返します（2 回目の呼び出しを行います）。

InvalidateCache ポリシー PurgeChildEntries を true に設定しても、正しく機能しない

InvalidateCache ポリシーで PurgeChildEntries を設定すると、KeyFragment 要素の値のみがパージされますが、キャッシュ全体がクリアされます。

回避策: KeyValueMapOperations ポリシーを使用してキャッシュバージョニングを繰り返し、キャッシュ無効化の必要性を回避します。

Edge UI に関する既知の問題

以降のセクションでは、Edge UI の既知の問題について説明します。

地域	既知の問題
組織が ID ゾーンにマッピングされていると、ナビゲーションバーから [Edge SSO Zone Administration] ページにアクセスできなくなります。	組織を ID ゾーンに接続すると、左側のナビゲーションバーから [Admin] > [SSO] を選択しても、Edge SSO Zone 管理ページにアクセスできなくなります。回避策として、https://apigee.com/sso からページに直接移動します。

統合ポータルに関する既知の問題

以下のセクションでは、統合ポータルの既知の問題について説明します。

地域	既知の問題
SmartDocs	Apigee Edge では、仕様エディタを使用して仕様を作成し、ポータルで SmartDocs を使用して API を公開する場合に、OpenAPI 仕様 3.0 がサポートされていますが、一部の機能はまだサポートされていません。たとえば、OpenAPI 仕様 3.0 の次の機能は現時点ではサポートされていません。スキーマの組み合わせと拡張のための `allOf` プロパティリモート参照サポートされていない機能が OpenAPI 仕様で参照されると、ツールはその機能を無視し、API リファレンスドキュメントをレンダリングする場合があります。それ以外の場合、サポートされていない機能によってエラーが発生し、API リファレンスドキュメントの正常なレンダリングができないようにします。いずれの場合も、今後のリリースでサポートされるまで、OpenAPI 仕様を変更して、サポートされていない機能の使用を避ける必要があります。注: API リファレンスドキュメントのレンダリングでは、仕様エディタの方が SmartDocs よりも制限が少ないため、ツール間で異なる結果となる場合があります。ポータルでこの API を試しに使用すると、OpenAPI 仕様の `consumes` に設定されている値に関係なく、`Accept` ヘッダーが `application/json` に設定されます。
SAML ID プロバイダ	SAML ID プロバイダでのシングルログアウト（SLO）は、カスタムドメインではサポートされていません。SAML ID プロバイダでカスタムドメインを有効にするには、SAML 設定を構成するときに [Sign-out URL] フィールドを空白のままにします。
ポータル管理者	現時点では、複数のユーザーによる同時のポータルの更新（ページ、テーマ、CSS、スクリプトの編集など）はサポートされていません。 API リファレンスドキュメントのページをポータルから削除した場合、再作成する方法はありません。API プロダクトを削除して再度追加し、API リファレンスドキュメントを再生成する必要があります。コンテンツセキュリティポリシーを設定している場合、変更が完全に適用されるまでに最長で 15 分ほどかかる場合があります。ポータルのテーマをカスタマイズするときには、変更が完全に適用されるまで最大で 5 分かかることがあります。
ポータルの機能	今後のリリースで検索機能が統合ポータルに統合される予定です。

Edge for Private Cloud に関する既知の問題

次のセクションでは、Edge for Private Cloud の既知の問題について説明します。

地域	既知の問題
バージョン 4.52 への更新時の Postgresql アップグレード	Apigee-postgresql で、Edge for Private Cloud バージョン 4.50 または 4.51 からバージョン 4.52 へのアップグレードで問題が発生しています。この問題は、主にテーブル数が 500 を超える場合に発生します。 Postgres のテーブルの総数を確認するには、以下の SQL クエリを実行します。 select count() from information_schema.tables 回避策:* Apigee Edge 4.50.00 または 4.51.00 を 4.52.00 にアップデートする場合は、Apigee-postgresql をアップグレードする前に予備手順を実施してください。注: この回避策を実施しない場合、Postgres のアップグレードが失敗する可能性があります。その場合は、PG スタンバイを使用するか、PG または VM のバックアップを動作バージョンにロールバックしてから、回避策の手順に沿ってアップグレードを再度実行します。
`apigee-mirror`（RHEL 8.0）	`apigee-mirror` は Red Hat Enterprise Linux（RHEL）8.0 では動作しません。回避策: 回避策として、以前のバージョンの RHEL、または Apigee でサポートされている別のオペレーティングシステムを実行しているサーバーに `apigee-mirror` をインストールします。RHEL 8.0 サーバーに Apigee をインストールした場合でも、ミラーを使用してパッケージを追加できます。
LDAP ポリシー	149245401: LDAP リソースを介して構成された JNDI の LDAP 接続プール設定が反映されず、JNDI のデフォルトにより毎回 1 回限りの接続が発生します。その結果、接続の開閉は 1 回使用されるたびに行われ、LDAP サーバーに 1 時間あたりに大量の接続が作成されます。回避策: LDAP 接続プールのプロパティを変更するには、次の手順を行い、すべての LDAP ポリシーでグローバルな変更を設定します。構成プロパティファイルが存在しない場合は作成します。 /opt/apigee/customer/application/message-processor.properties このファイルに次の行を追加します（LDAP リソース構成の要件に応じて Java Naming and Directory Interface（JNDI）プロパティの値を置き換えます）。 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" ファイル `/opt/apigee/customer/application/message-processor.properties` の所有者を apigee:apigee にします。各 Message Processor を再起動します。接続プールの JNDI プロパティが有効かどうかを確認するには、tcpdump を実行して LDAP 接続プールの動作を時系列でモニタリングします。注: 前の手順で指定した接続プールのプロパティはグローバルであるため、Edge の Message Processor が確立するすべての接続プール対応の LDAP 接続に適用されます。
高リクエスト処理レイテンシ	139051927: Message Processor で検出されたプロキシ処理の高レイテンシが、すべての API プロキシに影響を及ぼしています。症状には、通常の API 応答時間と比較して処理時間が 200 ～ 300 ms 遅延する傾向があり、TPS が低い場合でもランダムに発生する可能性があります。これは、Message Processor が接続するターゲットサーバーが 50 を超える場合に発生します。根本原因: Message Processor が保持しているキャッシュは、ターゲットサーバーへの送信接続用のターゲットサーバーの URL を HTTPClient オブジェクトにマッピングするものです。この設定はデフォルトで 50 に設定されており、ほとんどのデプロイでは低すぎる可能性があります。デプロイに組織と環境の組み合わせが複数あり、ターゲットサーバーの数が非常に多い場合、ターゲットサーバーの URL がキャッシュから削除され、レイテンシが発生します。検証: ターゲットサーバーの URL の削除がレイテンシの問題の原因であるかどうかを確認するには、Message Processor system.logs でキーワード「onEvict」または「Eviction」を検索します。このログは、キャッシュサイズが小さすぎるためにターゲットサーバーの URL が HTTPClient キャッシュから削除されることを示しています。回避策: Edge for Private Cloud バージョン 19.01 と 19.06 では、HTTPClient キャッシュ `/opt/apigee/customer/application/message-processor.properties` を編集および構成できます。 conf/http.properties+HTTPClient.dynamic.cache.elements.size=500 Message Processor を再起動します。すべての Message Processor で同じ変更を行います。値 500 は一例です。設定に最適な値は、Message Processor が接続するターゲットサーバーの数よりも大きくする必要があります。このプロパティを高く設定しても副作用はありません。唯一の影響は、Message Processor のリクエスト処理時間の改善です。注: Edge for Private Cloud バージョン 50.00 のデフォルト設定は 500 です。
Key-Value マップの複数のエントリ	157933959: 組織レベルまたは環境レベルをスコープとする同じ Key-Value マップ（KVM）への挿入と更新が同時に行われると、データに不整合と更新が失われます。注: この制限は、Edge for Private Cloud にのみ適用されます。Edge for Public Cloud とハイブリッドにはこの制限がありません。 Edge for Private Cloud の回避策として、`apiproxy` スコープで KVM を作成します。