Skip to main content
Version: Ignition 8.1

Troubleshoot the Ignition Integration

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

If the Ignition integration or the MaintainX® Ignition Module (referred to as the Ignition module) isn't behaving as expected, use the sections below to identify and resolve common issues.

Not Seeing Data in MaintainX​

If tags aren't being created or their values aren't updating in MaintainX, work through the following checks:

  • In the Ignition Gateway, go to Status, then select System to verify that the module status is Running.
  • Confirm the connector status is Running on the Ignition module.
  • Confirm your tag paths are valid and exist in Ignition.
  • Confirm the access token is correct and hasn't been revoked.
  • In the Ignition Gateway, go to Status, then select Logs to check for any Ignition module errors.

Ignition Module Is in a Sync Error State​

The Ignition module shows Sync Error when one or more connectors have a tag synchronization issue. To resolve the error, identify the affected connector and follow the instructions in Connector in the Module Is in a Sync Error State.

Connector in the Module Is in a Sync Error State​

A connector displays Sync Error when one or more configured tag paths are invalid or not found in Ignition. Valid tags continue to be monitored, but invalid ones aren't added to MaintainX.

To identify the invalid tags, check the Ignition Gateway logs. Go to Status, then select Logs. Each invalid tag path is logged with an error message.

Ignition Module Is in a Fatal Error State​

The Ignition module shows Fatal Error when it encounters an unrecoverable error and can't continue running. You can restart the module to try to recover from the error.

To restart the module:

  1. In the Ignition Gateway, go to Config, then select Modules.
  2. Locate the MaintainX Module and select Restart.

If the error persists, contact MaintainX Support.

Connector Is Unable to Reach the MaintainX Service​

If the connector can't reach the MaintainX service, it usually means your Ignition Gateway can't reach MaintainX. Common causes include:

  • A firewall rule blocking outbound traffic.
  • The Gateway not using the proxy server configured in your environment.

For the required network settings, see Secure Outbound Communication.

To test whether your Ignition Gateway can reach MaintainX:

  1. Open the Ignition Designer for your Gateway.

  2. From the top menu, select Tools > Script Console.

  3. Paste the following script and run it:

    from java.lang import Exception as JavaException

    url = "https://agent.maintainx.com/"

    try:
        client = system.net.httpClient()
        response = client.get(url)
        status = response.getStatusCode()

        if status >= 200 and status < 500:
            print "MaintainX is reachable."
        else:
            print "MaintainX is unreachable."

    except JavaException as e:
        print "MaintainX is unreachable."
        print str(e)

  4. If the output shows MaintainX is unreachable, your Gateway can't connect to MaintainX. Review the network settings with your IT administrator.

Contact MaintainX Support​

If your issue isn't listed here or you continue to experience problems, contact MaintainX Support. Include your Ignition Gateway logs to help us investigate.