Documentation

Work with bytes types

A bytes type represents a sequence of byte values.

Type name: bytes

Bytes syntax

Flux does not provide a bytes literal syntax. Use the bytes() function to convert a string into bytes.

bytes(v: "hello")
// Returns [104 101 108 108 111]

Only string types can be converted to bytes.

Convert strings to bytes

Use bytes() or hex.bytes() to convert strings to bytes.

  • bytes(): Convert a string to bytes
  • hex.bytes(): Decode hexadecimal value and convert it to bytes.

Convert a hexadecimal string to bytes

import "contrib/bonitoo-io/hex"

hex.bytes(v: "FF5733")
// Returns [255 87 51] (bytes)

Include the string representation of bytes in a table

Use display() to return the string representation of bytes and include it as a column value. display() represents bytes types as a string of lowercase hexadecimal characters prefixed with 0x.

import "sampledata"

sampledata.string()
    |> map(fn: (r) => ({r with _value: display(v: bytes(v: r._value))}))

Output

tag_time_value (string)
t12021-01-01T00:00:00Z0x736d706c5f673971637a73
t12021-01-01T00:00:10Z0x736d706c5f306d6776396e
t12021-01-01T00:00:20Z0x736d706c5f706877363634
t12021-01-01T00:00:30Z0x736d706c5f6775767a7934
t12021-01-01T00:00:40Z0x736d706c5f357633636365
t12021-01-01T00:00:50Z0x736d706c5f7339666d6779
tag_time_value (string)
t22021-01-01T00:00:00Z0x736d706c5f623565696461
t22021-01-01T00:00:10Z0x736d706c5f6575346f7870
t22021-01-01T00:00:20Z0x736d706c5f356737747a34
t22021-01-01T00:00:30Z0x736d706c5f736f78317574
t22021-01-01T00:00:40Z0x736d706c5f77666d373537
t22021-01-01T00:00:50Z0x736d706c5f64746e326276

Was this page helpful?

Thank you for your feedback!


Telegraf Enterprise now in public beta

Get early access to the Telegraf Controller and provide feedback to help shape the future of Telegraf Enterprise.

See the Blog Post

The upcoming Telegraf Enterprise offering is for organizations running Telegraf at scale and is comprised of two key components:

  • Telegraf Controller: A control plane (UI + API) that centralizes Telegraf configuration management and agent health visibility.
  • Telegraf Enterprise Support: Official support for Telegraf Controller and Telegraf plugins.

Join the Telegraf Enterprise beta to get early access to the Telegraf Controller and provide feedback to help shape the future of Telegraf Enterprise.

For more information:

InfluxDB Docker latest tag changing to InfluxDB 3 Core

On May 27, 2026, the latest tag for InfluxDB Docker images will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments.

If using Docker to install and run InfluxDB, the latest tag will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments. For example, if using Docker to run InfluxDB v2, replace the latest version tag with a specific version tag in your Docker pull command–for example:

docker pull influxdb:2