Retrieve the list of metrics metadata sent to Bronto

curl --request GET \
  --url https://api.eu.bronto.io/metrics \
  --header 'X-BRONTO-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-BRONTO-API-KEY': '<api-key>'}};

fetch('https://api.eu.bronto.io/metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eu.bronto.io/metrics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-BRONTO-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eu.bronto.io/metrics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-BRONTO-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.eu.bronto.io/metrics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-BRONTO-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "metrics": [
    {
      "metric_id": "b013a07d-aa13-47c1-9c74-635e42b22cbb",
      "metric_name": "system.cpu.utilization",
      "type": "GAUGE",
      "description": "Difference in system.cpu.time since the last measurement per logical CPU, divided by the elapsed time (value in interval [0,1]).",
      "unit": "s",
      "aggregation_temporality": "DELTA",
      "default_aggregation": "sum",
      "default_query": {
        "aggregation": "avg",
        "filter": "service.name = 'checkout'",
        "group_by_keys": [
          "Resource:host.name"
        ],
        "chart_type": "line"
      },
      "metadata": {
        "last_heartbeat_at": 1791331200000
      }
    }
  ]
}

{
  "code": 400,
  "type": "Bad Request",
  "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
  "details": "Validation failed: 'name' field is required and cannot be empty"
}

{
  "code": 404,
  "type": "Not Found",
  "correlation_id": "605f832bcfe44a1081441691c8d42253",
  "details": "Resource not found."
}

{
  "code": 500,
  "type": "Internal Server Error",
  "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
  "details": "Internal Server Error"
}

GET

metrics

Retrieve the list of metrics metadata sent to Bronto

curl --request GET \
  --url https://api.eu.bronto.io/metrics \
  --header 'X-BRONTO-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-BRONTO-API-KEY': '<api-key>'}};

fetch('https://api.eu.bronto.io/metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eu.bronto.io/metrics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-BRONTO-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eu.bronto.io/metrics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-BRONTO-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.eu.bronto.io/metrics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-BRONTO-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "metrics": [
    {
      "metric_id": "b013a07d-aa13-47c1-9c74-635e42b22cbb",
      "metric_name": "system.cpu.utilization",
      "type": "GAUGE",
      "description": "Difference in system.cpu.time since the last measurement per logical CPU, divided by the elapsed time (value in interval [0,1]).",
      "unit": "s",
      "aggregation_temporality": "DELTA",
      "default_aggregation": "sum",
      "default_query": {
        "aggregation": "avg",
        "filter": "service.name = 'checkout'",
        "group_by_keys": [
          "Resource:host.name"
        ],
        "chart_type": "line"
      },
      "metadata": {
        "last_heartbeat_at": 1791331200000
      }
    }
  ]
}

{
  "code": 400,
  "type": "Bad Request",
  "correlation_id": "95c6a974e3ab01209b6b0dfedb1b16c5",
  "details": "Validation failed: 'name' field is required and cannot be empty"
}

{
  "code": 404,
  "type": "Not Found",
  "correlation_id": "605f832bcfe44a1081441691c8d42253",
  "details": "Resource not found."
}

{
  "code": 500,
  "type": "Internal Server Error",
  "correlation_id": "b129b8e0e66c41aa9541a30f67e38ce2",
  "details": "Internal Server Error"
}

Authorizations

X-BRONTO-API-KEY

string

header

required

Query Parameters

from_expr

string

Expression used to select the set of metrics to return. The expression defines the criteria for which metrics are included and is applied across all available metrics to produce the result set. Supports logical operators (AND, OR), comparison operators (=, !=), and quoted string literals. The fields are metric_id, metric_name, description, type, service and the metric's tags by their exact key, e.g. "Tag:environment". service and tags can hold several values; a comparison matches if any value matches, and a negated comparison matches if no value does. The parameter is optional; if it is not provided, all metrics are returned. If the expression matches no metrics, a 200 response with an empty metrics array is returned.

Response

list of metrics with metadata

metrics

object[]

Show child attributes

API overview

api-keys

users

groups

search

context

live-tail

logs

datasets

monitors

dashboards

collections

access

downtimes

events

forward

roles

top-keys

widgets

integrations

exports

customers

tags

limits

permissions

ai

policies

encryption-keys

metrics

timeseries

patterns

Retrieve the list of metrics metadata sent to Bronto

Authorizations

Query Parameters

Response