Tag API
Contents
List all tags
GET
GET /api/v1/tags
Curl example:
Locate a Tag's Values
GET
GET /api/v1/tags/<tagname>
Path Parameters
Name | Type | Description |
---|---|---|
expr | String | To search for the tagged series that match the expression, users should include both tagname and value in the query |
filter | String | Tag value to search for |
limit | String | To limit the number of search results to the given number |
Curl example:
Search for tag name host
that matches the value prod
, and only show 3 matching results.
Locate Tagged Metrics and Values
GET
/api/v1/tags/findSeries?
Path Parameters
Name | Type | Description |
---|---|---|
expr | String | Format: |
filter | String | Format: |
limit | String | Format: |
Curl examples:
Search for tagged metric/series that match the expression cluster=prod&host=egg-0001
Response format with ‘?filter=machine-000*&limit=3
’:
Delete Tagged Metricss
POST
/api/v1/tags/delSeries
Curl example:
Delete all series that match the path foo.bar and tag1=val1 and tag2=val2.
If you have sent tagged metrics then the number of tagged metrics you have sent will be displayed when you hover over the metric count on your Homepage:
You can also locate, search, and delete your tagged metrics from within our Tag Search UI:
Last updated