Connector logs

edit

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

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 connectors
edit

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

edit

You can 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.