Skip to content

release: Telegraf Controller 1.1.0 - #7694

Merged
sanderson merged 43 commits into
masterfrom
release/telegraf-controller-1.1.0
Aug 25, 2026
Merged

release: Telegraf Controller 1.1.0#7694
sanderson merged 43 commits into
masterfrom
release/telegraf-controller-1.1.0

Conversation

@sanderson

Copy link
Copy Markdown
Collaborator

Full Telegraf Controller 1.1.0 documentation release:

New documentation sections and pages

  • Configuration groups section — overview, manage, use, and group aliases pages
  • High availability section — overview (with topology diagram), deploy, and load-balancing pages
  • Configuration aliases page
  • Global constants page
  • Configuration versioning page
  • Upgrade guide under install
  • v1.1.0 release notes

Renames

  • "Dynamic values" is now "Substitute values": configs/dynamic-values.mdconfigs/substitute-values.md, plus the matching JS component rename (tc-dynamic-values.jstc-substitute-values.js)

Updated existing content

  • Broad touch-ups across most Controller pages: agents, audit logs, LDAP/OIDC auth, tokens, users, configs (create/update/delete/use), the configs UI pages (including focus mode), install/troubleshoot/uninstall, architecture, config options, and glossary
  • Telegraf Enterprise feature listings gain high availability (telegraf/enterprise/, telegraf/v1/enterprise.md, manage-at-scale)

UI and infrastructure

  • New Lucide icon system: a lucide shortcode, icon stylesheet, updates to the existing icon shortcode, a Cypress test, and new npm dependencies
  • Telegraf secret syntax highlighting in code blocks (render-codeblock.html and code styles)
  • Updates to the telegraf/enterprise-feature and enterprise-upgrade shortcodes

Release prep and assets

  • Product data and download entries for Controller 1.1.0 (products.yml, tc_downloads.yml) and a release notification banner (notifications.yaml)
  • Three new screenshots: config group detail, version history, and version compare
  • Housekeeping: Vale vocabulary additions, AGENTS.md and DOCS-SHORTCODES.md updates

Checklist

  • Rebased/mergeable
  • Local build passes (npx hugo --quiet)

Suggested reviewers (click to expand)

Based on files changed, consider requesting review from:

InfluxDB 3

Content Engineering Product
Core, Enterprise influxdata/monolith-team peterbarnett03, garylfowler
Clustered influxdata/platform-team ritwika314, sanderson
Cloud Dedicated influxdata/cloud-single-tenant ritwika314, sanderson
Cloud Serverless mavarius, garylfowler
Explorer mavarius, peterbarnett03

InfluxDB v2 / v1 / Enterprise v1

Content Engineering Product
v2, Cloud (TSM) influxdata/edge sanderson, jstirnaman
v1, Enterprise v1 influxdata/edge sanderson, jstirnaman

Other Products

Content Engineering Product
Telegraf influxdata/telegraf-team sanderson, caterryan
Kapacitor influxdata/bonitoo sanderson, jstirnaman
Chronograf influxdata/bonitoo mavarius, caterryan
Flux sanderson, jstirnaman

Shared / Cross-Product

Content Reviewers
/content/shared/ influxdata/product-managers
API docs Relevant product team above

sanderson and others added 30 commits July 30, 2026 09:33
Document the enterprise high-availability feature for a compiled Telegraf
Controller binary: an overview of leader election and shared state, a
deployment guide, and load-balancer configuration (HAProxy, NGINX, AWS).
Add HA configuration options to the config reference, note the multi-node
model in the architecture reference, and list high availability as a
Telegraf Enterprise feature.
Clarify that a high-availability cluster can use self-managed PostgreSQL
or a PostgreSQL-compatible database that supports session-level advisory
locks, rather than only self-hosted PostgreSQL.
…ility

docs(controller): document high availability
Add a Manage configuration versions page covering automatic version
creation, version history, comparing versions, rollback, and pruning.
Cross-link from the create and update pages, add configuration
lifecycle events to the audit log categories, and renumber the Manage
configurations menu to resolve a weight collision.
…oning

docs(controller): document configuration versioning
Add a Focus mode section to the Configuration UI tools page covering
how to enter and exit the expanded editing view, and cross-link it
from the Code Editor and Telegraf Builder pages.
feat(icons): add Lucide icons for Telegraf Controller and Explorer
chore(controller): updated and add lucide icons to controller docs
Add a Manage configuration aliases page covering naming rules, adding,
using, transferring, and deleting aliases, including the /c/ short URL
for agents. Add an alias-based URL example to the use page and renumber
the Manage configurations menu to slot aliases after versions.
Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
docs(controller): document configuration aliases
… to value substitution

Add a Manage global constants page and a Constants section in the value
substitution docs. Rename the dynamic values page to substitute-values
with a redirect alias, document where each substitution type is resolved
(Controller-side vs agent-side), and sweep dynamic-values phrasing and
links across Controller docs. Add global constant and value substitution
glossary entries and a Constants audit category. Rename the
tc-dynamic-values code fence class and component to tc-substitute-values
with constant syntax highlighting; the render hook still maps the legacy
class for unmerged branches.
…docs/controller-global-constants

Resolve menu weights so aliases (104) precedes UI tools (105),
substitute-values (106), constants (107), use (108), and delete (109).
Sweep the incoming aliases page and the glossary related links to the
renamed substitute-values URL.
…ants

docs(controller): document global constants and rename dynamic values to value substitution
Add a Manage configuration groups section covering the compose-by-
reference model, creating and managing groups and member order, applying
groups to agents, and group aliases including transferring an alias from
a configuration to a group. Document array parameter values on the
substitute-values page, cross-link groups from the configs, constants,
and aliases pages, and add glossary and audit-log coverage.
…troller HA

What changed:
The Telegraf Controller high-availability page gets a centered topology
diagram showing the load balancer, controller nodes, and shared database,
plus a "What high availability protects" section that separates what node
redundancy covers (web interface, API, heartbeats) from what it does not
(the shared database).

Why:
The page described the leader/standby model in prose only, and it did not
state that the database remains a single point of failure unless made
highly available separately.

Impact:
Telegraf Controller HA page only. The diagram is the first consumer of the
diagram shortcode's center option added earlier on this branch, so this
change depends on that commit.

Verification:
Measured the rendered page in headless Chrome: the diagram renders 680px
wide (natural size 701px, so the column cap shrinks it slightly), centered
with equal 76px side gaps and 16px labels.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Add an Upgrade page to the install section covering database backup,
per-OS executable replacement steps that parallel the install guide,
version verification, and rolling upgrades for high-availability
clusters, including the migration lock behavior and the release-notes
convention for releases that require a full-cluster upgrade.
docs(controller): document configuration groups
docs(controller): add HA topology diagram and protection scope to Controller HA
…e listings

Sweep the Telegraf, Telegraf Enterprise, and Telegraf Controller docs
for enterprise feature enumerations and add high availability where it
was missing: the Telegraf 1.x enterprise page, manage-at-scale, the
Controller licensing section description, the license-enforcement
feature gating list, and the license-removal behavior list.
sanderson and others added 8 commits August 21, 2026 10:44
Add the Telegraf Controller v1.1.0 release entry covering high
availability, configuration versioning, aliases, global constants,
configuration groups, focus mode, the value substitution rename, and
new Telegraf Builder plugins, with links to the feature documentation.
…e-notes

docs(controller): add Telegraf Controller v1.1.0 release notes
@github-actions

github-actions Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Vale Style Check Results

Metric Count
Errors 0
Warnings 13
Warnings (13)
File Line Rule Message
content/telegraf/controller/agents/reporting-rules.md 43 Google.Colons ': R' should be in lowercase.
content/telegraf/controller/agents/reporting-rules.md 44 Google.Colons ': T' should be in lowercase.
content/telegraf/controller/agents/reporting-rules.md 47 Google.Colons ': E' should be in lowercase.
content/telegraf/controller/agents/reporting-rules.md 49 Google.Colons ': E' should be in lowercase.
content/telegraf/controller/agents/reporting-rules.md 81 InfluxDataDocs.Capitalization 'From the reporting rules list' should be in sentence case
content/telegraf/controller/agents/reporting-rules.md 87 InfluxDataDocs.Capitalization 'From reporting rule details' should be in sentence case
content/telegraf/controller/agents/reporting-rules.md 97 InfluxDataDocs.Capitalization 'From the agent list' should be in sentence case
content/telegraf/controller/agents/reporting-rules.md 103 InfluxDataDocs.Capitalization 'From an agent details page' should be in sentence case
content/telegraf/controller/config-groups/manage.md 88 InfluxDataDocs.Capitalization 'Delete a configuration group' should be in sentence case
content/telegraf/controller/config-groups/use.md 87 InfluxDataDocs.Capitalization 'View agents using a group' should be in sentence case
content/telegraf/controller/configs/delete.md 33 InfluxDataDocs.Capitalization 'From the configurations list page' should be in sentence case
content/telegraf/controller/configs/delete.md 41 InfluxDataDocs.Capitalization 'From the configuration detail page' should be in sentence case
content/telegraf/controller/configs/delete.md 51 InfluxDataDocs.Capitalization 'Delete multiple configurations' should be in sentence case

Check passed

@github-actions

Copy link
Copy Markdown
Contributor

Release version check

Product Release notes data/products.yml Status
telegraf_controller (latest_patch) 1.1.0 1.1.0 ✅ in sync

💡 Badge new features with the version

Documenting a new feature? Add a version badge in the page frontmatter — the
same mechanism used elsewhere in the docs:

  • metadata: [InfluxDB 3 Core v3.11+] — badge list under the page title
  • updated_in: v3.11 — an "Updated in v3.11" badge
  • introduced: v3.11 — a "‹Product› v3.11+" badge
  • menu.params.state: new — a "NEW" pill on the sidebar nav item

For inline version text, use {{< latest-patch >}} / {{< current-version >}},
which read the value from data/products.yml so it stays correct automatically.

@github-actions

github-actions Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

🔗 Link Check Results — Link Check Bot

30 broken link(s) found — fix them before merging.

Metric Value
Files Checked 30
Total Links 6574
Errors 30
Warnings 54
Success Rate 98.12899%

Broken Links

Source File Broken URL Error Report
content/chronograf/v1/introduction/installation/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/enterprise_influxdb/v1/introduction/installation/single-server/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/example/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/influxdb/v1/introduction/install/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/influxdb/v2/install/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/influxdb3/core/install/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/influxdb3/enterprise/install/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/influxdb3/explorer/install/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/agents/create/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/agents/delete/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/agents/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/agents/reporting-rules/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/audit-logs/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/audit-logs/view/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/authentication/ldap/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/authentication/oidc/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/config-groups/aliases/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/config-groups/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/config-groups/manage/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/config-groups/use/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/configs/aliases/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/configs/constants/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/configs/create/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/configs/delete/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/configs/substitute-values/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/configs/ui/code-editor/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/configs/ui/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/configs/ui/telegraf-builder/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/controller/configs/update/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
content/telegraf/v1/install/_index.md https://influxdata.com/blog/telegraf-controller-1-1-influxdb/ Rejected status code: 404 Not Found Report
⚠️ 54 warning(s) (do not fail CI)
Source File URL Issue
content/chronograf/v1/introduction/installation/_index.md https://reddit.com/r/influxdb Error (cached)
content/enterprise_influxdb/v1/introduction/installation/single-server/_index.md https://reddit.com/r/influxdb Error (cached)
content/enterprise_influxdb/v1/introduction/installation/single-server/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/example/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/example/_index.md https://reddit.com/r/influxdb Error (cached)
content/influxdb/v1/introduction/install/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/influxdb/v1/introduction/install/_index.md https://reddit.com/r/influxdb Error (cached)
content/influxdb/v2/install/_index.md https://docs.docker.com/engine/reference/run/#detached-vs-foreground Cannot find fragment: Cannot find fragment
content/influxdb/v2/install/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/influxdb/v2/install/_index.md https://reddit.com/r/influxdb Error (cached)
content/influxdb3/core/install/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/influxdb3/enterprise/install/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/influxdb3/enterprise/install/_index.md https://reddit.com/r/influxdb Error (cached)
content/influxdb3/explorer/install/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/telegraf/controller/agents/create/_index.md https://support.influxdata.com/ Network error: SSL certificate not trusted. Use --insecure if site is trusted (e…
content/telegraf/controller/agents/delete/_index.md https://reddit.com/r/influxdb Error (cached)
content/telegraf/controller/agents/delete/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/telegraf/controller/agents/_index.md https://support.influxdata.com/ Error (cached): Error (cached)
content/telegraf/controller/agents/_index.md https://reddit.com/r/influxdb Error (cached)
content/telegraf/controller/agents/reporting-rules/_index.md https://reddit.com/r/influxdb Error (cached)

Showing first 20 of 54 warnings. See the workflow run for full results.


Full details: workflow run summary and artifact. Last updated: 2026-08-25 12:21:59 UTC

@sanderson

Copy link
Copy Markdown
Collaborator Author

All of the broken links are for the blog post and can be ignored. That post will go live as we push the release out.

@sanderson
sanderson marked this pull request as ready for review August 25, 2026 12:20
@sanderson
sanderson requested a review from a team as a code owner August 25, 2026 12:20
@sanderson
sanderson requested review from jstirnaman and removed request for a team August 25, 2026 12:20
@sanderson
sanderson merged commit 173e438 into master Aug 25, 2026
28 of 37 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant