Aggregation Rules API

Contents

• Aggregation Rules API

  • Creating Aggregation Rules

  • Listing Aggregations

  • List Aggregation Rules by ID

  • Deleting Aggregates

  • Editing Your Aggregations

Aggregation rules consolidate the averaged values of many metrics into one, allowing for speedy graph rendering and visualization. Managing aggregation rules can be done easily with Hosted Graphite. Learn more about what our aggregation rules do, and how to use our Aggregation Feature here.

Creating Aggregation Rules

POST /v1/aggregates/

Path Parameters

Name	Type	Description
pattern*	String	Regex or node pattern to match ingested metrics to.
output*	String	Metric output, when a metric is matched with the pattern, those metrics will be mapped to this output and appear in your account.

200

OK

(The aggregation rule was created successfully. Returns created aggregation’s ID)

400

403

409

500

Curl Example:

curl -H "Content-Type: application/json" -X POST -d \
'{"pattern": "servers.*.requests.<response_code>", "output": "servers.all.requests.<response_code>"}' \
"https://[email protected]/v1/aggregates/"

Creates an aggregation with the pattern: servers.*.requests.<response_code> and the output servers.all.requests.<response_code>.

For example, metrics that look like servers.server-0001.requests.404 and servers.server-0002.requests.404 would appear in your account as aggregates.servers.all.requests.404.

---

Listing Aggregations

GET /v1/aggregates

200

OK List of your aggregation rules.

List Aggregation Rules by ID

GET /v1/aggregates/<aggregation_id>/

Lists your aggregations or individual aggregation if the optional ID is passed.

200

OK

Aggregation with passed ID if it exists, empty list otherwise.

Curl Example:

curl "https://[email protected]/v1/aggregates/<aggregation_id>/"

---

Deleting Aggregates

DELETE /v1/aggregates/<aggregate_id>/

Delete aggregation rule with passed ID

200

OK Aggregation was successfully deleted.

400

412

500

Curl Example:

curl -X DELETE "https://[email protected]/v1/aggregates/<aggregate_id>/"

---

Editing Your Aggregations

To edit an aggregation rule, you can do this through the Hosted Graphite UI. Additionally, aggregation rules have no state, so it is safe to delete and re-create them. Learn more about our Aggregate Rules Feature.

Aggregate Rules UI