# ROI Metrics Data (Enterprise)
Available in PagerDuty Process Automation Commercial products.
Incubating: This Feature or API is new! We may still have a few bugs or change some functionality in the future.
Automation provides value with each execution of a job. A job can save time, dollars, and most likely a combination of both. The ROI (return on investment) Metrics integration will help track the user-defined value of each job execution. ROI Metrics Data stores arbitrary key value pairs against your job to help understand your ROI per job execution. The metrics will be stored against the each execution of the job, and accessible via API for further analysis. There is also relevant default execution data to help you further understand your savings.
Currently, the data for this feature is stored as file based logs. To ensure resiliency please be sure that a LogStore is configured to backup the files.
# Configuring ROI Metrics
The values stored are unique entries chosen by the user. The values are abstracted from a specific metric type (hours, dollars, etc.) to allow customers to define their own ROI metrics. Follow these steps when editing a job to configure ROI Metrics:
- Choose the Execution Plugins tab.
- Check the box for ROI Metrics Data.
- Click Add Custom Field.
- Enter a value for:
- Field Label: This is the friendly name of the field that will be shown when picking a value
- Field Key: This is the name of the field used in the programmatic output.
- Description: (Optional) A description of the field value.
For simplified gathering later we suggest no spaces or special characters in the "Field Key".
- Click Add.
- Enter a value for the metric as an integer or decimal in the field shown.
- Save the job.
# Gathering ROI Metrics
When the Job is Executed a new Log Output screen called ROI Metrics Data will be shown when the job is complete.
Selecting that tab will show a table view of the ROI Metrics. In the example shown we can see the value provided along with the following metrics included by default:
- Job Duration (in seconds)
- Job Execution Time (UTC)
- Job ID
- Execution ID
The data is also available in JSON format both in the UI and from an API endpoint. Use our API Guide to access the data.
For a walk-through of how the ROI Metrics Data may be used and an example job that will help in gathering ROI metric data check out this Learning Article.