Connector logsedit

This document describes logs for native connectors and connector clients.

Enable logsedit

Elastic Cloudedit

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 clientsedit

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 logsedit

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

You can filter by service.type:

  • enterprise-search
  • connectors

Logs referenceedit

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.