Contact Us 1-800-596-4880

Anypoint DataGraph Troubleshooting

Troubleshooting Runtime Errors

If you encounter runtime errors when attempting to use the Anypoint DataGraph query editor, troubleshoot them as follows.

Failed to Fetch Schema Error

A failed to fetch schema error occurs when you navigate to the Anypoint DataGraph query editor and it displays the following:

{
  "message": "Failed to fetch",
  "stack": "TypeError: Failed to fetch"
}

Anypoint DataGraph generates this error when it cannot load the unified schema, and it occurs for one of three reasons:

  1. You’re unable to use Port 8082 on a shared load balancer.

    Solution: Create a dedicated load balancer (DLB) and set its URL to configure Anypoint DataGraph to route requests through the DLB.

  2. You’ve set a DLB using an invalid certificate.

    Solution: Ensure that your DLB has a valid, CA-signed certificate, or the browser won’t connect to Anypoint DataGraph.

  3. Your internet browser is unable to access Anypoint Virtual Private Cloud (VPC).

    Solution: Ensure that you can connect to Anypoint VPC from your internet browser. Refer to Anypoint DataGraph Architecture and Networking for an overview of Anypoint DataGraph networking.

Exception While Fetching Data Error

After you run a query, Anypoint DataGraph displays an error similar to the following:

{
  {
    "errors": [
        {
            "message": "Exception while fetching data (/ordersById) : Error 429 executing request.",
            "locations": [
                {
                    "line": 2,
                    "column": 3
                }
            ],
            "path": [
                "ordersById"
            ],
            "extensions": {
                "httpResponse": {
                    "statusCode": 429,
                    "xHeaders": {
                      "x-ratelimit-limit": 10
                      "x-ratelimit-remaining": 0
                      "x-ratelimit-reset": 41827
                      "x-xss-protection": "1; mode=block"
                  },
                  "contentType": "application/json",
                  "body": {
                    "error": "Quota has been exceeded"
                  }
                },
               "classification": "DataFetchingException"

An exception while fetching data error occurs when the unified schema can’t connect to its underlying APIs.

To troubleshoot this error, ensure that:

  1. The underlying APIs are running.

  2. The URL provided for each API is correct. Go to List of APIs added > Select an API > API details, and confirm the URL.

  3. You must request connections for any of your APIs that run on standalone instances that aren’t connected to Anypoint VPC.

  4. You check the extensions section of the error message for any details that may be useful in troubleshooting the error.

Other Runtime Errors

  • Can’t prettify an invalid query

    If you attempt to prettify an invalid query, DataGraph generates a syntax error. To resolve the issue, correct the syntax and then prettify the query.

  • Invalid action error

    If you perform an action in the DataGraph editor that creates an invalid schema, DataGraph generates an error. If you believe the action is valid, contact MuleSoft support.

Troubleshooting Schema Errors

If you encounter runtime errors when attempting to generate an API schema, troubleshoot them as follows.

Potential Errors When Generating an API Schema

When you add a new API to your unified schema, Anypoint DataGraph generates an API schema for it. However, not all features of an API specification are successfully generated into an API schema.

Anypoint DataGraph does not translate the following parts of an API specification into an API schema:

  • Requests with a Media type value other than application/json

  • Responses with a Media type value other than application/json

  • Response payloads with any of the unsupported types Schema, File, Tuple, Matrix, Nil, or arrays of any of the types

  • query params and headers with types other than scalars or scalar arrays

  • Endpoints of required params of unsupported types

  • union types with members other than objects and nils

  • JSON schema keywords if, then, and else

If your API specification is composed of only unsupported parts, Anypoint DataGraph does not generate an API schema and throws a Validation failed error.

Troubleshooting Errors When Adding, Updating, or Promoting APIs

If you encounter errors when adding, updating, or promoting APIs, troubleshoot them as follows:

  • Two users updated an environment at the same time error

    If two users attempt to update an environment at the same time, DataGraph generates an error for one of the users. If you receive the error, wait for any updates to complete and again.

  • Issue with action performed while editing an API error

    If you receive this error, try adding the API without editing to see if the edit actions created the problem.

  • Not enough capacity to deploy error

    DataGraph generates this error if your environment does not have the capacity available to create the unified schema. If you receive this error, request more capacity from your admin, or ask your operator to redistribute capacity within the organization.

Troubleshooting mTLS Errors

If you encounter mTLS errors, troubleshoot them as follows:

  • Uploading a file that cannot be read error

    This errors indicates that you uploaded a certificate file that is not in .pem format. Ensure the file is a valid .pem file and upload it again.

  • Trying to validate an invalid keystore error

    DataGraph generates this error if the private key or password does not match the certificate. Ensure the private key and certificate match or confirm the password.

  • Issue with TLS error

    This error occurs when trying to configure mTLS for an API that you’ve added to the unified schema. To troubleshoot this issue, add the API without configuring mTLS to determine if there is a problem with your TLS files.

Troubleshooting Access Errors

If you encounter errors when trying to access DataGraph, troubleshoot them as follows:

  • Access request not approved yet error

    If you encounter this error, request access from your admin.

  • Unauthorized error

    If you encounter this error, request authorization from your admin.

  • Too many requests error

    DataGraph generates this error if you attempt too many requests. In this case, wait some time and try your request again.

Troubleshooting Server Errors

If you encounter server errors, troubleshoot them as follows:

  • Server error when creating policies, contracts, tiers, and grant types

    If you encounter a server error when creating policies, contracts, tiers, or grant types, wait a few minutes and try again, or check the status of API Manager.

  • Server error when selecting asset

    If you encounter a server error when selecting an asset to create policies, wait a few minutes and try again, or check the status of Exchange.