PackageTrack

Go modules · #2354

github.com/grafana/gcx

v1.2.0grafana/gcx ↗

Release timeline

81 releases since 2026
2026

Releases

  1. v1.2.1-0.20260826065151-37400f0b57a926 Aug 2026pre-release

    Nothing published for this version

  2. v1.2.025 Aug 2026
    Release notes

    Breaking changes

    • A locked OS keychain is now its own fatal failure class (Keychain locked). gcx stops credential-consuming commands instead of falling back to a plaintext write, and the error explains how to unlock the keychain for the session (#1142)
    • Remove the broken gcx assistant dashboard subcommand (#1230)

    New features

    • Add the Database Observability provider: gcx dbo11y instances list and gcx dbo11y instances get <name> (#1199)

    Fixes

    • Remove the duplicated --agent-id default from assistant help text (#1232)

    Other

    • Add keychain setup and troubleshooting reference docs (#1142)
    • Teach the add-datasource skill the shared raw-SQL contract (#1227)
    • Bump create-github-app-token to 0.3.1 and tune the CI review process (#1236, #1217)
    Open source →
    Additional notes2 sources agree

    Breaking changes

    • A locked OS keychain is now its own fatal failure class (Keychain locked). gcx stops credential-consuming commands instead of falling back to a plaintext write, and the error explains how to unlock the keychain for the session (#1142)
    • Remove the broken gcx assistant dashboard subcommand (#1230)

    New features

    • Add the Database Observability provider: gcx dbo11y instances list and gcx dbo11y instances get <name> (#1199)

    Fixes

    • Remove the duplicated --agent-id default from assistant help text (#1232)

    Other

    • Add keychain setup and troubleshooting reference docs (#1142)
    • Teach the add-datasource skill the shared raw-SQL contract (#1227)
    • Bump create-github-app-token to 0.3.1 and tune the CI review process (#1236, #1217)
    Open source →
  3. v1.1.2-0.20260824095703-4444e3fe924a24 Aug 2026pre-release

    Nothing published for this version

  4. v1.1.124 Aug 2026
    Release notes

    Datasources

    • Add support for the MySQL and Postgres datasources (#970, #969)
    • Add support for the Elasticsearch datasource (#971)
    • Add support for Azure Monitor and Google Cloud Monitoring (#965, #974)
    • Restructure the generic query router to keep it simple (#1141)
    • Add the experimental gcx traces diff command (#1165)

    Providers

    • Add notification commands to the knowledge graph provider (#1077)
    • Add gcx irm incidents get-pir for post-incident reviews (#1163)
    • Report otlpIngestEndpointURL from frontend applications (#1223)

    Login and configuration

    • Add --oauth-manual for hosts without a reachable callback (#1136)
    • Let environment credentials override a keychain failure (#1066)
    • Scope gcx config check to one explicit context (#1155)

    Fixes

    • Include otlp_url and otlp_username in the cluster configuration (#1198)
    • Correct the order of dashboards in the output (#1201)

    Performance

    • Build the discovery registry one time (#925)
    • Limit the parallel fan-out in resource commands (#925)

    Other

    • Detect the pi coding agent harness for agent mode (#1208)
    • Report the batch resource volume as size buckets (#1108)
    • Add a Grafana version support policy to the documentation (#1197)
    • Regenerate the command line interface reference (#1224)
    Open source →
    Additional notes2 sources agree

    Datasources

    • Add support for the MySQL and Postgres datasources (#970, #969)
    • Add support for the Elasticsearch datasource (#971)
    • Add support for Azure Monitor and Google Cloud Monitoring (#965, #974)
    • Restructure the generic query router to keep it simple (#1141)
    • Add the experimental gcx traces diff command (#1165)

    Providers

    • Add notification commands to the knowledge graph provider (#1077)
    • Add gcx irm incidents get-pir for post-incident reviews (#1163)
    • Report otlpIngestEndpointURL from frontend applications (#1223)

    Login and configuration

    • Add --oauth-manual for hosts without a reachable callback (#1136)
    • Let environment credentials override a keychain failure (#1066)
    • Scope gcx config check to one explicit context (#1155)

    Fixes

    • Include otlp_url and otlp_username in the cluster configuration (#1198)
    • Correct the order of dashboards in the output (#1201)

    Performance

    • Build the discovery registry one time (#925)
    • Limit the parallel fan-out in resource commands (#925)

    Other

    • Detect the pi coding agent harness for agent mode (#1208)
    • Report the batch resource volume as size buckets (#1108)
    • Add a Grafana version support policy to the documentation (#1197)
    • Regenerate the command line interface reference (#1224)
    Open source →
  5. v1.1.1-0.20260821231957-d7c3d5c656dd21 Aug 2026pre-release

    Nothing published for this version

  6. v1.1.1-0.20260820192314-2ceeb16a02b220 Aug 2026pre-release

    Nothing published for this version

  7. v1.1.1-0.20260814143643-ebfdc4c0479514 Aug 2026pre-release

    Nothing published for this version

  8. v1.1.014 Aug 2026
    Release notes

    Breaking changes

    • gcx agento11y collections add-conversations and gcx agento11y collections remove-conversation emit type: gcx.agento11y.collection_membership instead of gcx.aio11y.collection_membership. schema_version stays 1. No fields changed. Scripts that read type must accept the new value.

    New features

    • Add gcx profiles data-range for Pyroscope ingestion health.
    • Add the same data-range command under gcx datasources pyroscope.
    • Add gcx instrumentation explain and list-explanations for the finding explanations that ship with otel-checker (now v0.3.1).
    • Add an EXPLAIN_ID column to gcx instrumentation check table output, and an explain_id field to its JSON output. Pass the value to gcx instrumentation explain.
    • Add gcx assistant investigations list-evidence.
    • Show the chat ID next to the investigation ID in investigations get.
    • Keep full v2 investigation summaries and totals in list output.
    • Filter IRM alert groups by escalation chain and by date window.
    • Add agent support to gcx metrics list-names.
    • Add agent support to metrics label matching.

    Improvements

    • Check contexts concurrently in gcx config check.
    • Record target_kind in usage telemetry events.

    Fixes

    • Make gcx dev serve exit on Ctrl-C.
    • Set AllowsEdits so gcx-managed dashboards stay editable in the UI.
    • Keep configType in Fleet so OTel pipelines round-trip.
    • Support UTF-8 label names in profiles.
    • Match experiment report types and trial counts to the API.
    • Send guard redaction config as redact with {id, regex}.
    • Drop rule_id from the rules update PATCH body.
    • Handle an unavailable keychain safely during verification.

    Internal

    • Rename the aio11y Go package to agento11y.
    • Add the integrate-with-gcx and review-pr contributor skills.
    • Add a command naming conventions guide.
    • Restructure the Grafana Cloud documentation.
    • Pin GCX_AGENT_MODE=false for the test tasks.
    • Add data sources code owners for internal/datasources.
    Open source →
    Additional notes2 sources agree

    Breaking changes

    • gcx agento11y collections add-conversations and gcx agento11y collections remove-conversation emit type: gcx.agento11y.collection_membership instead of gcx.aio11y.collection_membership. schema_version stays 1. No fields changed. Scripts that read type must accept the new value.

    New features

    • Add gcx profiles data-range for Pyroscope ingestion health.
    • Add the same data-range command under gcx datasources pyroscope.
    • Add gcx instrumentation explain and list-explanations for the finding explanations that ship with otel-checker (now v0.3.1).
    • Add an EXPLAIN_ID column to gcx instrumentation check table output, and an explain_id field to its JSON output. Pass the value to gcx instrumentation explain.
    • Add gcx assistant investigations list-evidence.
    • Show the chat ID next to the investigation ID in investigations get.
    • Keep full v2 investigation summaries and totals in list output.
    • Filter IRM alert groups by escalation chain and by date window.
    • Add agent support to gcx metrics list-names.
    • Add agent support to metrics label matching.

    Improvements

    • Check contexts concurrently in gcx config check.
    • Record target_kind in usage telemetry events.

    Fixes

    • Make gcx dev serve exit on Ctrl-C.
    • Set AllowsEdits so gcx-managed dashboards stay editable in the UI.
    • Keep configType in Fleet so OTel pipelines round-trip.
    • Support UTF-8 label names in profiles.
    • Match experiment report types and trial counts to the API.
    • Send guard redaction config as redact with {id, regex}.
    • Drop rule_id from the rules update PATCH body.
    • Handle an unavailable keychain safely during verification.

    Internal

    • Rename the aio11y Go package to agento11y.
    • Add the integrate-with-gcx and review-pr contributor skills.
    • Add a command naming conventions guide.
    • Restructure the Grafana Cloud documentation.
    • Pin GCX_AGENT_MODE=false for the test tasks.
    • Add data sources code owners for internal/datasources.
    Open source →
  9. v1.0.1-0.20260813131436-d31e00b75b4013 Aug 2026pre-release

    Nothing published for this version

  10. v1.0.1-0.20260805171018-d85236fddfd25 Aug 2026pre-release

    Nothing published for this version

  11. v1.0.1-0.20260805141756-c516236a6bdb5 Aug 2026pre-release

    Nothing published for this version

  12. v1.0.1-0.20260731143634-07be5700c3fb31 Jul 2026pre-release

    Nothing published for this version

  13. v1.0.1-0.20260728135205-32dcfcad14c428 Jul 2026pre-release

    Nothing published for this version

  14. v1.0.028 Jul 2026
    Release notes

    Features

    • alert: add ruler subtree for datasource-managed rule writes
    • kg: add entities correlate to resolve entities from alert labels
    • kg: add entity quality reports (kg quality), folded into kg diagnose

    Fixes

    • alert: make GMA alert rules modifiable via the resources tier
    • cloud: drop status/createdAt/updatedAt from stack regions output
    • aio11y: point plugin id at renamed grafana-agento11y-app

    Docs

    • GA: remove public preview warnings, add GA notes across docs and README
    • skills: harden agento11y-instrument and agento11y-prod-setup guidance
    • stop prescribing Editor/Admin for service-account tokens; installation fixes
    Open source →
    Additional notes2 sources agree

    Features

    • alert: add ruler subtree for datasource-managed rule writes
    • kg: add entities correlate to resolve entities from alert labels
    • kg: add entity quality reports (kg quality), folded into kg diagnose

    Fixes

    • alert: make GMA alert rules modifiable via the resources tier
    • cloud: drop status/createdAt/updatedAt from stack regions output
    • aio11y: point plugin id at renamed grafana-agento11y-app

    Docs

    • GA: remove public preview warnings, add GA notes across docs and README
    • skills: harden agento11y-instrument and agento11y-prod-setup guidance
    • stop prescribing Editor/Admin for service-account tokens; installation fixes
    Open source →
  15. v0.6.1-0.20260727094134-86a5ce01d66d27 Jul 2026pre-release

    Nothing published for this version

  16. v0.6.024 Jul 2026
    Release notes

    Breaking changes

    • Naming convergence: verb-first subcommand renames across all providers
      (e.g. versions→list-versions, create→upsert, summary→stats)
    • Config split into separate stacks, cloud entries, and contexts (auto-migrates)
    • Agent output contract: one JSON document per finite command
    • Profiles: profile-types renamed to list-profile-types at both mounts
    • Alert: dropped create/update/apply aliases from templates upsert

    Features

    • Telemetry: first-run notice and default-on anonymous usage stats
    • Output: list truncation contract with honest caps and agent-legible metadata
    • aio11y: experiments v2 shapes and commands, plus conversation annotations
    • kg: --dry-run for model-rules and prom-rules upsert
    • Profiles: time-range flags for labels and list-profile-types

    Fixes

    • Cloud: stop misreporting invalid stack slugs as "slug already taken"
    • appo11y: honor --config across the direct command tree
    • aio11y: honor --config in direct agento11y CRUD commands
    • irm: decode expanded webhook integration filters

    Docs

    • Added anonymous usage statistics page; fixed usage-stats command examples
    Open source →
    Additional notes2 sources agree

    Breaking changes

    • Naming convergence: verb-first subcommand renames across all providers (e.g. versions→list-versions, create→upsert, summary→stats)
    • Config split into separate stacks, cloud entries, and contexts (auto-migrates)
    • Agent output contract: one JSON document per finite command
    • Profiles: profile-types renamed to list-profile-types at both mounts
    • Alert: dropped create/update/apply aliases from templates upsert

    Features

    • Telemetry: first-run notice and default-on anonymous usage stats
    • Output: list truncation contract with honest caps and agent-legible metadata
    • aio11y: experiments v2 shapes and commands, plus conversation annotations
    • kg: --dry-run for model-rules and prom-rules upsert
    • Profiles: time-range flags for labels and list-profile-types

    Fixes

    • Cloud: stop misreporting invalid stack slugs as "slug already taken"
    • appo11y: honor --config across the direct command tree
    • aio11y: honor --config in direct agento11y CRUD commands
    • irm: decode expanded webhook integration filters

    Docs

    • Added anonymous usage statistics page; fixed usage-stats command examples
    Open source →
  17. v0.5.1-0.20260723164805-1ffe1f6868d023 Jul 2026pre-release

    Nothing published for this version

  18. v0.5.021 Jul 2026
    Release notes
    • Register the Assistant as a first-class provider, moving mcp-servers into the resources pipeline
    • Breaking: rename the aio11y command tree and skills to agento11y
    • Breaking: rename the agento11y-eval-starter skill to agento11y-test-starter
    • Add agento11y-instrument skill (setup → instrument → verify loop)
    • Add agento11y-prod-setup skill for production evals and guards
    • Bundle the agento11y-test-starter starter skill
    • Breaking: remove the explore-datasources skill
    • Retune skill descriptions and fix API drift in aio11y, SLO, and Synthetics guidance
    • Export anonymous usage events as flat JSON over HTTP when telemetry is enabled
    • Add profiles span and trace selectors; include trace IDs in exemplars
    • Fix profiles --top totals to exclude the pre-window boundary point
    • Add KG prom-rules schema command and --dry-run to suppressions create
    • Route KG write API through the Asserts plugin proxy
    • Fix KG entity/relationship deletes to use the collection-path API
    • Support Dashboard V2 in the resource linter
    • Descend into single-key list envelopes for --json discovery and selection
    • Include an output-shape hint in --jq runtime errors
    • Request full cloud scopes in the login cloud followup flow
    • Derive SDK imports for generated dev import code from actual usage
    • Disclose per-product Grafana Cloud costs in docs and help text
    • Clarify gcx works with OSS and Enterprise, not just Cloud
    • Mark the traces --llm flag experimental and document its Accept header
    Open source →
    Additional notes2 sources agree
    • Register the Assistant as a first-class provider, moving mcp-servers into the resources pipeline
    • Breaking: rename the aio11y command tree and skills to agento11y
    • Breaking: rename the agento11y-eval-starter skill to agento11y-test-starter
    • Add agento11y-instrument skill (setup → instrument → verify loop)
    • Add agento11y-prod-setup skill for production evals and guards
    • Bundle the agento11y-test-starter starter skill
    • Breaking: remove the explore-datasources skill
    • Retune skill descriptions and fix API drift in aio11y, SLO, and Synthetics guidance
    • Export anonymous usage events as flat JSON over HTTP when telemetry is enabled
    • Add profiles span and trace selectors; include trace IDs in exemplars
    • Fix profiles --top totals to exclude the pre-window boundary point
    • Add KG prom-rules schema command and --dry-run to suppressions create
    • Route KG write API through the Asserts plugin proxy
    • Fix KG entity/relationship deletes to use the collection-path API
    • Support Dashboard V2 in the resource linter
    • Descend into single-key list envelopes for --json discovery and selection
    • Include an output-shape hint in --jq runtime errors
    • Request full cloud scopes in the login cloud followup flow
    • Derive SDK imports for generated dev import code from actual usage
    • Disclose per-product Grafana Cloud costs in docs and help text
    • Clarify gcx works with OSS and Enterprise, not just Cloud
    • Mark the traces --llm flag experimental and document its Accept header
    Open source →
  19. v0.4.5-0.20260717154515-0f92fb07d53017 Jul 2026pre-release

    Nothing published for this version

  20. v0.4.5-0.20260713065025-a666b533ff1c13 Jul 2026pre-release

    Nothing published for this version

  21. v0.4.410 Jul 2026
    Release notes
    • Add full CRUD lifecycle for datasources (create, update, delete, health, schemas)
    • Add --name filter to datasources list
    • Parallelize per-plugin-group datasource list fetch for speed
    • Add CRUD verbs and discovery for IRM OnCall resources
    • Fix IRM build break from a semantic merge conflict
    • Add OAuth login flow for gcx cloud login (grafana.com), marked experimental
    • Expand OAuth scopes; drop k6 from write scopes; fix login help text/doc links
    • Add anonymous usage stats core library (telemetry, not yet wired in)
    • Add fail-safe client-side dry-run for APIs that ignore dryRun
    • Add metrics cardinality analysis commands
    • Add filter, group-by, and label discovery to appo11y services commands
    • Add assistant mcp-servers command group
    • Add knowledge graph entity & relationship write commands (gated, experimental)
    • Add x-client-id header to Synthetic Monitoring requests
    • Fix logs: distinguish structured metadata from indexed stream labels
    • Skip /bootdata namespace validation when stack-id is set (faster config load)
    • Dedupe HTTP client construction/error parsing across providers
    • Dedupe Prometheus/Loki/CloudWatch onto shared query transport
    • Dedupe aio11y marshal/status-check/decode pattern
    • Dedupe datasources config-loading boilerplate
    • Add drift check ensuring bundled skills match real gcx commands
    • Switch lint to Go module mode, dropping the vendor/ requirement
    • Update Go dependencies
    • Fix docs links in README, CLI help text, and OAuth login docs
    • Use main branch for deploy previews; update SM CODEOWNERS
    Open source →
    Additional notes2 sources agree
    • Add full CRUD lifecycle for datasources (create, update, delete, health, schemas)
    • Add --name filter to datasources list
    • Parallelize per-plugin-group datasource list fetch for speed
    • Add CRUD verbs and discovery for IRM OnCall resources
    • Fix IRM build break from a semantic merge conflict
    • Add OAuth login flow for gcx cloud login (grafana.com), marked experimental
    • Expand OAuth scopes; drop k6 from write scopes; fix login help text/doc links
    • Add anonymous usage stats core library (telemetry, not yet wired in)
    • Add fail-safe client-side dry-run for APIs that ignore dryRun
    • Add metrics cardinality analysis commands
    • Add filter, group-by, and label discovery to appo11y services commands
    • Add assistant mcp-servers command group
    • Add knowledge graph entity & relationship write commands (gated, experimental)
    • Add x-client-id header to Synthetic Monitoring requests
    • Fix logs: distinguish structured metadata from indexed stream labels
    • Skip /bootdata namespace validation when stack-id is set (faster config load)
    • Dedupe HTTP client construction/error parsing across providers
    • Dedupe Prometheus/Loki/CloudWatch onto shared query transport
    • Dedupe aio11y marshal/status-check/decode pattern
    • Dedupe datasources config-loading boilerplate
    • Add drift check ensuring bundled skills match real gcx commands
    • Switch lint to Go module mode, dropping the vendor/ requirement
    • Update Go dependencies
    • Fix docs links in README, CLI help text, and OAuth login docs
    • Use main branch for deploy previews; update SM CODEOWNERS
    Open source →
  22. v0.4.4-0.20260705005855-07fa8b09a48a5 Jul 2026pre-release

    Nothing published for this version

  23. v0.4.31 Jul 2026
    Release notes
    • Query: fall back to /api/ds/query on any non-200 from the k8s query API
    • Pyroscope: default the metrics query step from the datasource config
    • Knowledge Graph: apply the selected time range to entity scopes lookup
    • Agent mode: mark cloud-only commands via new agent.availability annotation
    • Windows: open OAuth browser via explorer.exe so the login URL survives
    • CI: auto-publish the Homebrew formula and drop dead docs jobs
    Open source →
    Additional notes2 sources agree
    • Query: fall back to /api/ds/query on any non-200 from the k8s query API
    • Pyroscope: default the metrics query step from the datasource config
    • Knowledge Graph: apply the selected time range to entity scopes lookup
    • Agent mode: mark cloud-only commands via new agent.availability annotation
    • Windows: open OAuth browser via explorer.exe so the login URL survives
    • CI: auto-publish the Homebrew formula and drop dead docs jobs
    Open source →
  24. v0.4.229 Jun 2026
    Release notes
    • Add Athena datasource provider (query, list catalogs/databases/tables, describe-table)
    • Introduce shared SQL query package, refactoring ClickHouse onto it
    • Synthetic Monitoring now syncs via a Grafana datasource proxy client
    • Set X-Grafana-Caller-Id header on all datasource queries
    • Refine output formatting (format and jq handling)
    • Remove obsolete publish-technical-documentation workflows
    Open source →
    Additional notes2 sources agree
    • Add Athena datasource provider (query, list catalogs/databases/tables, describe-table)
    • Introduce shared SQL query package, refactoring ClickHouse onto it
    • Synthetic Monitoring now syncs via a Grafana datasource proxy client
    • Set X-Grafana-Caller-Id header on all datasource queries
    • Refine output formatting (format and jq handling)
    • Remove obsolete publish-technical-documentation workflows
    Open source →
  25. v0.4.124 Jun 2026
    Release notes
    • Breaking: --log-http-payload has been renamed to --insecure-log-http-payload. The old flag name now exits with an error naming the replacement. Payload-dump behavior is unchanged — credentials, cookies, OAuth refresh tokens, and request bodies still appear in the dump when the flag is set. A startup warning is now printed to stderr when the flag is active.
    • Breaking: gcx dev serve --address now defaults to 127.0.0.1 (loopback) instead of 0.0.0.0. Users who need LAN or remote access should pass --address 0.0.0.0 explicitly. The WebSocket livereload endpoint now rejects cross-origin requests from hosts other than localhost, 127.0.0.1, [::1], or the configured listen address.
    • Soft-breaking: Custom Rego rules loaded via gcx dev lint --rules can no longer call http.send, any net.* builtin, or opa.runtime. No flag is provided to re-enable them. Bundled rules are unaffected.
    • Added --jq for inline JSON transformation and improved agent-mode hints.
    • Added OAuth login support for agent and non-interactive workflows.
    • Improved config performance with lazy keychain checks and StackID caching.
    • Moved stack management under the gcx cloud stacks command group.
    • Added App O11y service list, get, map, and operation breakdown commands.
    • Added Instrumentation Hub gcx instrumentation check diagnostics.
    • Expanded Assistant investigations with Lodestone v2 capability detection.
    • Expanded Knowledge Graph diagnose, meta metrics, and model-rules support.
    • Improved IRM incident filtering, paging, and OnCall escalation output.
    • Added metrics instant-query timestamps and richer Tempo tag-value output.
    • Hardened local debug surfaces and JSON error output for agent workflows.
    Open source →
    Additional notes2 sources agree
    • Breaking: --log-http-payload has been renamed to --insecure-log-http-payload. The old flag name now exits with an error naming the replacement. Payload-dump behavior is unchanged — credentials, cookies, OAuth refresh tokens, and request bodies still appear in the dump when the flag is set. A startup warning is now printed to stderr when the flag is active.
    • Breaking: gcx dev serve --address now defaults to 127.0.0.1 (loopback) instead of 0.0.0.0. Users who need LAN or remote access should pass --address 0.0.0.0 explicitly. The WebSocket livereload endpoint now rejects cross-origin requests from hosts other than localhost, 127.0.0.1, [::1], or the configured listen address.
    • Soft-breaking: Custom Rego rules loaded via gcx dev lint --rules can no longer call http.send, any net.* builtin, or opa.runtime. No flag is provided to re-enable them. Bundled rules are unaffected.
    • Added --jq for inline JSON transformation and improved agent-mode hints.
    • Added OAuth login support for agent and non-interactive workflows.
    • Improved config performance with lazy keychain checks and StackID caching.
    • Moved stack management under the gcx cloud stacks command group.
    • Added App O11y service list, get, map, and operation breakdown commands.
    • Added Instrumentation Hub gcx instrumentation check diagnostics.
    • Expanded Assistant investigations with Lodestone v2 capability detection.
    • Expanded Knowledge Graph diagnose, meta metrics, and model-rules support.
    • Improved IRM incident filtering, paging, and OnCall escalation output.
    • Added metrics instant-query timestamps and richer Tempo tag-value output.
    • Hardened local debug surfaces and JSON error output for agent workflows.
    Open source →
  26. v0.4.1-0.20260619104858-87d2b276ca2a19 Jun 2026pre-release

    Nothing published for this version

  27. v0.4.1-0.20260618084325-761128aa443018 Jun 2026pre-release

    Nothing published for this version

  28. v0.4.1-0.20260611125145-74fff38ba3e811 Jun 2026pre-release

    Nothing published for this version

  29. v0.4.1-0.20260605230247-9f5025b381f15 Jun 2026pre-release

    Nothing published for this version

  30. v0.4.1-0.20260603161010-f28846fc9abd3 Jun 2026pre-release

    Nothing published for this version

  31. v0.4.02 Jun 2026
    Release notes
    • Added gcx assistant conversation list and gcx assistant conversation get to inspect Assistant conversations and transcripts.
    • Added support for continuing accessible non-CLI Assistant conversations by context ID, with a warning when the source is not CLI.
    • Added automatic migration of token-shaped config secrets into the OS keychain, with plaintext fallback when the keychain is unavailable.
    • Breaking: renamed gcx kg rules to gcx kg prom-rules to align with model-rules and relabel-rules.
    • Added read-only gcx kg relabel-rules get for prologue, epilogue, and generated rule groups.
    • Fixed kg diagnose verdicts so failing checks no longer report a healthy service, and reclassify scoped no-data checks as label-scope warnings when unscoped data exists.
    • Shared Grafana datasource query transport and dataframe wire types across ClickHouse, InfluxDB, and Infinity clients.
    • Hardened Claude GitHub Actions secret handling by scoping Vault outputs and restricting @claude triggers to trusted repository associations.
    • Improved agent guidance for dashboard workflows and Tempo trace analysis, including recommending gcx traces get --llm -o json for full-trace analysis.
    • Removed several small direct dependencies in favor of internal implementations.
    Open source →
    Additional notes2 sources agree
    • Added gcx assistant conversation list and gcx assistant conversation get to inspect Assistant conversations and transcripts.
    • Added support for continuing accessible non-CLI Assistant conversations by context ID, with a warning when the source is not CLI.
    • Added automatic migration of token-shaped config secrets into the OS keychain, with plaintext fallback when the keychain is unavailable.
    • Breaking: renamed gcx kg rules to gcx kg prom-rules to align with model-rules and relabel-rules.
    • Added read-only gcx kg relabel-rules get for prologue, epilogue, and generated rule groups.
    • Fixed kg diagnose verdicts so failing checks no longer report a healthy service, and reclassify scoped no-data checks as label-scope warnings when unscoped data exists.
    • Shared Grafana datasource query transport and dataframe wire types across ClickHouse, InfluxDB, and Infinity clients.
    • Hardened Claude GitHub Actions secret handling by scoping Vault outputs and restricting @claude triggers to trusted repository associations.
    • Improved agent guidance for dashboard workflows and Tempo trace analysis, including recommending gcx traces get --llm -o json for full-trace analysis.
    • Removed several small direct dependencies in favor of internal implementations.
    Open source →
  32. v0.3.1-0.20260618081835-5f287ca9683618 Jun 2026pre-release

    Nothing published for this version

  33. v0.3.1-0.20260527192149-33d1c41e249327 May 2026pre-release

    Nothing published for this version

  34. v0.3.1-0.20260527091307-f2bc232ad46327 May 2026pre-release

    Nothing published for this version

  35. v0.3.026 May 2026
    Release notes2 sources agree
    • Added ClickHouse, CloudWatch, and Infinity datasource providers.
    • Added richer IRM OnCall alert groups and SRE triage tooling.
    • Added a create-dashboard skill and dashboard list --limit flag.
    • Improved KG diagnosis for trace propagation and split environments.
    • Fixed KG rule list/get/delete calls to match the backend API.
    • Added dual k6 client support for OAuth and service-account tokens.
    • Fixed k6 provider support for OAuth login.
    • Made aio11y experiment cancellation require confirmation.
    • Warn when API responses return HTML instead of JSON.
    • Exit cleanly on Ctrl+C without noisy errors.
    • Normalized dashboard snapshot time ranges.
    • Removed target-valid-logql rule to restore go install compatibility.
    • Updated login help and Homebrew publishing.
    Open source →
  36. v0.2.17-0.20260522203517-7a9059c73a7422 May 2026pre-release

    Nothing published for this version

  37. v0.2.17-0.20260521132924-41c5528dc06121 May 2026pre-release

    Nothing published for this version

  38. v0.2.1621 May 2026
    Release notes2 sources agree
    • Add aio11y experiments command group for managing evaluation experiments
    • Add aio11y guards subcommand for managing hook rules
    • Fix kg insights chart and sources request/response schemas
    • Fix k6 token piping warning to reference the correct command
    • Centralize signal command wiring across metrics, logs, traces, and profiles
    • Consolidate error types into internal/gcxerrors, removing fail shims
    • Surface diagnose-entity-graph and document how skills get invoked
    • Mint Homebrew tap App token via broker in release workflow
    • Replace Dependabot with Renovate for dependency updates
    • Update Go module dependencies
    Open source →
  39. v0.2.16-0.20260520112926-f1590022d07720 May 2026pre-release

    Nothing published for this version

  40. v0.2.16-0.20260519125608-abba1ca5425519 May 2026pre-release

    Nothing published for this version

  41. v0.2.1518 May 2026
    Release notes2 sources agree
    • New: gcx instrumentation command tree — clusters, services, setup, status
    • New: InfluxDB datasource provider
    • New: gcx irm incidents contexts list command
    • New: Knowledge Graph diagnose command
    • Profiles query: add --profile-id and --stacktrace-selector flags
    • Profiles query: add pprof output format
    • Profiles query: hint at profile-types command in --profile-type help
    • Breaking: rename kg health to kg summary with restructured output
    • Breaking: remove duplicate kg scopes command (use kg entities scopes)
    • Breaking: remove UI-centric kg insights query/summary/graph commands
    • Breaking: move cypher under kg entities cypher
    • Breaking: unify insight filtering under kg entities list --insight
    • Surface propagated assertions in kg entities list
    • Add insight filter flags to kg entities inspect
    • Improve kg entities help text and surface scope props in schema
    • Fix kg insights search endpoint to /v1/assertions/search
    • Fix config use-context to write to the right file when a local .gcx.yaml is loaded
    • Fix login to derive context name from --server when no name is given
    • Fix datasource kind normalization to recognize Prometheus flavor plugins
    • Eliminate redundant datasource GET after auto-discovery
    • Include valid values in enum-shaped error messages
    • Remove superseded gcx setup instrumentation subtree
    • Refactor pyroscope query to use Options pattern
    • Docs: document --time flag for instant queries on explore-datasources
    • Docs: add manifest examples to gcx irm incidents create
    • Docs: move mounting docs to public documentation; fix broken anchor
    • Add CODEOWNERS with product team co-ownership
    • Add docs sync to the website repo on merge to main
    Open source →
  42. v0.2.15-0.20260513121030-3f1d3d810ce313 May 2026pre-release

    Nothing published for this version

  43. v0.2.15-0.20260512232926-b956618196cb12 May 2026pre-release

    Nothing published for this version

  44. v0.2.15-0.20260512112221-eb29f45bbb8b12 May 2026pre-release

    Nothing published for this version

  45. v0.2.15-0.20260511221055-f135d4c23b7f11 May 2026pre-release

    Nothing published for this version

  46. v0.2.15-0.20260511082816-85e6036d877311 May 2026pre-release

    Nothing published for this version

  47. v0.2.149 May 2026
    Release notes2 sources agree
    • New: Instrumentation Hub provider package with full CRUD, RMW, and Helm formatter support
    • New: Alert provisioning CRUD — contact-points, mute-timings, notification-policies, and templates
    • New: AI Observability saved-conversations and collections commands
    • New: gcx version structured subcommand with machine-readable output
    • New: gcx assistant dashboard subcommand; fix --agent-id flag
    • New: Login accepts --org-id to configure organization ID
    • Knowledge Graph entities list now supports pagination
    • Knowledge Graph inspect drops hardcoded filters for raw, agent-friendly output
    • Agents codec with temp-file spill for token-efficient agent output
    • Log failed agent invocations to disk for capability-gap analysis
    • Fix exit codes: usage errors emit 2, partial failures emit 4
    • stacks delete: rename --yes to --force; respect agent mode
    • Migrate all provider delete commands to consistent ConfirmDestructive
    • Fix non-interactive confirmation bypass for metrics adaptive and alert
    • Config check now classifies .grafana.com hosts and stack-id as Cloud
    • Login now suggests running config check after successful login
    • Fix IRM incident URL template to use correct OnCall plugin slug
    • Dev import: register v1 converters for Folder and Dashboard resources
    • --json list field discovery now returns all nested paths recursively (previously limited to top-level + one level of spec.*). Users relying on gcx resources get --json list or gcx resources schemas --json list will see a larger field set.
    Open source →
  48. v0.2.14-0.20260506191712-226d20b7041e6 May 2026pre-release

    Nothing published for this version

  49. v0.2.136 May 2026
    Release notes2 sources agree

    Note: This release includes two important bugfixes

    • Fix --dry-run not being honored in resource delete operations. PR #643.
    • Fix --context flag not applied across all CRUD adapter operations. PR #625.

    Update to this version to avoid unintended operations on your Grafana Cloud stack.

    Other changes in this release:

    • Add gcx stacks commands: list, get, create, update, delete, regions
    • Rename synth provider to synthetic-monitoring
    • Render trace trees as a formatted table in gcx traces get
    • Add RCA Workbench deep link to gcx kg entities inspect
    • Consolidate Knowledge Graph insights filtering into kg entities list
    • Prevent env var secrets from being written to the config file
    • Handle read-only files gracefully during skill updates
    • Update agent skills to remove common usage errors
    • Bump Go module and GitHub Actions dependencies
    Open source →
  50. v0.2.124 May 2026
    Release notes2 sources agree
    • Dashboards: new CRUD, search, and version history provider
    • Dashboards: dev server syncs variable params to URL and restores on refresh
    • Knowledge Graph: add suppressions list and suppressions delete commands
    • Knowledge Graph: fix suppressions overwrite bug
    • Knowledge Graph: replace kg inspect with entities inspect (LLM summary)
    • Knowledge Graph: align all kg commands to [noun] [verb] format
    • Knowledge Graph: improve entities list usability
    • Login: support custom OAuth callback port via --callback-port
    • Login: bind OAuth callback port before opening browser to avoid race
    • Login: step-aware errors during connectivity validation
    • Profiles: add exemplars support (exemplars profile and exemplars span)
    • Datasources: add Grafana Explore share links for query results
    • Notifications: alert users when a new gcx version is available
    • Skills: notify users when installed skills have updates
    • Assistant: gracefully block commands on self-hosted Grafana instances
    • Linter: detect missing title/description on panels in collapsed rows
    • Tooling: replace devbox with mise for dev environment setup
    Open source →
  51. v0.2.12-0.20260504080507-80c766f3ee484 May 2026pre-release

    Nothing published for this version

  52. v0.2.12-0.20260430105858-0e39a5e7eab330 Apr 2026pre-release

    Nothing published for this version

  53. v0.2.12-0.20260429083812-748ba49b578729 Apr 2026pre-release

    Nothing published for this version

  54. v0.2.1129 Apr 2026
    Release notes2 sources agree
    • Add mTLS client certificate authentication for config and login (Teleport)
    • Add kg describe command for schema, scopes, and telemetry configs
    • Add skills update command to update existing installed skills
    • Fix metrics default view to be usable out of the box
    • Fix synthetic monitoring to surface required scopes on register/install failure
    • Fix grafana-com instance selector regression
    • Fix config set/unset to resolve bare paths against the current context
    • Fix front matter in the debug-with-grafana skill
    • Update README with sigil/aio11y rename and restored Compatibility section
    • Update Go dependencies, GitHub Actions, and MySQL Docker tag to v9.7
    • Remove PyPI publishing job from release CI
    Open source →
  55. v0.2.11-0.20260427142542-ebb64ec1714827 Apr 2026pre-release

    Nothing published for this version

  56. v0.2.11-0.20260427074344-dc7189e96a5627 Apr 2026pre-release

    Nothing published for this version

  57. v0.2.11-0.20260423130049-a2b7225e853b23 Apr 2026pre-release

    Nothing published for this version

  58. v0.2.1023 Apr 2026
    Release notes2 sources agree
    • Replace Homebrew binary cask with source formula for Gatekeeper-free macOS installs
    • Add automated workflow to publish Homebrew formula on release
    • Update installation docs and README with new Homebrew instructions
    Open source →
  59. v0.2.923 Apr 2026
    Release notes2 sources agree
    • Consolidated gcx auth and gcx config into a unified gcx login command
    • Renamed gcx sigil command and provider to gcx aio11y (AI Observability)
    • Fixed gcx irm to pass --max-age filter through to the OnCall backend
    • Added PyPI publishing to the release workflow
    • Bumped Claude plugin version automatically on release
    • Added Grafana Cloud API tiers architectural overview to the docs
    • Added compatibility matrix to the README
    Open source →
  60. v0.2.9-0.20260423215804-f0975cc4ef2d23 Apr 2026pre-release

    Nothing published for this version