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 sends Terraform run execution event 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
The Scalr integration is not included in the Datadog Agent package, so you need to install it.
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 to install it with the Docker Agent or earlier versions of the Datadog Agent.
Run the following command to install the Agent integration:
datadog-agent integration install -t datadog-scalr==1.0.0
Configure your integration similar to an Agent-based integration.
Configuration
Edit the scalr.d/conf.yaml file in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your Scalr metrics. See the sample scalr.d/conf.yaml for all available configuration options.
Restart the Agent.
Validation
Run the Agent’s status subcommand and look for scalr under the Checks section.
Data Collected
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 |
Events
Scalr sends run execution results as an event to the Events Explorer.
Troubleshooting
Need help? Contact Datadog support or Scalr support.
Further Reading
