› › ›

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.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/es-connectors-logs.html