Prometheus API

IBM® Cloud Private Version 3.1.2 uses Prometheus Version 2.0 to manage the metrics from scrape targets.

Both the cluster administrator and team administrator can access the Prometheus API.

You must access Prometheus through the Prometheus API service proxy.

To view the Prometheus API docs, see Prometheus HTTP API Opens in a new tab .

Running Prometheus API commands

When you run a Prometheus API command, you must obtain and specify the authentication header. See Preparing to run component or management API commands.

After you obtain that information, you can run Prometheus API commands. For example, to get the boot time for all nodes, run the following command:

curl -k -s -X GET -H "Authorization:Bearer $ACCESS_TOKEN" https://<Cluster Master Host>:<Cluster Master API Port>/prometheus/api/v1/query?query=node_boot_time_seconds

$ACCESS_TOKEN is the variable that stores the authentication token for your cluster.
<Cluster Master Host> and <Cluster Master API Port> are defined in Master endpoints.

The output resembles the following content:

{"status":"success","data":{"resultType":"vector","result":[{"metric":{"__name__":"node_boot_time","app":"monitoring-prometheus", \
"chart":"ibm-icpmonitoring-1.1.0","component":"nodeexporter","heritage":"Tiller","instance":"9.42.135.189:9100", \
"job":"kubernetes-service-endpoints","kubernetes_name":"monitoring-prometheus-nodeexporter","kubernetes_namespace":"kube-system", \
"release":"monitoring"},"value":[1523394278.231,"1521476293"]}, \
{"metric":{"__name__":"node_boot_time","app":"monitoring-prometheus","chart":"ibm-icpmonitoring-1.1.0", \
"component":"nodeexporter","heritage":"Tiller","instance":"9.42.135.84:9100","job":"kubernetes-service-endpoints", \
"kubernetes_name":"monitoring-prometheus-nodeexporter","kubernetes_namespace":"kube-system","release":"monitoring"}, \
"value":[1523394278.231,"1521476285"]},{"metric":{"__name__":"node_boot_time","app":"monitoring-prometheus", \
"chart":"ibm-icpmonitoring-1.1.0","component":"nodeexporter","heritage":"Tiller","instance":"9.42.78.191:9100", \
"job":"kubernetes-service-endpoints","kubernetes_name":"monitoring-prometheus-nodeexporter","kubernetes_namespace": \
"kube-system","release":"monitoring"},"value":[1523394278.231,"1521476254"]}]}}