# Integration with 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 <Btn>Organization Settings → API Keys</Btn>
obtain an API key:

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

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

Example configuration:

```toml
[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 <Btn>Logs</Btn> in Datadog and watch the logs coming:

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

### Exporting metrics

To export metrics to Datadog, use the same API key from
<Btn>Organization Settings → API Keys</Btn> 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
[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 <Btn>Metrics → Summary</Btn> 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]: /product/administration/deployment/monitoring
[ref-monitoring-integrations-conf]: /product/administration/deployment/monitoring#configuration
