Skip to main content
Version: Ignition 8.1

Configure Ignition Tags

availability
Feature availability by platform, plan type, and user type
Platform:AvailableWebNot availableMobile
Plan Type:Not availableBasicNot availableEssentialAvailablePremiumAvailableEnterprise
User Type:Not availableRequesterNot availableFull UserAvailableAdministrator

Tags you add to the MaintainX® Ignition Module (referred to as the Ignition module) define which Ignition tag data the module monitors and how it sends that data to MaintainX. Tag limits and smart filtering keep data volume within platform limits.

Prerequisites​

Identify Your Ignition Tag Paths​

Before MaintainX can monitor your Ignition tags, you need to provide their paths. Use the Ignition Gateway to find the paths for the tags or folders you want to monitor.

  1. In the Ignition Gateway, navigate to Status, then select Tags.

  2. Select Browse on a specific folder to see other folders and tags underneath it.

  3. Select Details on a specific tag.

  4. On the tag's details page, do the following:

    • Copy the Path value only (e.g., [default]Boiler1) to monitor all the tags in the folder.
    • Copy the Path value with the tag name appended (e.g., [default]Boiler1/Temperature) to monitor the specific tag.

Supported Data Types​

The Ignition module supports the following data types:

  • Integer
  • Float
  • String
  • Text
  • Datetime
  • Boolean

MaintainX also streams member tags of the types listed above from User Defined Type (UDT) instances. For more information, see Add Tags to the Ignition Module.

If you provide a folder path as input, invalid tags are ignored.

Add Tags to the Ignition Module​

Tag paths tell MaintainX which Ignition tags to monitor. Each connector supports up to 300 distinct tag paths and a total of 6,000 tags. For more information, see Limitations.

If your Ignition tag tree uses User Defined Types (UDTs), MaintainX flattens UDT member paths into tag names by joining the UDT instance name and member with a slash (/). For nested UDTs (UDTs that include other UDTs as members), the separator stacks at each level. For example:

  • A member tag inside a UDT instance: PumpA/Temperature
  • A member tag inside a nested UDT: CompressorSkid01/MainMotor/RPM (CompressorSkid01 and MainMotor are UDT instances, and RPM is the tag)

When you enter a tag path, treat each UDT instance like a folder. MaintainX subscribes to all of the member tags beneath it. You can also enter the path to a single member tag inside a UDT instance to subscribe to just that tag.

To enter your tag paths:

  1. In the Ignition Gateway, go to the MaintainX Module Settings page and navigate to Config, then select Overview.

  2. In the Connections section, select Configure the MaintainX Module.

  3. On the connector you set up earlier, select the Actions icon.

  4. Select + New Path.

  5. Enter the tag paths you want to monitor in the Tag Paths field:

    • For a specific tag. Example: [default]Boiler1/Temperature
    • For all tags in a folder. Example: [default]Boiler1
    • To monitor all member tags in a UDT instance. Example: [default]EnterpriseData/UDTSim/Pump1

  6. Select Save Changes.

If you add tags to a folder that's already monitored, they're automatically discovered and added to MaintainX. Folders are automatically rescanned every hour to ensure new tags are picked up.

tip

To force a rescan, go to the MaintainX Module Settings page in the Ignition Gateway, locate and edit the connector you want to rescan, and select Save Changes.

Map Tags to Meters​

At this point, MaintainX has tag data flowing in, but each tag still needs to be mapped to a meter before it can update readings, trigger work orders, or power automations. Smart tag mapping uses AI to suggest a meter, unit, and asset for each tag, so you don't have to configure every mapping manually.

For more information, see Map Tags to Meters.

Verify Data Is Flowing​

After you map your tags to meters, confirm that readings are reaching MaintainX.

  1. From the sidebar, select Meters.
  2. From the list, find a meter that's mapped to one of your Ignition tags.
  3. Select the meter to open it.
  4. In the Readings section, select See All Readings to confirm new readings are arriving.

Allow a few minutes after the Ignition module starts syncing for the first readings to arrive. After that, readings arrive as tag values update in the Ignition Gateway. If no readings appear, see Not Seeing Data in MaintainX.