> ## Documentation Index
> Fetch the complete documentation index at: https://cubed3-feat-druid-driver-streaming.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration with Datadog

> Datadog is a popular fully managed observability service. This guide demonstrates how to set up Cube Cloud to export logs and metrics to Datadog.

[Datadog][datadog] is a popular fully managed observability service. This guide
demonstrates how to set up Cube Cloud to export logs and metrics to Datadog.

## Configuration

First, enable [monitoring integrations][ref-monitoring-integrations] in Cube
Cloud.

### Exporting logs

To export logs to Datadog, go to **Organization Settings → API Keys**
obtain an API key:

<Frame>
  <img src="https://ucarecdn.com/d4703748-aea9-4d74-bac2-febe13c604c6/" />
</Frame>

Then, configure the [`datadog_logs`][vector-datadog-logs] sink in your
[`vector.toml` configuration file][ref-monitoring-integrations-conf].

Example configuration:

```toml theme={null}
[sinks.datadog_logs]
type = "datadog_logs"
inputs = [
  "cubejs-server",
  "refresh-scheduler",
  "warmup-job",
  "cubestore"
]
default_api_key = "$CUBE_CLOUD_MONITORING_DATADOG_API_KEY"
site = "datadoghq.eu"
compression = "gzip"
healthcheck = false
```

Note that Datadog accounts belong to specific [sites][datadog-docs-sites]
throughout the world. Use the `site` option to configure the sink appropriately.
When miscofigured, Vector agent outputs the following error:
`Client request was forbidden`.

Commit the configuration for Vector, it should take effect in a minute. Then,
navigate to **Logs** in Datadog and watch the logs coming:

<Frame>
  <img src="https://ucarecdn.com/5e66f3d6-85a7-498c-89e8-41632d1b184c/" />
</Frame>

### Exporting metrics

To export metrics to Datadog, use the same API key from
**Organization Settings → API Keys** as configured for logs.

Then, configure the [`datadog_metrics`][vector-datadog-metrics] sink in your
[`vector.toml` configuration file][ref-monitoring-integrations-conf].

Example configuration:

```toml theme={null}
[sinks.datadog_metrics]
type = "datadog_metrics"
inputs = [
  "metrics"
]
default_api_key = "$CUBE_CLOUD_MONITORING_DATADOG_API_KEY"
site = "datadoghq.eu"
```

Again, upon commit the configuration for Vector should take effect in a minute. Then,
navigate to **Metrics → Summary** in Datadog and explore the available
metrics. Cube metrics are prefixed with `cube_`, such as `cube_cpu_usage_ratio`,
`cube_memory_usage_ratio`, and `cube_requests_total`.

[datadog]: https://www.datadoghq.com

[datadog-docs-sites]: https://docs.datadoghq.com/getting_started/site/

[vector-datadog-logs]: https://vector.dev/docs/reference/configuration/sinks/datadog_logs/

[vector-datadog-metrics]: https://vector.dev/docs/reference/configuration/sinks/datadog_metrics/

[ref-monitoring-integrations]: /admin/monitoring/monitoring-integrations

[ref-monitoring-integrations-conf]: /admin/monitoring/monitoring-integrations#configuration