Graph Vertexstatus Incremental
頂点ステータスへの増分更新を返します。各レスポンスには、次の呼び出しに使用する lastVersion が含まれます。
apmdevops104jp
頂点ステータスへの増分更新を返します。各レスポンスには、次の呼び出しに使用する
lastVersion
が含まれます。- ユーザがアクセスできるすべてのユニバース全体で頂点ステータスを結合します
- レスポンスにはすべての更新が含まれません。同じステータスへの複数の更新がある場合、最後の有効な更新のみがレポートされます。
GET /apm/appmap/graph/vertexstatus/incremental?sinceVersion=0
この最初の呼び出しでは、現時点のすべてのステータスを返します。レスポンスには、増分更新を取得するための
lastVersion
が含まれます。初期スナップショットとしてコンシューマ側でこの呼び出しをキャッシュします。{ "_embedded": { "status": { "alerts": [ { "vertexId": "Enterprise Team Center:8", "alertName":"custom alert #8" "state": "OK", "startTime":"2015-04-12T09:59:12.221Z" }, { "vertexId": "Enterprise Team Center:8", "alertName":"custom alert #1", "state": "DANGER", "startTime":"2015-04-12T09:59:12.221Z" }, {...} ] } }, "_links": { "self": { "href": "http://tas-cz-nc6.ca.com:8081/apm/appmap/graph/vertexstatus/incremental" }, "parent": { "href": "http://tas-cz-nc6.ca.com:8081/apm/appmap" }, "next": { "href": "http://tas-cz-nc6.ca.com:8081/apm/appmap/graph/vertexstatus/incremental?sinceVersion=eyJ0eXBlIjoiVkVSVEVYU1RBVFVTIiwidmVyc2lvbnMiOnsidGFzLWN6LW5lZC5jYS5jb206ODA4MSI6MTQ3Mzc1NDMzMDQ1MSwidGFzLWN6LW5jMC5jYS5jb206ODA4MSI6MTQ3Mzc1NDMzMDM1MCwiRW50ZXJwcmlzZSBUZWFtIENlbnRlciI6MTQ3Mzc1NDMyOTI3MH19" } }, "lastVersion": "eyJ0eXBlIjoiVkVSVEVYU1RBVFVTIiwidmVyc2lvbnMiOnsidGFzLWN6LW5lZC5jYS5jb206ODA4MSI6MTQ3Mzc1NDMzMDQ1MSwidGFzLWN6LW5jMC5jYS5jb206ODA4MSI6MTQ3Mzc1NDMzMDM1MCwiRW50ZXJwcmlzZSBUZWFtIENlbnRlciI6MTQ3Mzc1NDMyOTI3MH19" //"0" means reset the cache }
GET /apm/appmap/graph/incremental?sinceVersion=XXXXYYYYZZZZZ
最後の呼び出し以降の増分変更を返します。最後の呼び出しは、応答の
lastVersion
フィールドで識別されます。応答には、新規/変更された頂点、削除された頂点、新規/変更された辺、削除された辺に関する情報が含まれます。スナップショットにこの応答を適用します。コンシューマ側でキャッシュしたままにします。以下の例を参照してください。
{ "_embedded": { "status": { "alerts": [ //we only have updates here because status does not get deleted, it only goes to "UNKNOWN" //only status changes since last call are included - same as we do with Vertices and Edges { "vertexId": "Enterprise Team Center:8", "alertName":"custom alert #8" "state": "OK", "startTime":"2015-04-12T09:59:12.221Z" }, { "vertexId": "Enterprise Team Center:8", "alertName":"custom alert #1", "state": "UNKNOWN", // "UNKNOWN" means alert went away "startTime":"2015-04-12T09:59:12.221Z" }, {...} ] } }, "_links": { "self": { "href": "http://tas-cz-nc6.ca.com:8081/apm/appmap/graph/vertexstatus/incremental" }, "parent": { "href": "http://tas-cz-nc6.ca.com:8081/apm/appmap" }, "next": { "href": "http://tas-cz-nc6.ca.com:8081/apm/appmap/graph/vertexstatus/incremental?sinceVersion=eyJ0eXBlIjoiVkVSVEVYU1RBVFVTIiwidmVyc2lvbnMiOnsidGFzLWN6LW5lZC5jYS5jb206ODA4MSI6MTQ3Mzc1NDMzMDQ1MSwidGFzLWN6LW5jMC5jYS5jb206ODA4MSI6MTQ3Mzc1NDMzMDM1MCwiRW50ZXJwcmlzZSBUZWFtIENlbnRlciI6MTQ3Mzc1NDMyOTI3MH19" } }, "lastVersion": "eyJ0eXBlIjoiVkVSVEVYU1RBVFVTIiwidmVyc2lvbnMiOnsidGFzLWN6LW5lZC5jYS5jb206ODA4MSI6MTQ3Mzc1NDMzMDQ1MSwidGFzLWN6LW5jMC5jYS5jb206ODA4MSI6MTQ3Mzc1NDMzMDM1MCwiRW50ZXJwcmlzZSBUZWFtIENlbnRlciI6MTQ3Mzc1NDMyOTI3MH19" //"0" means reset the cache }
注
:- 必要なだけの頻度で、呼び出しを繰り返して増分更新を取得します。呼び出すたびに、すべての変更がクランプまたはページングなしで処理されます。非常に大規模なペイロードは、メモリに保持される代わりにストリーミング レスポンス JSON で処理されます。
- いつでもデータの新規スナップショットを取得できます。GET /apm/appmap/graph/incremental?sinceVersion=0を使用します。たとえば、アプリケーションが再起動された場合に、この呼び出しを使用できます。この呼び出しにより、増分更新を取得する新しい lastVersion を取得できます。