---
title: Convox
description: Convox is an open-source PaaS designed for total privacy and zero upkeep.
breadcrumbs: Docs > Integrations > Convox
---

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

Get metrics from Convox in real time to visualize your containers' performance.



## Setup{% #setup %}

See the [Convox documentation](https://docs.convox.com/integrations/monitoring/datadog) to set up the Datadog integration.

### Deploy the Datadog Agent{% #deploy-the-datadog-agent %}

You can deploy the Datadog Agent as a Convox app by using a `docker-compose.yml` manifest. Use a `count` that matches the `InstanceCount` parameter of your Rack.

```shell
# check out the repo
$ git clone https://github.com/convox-examples/datadog.git
$ cd dd-agent

# deploy the agent app and secret
$ convox apps create
$ convox env set DD_API_KEY=<your api key>
$ convox deploy
$ convox scale agent --count=3 --cpu=10 --memory=128
```

Run `convox deploy` to deploy Datadog Agent into ECS.

### Auto scaling{% #auto-scaling %}

If autoscaling is enabled on your Rack, you need to dynamically scale the Datadog Agent count to match the Rack instance count.

For more information, see the [Listening for ECS CloudWatch Events](http://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_cwet.html) tutorial.

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

### Metrics{% #metrics %}

The Convox integration does not include any metrics.

### Events{% #events %}

The Convox integration does not include any events.

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

The Convox integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

When configuring environment variables in the `convox.yml` file, the `environment` parameter must be defined on the same level as the `services` parameter.



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

## Further Reading{% #further-reading %}

- [Monitor your AWS ECS platform with Convox and Datadog](https://www.datadoghq.com/blog/monitor-aws-ecs-convox-integration/)