Get Usage by Tag

GET

https://api.mezmo.com/v1/usage/tags/:name

GET

/v1/usage/tags/:name

curl -G https://api.mezmo.com/v1/usage/tags/name \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d from=1 \
     -d to=1

200Retrieved

{
  "payment-service": {
    "INFO": 45.3,
    "WARN": 3.2,
    "ERROR": 1.1,
    "request_latency_ms": 120.5,
    "error_rate_5xx": 0.02,
    "hosts": {
      "logs.acme-corp.io": 30.1,
      "telemetry.acme-corp.io": 19.5
    }
  },
  "auth-gateway": {
    "INFO": 60.7,
    "WARN": 2.5,
    "ERROR": 0.5,
    "request_latency_ms": 95.7,
    "error_rate_5xx": 0.01,
    "hosts": {
      "logs.acme-corp.io": 40.2,
      "telemetry.acme-corp.io": 23.5
    }
  },
  "order-processor": {
    "INFO": 50,
    "WARN": 4,
    "ERROR": 2,
    "request_latency_ms": 150.3,
    "error_rate_5xx": 0.03,
    "hosts": {
      "logs.acme-corp.io": 35,
      "telemetry.acme-corp.io": 21
    }
  }
}

Gets the aggregated usage information for a tag matching the name provided as a path parameter, during a time period. Returns null when not found.

Authentication

Authorizationstring

This key is used for all apis with the exception of ingest. You can obtain it following these instructions and placing the key in the header of your call in the format of Authorization: Token {accesstoken} For example:

curl -H 'Authorization: Token <ACCESS TOKEN>'

servicekeystring

(Deprecated) This key is used for v1 and v2 apis with the exception of ingest. Service keys can be used by placing your service key in the Authorization header of your api call. NOTE Usage of the service key auth mechanism has been deprecated in favor of IAM Access Tokens. Service keys can no longer be created, but can still be used for v1 and v2 apis while the transition takes place

Path parameters

namestringRequired

The name of the app from which to get the aggregated usage data

Query parameters

fromintegerRequired

Start date. Set as UNIX timestamp in seconds.

tointegerRequired

End date. Set as UNIX timestamp in seconds.

Authentication

Path parameters

Query parameters

Response