Overview
Capistrano is a remote server automation and deployment tool written in Ruby.
Install the Capistrano Datadog integration to:
- Capture and search for deploy events in your event stream
- Overlay deploy events with other metrics within dashboards to identify which deploys affect your application’s performance
Once you enable this integration for a given Capfile, each Capistrano task that completes is submitted as an event to Datadog. Role information and logging output are submitted too.
Setup
Installation
Install the dogapi Ruby gem:
sudo gem install dogapi --version ">=1.10.0"
Configuration
Add the following to the beginning of any Capfile whose tasks you want to send to Datadog:
require "capistrano/datadog"
set :datadog_api_key, "${your_api_key}"
Validation
After you’ve configured your Capfile and have run at least one Capistrano task:
- Navigate to your events stream.
- Either enter
sources:capistrano in the Search bar, or click ‘Capistrano’ in the FROM list of integrations on the left. - Either enter
priority:all in the Search bar, or click ‘All’ in the PRIORITY list on the left. Capistrano tasks are submitted with Low priority by default, so they do not display using the default events stream view (Normal priority).
Data Collected
Metrics
The Capistrano integration does not include any metric.
Events
The Capistrano integration does not include any events.
Service Checks
The Capistrano integration does not include any service checks.
Troubleshooting
Need help? Contact Datadog support.
