Hosted Graphite Docs
Get StartedBook a Demo
  • Welcome to Hosted Graphite
  • Getting Started
  • HG-CLI
  • Sending Metrics
    • Supported Protocols
    • Graphite Tag Support
    • Metric Management
    • Metric APIs
  • Language Guide
    • Metric Libraries
    • .NET
    • Go
    • Java
    • Javascript
    • Node.js
    • PHP
    • Postman
    • Python 2.x
    • Python 3.x
    • Python Pickle
    • Ruby
    • Shell
    • TypeScript
  • Dashboard and Graphs
    • Primary Dashboards
    • Dashboard Library
    • Local Dashboard Integration
    • Worldmap Panel
    • Graphite Dashboard Guide
    • Graphite Graph Menu Reference
    • Other Dashboard Options
  • Alerting Guide
    • Alerting Overview
    • Alerts API
    • Notification Channels API
    • Scheduled Mutes API
    • Using Your Own Alerting
  • Agents Guide
    • The Hosted Graphite Agent
      • Base Metrics
      • System Layout
    • Telegraf
    • K8 Telegraf Daemon
    • OpenTelemetry
    • collectd Agent
    • StatsD Agent
    • Diamond
  • Add-Ons and Integrations Guide
    • AWS CloudWatch
    • Azure Monitor Metrics
    • GCP Metrics
    • Carbon-C-Relay
    • Circle CI
    • Cloudbees
    • Collectd Add Ons
    • GitHub
    • GitLab
    • Heroku
    • Hosted StatsD
    • New Relic
    • Papertrail
    • Pingdom
    • Sentry
    • Sitespeed
    • StatsD Add-on
    • Statuspage
  • Account Management
    • Access Keys
    • Account Diagnostics
    • Account Settings
    • Team Access: Limited Access Groups
    • SAML Authentication
    • Team Access
  • Additional Features
    • Aggregation Rules
    • Data Views
  • API Guides
    • Metrics API
    • Tag API
    • Graphite Render API
    • Render Variables API
    • Dashboard API
    • Annotations and Events API
    • Aggregation Rules API
    • Alerts APIs
  • FAQ
    • General
    • Business
    • Technical
    • Account Metrics and Limiting
    • Customization
    • Troubleshooting
    • Support
    • Changelog
Powered by GitBook
On this page
  • Listing All Tags
  • Search Tagged Metrics
  • Locate Tagged Metrics and Values
  • Deleting Tagged Metrics
  • Monitoring your Tagged Metrics usage

Was this helpful?

  1. API Guides

Tag API

PreviousMetrics APINextGraphite Render API

Last updated 4 months ago

Was this helpful?

Contents

GET GET /api/v1/tags

HTTP/1.1 200
Content-Type: application/json
[
  "cluster",
  "host",
  "process",
  "service",
  "name"
]

Bad Request

Curl example:

curl -X GET "https://YOUR-API-KEY@api.hostedgraphite.com/api/v1/tags"

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

OK

Bad Request

Not Implemented

Curl example:

curl -X GET "https://YOUR-API-KEY@api.hostedgraphite.com/api/v1/tags/host?filter=prod-00*&limit=3"

Search for tag name host that matches the value prod, and only show 3 matching results.

GET /api/v1/tags/findSeries?

Path Parameters

Name
Type
Description

expr

String

Format: expr=tagname=tagvalue or expr=tagname1=tagvalue1&tagname2=tagvalue2 To search for the tagged series that match the expression, users should include both tagname and value in the query.

filter

String

Format: filter=prod-00* Tag value to search for.

limit

String

Format: limit=3 To limit the number of search results to the given number.

HTTP/1.1 200
Content-Type: application/json 
[
  "0.queue_backlog;cluster=prod;host=prod-egg-0021;process=grind;service=data_process",
  "2.queue_backlog;cluster=prod;host=prod-egg-0021;process=grind;service=data_process",
  "0.items;cluster=prod;host=prod-egg-001;process=dump;service=data_process"
]

Bad Request

Internal Server Error

Curl examples:

curl -X GET "https://YOUR-API-KEY@api.hostedgraphite.com/api/v1/tags/findSeries?expr=cluster=prod&host=egg-0001"

Search for tagged metric/series that match the expression cluster=prod&host=egg-0001

Response format with ‘?filter=machine-000*&limit=3’:

HTTP/1.1 200
Content-Type: application/json

{"tag": "host",
 "values": [{"count": 59, "value": "machine-0001"},
            {"count": 57, "value": "machine-0002"},
            {"count": 59, "value": "machine-0003"}]
}

POST /api/v1/tags/delSeries

OK

Bad Request

Curl example:

curl -X POST "https://YOUR-API-KEY@api.hostedgraphite.com/api/v1/tags/delSeries" --data-urlencode "path=foo.bar;tag1=val1;tag2=val2"

Delete all series that match the path foo.bar and tag1=val1 and tag2=val2.


You can also locate, search, and delete your tagged metrics from within our Tag Search UI:

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
Tag API
Listing All Tags
Search Tagged Metrics
Locate Tagged Metrics and Values
Deleting Tagged Metrics
Monitoring your Tagged Metrics usage
Listing All Tags
Search Tagged Metrics
Locate Tagged Metrics and Values
Deleting Tagged Metrics
Monitoring your Tagged Metrics usage
Total Tags in Account
Tag Search UI