Referencing Resources

Available:Reference Macro Format

From version 1.213, a reserved prefix is available.

Resources can be referenced using a macro where the portion of the macro before the :// is used to identify the type of the resource. The prefix is case sensitive, and if no prefix is supplied then LogScale assumes the macro is a saved query.

  • Parser

    To reference a parser, use the prefix $parser://, for example, $parser://myParser(). To refer to a specific parser within a given package, use $parser://package/scope:myParser().

    Referencing the parser in this way only references the parser content, not on the remainder of the parser such as tags or standardized fields applied.

    Using the macro in this way enables inclusion of the parser processing within another parser.

  • Saved Search

    To reference a saved search, use the prefix $query://, for example, $query://myQuery.

When using the macro:

  • Prefix is case sensitive.

  • If no prefix is supplied, then the reference is assumed to be a saved search.

  • If the resource type is not supported, then the reference is treated as an invalid reference, and an error will be produced noting that the resouece cannot be resolved.

  • Circular references are not allowed.