Skip to content
This repository has been archived by the owner on Aug 23, 2023. It is now read-only.

Commit

Permalink
Update HTTP docs
Browse files Browse the repository at this point in the history
  • Loading branch information
shanson7 committed Dec 23, 2019
1 parent 0faa5a5 commit 6ffc099
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 1 deletion.
1 change: 1 addition & 0 deletions docs/cloud/http-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -279,6 +279,7 @@ that duplicate entries will be returned.

* expr (required): a list of [tag expressions](#tag-expressions)
* from: Graphite [from time specification](#fromto) (optional. defaults to now-24hours)
* format: series-json, lastupdate-json. (defaults to series-json)

##### Example

Expand Down
28 changes: 27 additions & 1 deletion docs/http-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,33 @@ json and treejson are the same.
curl -H "X-Org-Id: 12345" "http://localhost:6060/metrics/find?query=statsd.fakesite.counters.session_start.*.count"
```

## Find tagged metrics

```
GET /tags/findSeries
POST /tags/findSeries
```

Returns metrics which match tag queries and have received an update since `from`.
Note: the returned results are not deduplicated and in certain cases it is possible
that duplicate entries will be returned.

##### Parameters

* expr (required): a list of [tag expressions](#tag-expressions)
* from: Graphite [from time specification](#fromto) (optional. defaults to now-24hours)
* format: series-json, lastupdate-json. (defaults to series-json)

##### Example

```sh
curl "http://localhost:6060/tags/findSeries?expr=datacenter=dc1&expr=server=web01"

[
"disk.used;datacenter=dc1;rack=a1;server=web01"
]
```

## Deleting metrics

This will delete any metrics (technically metricdefinitions) matching the query from the index.
Expand Down Expand Up @@ -475,4 +502,3 @@ The time specification is used throughout the http api and it can be any of thes
- `y`, `year`, `years`

* datetime in any of the following formats: `15:04 20060102`, `20060102`, `01/02/06`

0 comments on commit 6ffc099

Please sign in to comment.