Troubleshooting {{esql}} [esql-troubleshooting]

This section provides some useful resource for troubleshooting {{esql}} issues:

• {applies_to}stack: preview 9.4 {applies_to}serverless: unavailable Query logging: Log all query types, including {{esql}}, with a managed data stream (recommended)
• Legacy {{esql}} query log: Log {{esql}} queries using the older esql.querylog settings
• Task management API: Learn how to diagnose issues like long-running queries.
• Circuit breaker settings: Learn how {{esql}} uses the circuit breaker and how to configure it. For circuit breaker errors, see Circuit breaker errors.

::::{include} _snippets/common/query-performance-tip.md ::::

Filing a support case

When filing a support case for a slow or failing {{esql}} query, include the following information so the support team can investigate quickly:

• The full {{esql}} query text
• The cluster version, available from GET /
• The index pattern and approximate document count
• The time range covered by the query
• The fields and field types across all indices participating in the query, available from the field capabilities API
• The took value from the response
• Any error messages
• A query log entry, if query logging is enabled