This version of the OpenSearch documentation is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Search telemetry

You can use search telemetry to analyze search request performance by success or failure in OpenSearch Dashboards. OpenSearch stores telemetry data in the .kibana_1 index.

Because there are thousands of concurrent search requests from OpenSearch Dashboards, the heavy traffic can cause significant load in an OpenSearch cluster.

OpenSearch clusters perform better with search telemetry turned off.

Turning on search telemetry

Search usage telemetry is turned off by default. To turn it on, you need to set data.search.usageTelemetry.enabled to true in the opensearch_dashboards.yml file.

You can find the OpenSearch Dashboards YAML file in the opensearch-project repository on GitHub.

Turning on telemetry in the opensearch_dashboards.yml file overrides the default search telemetry setting of false in the Data plugin configuration file.

Turning search telemetry on or off

The following table shows the data.search.usageTelemetry.enabled values you can set in opensearch_dashboards.yml to turn search telemetry on or off.

OpenSearch Dashboards YAML valueSearch telemetry status: on or off
trueOn
falseOff
noneOff

Sample opensearch_dashboards.yml with telemetry enabled

This OpenSearch Dashboards YAML file excerpt shows the telemetry setting set to true to turn on search telemetry:

  1. # Set the value of this setting to false to suppress
  2. # search usage telemetry to reduce the load of the OpenSearch cluster.
  3. data.search.usageTelemetry.enabled: true