→ Applies to: SynetoOS 6.x

Create the Token to Access the API

Step 1. Login to SynetoOS GUI

Step 2. Click on the question mark in the top right-hand corner

Step 3. Click on View API explorer

You'll be redirected to Syneto Doorman API

Step 4. Search for POST and click on /v1/apiKeys

Step 5. Prepare this code with the information needed (replace <name>, <user>, <resource>, <network/subnet>, <validity> with the correct information)

{
  "name": "<name>",
  "owner": "<user>",
  "scopes": [
    {
      "resource": "/<resource>",
      "permissions": [ "GET" ]
    }
  ],
  "allowed_networks": [ "<network/subnet>" ],
  "validity": "<validity>"
}

name: an arbitrary name representing the app that uses the API key. For monitoring purposes, the name could be “monitoring”;

owner: any name;

resource: specifies the API endpoint for which the key is intended. For monitoring purposes, the resource name is “prometheus”;

permissions: defines the allowed methods (GET, POST, DELETE). For monitoring purposes, the correct value is “GET”;

allowed_network: indicates the networks from which the connection is allowed, with the format “0.0.0.0/0”;

validity: specifies the number of days the key will remain valid, suffixed with “d”. For example “1095d” (for three years).

Use the example below to enable access to the monitoring endpoint.

{
  "name": "monitoring",
  "owner": "admin",
  "scopes": [
    {
      "resource": "/prometheus",
      "permissions": [ "GET" ]
    }
  ],
   "allowed_networks": [
      "0.0.0.0/0"
    ],
  "validity": "1000d"
}

NOTE
“prometheus” is the endpoint to be monitored.

Step 6. Empty the “Request body” field and paste the code from Step 5

Step 7. Scroll down and click on TRY

Step 8. The system responds with a Response Status: 200 and a token will be provided

Save the token in a safe place, since this will be the only time it will be visible.
If you lost it, you have to create a new one.

API Endpoint URLs

Step 1. List all available metrics (replace <syneto-os-ip> with the correct information)

https://<syneto-os-ip>/prometheus/api/v1/label/__name__/values

Step 2. Query a specific metric (replace <syneto-os-ip> and <metric-name> with the correct information)

https://<syneto-os-ip>/prometheus/api/v1/query?query=<metric-name>

Step 3. Use the following command to query a metric (replace <api_key>, <syneto-os-ip> and <metric-name> with the correct information)

curl -k \
 -H "x-api-key: <api_key>" \
 "https://<syneto-os-ip>/prometheus/api/v1/query?query=<metric-name>"

EXAMPLE

curl -k \
 -H "x-api-key: 2v-gJC5bcfP9uZvaVcDNnLXvlUs422tm0covuSkRqbg" \
 "https://192.168.1.2/prometheus/api/v1/query?query=latest_replication_status"