Plugins
Data sourceCommercial
Edelbyte Datasource logo

Edelbyte Datasource

Edelbyte

Get plugin

Edelbyte data source for Grafana

Edelbyte is the unified data platform for any data challenge, from search and analytics to AI applications, with an architecture designed from the ground up to make real-time performance practical and cost-efficient at scale. It runs in any cloud, self-hosted or on-premises, and queries data where it lives.

This plugin connects Grafana to an Edelbyte cluster, so you can query it from any panel, from Explore, and from alert rules. Edelbyte is queried in Kusto Query Language (KQL) or PostgreSQL-compatible SQL. This data source uses the KQL endpoint; teams working in SQL can reach the same cluster through Grafana's built-in PostgreSQL data source, and both can sit side by side on one dashboard.

You do not need to know KQL to get started. The visual query builder composes the query for you from a table, filters and aggregations, and the KQL editor completes table and column names from your cluster's schema and marks errors as you type.

What you can do

  • Visualize query results as tables, time series, logs or traces.
  • Build alert rules and annotations on queries against your cluster.
  • Drive dashboards with template variables backed by queries.
  • Compose queries in the visual builder, or write them directly in the KQL editor.
  • Mix this data source with Grafana's PostgreSQL data source on the same dashboard when some panels are written in SQL.
  • Authenticate with OAuth2 client credentials from Microsoft Entra ID or Amazon Cognito, or with an AWS IAM role.

Requirements

  • Grafana 11.6.11 or later, self-managed or Grafana Cloud.
  • An Edelbyte cluster reachable over HTTPS from the Grafana server.
  • An identity for the data source with the Viewer role on the cluster or on the databases you want to query.

Installation

Grafana Cloud: open Administration > Plugins and data, search for Edelbyte, and click Install.

Grafana CLI:

grafana cli plugins install edelbyte-kql-datasource

Restart Grafana after the install.

Configuration

Open Connections > Data sources > Add new data source and choose Edelbyte Datasource.

Cluster URL

Field Description
Cluster URL HTTPS URL of your cluster, for example https://cluster.edelbyte.cloud
Trust cluster host Only for a cluster on a custom domain, see below

The plugin sends access tokens only to hosts under the Edelbyte domains (.edelbyte.cloud, .edelbyte.dev). If your cluster runs on a custom domain such as https://logs.example.com, the connection test fails with cluster URL host "..." is not a trusted Edelbyte domain. Enable Trust cluster host to trust that one host, and only that host, for this data source. Enable it only for a domain you control.

Authentication

Pick an Auth Type. The remaining fields depend on it.

Auth Type authType Use when Fields
Client Credentials (OIDC) clientcredentials You have a client ID and secret from Microsoft Entra ID or Amazon Cognito. This is the option for Grafana Cloud. Issuer URL, Client ID, Client Secret
AWS IAM Role awsiam Grafana runs under an AWS IAM role (EC2, ECS, Fargate, EKS) and the cluster accepts AWS identities AWS Region, Audience, optionally Assume Role ARN and External ID

Client Credentials (OIDC). The plugin discovers the token endpoint from {issuerUrl}/.well-known/openid-configuration and the OAuth scope from the cluster's protected-resource document (RFC 9728). You do not configure a scope or audience. Issuer URLs:

Identity provider Issuer URL
Microsoft Entra ID https://login.microsoftonline.com/{tenantId}/v2.0
Amazon Cognito https://cognito-idp.{region}.amazonaws.com/{userPoolId}

AWS IAM Role. Credentials come from the AWS SDK default credential chain on the Grafana host (task role, instance role, IRSA), so no secrets are stored in Grafana. Only temporary, session-based credentials are accepted. Audience must match the audience configured on the cluster, and AWS Region must be the region you sign in. Set Assume Role ARN to have the plugin call sts:AssumeRole first; External ID is passed through when the role's trust policy requires it. The optional access key fields are for environments where no ambient credentials reach the plugin process; leave them empty in production.

Secrets are stored in Grafana's encrypted secure JSON data.

Additional settings

Field Description
Default database Preselected database in the query editor
Query timeout Client-side timeout per query, up to one hour
Use dynamic caching Caches each query for as long as its time bucket (bin size)
Cache max age Fixed cache lifetime when dynamic caching is off
Default editor mode Builder or KQL
OpenAI API key Optional. Enables the query generator, see Data sent to third parties

Click Save & test. The test resolves the cluster, authenticates and lists the databases the identity can see.

Provisioning

The same settings can be provisioned from YAML. Minimal Client Credentials (OIDC) example:

apiVersion: 1
datasources:
  - name: Edelbyte
    type: edelbyte-kql-datasource
    access: proxy
    jsonData:
      clusterUrl: https://cluster.edelbyte.cloud
      defaultDatabase: Telemetry
      authType: clientcredentials
      oidcIssuerUrl: https://login.microsoftonline.com/{tenantId}/v2.0
      oidcClientId: {clientId}
    secureJsonData:
      clientSecret: {clientSecret}

For a cluster on a custom domain add trustClusterHost: true to jsonData. For AWS IAM Role set authType: awsiam with awsIamRegion, awsIamAudience and optionally awsIamAssumeRoleArn and awsIamExternalId.

Querying

Select the Database and the Format in the query header, then write KQL or switch to Builder.

Format Use for
Table Any result shape, table panels, stat panels
Time series Graphs. The result needs a datetime column and at least one numeric column
Logs The Logs view in Explore and logs panels
Trace The Trace view in Explore. The result must follow Grafana's trace data frame structure

Time series:

Requests
| where $__timeFilter(Timestamp)
| summarize count() by bin(Timestamp, $__timeInterval), Region
| order by Timestamp asc

Table:

Requests
| where $__timeFilter(Timestamp) and StatusCode >= 500
| project Timestamp, Region, StatusCode, Path, DurationMs
| order by Timestamp desc

Macros

Macro Expands to
$__timeFilter(column) column >= datetime(<from>) and column <= datetime(<to>) for the dashboard time range
$__timeFrom datetime(<from>)
$__timeTo datetime(<to>)
$__timeInterval The panel interval as a timespan, for example 5000ms, for use in bin()
$__contains(column, $variable) column in ('a', 'b') for a multi-value variable. With the custom all value all it expands to 1 == 1

Template variables

Create a variable of type Query, pick the Edelbyte data source, and write a query that returns one column:

Requests | distinct Region

databases() returns the list of databases. Use the variable in a query with where Region == '$region', or for multi-value variables where Region in ($region) or $__contains(Region, $region).

Query builder

The builder lets you pick a table, add type-aware filters, aggregate and group (including time buckets), and expand dynamic columns into their properties from a sample of the data. Switch to the KQL editor at any time to see and edit the generated query.

Annotations

An annotation query returns a Timestamp column (datetime), a Text column (string) and optionally Tags (comma-separated string):

Deployments
| where $__timeFilter(Timestamp)
| project Timestamp, Text = strcat(Service, " ", Version), Tags = "deploy"

Alerting

Alert rules work with any query in Table or Time series format. Use $__timeFilter so the rule evaluates the configured window.

Data sent to third parties

The plugin sends data to the cluster you configure and nowhere else, with two optional exceptions that only apply when you use them:

  • Generate query (OpenAI editor mode) sends your prompt, with a fixed KQL instruction, to OpenAI (api.openai.com) using the OpenAI API key from the data source settings, or to the provider configured in the Grafana LLM app when that app is enabled.
  • Explain KQL sends the KQL text of the current query, with a fixed instruction, to the Grafana LLM app and its configured provider.

Nothing is sent until you click one of these buttons. Query results and schema are never sent. Leave the API key empty and the LLM app disabled to turn both features off. The plugin collects no usage statistics.

Troubleshooting

Symptom Check
Save & test fails The cluster URL starts with https://; the identity provider and cluster are reachable from the Grafana server
not a trusted Edelbyte domain The cluster runs on a custom domain. Enable Trust cluster host
No databases in the dropdown The data source identity lacks the Viewer role on the cluster or databases
Panel says the data is not a time series The query returns no datetime column or no numeric column. Switch to Table to inspect the result
AWS IAM Role: credentials not found The Grafana host has no task, instance or pod role; or the audience does not match the cluster's configuration

Links

Version
0.7.4
Dependencies
  • Grafana >=11.6.11
Developer
Edelbyte

Grafana Cloud

Connect any plugin in Grafana Cloud.

  • 150+ data source integrations
  • Grafana Assistant - AI that correlates your data, builds queries, and answers questions
  • 10k Prometheus metrics + 50 GB logs, traces, and profiles on the free tier
  • ...and more
Create free account