---
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
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}

## 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/)