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 »

› › ›

Connector logs

edit

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 »