STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/grafana-cloud/send-data/alloy/get-started/expressions.md (append .md) or send Accept: text/markdown to /docs/grafana-cloud/send-data/alloy/get-started/expressions/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/llms-full.txt.

Instrument and send data

Grafana Alloy

Get started

Expressions

Grafana Cloud

Expressions

You learned about components and how they work together in pipelines in the previous sections. Now you’ll learn about expressions. These are the mechanism that makes your configurations dynamic by computing values and connecting components together.

Expressions are the key to Alloy’s flexibility. They let you reference data from other components, transform values using functions, and create dynamic configurations that respond to changing conditions.

How expressions work

Expressions compute values that you assign to component arguments. The component controller evaluates expressions when components start and whenever their dependencies change.

Basic expressions are literal values like "Hello, world!" or true. More powerful expressions can reference component exports, call functions, or perform calculations.

All component arguments have an underlying type. Alloy checks the expression type during evaluation to ensure compatibility before assigning the result to an attribute. This type checking prevents configuration errors and ensures your pipelines work correctly.

Expression types

The four main types of expressions you’ll use are:

Literal values: Constants like "debug", 8080, or true.
Component references: Values from other components like local.file.config.content.
Function calls: Built-in functions like sys.env("HOME") or encoding.from_json(local.file.data.content).
Arithmetic operations: Mathematical calculations like 1 + 2 or port_base + offset.

You can combine these types to create complex expressions that transform data and connect components in sophisticated ways.

Next steps

Now that you understand how expressions work, learn to write different types of expressions:

Component exports - Reference data from other components to connect your pipeline
Types and values - Understand data types and how they work with expressions

For advanced expression features:

Function calls - Transform and compute values using built-in functions
Operators - Combine and manipulate values using mathematical and logical operators