Elastic Docs › ›Elastic connectors
« Using connectors Troubleshooting connectors »

Connector known issuesedit

Enterprise Search service: connector clientsedit

As of 8.10.0 self-managed connector clients no longer require the Enterprise Search service to be running on your Elastic deployment. However, if you are upgrading connectors from versions earlier than 8.9, you’ll need to run Enterprise Search once to migrate your connectors to the new format. If you have trouble with this migration, please contact support.

To run connector clients your self-deployed connector service version must match your Elasticsearch version. For example, if you’re running Elasticsearch 8.10.1, your connector service should be version 8.10.1.x. Elastic does not support deployments running mismatched versions (except during upgrades).

Connector serviceedit

The connector service has the following known issues:

  • The connector service does not work with traffic filters.

    To use the connector service, you must disable traffic filters. This known issue will be fixed in a future release.

  • The connector service will fail to sync when the connector tries to fetch more more than 2,147,483,647 (2^31-1) documents from a data source

    A workaround is to manually partition the data to be synced using multiple search indices.

  • Custom scheduling might break when upgrading from version 8.6 or earlier.

    Use the following manual workaround:

    POST /.elastic-connectors/_update/<connector-id>
{
  "doc": {
    "custom_scheduling": {}
  }
}

  • Connectors upgrading from 8.7 or earlier can be missing configuration fields

    A connector that was created prior to 8.8 can sometimes be missing configuration fields. This is a known issue for the MySQL connector but could also affect other connectors.

    If the connector client raises the error Connector for <connector_id> has missing configuration fields: <field_a>, <field_b>..., you can resolve the error by manually adding the missing configuration fields via the Dev Tools. Only the following two field properties are required, as the rest will be autopopulated by the connector client:

    • type: one of str, int, bool, or list

    • value: any value, as long as it is of the correct type (list type values should be saved as comma-separated strings)

      POST /.elastic-connectors/_update/<connector_id>
{
  "doc" : {
    "configuration": {
      <field_a>: {
        "type": "str",
        "value": ""
      },
      <field_b>: {
        "type": "bool",
        "value": false
      },
      <field_c>: {
        "type": "int",
        "value": 1
      },
      <field_d>: {
        "type": "list",
        "value": "a,b"
      }
    }
  }
}

  • Python connectors that upgraded from *8.7.1 will report document volumes in gigabytes (GB) instead of megabytes (MB)*

    As a result, true document volume will be under-reported by a factor of 1024.

Individual connector known issuesedit

Individual connectors may have additional known issues. Refer to each connector’s reference documentation for connector-specific known issues.

Workplace Search connector known issuesedit

For Workplace Search connectors, see the Workplace Search documentation.

« Using connectors Troubleshooting connectors »