218 lines
6.9 KiB
Markdown
218 lines
6.9 KiB
Markdown
---
|
|
title: Telegraf Controller release notes
|
|
description: >
|
|
Important features, bug fixes, and changes in Telegraf Controller releases.
|
|
menu:
|
|
telegraf_controller:
|
|
name: Release notes
|
|
parent: Reference
|
|
weight: 101
|
|
---
|
|
|
|
## v0.0.5-beta {date="2026-03-26"}
|
|
|
|
<!-- Link only be on the latest version, update and move with new versions. -->
|
|
[Download Telegraf Controller v0.0.5-beta](/telegraf/controller/install/#download-and-install-telegraf-controller)
|
|
|
|
### Important changes
|
|
|
|
This release introduces user and account management, API token authentication,
|
|
and configurable authentication options.
|
|
By default, authentication is required to interact with all API endpoints.
|
|
If you have agents reading configurations from and reporting heartbeats
|
|
to {{% product-name %}}, they will begin to fail with authorization errors.
|
|
|
|
**To avoid agent authorization errors:**
|
|
|
|
1. Temporarily disable authentication on the **Heartbeat** and **Configs** APIs.
|
|
You can use either the `--disable-auth-endpoints` command flag or the
|
|
`DISABLED_AUTH_ENDPOINTS` environment variable when starting
|
|
{{% product-name %}}.
|
|
|
|
{{< code-tabs-wrapper >}}
|
|
{{% code-tabs %}}
|
|
[Command flags](#)
|
|
[Environment Variables](#)
|
|
{{% /code-tabs %}}
|
|
{{% code-tab-content %}}
|
|
|
|
<!--pytest.mark.skip-->
|
|
```bash
|
|
telegraf_controller --disable-auth-endpoints=configs,heartbeat
|
|
```
|
|
|
|
{{% /code-tab-content %}}
|
|
{{% code-tab-content %}}
|
|
|
|
<!--pytest.mark.skip-->
|
|
```bash
|
|
export DISABLED_AUTH_ENDPOINTS="configs,heartbeat"
|
|
|
|
telegraf_controller --disable-auth-endpoints=configs,heartbeat
|
|
```
|
|
|
|
{{% /code-tab-content %}}
|
|
{{< /code-tabs-wrapper >}}
|
|
|
|
2. [Create an API token](/telegraf/controller/tokens/create/) with read
|
|
permissions on the **Configs** API and write permissions on the
|
|
**Heartbeat** API.
|
|
|
|
3. Use the `INFLUX_TOKEN` environment variable to define the `token` option
|
|
in your heartbeat output plugin configuration:
|
|
|
|
```toml { .tc-dynamic-values }
|
|
[[outputs.heartbeat]]
|
|
# ...
|
|
token = "${INFLUX_TOKEN}"
|
|
```
|
|
|
|
4. Define the `INFLUX_TOKEN` environment variable in your Telegraf
|
|
environment:
|
|
|
|
<!--pytest.mark.skip-->
|
|
```bash {placeholders="YOUR_TELEGRAF_CONTROLLER_TOKEN"}
|
|
export INFLUX_TOKEN=YOUR_TELEGRAF_CONTROLLER_TOKEN
|
|
|
|
telegraf --config "https://localhost:8888/api/configs/..."
|
|
```
|
|
|
|
Replace {{% code-placeholder-key %}}`YOUR_TELEGRAF_CONTROLLER_TOKEN`{{% /code-placeholder-key %}}
|
|
with your {{% product-name %}} API token.
|
|
|
|
> [!Important]
|
|
> It's important to use the `INFLUX_TOKEN` environment variable.
|
|
> When present, Telegraf uses this specific variable to set the token used
|
|
> in the `Authorization` header when requesting the configuration.
|
|
|
|
5. Navigate to the **Settings** page in {{% product-name %}} and reenable
|
|
authentication on the Configs and Heartbeat APIs. Save your changes.
|
|
|
|
### Features
|
|
|
|
- Add user authentication and session management with login and setup pages.
|
|
- Add user management with invite system, password reset, and password
|
|
complexity validation.
|
|
- Add token management with create workflow and management pages.
|
|
- Add account management page with ownership transfer flow.
|
|
- Add settings page.
|
|
- Add application version retrieval and display.
|
|
- Enhance Heartbeat plugin with logs, status configurations, and agent
|
|
status checks.
|
|
- Add dynamic parsing component support for Exec and Google Cloud PubSub Push plugins.
|
|
- Add plugin support to the Telegraf Builder UI:
|
|
- Aerospike (`inputs.aerospike`)
|
|
- Alibaba Cloud Monitor Service (Aliyun) (`inputs.aliyuncms`)
|
|
- Amazon Elastic Container Service (`inputs.ecs`)
|
|
- AMD ROCm System Management Interface (SMI) (`inputs.amd_rocm_smi`)
|
|
- AMQP Consumer (`inputs.amqp_consumer`)
|
|
- Apache (`inputs.apache`)
|
|
- APC UPSD (`inputs.apcupsd`)
|
|
- Apache Aurora (`inputs.aurora`)
|
|
- Azure Queue Storage (`inputs.azure_storage_queue`)
|
|
- Bcache (`inputs.bcache`)
|
|
- Beanstalkd (`inputs.beanstalkd`)
|
|
- Beat (`inputs.beat`)
|
|
- BIND 9 Nameserver (`inputs.bind`)
|
|
- Bond (`inputs.bond`)
|
|
- Burrow (`inputs.burrow`)
|
|
- Ceph Storage (`inputs.ceph`)
|
|
- chrony (`inputs.chrony`)
|
|
- Cisco Model-Driven Telemetry (MDT) (`inputs.cisco_telemetry_mdt`)
|
|
- ClickHouse (`inputs.clickhouse`)
|
|
- Google Cloud PubSub Push (`inputs.cloud_pubsub_push`)
|
|
- Amazon CloudWatch Metric Streams (`inputs.cloudwatch_metric_streams`)
|
|
- Netfilter Conntrack (`inputs.conntrack`)
|
|
- Hashicorp Consul (`inputs.consul`)
|
|
- Hashicorp Consul Agent (`inputs.consul_agent`)
|
|
- Bosch Rexroth ctrlX Data Layer (`inputs.ctrlx_datalayer`)
|
|
- Mesosphere Distributed Cloud OS (`inputs.dcos`)
|
|
- Device Mapper Cache (`inputs.dmcache`)
|
|
- Data Plane Development Kit (DPDK) (`inputs.dpdk`)
|
|
- Elasticsearch (`inputs.elasticsearch`)
|
|
- Ethtool (`inputs.ethtool`)
|
|
- Exec (`inputs.exec`)
|
|
- Fibaro (`inputs.fibaro`)
|
|
- File (`inputs.file`)
|
|
- Filecount (`inputs.filecount`)
|
|
- File statistics (`inputs.filestat`)
|
|
- Fireboard (`inputs.fireboard`)
|
|
- AWS Data Firehose (`inputs.firehose`)
|
|
- Fluentd (`inputs.fluentd`)
|
|
- Fritzbox (`inputs.fritzbox`)
|
|
- GitHub (`inputs.github`)
|
|
- gNMI (gRPC Network Management Interface) (`inputs.gnmi`)
|
|
- Google Cloud Storage (`inputs.google_cloud_storage`)
|
|
- GrayLog (`inputs.graylog`)
|
|
- HAProxy (`inputs.haproxy`)
|
|
- HDDtemp (`inputs.hddtemp`)
|
|
- HTTP (`inputs.http`)
|
|
- HTTP Listener v2 (`inputs.http_listener_v2`)
|
|
- HueBridge (`inputs.huebridge`)
|
|
- Hugepages (`inputs.hugepages`)
|
|
- Icinga2 (`inputs.icinga2`)
|
|
- InfiniBand (`inputs.infiniband`)
|
|
- InfluxDB (`inputs.influxdb`)
|
|
- InfluxDB Listener (`inputs.influxdb_listener`)
|
|
- InfluxDB V2 Listener (`inputs.influxdb_v2_listener`)
|
|
- Intel Baseband Accelerator (`inputs.intel_baseband`)
|
|
- Intel® Dynamic Load Balancer (`inputs.intel_dlb`)
|
|
- Intel® Platform Monitoring Technology (`inputs.intel_pmt`)
|
|
|
|
### Bug fixes
|
|
|
|
- Fix default Heartbeat plugin configuration and environment variable exports.
|
|
|
|
---
|
|
|
|
## v0.0.4-alpha {date="2026-02-05"}
|
|
|
|
### Features
|
|
|
|
- Require InfluxData EULA acceptance before starting the server.
|
|
- Add plugin support to the Telegraf Builder UI and TOML parser:
|
|
- ActiveMQ (`inputs.activemq`)
|
|
- Vault (`secretstores.vault`)
|
|
- All parsers
|
|
- All serializers
|
|
- Add support for custom logs directory.
|
|
- Reduce binary size.
|
|
|
|
### Bug fixes
|
|
|
|
- Fix question mark position in deletion popup.
|
|
|
|
---
|
|
|
|
## v0.0.3-alpha {date="2026-01-14"}
|
|
|
|
### Features
|
|
|
|
- Add linux-arm64 binary support.
|
|
- Add build validation for missing plugins.
|
|
- Add local file handling for configurations.
|
|
|
|
---
|
|
|
|
## v0.0.2-alpha {date="2026-01-13"}
|
|
|
|
### Features
|
|
|
|
- Identify external configurations for Telegraf agents.
|
|
- Add SSL support for backend connections.
|
|
- Add health check status API endpoint.
|
|
- Add `Last-Modified` header to GET TOML API response and remove duplicate
|
|
protocol handling.
|
|
- Compile native Rust NAPI server for heartbeat service.
|
|
|
|
### Bug fixes
|
|
|
|
- Fix default parsing unit to use seconds.
|
|
- Fix command line string generation.
|
|
|
|
---
|
|
|
|
## v0.0.1-alpha {date="2026-01-01"}
|
|
|
|
_Initial alpha build of Telegraf Controller._
|