Skip to main content

connection

Typed specification

Generated by the pinned ess generate --kind docs from adapters/grafana/spec/ess. Structural validation establishes consistency; behaviour, storage and cross-record predicates remain implementation obligations.

The Grafana local connection — its native configuration, the grafana.service_account and grafana.irm_service_account profiles and the configured identity probes that prove a service-account token.

connectors_grafana.connection is one of connectors_grafana's bounded contexts. Back to the index.

Types​

IdentityProbe​

connectors_grafana.connection.IdentityProbe is a record of four fields:

  • method — String
  • path — String
  • source — connectors_grafana.connection.IdentitySource
  • kind — String

Every value satisfies method == "GET", path == "api/datasources" and kind == "grafana.connection".

IdentitySource​

connectors_grafana.connection.IdentitySource is one of configuration.

InstanceId​

connectors_grafana.connection.InstanceId wraps String and is not interchangeable with one: the whole value of naming it separately is the crossings the model then refuses. Its characters are drawn from ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_.-. Every value satisfies (value.count >= 1 and value.count <= 128).

IrmIdentityProbe​

connectors_grafana.connection.IrmIdentityProbe is a record of six fields:

  • method — String
  • path — String
  • query — String
  • header — String
  • source — connectors_grafana.connection.IdentitySource
  • kind — String

Every value satisfies method == "GET", path == "api/v1/alert_groups/", query == "started_at=2000-01-01T00:00:00_2000-01-01T00:00:01&perpage=1", header == "X-Grafana-URL" and kind == "grafana.connection".

IrmServiceAccountProfile​

connectors_grafana.connection.IrmServiceAccountProfile is a record of nine fields:

  • id — String
  • scheme — String
  • capability — String
  • purpose — String
  • subject — String
  • minimum_scopes — List<String>
  • evidence_lifetime_ms — Integer
  • entry — String
  • identity — connectors_grafana.connection.IrmIdentityProbe

Every value satisfies id == "grafana.irm_service_account", scheme == "http_bearer", capability == "http-bearer", purpose == "service_account", subject == "app", minimum_scopes.count == 0, evidence_lifetime_ms == 60000 and entry == "connectors_grafana.connection.ServiceAccountEntry".

LocalConfiguration​

connectors_grafana.connection.LocalConfiguration is a record of five fields:

  • format — String
  • instance — connectors_grafana.connection.InstanceId
  • base_url — String
  • ca_file — Optional<String>, which may be absent
  • irm_api_url — Optional<String>, which may be absent

Every value satisfies format == "connectors-grafana-local/1", (base_url.count >= 8 and base_url.count <= 512), base_url starts_with "https://", (ca_file.count >= 1 and ca_file.count <= 4096), (irm_api_url.count >= 8 and irm_api_url.count <= 512) and irm_api_url starts_with "https://".

ServiceAccountEntry​

connectors_grafana.connection.ServiceAccountEntry is a record of one field:

  • token — connectors_grafana.connection.ServiceAccountToken

ServiceAccountProfile​

connectors_grafana.connection.ServiceAccountProfile is a record of nine fields:

  • id — String
  • scheme — String
  • capability — String
  • purpose — String
  • subject — String
  • minimum_scopes — List<String>
  • evidence_lifetime_ms — Integer
  • entry — String
  • identity — connectors_grafana.connection.IdentityProbe

Every value satisfies id == "grafana.service_account", scheme == "http_bearer", capability == "http-bearer", purpose == "service_account", subject == "app", minimum_scopes.count == 0, evidence_lifetime_ms == 60000 and entry == "connectors_grafana.connection.ServiceAccountEntry".

ServiceAccountToken​

connectors_grafana.connection.ServiceAccountToken wraps String and is not interchangeable with one: the whole value of naming it separately is the crossings the model then refuses. Its characters are drawn from !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_abcdefghijklmnopqrstuvwxyz{|}~. Every value satisfies (value.count >= 1 and value.count <= 8192)`.

Four of the types above are reached by nothing else in this system: connectors_grafana.connection.IrmServiceAccountProfile, connectors_grafana.connection.LocalConfiguration, connectors_grafana.connection.ServiceAccountEntry and connectors_grafana.connection.ServiceAccountProfile. No entity, view, command, event, error or crossing names them, so it is either vocabulary something outside this specification uses or a leftover — and only a person can tell which.

Generated from connectors_grafana v1 · model digest 5a16b14a6f74fe19a54b52e116e508d3918aa3e17aa0fc985cf6283b400eff6f · contract digest slice-sha256/2:d69e7fe810bd03b455db411ab24f5b9236c07edd16dbc7bac7f7b84195ec12f7. Do not edit this file; change the specification and regenerate it with ess generate.