Telegraf Controller release notes

v0.0.5-beta

Download Telegraf Controller v0.0.5-beta

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 Telegraf Controller, 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 Telegraf Controller.

   Command flags Environment Variables

   telegraf_controller --disable-auth-endpoints=configs,heartbeat

   export DISABLED_AUTH_ENDPOINTS="configs,heartbeat"
   
   telegraf_controller --disable-auth-endpoints=configs,heartbeat

2. Create an API token 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:

   [[outputs.heartbeat]]
   # ...
   token = "${INFLUX_TOKEN}"

4. Define the INFLUX_TOKEN environment variable in your Telegraf environment:

   export INFLUX_TOKEN=
   YOUR_TELEGRAF_CONTROLLER_TOKEN
   
   telegraf --config "https://localhost:8888/api/configs/..."

   Replace YOUR_TELEGRAF_CONTROLLER_TOKEN with your Telegraf Controller API token.

   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 Telegraf Controller 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

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

Features

• Add linux-arm64 binary support.
• Add build validation for missing plugins.
• Add local file handling for configurations.

v0.0.2-alpha

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

Initial alpha build of Telegraf Controller.