Connector logs

This document describes logs for managed connectors and self-managed connectors.

Enable logs

Elastic Cloud

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 connectors

Note that self-managed deployments and self-managed connector 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

You can view logs in Kibana.

You can filter by service.type:

  • enterprise-search
  • connectors

Logs reference

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.