---
title: Bonsai
description: Bonsai Managed Elasticsearch
breadcrumbs: Docs > Integrations > Bonsai
---

# Bonsai
Supported OS Integration version1.0.0
## Overview{% #overview %}

Track request level metrics for your Bonsai clusters to:

- Visualize the performance of your clusters
- Correlate search performance with application performance
- Create alerts



## Setup{% #setup %}

Integrating your cluster with Datadog requires submitting your API key to the bonsai app.

### Acquire API key{% #acquire-api-key %}

In Datadog, navigate to [Integrations –> API](https://app.datadoghq.com/organization-settings/api-keys) and copy your API Key.



### Submit API key{% #submit-api-key %}

Navigate to [Bonsai –> Clusters](https://app.bonsai.io/clusters) and click the cluster you want to integrate. Navigate to the Manage tab and scroll to the bottom of the page.

Under the "Datadog Integration" section paste your API key and click "Activate Datadog".



### Verify{% #verify %}

If your key is valid, you should see the integration as active.



Within a few minutes, request metrics are available in your Datadog dashboard.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **bonsai.req.2xx**(gauge)              | Number of requests with a 2xx (successful) response code*Shown as request*                      |
| **bonsai.req.4xx**(gauge)              | Number of requests with a 4xx (client error) response code*Shown as request*                    |
| **bonsai.req.5xx**(gauge)              | Number of requests with a 5xx (server error) response code*Shown as request*                    |
| **bonsai.req.max\_concurrency**(gauge) | Peak concurrent requests*Shown as connection*                                                   |
| **bonsai.req.p50**(gauge)              | The median request duration*Shown as minute*                                                    |
| **bonsai.req.p95**(gauge)              | The 95th percentile request duration*Shown as minute*                                           |
| **bonsai.req.p99**(gauge)              | The 99th percentile request duration*Shown as minute*                                           |
| **bonsai.req.queue\_depth**(gauge)     | Peak queue depth (how many requests are waiting due to concurrency limits)*Shown as connection* |
| **bonsai.req.reads**(gauge)            | The number of requests which read data*Shown as request*                                        |
| **bonsai.req.rx\_bytes**(gauge)        | The number of bytes sent to elasticsearch*Shown as byte*                                        |
| **bonsai.req.total**(gauge)            | The total number of requests*Shown as request*                                                  |
| **bonsai.req.tx\_bytes**(gauge)        | The number of bytes sent to client*Shown as byte*                                               |
| **bonsai.req.writes**(gauge)           | The total number of writes*Shown as request*                                                    |

Metrics are tagged for each cluster, so you can segment based on clusters. The tags look like:

```text
cluster:my-cluster-slug
```

### Events{% #events %}

The Bonsai integration does not include any events.

### Service Checks{% #service-checks %}

The Bonsai integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog Support](https://docs.datadoghq.com/help/).