---
title: Scalr
description: Scalr is a Terraform Automation and COllaboration (TACO) product
breadcrumbs: Docs > Integrations > Scalr
---

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

Scalr is a terraform cloud alternative that provides you with the controls, visibility, and flexibility to decentralize your terraform operations in one place.

The Scalr [integration](https://docs.scalr.com/en/latest/integrations.html) sends Terraform run execution [event](https://docs.datadoghq.com/events/) details and metrics for in-depth analysis and reporting such as queue runs, queue state, the number of environments, and workspace count. These metrics are visualized in their out-of-the-box dashboard to help correlate deployments with other infrastructure changes and to track trends within your Terraform pipeline.

## Setup{% #setup %}

The Scalr integration is not included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package, so you need to install it.

### Installation{% #installation %}

For the Datadog Agent v7.21 or v6.21 and later, follow these instructions to install the Scalr integration on your host. See [Use Community Integrations](https://docs.datadoghq.com/agent/guide/use-community-integrations/) to install it with the Docker Agent or earlier versions of the Datadog Agent.

1. Run the following command to install the Agent integration:

   ```shell
   datadog-agent integration install -t datadog-scalr==1.0.0
   ```

1. Configure your integration similar to an Agent-based [integration](https://docs.datadoghq.com/getting_started/integrations/).

### Configuration{% #configuration %}

1. Edit the `scalr.d/conf.yaml` file in the `conf.d/` folder at the root of your [Agent's configuration directory](https://docs.datadoghq.com/agent/guide/agent-configuration-files/#agent-configuration-directory) to start collecting your Scalr metrics. See the [sample scalr.d/conf.yaml](https://github.com/DataDog/integrations-extras/blob/master/scalr/datadog_checks/scalr/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands/#start-stop-and-restart-the-agent).

### Validation{% #validation %}

Run the [Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands/#service-status) and look for `scalr` under the Checks section.

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

### Metrics{% #metrics %}

|  |
|  |
| **scalr.environments.count**(gauge)               | The number of environments.*Shown as unit*               |
| **scalr.workspaces.count**(gauge)                 | The number of workspaces.*Shown as unit*                 |
| **scalr.runs.count**(gauge)                       | The number of runs.*Shown as unit*                       |
| **scalr.runs.successful**(gauge)                  | The number of successful runs.*Shown as unit*            |
| **scalr.runs.failed**(gauge)                      | The number of failed runs.*Shown as unit*                |
| **scalr.runs.awaiting\_confirmation**(gauge)      | The number of runs awaiting confirmation.*Shown as unit* |
| **scalr.runs.concurrency**(gauge)                 | The number of current concurrent runs.*Shown as unit*    |
| **scalr.runs.queue\_size**(gauge)                 | The number of runs in a queue.*Shown as unit*            |
| **scalr.quota.max\_concurrency**(gauge)           | The number of maximum parallel runs.*Shown as unit*      |
| **scalr.billing.runs.count**(gauge)               | The number of billing runs.*Shown as unit*               |
| **scalr.billing.run\_minutes.count**(gauge)       | The number of billing minutes.*Shown as unit*            |
| **scalr.billing.flex\_runs.count**(gauge)         | The number of billing flex runs.*Shown as unit*          |
| **scalr.billing.flex\_run\_minutes.count**(gauge) | The number of billing flex runs minutes.*Shown as unit*  |

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

**scalr.can\_connect**

Returns `CRITICAL` if the Agent can't connect to the Scalr endpoint, OK otherwise

*Statuses: ok, critical*

### Events{% #events %}

Scalr sends run execution results as an event to the [Events Explorer](https://docs.datadoghq.com/events/explorer/).

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/) or [Scalr support](https://scalr-labs.atlassian.net/servicedesk/customer/portal/31).