References and Expressions

When References Are Resolved

Source References

Use ${source::...} to reference a source output table.

leftTable: ${source::monitors.network.discovery.sources.ports}
rightTable: ${source::monitors.network.discovery.sources.aliases}

Column and Entry References

Column references are positional and 1-based:

attributes:
  id: $1
  name: $2

These positions refer to the current table shape at that pipeline stage.

• $1 = first column of the current row
• $2 = second column of the current row
• $3 = third column of the current row

If computes add, remove, or reorder columns, these references must be updated accordingly.

The example below shows the same row as a table and as serialized text:

disk01;SSD;ok

File References

Use ${file::<relative-path>} for embedded scripts/files in connector folder.

script: ${file::fan-info.awk}
commandLine: /bin/sh ${file::collector.sh}

Translation References

Use ${translation::<tableName>} with translate/arrayTranslate/perBitTranslation.

translationTable: ${translation::SensorStatusTable}

Constant References

Use ${constant::<constantName>} for reusable literal values.

hw.parent.id: ${constant::_DEVICE_ID}

Connector Variable References

Use ${var::<variableName>} for user-configurable values declared under connector.variables (each with a description and a defaultValue):

commandLine: /usr/bin/ps -e -o comm,args | grep -E "${var::matchName}"

Variables are substituted at connector load time, from the defaultValue or from the user's additionalConnectors configuration. Always declare a defaultValue: with neither a default nor a configured value, the literal ${var::name} survives unresolved. See Reuse and Configuration^[1] for declaration and configuration details.

Protocol and Resource Attribute References

value: ${protocol::jmx.port}
header: "Authorization: Bearer ${resource.attribute::api.token}"

• ${protocol::<type>.<property>} accesses configured protocol data.
• ${resource.attribute::<key>} accesses host/resource-level attributes.

Mono-Instance Attribute References

Use ${attribute::<key>} in mono-instance contexts: monoInstance collect jobs run once per discovered instance, and this reference injects that instance's attributes (as mapped during discovery) into the source. See Monitors and Jobs^[2].

commandLine: /bin/sh ${file::detail.sh} ${attribute::id}

Inline AWK Expressions

Use ${awk::...} for concise expression-level formatting.

name: ${awk::sprintf("%s (%s)", $2, $3)}

References in Compute Attributes

${resource.attribute::<attribute-key>}

${protocol::<protocol-type>.<property>}

${source::<source-name>}

sources:
  source(1):
    type: http
    path: /api/device
    computes:
      - type: replace
        column: 1
        existingValue: "PORT"
        newValue: ${protocol::http.port}

sources:
  source(1):
    type: http
    path: /api/device
    computes:
      - type: append
        column: 1
        value: " - ${source::monitors.enclosure.simple.sources.source_discovery}"

sources:
  source(1):
    type: http
    path: /api/hosts
    computes:
      - type: keepOnlyMatchingLines
        column: 3
        valueList: "https://${resource.attribute::host.name}"

Runtime Credential Macros (%{...})

%{...} macros inject the resource's configured credentials at execution time. They work in HTTP sources and criteria (url, path, header, body, authenticationToken) and in command lines (SSH/local/WMI):

header: "Authorization: Basic %{BASIC_AUTH_BASE64}"

To escape the injected value for the surrounding syntax, wrap the macro as %{esc(TYPE)::MACRO} where TYPE is one of json, xml, url, regex, windows, cmd, powershell, linux, bash, sql:

body: '{ "user": "%{esc(json)::USERNAME}", "password": "%{esc(json)::PASSWORD}" }'

The related %{SUDO:command} macro (command elevation) is tied to the connector's sudoCommands list — see Reuse and Configuration^[1].

Serialization Side Effects (Advanced but Important)

Tables are internally list-of-list-of-strings, but many transformations pass through semicolon-separated serialized rows. Because semicolon is the column separator, appending ;value to a column payload can effectively create a new materialized column once the row is re-parsed.

Example:

# original row
node01;ClusterA;ok

# after append on column 2 with value ';PowerStore'
node01;ClusterA;PowerStore;ok

Use this behavior intentionally and carefully; it is powerful but easy to misuse.

Common Mistakes

• broken source paths when refactoring monitor names
• using relative source references where absolute references are required
• mixing positional columns after compute pipeline changes without remapping
• embedding secrets directly instead of protocol/resource references