NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #2229 by repository stars
Latest stable
v1.7.1
Last release 16 days ago
06 Nov 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 37 of 37 stable releases
Nothing withdrawn
no release was ever pulled
7 months old
136 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Build release binaries with Go 1.26.10 and update golang.org/x/net to v0.60.0, picking up standard library security fixes and five HTTP/2 fixes (GO-20…
Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
v1.7.0 was tagged but never published: its image build failed. v1.7.1 is the first published release with the v1.7.0 changes, listed below.
golang.org/x/net to
v0.60.0, picking up standard library security fixes and five HTTP/2
fixes (GO-2026-6603, -6610, -6611, -6612, -6617) (#1625)gcx api, and missing Cloud or Synthetic
Monitoring credentials exit 3 instead of 1. Unknown flags and missing or
extra positional arguments exit 2 instead of 1. Error summaries use a fixed
vocabulary (Authentication failed, Authorization failed,
Resource not found, Resource conflict, Invalid command usage).
Update scripts that branch on exit 1 or match the old error text. (#1483)--allow-ui-updates=false to keep them provisioned. Updating a contact
point that is already provisioned requires --allow-ui-updates=false;
without it Grafana rejects the update. Alert rules are unchanged. (#1553)gcx synthetic-monitoring checks status and checks get --show-status now
read from the Synthetic Monitoring datasource and require Synthetic
Monitoring app v1.64.0 or later. SUCCESS (JSON success) is now
reachability over 3 hours instead of a 5-minute probe_success average, so
some checks may change between OK and FAILING. --datasource-uid is
hidden and ignored; it is still accepted, with a warning. (#1489)gcx logs query and gcx datasources loki query (including generic
datasources query against Loki) now reject metric queries such as
rate(...) in every output format, instead of printing metric values as
log lines. Run metric queries with gcx logs metrics. (#1580)gcx kg notifications upsert now rejects unknown or misspelled fields, and
input containing more than one YAML document. Both previously succeeded,
dropping the unknown key or the extra documents. It now also accepts the
output of notifications get and list directly. Correct field names in
saved notification files before you upgrade. (#1571)kg graph queries and threshold commands; deprecate legacy entity querieskg graph query and meta schema help, with --jq examplessynthetic-monitoring suggestions list-o csv) for Prometheus, Loki, SQL, tabular, Cloud,
search-metrics, Tempo and Pyroscope queriesdatasources loki query-patterns and logs query-patterns-o graph for Loki log queries as a log-volume histogramprofiles helpGCX_CONTEXT environment variableirm oncall schedules list-final-shifts ignoring --start/ingestMinor bump: new features since v1.6.0, plus four breaking changes called out in the changelog:
Release v1.7.0.
Minor bump: new features since v1.6.0, plus four breaking changes called
out in the changelog:
--allow-ui-updates=false opts out);synthetic-monitoring checks status needs SM app v1.64.0,success is now 3h reachability, --datasource-uid is ignored.gcx logs metrics.Includes regenerated docs/sources/cli-reference.md and
configuration.md for v1.7.0.
🤖 Generated with Claude Code
Co-authored-by: Claude Opus 5.5 noreply@anthropic.com
gcx api, and missing Cloud or Synthetic
Monitoring credentials exit 3 instead of 1. Unknown flags and missing or
extra positional arguments exit 2 instead of 1. Error summaries use a fixed
vocabulary (Authentication failed, Authorization failed,
Resource not found, Resource conflict, Invalid command usage).
Update scripts that branch on exit 1 or match the old error text. (#1483)--allow-ui-updates=false to keep them provisioned. Updating a contact
point that is already provisioned requires --allow-ui-updates=false;
without it Grafana rejects the update. Alert rules are unchanged. (#1553)gcx synthetic-monitoring checks status and checks get --show-status now
read from the Synthetic Monitoring datasource and require Synthetic
Monitoring app v1.64.0 or later. SUCCESS (JSON success) is now
reachability over 3 hours instead of a 5-minute probe_success average, so
some checks may change between OK and FAILING. --datasource-uid is
hidden and ignored; it is still accepted, with a warning. (#1489)gcx logs query and gcx datasources loki query (including generic
datasources query against Loki) now reject metric queries such as
rate(...) in every output format, instead of printing metric values as
log lines. Run metric queries with gcx logs metrics. (#1580)gcx kg notifications upsert now rejects unknown or misspelled fields, and
input containing more than one YAML document. Both previously succeeded,
dropping the unknown key or the extra documents. It now also accepts the
output of notifications get and list directly. Correct field names in
saved notification files before you upgrade. (#1571)kg graph queries and threshold commands; deprecate legacy entity querieskg graph query and meta schema help, with --jq examplessynthetic-monitoring suggestions list-o csv) for Prometheus, Loki, SQL, tabular, Cloud,
search-metrics, Tempo and Pyroscope queriesdatasources loki query-patterns and logs query-patterns-o graph for Loki log queries as a log-volume histogramprofiles helpGCX_CONTEXT environment variableirm oncall schedules list-final-shifts ignoring --start/ingestNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Faro app writes now reject spec.settings.geolocationLevel: region. Change it to subdivision in saved manifests before you upgrade. This affects gcx fr
spec.settings.geolocationLevel: region.
Change it to subdivision in saved manifests before you upgrade.
This affects gcx frontend apps writes and resource pushes. Before this
release, gcx ignored Faro app settings on writes, so region never took
effect. Faro settings now reach the API. (#1444)gcx datasources loki labels and gcx logs labels now reject stray
positional arguments. They also reject an explicit empty --query or
--label. Omit these flags for an unscoped label list. Give each flag
a nonempty value when you use it. (#1325)gcx signup to create a Grafana Cloud account and save its first
connection. Complete account setup in the browser. If the connection
fails after signup, finish it with gcx login. (#1383)gcx login --cloud --oauth open the stack chooser when no server
is set. Browser cancellation now exits with code 5. On macOS, the
terminal watcher uses its own device, so SSH paste works. (#1383)gcx docs commands to search and read Grafana product docs.
(#1234)gcx alert routing-trees commands to manage native alert routing
trees. (#1472)gcx profiles query-anomalies and
gcx datasources pyroscope query-anomalies commands. Their flags and
output may change. (#1435)--query to scope Loki label and value lists. (#1325)--dry-run to Synthetic Monitoring check create and update.
(#1429)GCX_AGENT_SPILL_BYTES=0 disable output spilling. (#1461, #1439)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
gcx cloud stacks create now requires --org , including dry runs. The Cloud API validates access to the selected organisation.
gcx cloud stacks create now requires --org <org-slug>, including
dry runs. The Cloud API validates access to the selected organisation.name, orgSlug,
slug, status, and url in every output format. Use
gcx cloud stacks get <slug> -o json for full details. Dry runs still
return a request preview.--org and --name; stack slugs retain
strict lowercase-alphanumeric validation. Blank values are rejected.Update scripts before upgrading:
# Add the explicit destination organisation to existing create commands.
gcx cloud stacks create --org example-org --name demo --slug demo --region us --dry-run
# After creation, retrieve fields omitted from the concise result.
gcx cloud stacks get demo -o json
gcx cloud orgs list to show organisation slugs and membership roles
for the signed-in user. It uses the selected context's Cloud endpoint,
including dev and ops, and supports structured output.profile. Rerun gcx cloud login if
your saved login lacks that scope.gcx cloud stacks get <slug> with the same config/context before retrying:
the stack may already exist or still be provisioning.cloud stacks list; that command
already required --org before this release.spec.folderUid in check manifests,
responses, and resource workflows. Omit it to retain the assignment;
supply an empty string to clear it.--since or --from/--to can speed up trace-ID lookup.
Use the correct time range; one that excludes the trace returns not found.Nothing published for this version
Nothing published for this version
Nothing published for this version
Add gcx metrics search metric-names/label-names/label-values and gcx datasources prometheus search-metric-names/search-label-names/search-label-values
Metrics and traces
gcx metrics search metric-names/label-names/label-values and
gcx datasources prometheus search-metric-names/search-label-names/search-label-values,
backed by the experimental Prometheus/Mimir search API (#1374)gcx traces get and
gcx datasources tempo get: --filter keeps the spans that match a TraceQL
spanset expression, shaped by --keep-hierarchy, --match-depth and
--ancestor-depth; --prune (with --prune-group-by, --prune-min-spans,
--prune-max-parent-depth) collapses repeated sibling spans. Both are off
unless set, and aim at shrinking large traces before --llm analysis (#1250)Authentication and configuration
gcx login (#1389)Agent Observability
gcx agento11y model-rates to set your own negotiated model prices (#1377)Synthetic Monitoring and IRM
gcx synthetic-monitoring queries list/get for named queries (#1373)Application Observability
gcx appo11y operations list/get (#1334)Security and debugging
--insecure-log-http-payload dumps now run at the innermost transport layer
and show every header that reaches the wire, including the OAuth bearer
token. They also show the OAuth token refresh exchange, which carries the
refresh token and the rotated token pair. Treat captured debug logs as
secrets (#1190)http request dump and http response dump, include
Content-Length and Accept-Encoding in request dumps, report why a dump
failed, and document that dumps log at Debug level (-vvv) (#1190)Docs and internals
Nothing published for this version
Nothing published for this version
Nothing published for this version
Use gcx resources push and pull for new SLO workflows. Generic push matches natural keys. Deprecated SLO wrappers match UUIDs only
Synthetic Monitoring
Datasources and queries
Dashboards, Assistant, and Agent Observability
Application Observability
SLO, Fleet, and skills
gcx resources push and pull for new SLO workflows. Generic push
matches natural keys. Deprecated SLO wrappers match UUIDs only (#1342)Security and telemetry
Other
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Using --token still works but it is deprecated and hidden from help
Breaking changes
Keychain unavailable error in this scenario. A locked, as opposed to absent, keychain already failed closed and is unchanged. Set GCX_KEYCHAIN=off to opt in to a plaintext write. (#1271)gcx fleet. gcx will need write permissions when using the OAuth flow for all gcx fleet commands. Users will need grafana-collector-app:read for named routes, and wildcard routes need the Admin role or grafana-collector-app:admin, including some read-only commands such as tenant get-limits. (#1261)gcx synthetic-monitoring probes deploy emits different manifests, and the probe token is now provided through a Kubernetes Secret, defined by the SM_AGENT_API_TOKEN environment variable. To use this, regenerate the manifests and update anything that read the token out of the Deployment arguments before applying. Using --token still works but it is deprecated and hidden from help (#1262)gcx synthetic-monitoring probes reset-token now returns the new token value instead of just confirming the reset. The value is in gcx.synth.probe_token_reset. Anything parsing the previous result shape needs updating (#1262)gcx irm oncall schedules list-final-shifts takes a --timezone flag and sends the timezone of the schedule, rather than the host. Without the --timezone flag it now uses the schedule's timezone, falling back to UTC with a warning if the schedule does not have a timezone set. (#1187)Datasources and queries
gcx profiles series for series discovery (#1086)-o dot call-graph output to gcx profiles query (#1122)gcx traces baseline command (#1168)Alerting and IRM
gcx alert state-history and notification history (#1296, #1258)gcx irm incidents update, and honour incident severity (#1191)alert-groups list --limit 0 now returns every alert group (#1213)Configuration and credentials
credentials.keychain policy (#1266)GCX_KEYCHAIN to disable the OS credential store (#1242)Agent Observability and Instrumentation
gcx agento11y experiments pull for experiment bundles (#1267)gcx agento11y rules list-scores for online scores (#1226)--fix-plan to gcx instrumentation check (#1115)Telemetry
api command usage by route, method, and type (#1094)canceled (#1109)Fixes
create -f and update -f accept the K8s envelope that gcx itself prints, instead of discarding every field of the file (#1187)--jq now works together with -o agents (#1287)extraLogLabels under the label field (#1238)Other
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
A locked OS keychain is now its own fatal failure class (Keychain locked). gcx stops credential-consuming commands instead of falling back to a plaint
Breaking changes
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)gcx assistant dashboard subcommand (#1230)New features
gcx dbo11y instances list and gcx dbo11y instances get <name> (#1199)Fixes
--agent-id default from assistant help text (#1232)Other
add-datasource skill the shared raw-SQL contract (#1227)create-github-app-token to 0.3.1 and tune the CI review process (#1236, #1217)Nothing published for this version
Add support for the MySQL and Postgres datasources (#970, #969)
Datasources
gcx traces diff command (#1165)Providers
gcx irm incidents get-pir for post-incident reviews (#1163)otlpIngestEndpointURL from frontend applications (#1223)Login and configuration
--oauth-manual for hosts without a reachable callback (#1136)gcx config check to one explicit context (#1155)Fixes
otlp_url and otlp_username in the cluster configuration (#1198)Performance
Other
Datasources
gcx traces diff command (#1165)Providers
gcx irm incidents get-pir for post-incident reviews (#1163)otlpIngestEndpointURL from frontend applications (#1223)Login and configuration
--oauth-manual for hosts without a reachable callback (#1136)gcx config check to one explicit context (#1155)Fixes
otlp_url and otlp_username in the cluster configuration (#1198)Performance
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)
irm: gcx irm oncall alert-groups list --limit 0 returns every matching alert group instead of stopping at 1000, and --limit N above 1000 is honored (#1157).
instrumentation: app and service writes (clusters apps configure/remove, services include/exclude/clear) no longer fail with otlp_url is required.
Nothing published for this version
Nothing published for this version
Nothing published for this version
gcx agento11y collections add-conversations and gcx agento11y collections remove-conversation emit type: gcx.agento11y.collection_membership instead o
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
gcx profiles data-range for Pyroscope ingestion health.data-range command under gcx datasources pyroscope.gcx instrumentation explain and list-explanations for the finding explanations that ship with otel-checker (now v0.3.1).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.gcx assistant investigations list-evidence.investigations get.gcx metrics list-names.Improvements
gcx config check.target_kind in usage telemetry events.Fixes
gcx dev serve exit on Ctrl-C.AllowsEdits so gcx-managed dashboards stay editable in the UI.configType in Fleet so OTel pipelines round-trip.redact with {id, regex}.rule_id from the rules update PATCH body.Internal
aio11y Go package to agento11y.integrate-with-gcx and review-pr contributor skills.GCX_AGENT_MODE=false for the test tasks.internal/datasources.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
alert: add ruler subtree for datasource-managed rule writes
entities correlate to resolve entities from alert labelskg quality), folded into kg diagnoseNothing published for this version
Naming convergence: verb-first subcommand renames across all providers (e.g. versions→list-versions, create→upsert, summary→stats)
versions→list-versions, create→upsert, summary→stats)profile-types renamed to list-profile-types at both mountscreate/update/apply aliases from templates upsert--dry-run for model-rules and prom-rules upsertlabels and list-profile-types--config across the direct command tree--config in direct agento11y CRUD commandsNothing published for this version
Register the Assistant as a first-class provider, moving mcp-servers into the resources pipeline
mcp-servers into the resources pipelineaio11y command tree and skills to agento11yagento11y-eval-starter skill to agento11y-test-starteragento11y-instrument skill (setup → instrument → verify loop)agento11y-prod-setup skill for production evals and guardsagento11y-test-starter starter skillexplore-datasources skill--top totals to exclude the pre-window boundary pointprom-rules schema command and --dry-run to suppressions create--json discovery and selection--jq runtime errorslogin cloud followup flowdev import code from actual usage--llm flag experimental and document its Accept headerNothing published for this version