Vertex
指定したフィルタ条件および射影に従って Vertex のリストを返します
apmdevops102jp
指定したフィルタ条件および射影に従って Vertex のリストを返します
- タイムスタンプの時点での履歴クエリが可能です。属性、アラート、およびその他のフィールドは、履歴を保持します。デフォルトのタイムスタンプは、現在です。
- 静的射影の「compact」と「full」をサポートしています。デフォルトは「compact」です。
サポートされている動詞: GET、PATCH
サポートされているパラメータ: projection、timestamp、q
GET
コレクションのフィルタリングのサポート
timestamp によって、タイムスタンプの時点でのコレクションのスナップショットを取得します。デフォルトは現在です。
- GET /apm/appmap/vertex?timestamp:1970-01-01T00:00:01Z
- Lucene 構文でのフィルタリングがサポートされます。構文の詳細な説明については、https://lucene.apache.org/core/4_7_0/queryparser/org/apache/lucene/queryparser/classic/package-summary.html を参照してください
フィルタリングの例:
- GET /apm/appmap/vertex?q=id:101Vertex ID によるフィルタリング
- GET /apm/appmap/vertex?q=attributes.city:Paris AND attributes.sky:blue論理演算子を使用して、フィルタリング式を組み合わせることができます
- GET /apm/appmap/vertex?q=(attributes.city:Paris AND attributes.sky:blue ) OR (attributes.city:London AND attributes.sky:grey)中かっこを使用して論理式をグループ化
- GET /apm/appmap/vertex?q=attributes.sky\ color:deep\ blueスペースやその他の特殊文字はエスケープする必要があります
/vertex/ は full および compact (デフォルト)の射影をサポートしています。
Full
{ "_links": { "self": { "href": "http://localhost:8081/apm/appmap/vertex"}, "parent": { "href": "http://localhost:8081/apm/appmap/"} }, "_embedded": { "vertex": [ { "id": "497", "timestamp": "2015-05-14T09:59:12.221Z", "attributes": [ { "name": "applicationName", "value": "AuthenticationService", "type": "GATHERED" }, { "name": "type", "value": "SERVLET", "type": "GATHERED" }, { "name": "servletClassName", "value": "DefaultServlet", "type": "GATHERED" }, { "name": "city", "value": "Paris", "type": "CUSTOM" } ], "_links": { "parent": { "href": "http://localhost:8081/apm/appmap/vertex" }, "self": {"href": "http://localhost:8081/apm/appmap/vertex/497"} } }, { "id": "480", "timestamp": "2015-05-14T09:59:12.221Z", "attributes": [ { "name": "name", "value": "Place Order", "type": "GATHERED" }, { "name": "type", "value": "BUSINESSTRANSACTION", "type": "GATHERED" }, { "name": "serviceId", "value": "Trading Service", "type": "GATHERED" }, { "name": "city", "value": "Paris", "type": "CUSTOM" } ], "_links": { "parent": {"href": "http://localhost:8081/apm/appmap/vertex"}, "self": { "href": "http://localhost:8081/apm/appmap/vertex/480"} } } ] } }
Compact
{ "_links": { "self": {"href": "http://localhost:8081/apm/appmap/vertex"}, "parent": {"href": "http://localhost:8081/apm/appmap/"} }, "_embedded": { "vertex": [ { "id": "516", "timestamp": "2015-05-14T10:43:10.163Z", "attributes": { "name": "WebService|Auth", "applicationName": "AuthenticationEngine", "hostname": "webserver.ca.com", "type": "SERVLET", "agent": "tas-cz-n8d|Tomcat|Tomcat Agent", "servletClassName": "DefaultServlet", "ipAddress": "10.0.0.1" }, "_links": { "parent": {"href": "http://localhost:8081/apm/appmap/vertex"}, "self": {"href": "http://localhost:8081/apm/appmap/vertex/516"} } } }
PATCH
選択した Vertex の属性値を更新します。
- 属性名は一意である必要があります。重複した属性は破棄されます。
- 指定した Vertex に属性がある場合は、更新されます。そうでない場合、PATCH により指定の名前で CUSTOM 属性が作成されます
- CUSTOM 属性は、作成、更新、または削除することができます。PATCH によって作成された属性は常に CUSTOM です
- DECORATED 属性を更新できます。更新された場合は、CUSTOM になります。
- 収集された属性を更新または削除することはできません。
要求のペイロードの例を以下に示します。
- 指定された属性名は一意であることが予期されます。PATCH では、すべての重複した属性は無視されます。
[{ "id":"3", "attributes": { "Attr1":"newValue", "Attr2": null // NULL deletes attribute } }, ...]
サポートされているパラメータ
プロパティ名 | タイプ | 説明 |
vertex | 配列 | Vertex の配列 - 射影に依存します。 |