Streamline data collection from your platform environment

Accessing cluster details is straightforward using kubectl. However, there are instances where required automation data is not stored within your Kubernetes cluster. This is where Asergo's GraphQL Dashboard excels.

Full feature parity

Perform anything the GUI allows directly via GraphQL. Consolidate complex workflows into single API calls alongside dashboard-level operations.

Consolidated data retrieval

Fetch multiple resources in one GraphQL request. No need for multiple kubectl invocations—use one query to get everything you need efficiently and predictably.

Flexible data streaming

Stream data not just to Asergo Prometheus, but to any external endpoint of your choice.

API in practice

An API endpoint for every infrastructure task with GraphQL

Do more than just check status — build, scale, and manage infrastructure dynamically. Our comprehensive API provides endpoints for every task, enabling seamless integration and automation within your existing systems.

query K8sDetails{
  viewer{kubernetes{cluster(id:"ahnu6"){
    name
    version
    implementation{nodes{
      id
      node_ip
      metadata{
        name
        isMaster
        isWorker
        upgradeStatus
      }
      status{
        conditions{
          type
          status
          message
        }
      }
      osVersionInfo{
        version
      }
    }}
  }}}
}

curl -s -X POST https://api.asergo.com/v1/graphql \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "viewer{kubernetes{cluster(id:\"abc123\"){id name k8sVersion}}}"
  }' | jq '.data.cluster'

import requests

response = requests.post(
    "https://api.asergo.com/v1/graphql",
    json={"query": "viewer{kubernetes{cluster(id:\"abc123\"){id name k8sVersion}}}"},
    headers={"Authorization": f"Bearer {API_KEY}"}
)

cluster = response.json()["data"]["cluster"]
print(f"Cluster {cluster['name']}: {cluster['status']}")

use reqwest;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    let response = client
        .post("https://api.asergo.com/v1/graphql")
        .header("Authorization", format!("Bearer {}", api_key))
        .json(&json!({
            "query": "viewer{kubernetes{cluster(id:\"abc123\"){id name k8sVersion}}}"
        }))
        .send()
        .await?;

    let data: serde_json::Value = response.json().await?;
    let cluster = &data["data"]["cluster"];
    println!("Cluster {}: {}", cluster["name"], cluster["status"]);
    Ok(())
}

-module(cluster_api).
-export([get_status/0]).

get_status() ->
    Query = "viewer{kubernetes{cluster(id:\"abc123\"){id name k8sVersion}}}",
    Body = jsx:encode(#{<<"query">> => list_to_binary(Query)}),
    Headers = [
        {<<"Authorization">>, <<"Bearer ", (list_to_binary(ApiKey))/binary>>},
        {<<"Content-Type">>, <<"application/json">>}
    ],

    case httpc:request(post, {
        "https://api.asergo.com/v1/graphql",
        Headers,
        "application/json",
        Body
    }, [], []) of
        {ok, {{_, 200, _}, _, ResponseBody}} ->
            {ok, Data} = jsx:decode(list_to_binary(ResponseBody)),
            Cluster = maps:get(<<"cluster">>, maps:get(<<"data">>, Data)),
            io:format("Cluster ~s: ~s~n", [maps:get(<<"name">>, Cluster), maps:get(<<"status">>, Cluster)]);
        {error, Reason} ->
            {error, Reason}
    end.

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

public class ClusterApi
{
    private static readonly HttpClient client = new HttpClient();

    public static async Task<dynamic> GetStatusAsync(string apiKey)
    {
        var query = "viewer{kubernetes{cluster(id:\"abc123\"){id name k8sVersion}}}";
        var requestBody = new { query };

        var json = JsonConvert.SerializeObject(requestBody);
        var content = new StringContent(json, Encoding.UTF8, "application/json");

        client.DefaultRequestHeaders.Authorization =
            new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", apiKey);

        var response = await client.PostAsync("https://api.asergo.com/v1/graphql", content);
        var responseContent = await response.Content.ReadAsStringAsync();

        dynamic data = JsonConvert.DeserializeObject(responseContent);
        var cluster = data.data.cluster;

        Console.WriteLine($"Cluster {cluster.name}: {cluster.status}");
        return cluster;
    }
}

Query data in one call

GraphQL allows fetching multiple resources (clusters, nodes, logs, status) in a structured query—replacing several kubectl commands with a single API request.

Infrastructure mutations

Create clusters, schedule upgrades, add DNS, reboot nodes—all via GraphQL mutations.

Data streaming options

While the API itself doesn't stream, you can fetch snapshots or logs and then post-process or forward them to external systems.

Identity & auth integration

Manage OIDC settings and using Dashboard credentials for Kubernetes auth.

Dashboard and GraphQL API

A Kubernetes dashboard built on top of our GraphQL API

All dashboard features are available through the GraphQL API. While real-time cluster data typically feeds directly into your Asergo Prometheus, you may require data streaming to an external endpoint outside Asergo's data centers or even echoing the data stream to utilize both Asergo Prometheus and an external endpoint.

GraphQL explorer llms_asergo_API.txt

Looking at Node Management data in the dashboard

GraphQL query to fetch the same data

query K8sDetails{
  viewer{kubernetes{cluster(id:"ahnu6"){
    name
    version
    implementation{nodes{
      id
      node_ip
      metadata{
        name
        isMaster
        isWorker
        upgradeStatus
      }
      status{
        conditions{
          type
          status
          message
        }
      }
      osVersionInfo{
        version
      }
    }}
  }}}
}

FAQ

Frequently Asked Questions

Here are some of the most frequently asked questions about Asergo. If you have any other questions, please contact us.