Caution

Grafana Agent has reached End-of-Life (EOL) on November 1, 2025. Agent is no longer receiving vendor support and will no longer receive security or bug fixes. Current users of Agent Static mode, Agent Flow mode, and Agent Operator should proceed with migrating to Grafana Alloy. If you have already migrated to Alloy, no further action is required. Read more about why we recommend migrating to Grafana Alloy.

Documentationbreadcrumb arrow Grafana Agentbreadcrumb arrow Flow modebreadcrumb arrow Referencebreadcrumb arrow Standard librarybreadcrumb arrow coalesce
Open source

coalesce

coalesce takes any number of arguments and returns the first one that isn’t null, an empty string, empty list, or an empty object. It is useful for obtaining a default value, such as if an environment variable isn’t defined. If no argument is non-empty or non-zero, the last argument is returned.

Examples

> coalesce("a", "b")
a
> coalesce("", "b")
b
> coalesce(env("DOES_NOT_EXIST"), "c")
c