15.02.18 - Apigee Edge クラウド リリースノート

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

2015 年 2 月 17 日（火）に、Apigee Edge の新しいクラウド バージョンをリリースしました。

新機能と拡張機能

このリリースにおける新機能と改善点は次のとおりです。

アナリティクスの強化

このリリースには、Edge 分析のダッシュボードとレポートのユーザビリティとパフォーマンスの多くの改善が含まれています。

  • API、デベロッパー、プロダクト、デベロッパー アプリのパフォーマンス グラフが移動しました。以前は、これらのエンティティのメインページの下部に表示されていました。グラフにアクセスするには、各ページの上部にある [アナリティクス] タブを選択します。
  • このリリースには、既存のダッシュボードまたは新しいダッシュボードに対する次の大きな変更が含まれています。
    • Apigee ダッシュボード（改訂版）: プロキシ トラフィック、デベロッパー エンゲージメント、デベロッパー アプリの 3 つの指標グラフが含まれています。各グラフには、各指標をドリルダウンできる [詳細] ビューがあります。Apigee ダッシュボードをご覧ください。
    • プロキシ パフォーマンス（新規）: API プロキシのトラフィック パターンと処理時間が表示されます。API プロキシ パフォーマンス ダッシュボードに代わるものです。API プロキシのパフォーマンスをご覧ください。
    • トラフィックの構成（改訂）: ダッシュボードの外観と操作性、コンテンツを全面的に改訂しました。API プログラム全体に対する上位の API、アプリ、デベロッパー、プロダクトの影響を相対的に測定します。トラフィック構成をご覧ください。
    • エラー分析（改訂版）: 外観と内容を全面的に改訂しました。API プロキシとターゲットのエラー率が表示されます。Error Code Analysis ダッシュボードをご覧ください。
  • 既存のダッシュボードの名前が変更されました。
    • [Endpoint Performance] が [Target Performance] に変更されました。API プロキシ バックエンド ターゲットのトラフィック パターンとパフォーマンス指標が表示されます。目標達成度をご覧ください。
    • [Partner Engagement] が [Developer Engagement] に名称変更されました。登録済みのアプリ デベロッパーのうち、最も多くの API トラフィックを生成しているデベロッパーが表示されます。デベロッパーごとに、最も多くの API トラフィックと最も多くのエラーを生成しているユーザーを探すことができます。デベロッパー エンゲージメントをご覧ください。

管理 UI のフィルタ オプション

管理 UI の [API プロキシ]、[プロダクト]、[デベロッパー]、[アプリ] の各ページで、検索用の新しいフィルタ オプションが使用できるようになりました。

Offline Trace ツール

Offline Trace ツールを使用すると、以前に保存されたトレース セッションを表示および分析できます。保存されているトレース セッションは、基本的にトレース セッションの「記録」であり、トラブルシューティングや詳細な分析が必要な場合に役立ちます。Offline Trace ツールの UI は、「ライブ」の Trace ツールと似ています。

詳細については、オフライン Trace ツールの使用をご覧ください。

ユーザー設定に表示されるユーザーロール

管理 UI の [ユーザー設定] ページ（[ユーザー名] > [ユーザー設定]）に、ユーザーのロールが表示されるようになりました。

Edge 管理 UI の機能強化

このリリースには、Edge 管理 UI のユーザビリティと一貫性を改善するいくつかの小さな変更が含まれています。

修正済みのバグ

このリリースでは以下のバグが修正されています。

問題 ID 説明
APIRT-272 io.timeout.millis 設定が反映されない
API プロキシの HTTP ターゲット接続の io.timeout.millis 設定が、動的ターゲット エンドポイントで反映されるようになりました。
APIRT-441 クライアントに返される OAuth エラー メッセージが変更されました
OAuthV2 ポリシーで continueOnError が true に設定されている場合、Edge は次の新しいフロー変数を入力して、エラーに関する詳細情報を提供します。oauthV2.policy-name.fault.name と oauthV2.policy-name.fault.cause
APIRT-641 最新の XSD の場所
Apigee サンプル GitHub リポジトリで Edge ポリシーのスキーマが更新されました。https://github.com/apigee/api-platform-samples/tree/master/schemas/policy をご覧ください。
APIRT-848 Message Processor の RES メモリ使用率が高い
APIRT-970 メッセージ プロセッサのヒープ使用率が高い
APIRT-998 複数の X-Forwarded-For IP を含む AccessControl ポリシーでトラフィックがブロックされない
Access Control ポリシーでは、最初の X-Forwarded-For ヘッダーのみが使用されていました。複数の X-Forwarded-For ヘッダーが存在する場合、ポリシーはすべてのヘッダーを使用するようになりました。
APIRT-1078 デプロイ中に Message Processor と Router が古い状態になることがある
APIRT-1098 JavaScript の実行中に java.util.ConcurrentModificationException を示す MP ログ
デバッグ/トレース中に、一部の JavaScript ポリシーでサービスを利用できないエラーがスローされていました。なお、本事象はすでに解決しております。
APIRT-1099 GetOAuthV2Info - AuthorizationCode に関する問題。NPE をスローします。
GetOAuthV2Info ポリシーが「AuthorizationCode」を取得しようとしたときに、null ポインタ例外をスローしていました。この問題は解決されました。このポリシーで AuthorizationCode 情報を取得できるようになりました。
AXAPP-572 ダッシュボード ページのプルダウンで選択後に状態が変化しない
AXAPP-1295 カスタム レポートで内部サーバー エラーが発生する
管理 UI で、カスタム レポートからのアナリティクス呼び出しで特殊文字（%、"）が適切にエンコードされるようになりました。
AXAPP-1320 カスタム ディメンションが空の場合にドリルダウンすると、精度レベルが「正確」のエラーが発生する
AXAPP-1390 [ダッシュボード] ページで上位のパフォーマンス ビューを読み込もうとすると「サーバー エラー」の警告が表示される
AXAPP-1427 「分単位」で表示するとダッシュボードの応答性が低下する
CORERT-280 すべてのスレッドを消費しないように、TCPMonitor は固定間隔ではなく固定遅延でタスクをスケジュールする必要があります
システム リソースをより効率的に処理するように TCPMonitor コードが最適化されました。
CORERT-297 ロードテスト中に Netty ルーターで直接バッファ メモリが確認された: java.lang.OutOfMemoryError
CORERT-331 URL に「|」が含まれていると、不正なリクエストが発生する
URL にパイプ文字（「|」）が含まれていると、不正なリクエスト エラーが発生していました。この問題は修正されました。
CORERT-338 proxyBasePath、env、vhost エイリアス、vhost ポートと競合するエントリがある場合に最適なベースパスの一致を見つける
CORERT-348 「Connection: close」レスポンス ヘッダーにより、バックエンドの 200 が 503 に変更される
DEVRT-1039 トランザクション料金プランは必須ではありません
トランザクション記録ポリシーの要件が適用されていませんでした。収益化では、商品を含むパッケージの料金プランを定義する前に、商品のトランザクション記録ポリシーが存在することが引き続き必要になります。
DEVRT-1210 利用規約の日付フィールドで検証に組織のタイムゾーンが使用されない
利用規約の有効日が正しく計算されていませんでした。日付が組織のタイムゾーンに対して検証されるようになりました。
MGMT-927 Develop UI でポリシーの XML が正しく解析されず、新しいリビジョンを保存するときに問題が発生する可能性がある
XML 定義が複数行に折り返されている場合、管理 UI で API プロキシとポリシーが解析されませんでした。なお、本事象はすでに解決しております。
MGMT-1294 ターゲット バックエンドの応答に時間がかかると、新しいトレース UI に受信リクエストが表示されない
MGMT-1302 管理 UI へのログインでリダイレクト ループが発生する
Firefox で管理 UI にログインできない場合がありました。この問題は修正済みです。
MGMT-1309 Trace UI フィルタで特殊文字が明示的に URL エンコードされる
MGMT-1323 認証情報なしで API モデルを取得できる
API モデル リソースでは、proxyUrl ディスカバリー エンドポイントを除くすべてのリクエストで認証が必要になりました。つまり、バックエンドから SmartDocs HTML を直接表示するには、認証情報が必要になります。
MGMT-1386 APIProxy の概要ページで AJAX エラーが発生する
複数の組織が異なるブラウザタブでアクティブになっている場合に、データ整合性エラーが発生していました。Edge 管理 UI で、複数のブラウザタブを使用している状況でのデータの整合性を確保できるようになりました。ブラウザタブで 1 つの組織を操作すると、他のすべての管理 UI タブでその組織に切り替えるよう求められます。
MGMT-1410 Service Callout で使用されているターゲット サーバーが検証されない
Service Callout ポリシーで、API プロキシ バンドルのデプロイ時にターゲット エンドポイントの欠落が許可されていました。ポリシーのターゲット エンドポイントが検証されるようになり、Service Callout でターゲット エンドポイントが見つからない場合は、デプロイ時にエラーがスローされます。
MGMT-1411 TargetEndPoint の LoadBalancer に <Path> 変数がないと、デプロイ中に NPE がスローされる
HTTPTargetConnection で、LoadBalancer が使用され、Path が指定されていない場合、500 エラーがスローされていました。この問題は解決されました。LoadBalancer に Path 要素がない場合は、デフォルトの「/」が使用されます。
MGMT-1416 誤った Condition を含むプロキシ バンドルをデプロイする際のエラー メッセージを改善
API プロキシの開発中に発生するエラー メッセージが改善され、エラーの場所と理由に関する詳細情報が含まれるようになりました。
MGMT-1496 ユーザーを追加する際に UI に誤ったエラー メッセージが表示される
既存のユーザーを組織に再度追加しようとすると、「User undefined already exists in the organization」というメッセージが表示されました。「undefined」という単語がユーザー名に置き換えられるようになりました。
MGMT-1532 編集権限のないカスタムロールでは API プロキシを作成できない
MGMT-1538 メールのローカル部分に $ を含むデベロッパーを取得できない
MGMT-1543 管理 UI で「ユーザー」ロールでデプロイできない

既知の問題

このリリースには、次の既知の問題があります。

問題 ID 説明
APIRT-950 レポートにデベロッパー アプリとプロダクトの「na」が表示されることがある
分析レポートに「na」が表示されることがあります。次のドキュメント トピックでは、さまざまなコンテキストでの「na」の意味について説明しています。意味今後の更新で、UI でのこのラベルの表示が改善されます。