IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Troubleshooting connectors Connector Scalability »
Elastic Docs › ›Elastic connectors ›Management topics

Connector logs

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Connector logs

edit

This document describes logs for native connectors and connector clients.

Enable logs

edit
Elastic Cloud
edit

Elastic Cloud users need to enable logging to view connector logs. Go to Cloud > Deployment > your-deployment > Logs and metrics to enable logs.

Once enabled, you can view logs in Kibana.

Configure the log_level user setting for Enterprise Search. See Add Enterprise Search user settings in the Elastic Cloud documentation.

Self-managed connector clients
edit

Note that self-managed deployments and connector client logs are written to STDOUT.

Self-managed connectors have the following logging options:

  • Use the service.log_level setting in your connector service configuration file to specify the log level for the service.

    • Enable elasticsearch.bulk.enable_operations_logging to log the result of sending documents to Elasticsearch from connectors, for auditing and debugging. This setting depends on the service.log_level and will be logged at DEBUG level .
  • Use the elasticsearch.log_level setting to specify the log level for the Elasticsearch client used by the connector service.

View connector logs

edit

See View and query logs to learn how to view logs in Kibana.

You can filter by service.type:

  • enterprise-search
  • connectors

Logs reference

edit

Logs use Elastic Common Schema (ECS), without extensions. See the ECS Reference for more information.

The fields logged are:

  • @timestamp
  • log.level
  • ecs.version
  • labels.index_date
  • tags
  • log.logger
  • service.type
  • service.version
  • process.name
  • process.pid
  • process.thread.id

See Logging in the Elasticsearch documentation for more information.

« Troubleshooting connectors Connector Scalability »