---
schema_version: "1"
id: cd5ad5e186d0eb5c78f99ade625c1ab3cc245487ea6277f485f771df715e2b91
title: Anypoint DataGraph Troubleshooting
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/datagraph/troubleshoot-schemas-queries.md
canonical_url: https://docs.mulesoft.com/datagraph/troubleshoot-schemas-queries
source_site: docs.mulesoft.com
content_type: documentation
content_hash: e2989d701fcf0e958d400ad430b5337352dedea7c5ee27f33324ded00e5db248
description: MuleSoft Documentation Site
latest: true
---
---
product: DataGraph
---

# Anypoint DataGraph Troubleshooting

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

The following topics provide useful information for troubleshooting in DataGraph:

- [Troubleshooting Runtime Errors](#troubleshooting-runtime-errors)

- [Troubleshooting Schema Errors](#troubleshooting-schema-errors)

- [Troubleshooting mTLS Errors](#troubleshooting-mtls-errors)

- [Troubleshooting Access Errors](#troubleshooting-access-errors)

- [Troubleshooting Server Errors](#troubleshooting-server-errors)

## 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](https://docs.mulesoft.com/datagraph/set-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](https://docs.mulesoft.com/datagraph/hosting-options#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](https://docs.mulesoft.com/cloudhub/to-request-vpc-connectivity) 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.

## See Also

- [Troubleshoot Queries With Response Logs](https://docs.mulesoft.com/datagraph/troubleshoot-query-logs)

- [Troubleshoot Query Performance with Query Tracing](https://docs.mulesoft.com/datagraph/troubleshoot-query-traces)

- [Resolving Conflicts and Merge Inconsistencies](https://docs.mulesoft.com/datagraph/resolve-conflicts)

- [Known Issues](https://help.salesforce.com/s/issues)
