4.19.06 Edge for Private Cloud リリースノート

最初に取引を評価しない

Edge for Private Cloud では、最初に組織の収益化を有効にした際、トランザクションを評価しません。これは、新規および既存の組織に適用されます。

Monetization イネーブルメント API は、ジョブ ID を返します。完了すると、ジョブのステータスが成功を示します。ただし、最初に収益化された API 呼び出しは収益化によって処理されず、評価されません。これらの取引は、通常のアナリティクスにのみ表示されます。

回避策:

apigee-service edge-message-processor restart

収益化が有効になった後、MP を再起動すると、起動時に ZooKeeper から構成が読み込まれます。これは再起動ごとに発生します。つまり、この問題は初期段階でのみ発生します。

Mint Rating サーバーのメモリリーク

新しい Qpid インスタンスが mxgroup に登録されると、キューはコンシューマーなしでビルドされ、利用可能なすべてのリソースが使用されるまでキューの深さが増加します。

回避策:

apigee-sso のインストールのメタデータ ファイル形式

apigee-sso をインストールし、URL の代わりに metadata.xml ファイルを使用する場合、metadata.xml ファイルにファイルの末尾に改行（CRLF）が含まれない場合、metadata.xml ファイルはすべて読み込まれません。

回避策:

この問題を回避するには、次のいずれかを行います。

• metadata.xml ファイルの末尾に CRLF を追加する

  または

• メタデータに URL ベースの位置情報を使用する

apigee-monit は Amazon Linux 1 でサポートされていません

回避策:

Message Processor のバックアップが正しいファイルセットをバックアップしない

回避策:

バックアップをもう一度実行すると、正しいファイルセットがバックアップされます。

複数のデータセンター構成での DataAccessException

複数のデータセンター構成で 1 つのデータストアが使用できなくなると、次のエラーが発生することがあります。

DataAccessException: Error while accessing datastore;
Please retry later

その結果、Management Server は、dc-1 と dc-2 の両方の Cassandra ノードに接続しようとしているため、起動しない可能性があります。DataAccessExceptions は、Cassandra ノードがダウンすると発生します。また、API トラフィックが中断され、Message Processor が KVM を取得しようとしたときに DataAccessExceptions が報告される場合があります。

想定される状態は、Management Server がリージョン間でデータストア コンポーネントに接続しないことです。

回避策

回避策は、使用不可のデータセンターで次の Cassandra ノードタイプを登録解除し、Cassandra ノードが再び使用可能になった後で再登録することです。

• kms-datastore
• dc-datastore
• keyvaluemap-datastore

これらの Cassandra ノードタイプを登録解除して再登録するには:

1. 次の curl コマンドを使用して、Cassandra ノードの UUID を取得します。

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   ここで

   • ADMIN_EMAIL と ADMIN_PW は Apigee アカウントの認証情報です。
   • MS_IP と MS_PORT は、Management Server の IP アドレスとポート番号です。
   • REGION は、Management Server が配置されているデータセンターの名前です。
   • GATEWAY_POD は Pod 名です。デフォルトでは「gateway」です。ただし、別の名前に変更している可能性があるため、実装を確認してください。
   • CASSANDRA_NODE_TYPE は、kms-datastore、dc-datastore、keyvaluemap-datastore のいずれかです。

   例:

   curl -u nickdanger@google.com:myP@$$w0rD
     "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

   レスポンスは次の形式を使用します。

   {
     "internalIP" : "POD_IP_ADDRESS",
     "isUp" : [true|false],
     "pod" : "GATEWAY_POD",
     "reachable" : [true|false],
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
       "uUID" : "POD_UUID"
   }

   例:

   {
     "internalIP" : "192.168.1.11",
     "isUp" : false,
     "pod" : "gateway",
     "reachable" : false,
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : "dc-datastore",
     "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
   }

   レスポンスに含まれる uUID フィールドの値をメモします。これらを使用してノードの登録を解除します。

2. Cassandra ノードタイプ（kms-datastore、dc-datastore、keyvaluemap-datastore）ごとにステップ 1 を繰り返します。返された UUID をメモしてください。
3. 次のコマンドを使用してノードの登録を解除します。

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   ここで、UUID は前のコマンドのレスポンスで返された UUID です。

4. ステップ 1 と 2 で収集した UUID ごとにステップ 3 を繰り返します。
5. 次のコマンドを使用してノードを再登録します。

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
     "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
     Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
     region=REGION&pod=GATEWAY_POD" -H \
     'content-type: application/x-www-form-urlencoded' -X POST

これらのオペレーションによって Zookeeper のノードの登録と登録解除が行われるため、Cassandra クラスタへの影響はありません。これらのコマンドの詳細については、データストア登録の更新をご覧ください。

ログメッセージに追加情報を含む MessageLogging ポリシー

MessageLogging ポリシーの FormatMessage 要素は、ログに記録されたメッセージの形式を制御します。FormatMessage=false の場合、ログに記録されるメッセージに Apigee が生成した情報は含まれません。FormatMessage=false を設定しても、ログメッセージには次の情報が含まれます。

• 優先度スコア
• タイムスタンプ

回避策: