Set up Datadog for Leapwork Performance

This guide shows you how to connect Leapwork Performance to Datadog so you can monitor run results with Datadog dashboards. You will create an API key, configure the connection, and verify that metrics flow into Datadog.

Use this guide when you want to send Leapwork Performance run data latency, throughput, error rates, and status codes to Datadog for visualization and alerting.

Prerequisites

Before you begin, make sure you have:

• A Datadog account

• A Datadog API key (or the ability to create one)

• A Leapwork Performance company with access to Settings → App Monitoring

• At least one completed run in Leapwork Performance (for validation)

Create a Datadog API key

1. Open Organization Settings in Datadog.

2. Select API Keys.

3. Select New Key.

4. Copy the full API key immediately — you cannot retrieve it later.

Note: Leapwork Performance requires a Datadog API Key, not an Application Key. Use the Datadog site that matches your account region — for example, datadoghq.com (US) or datadoghq.eu (EU).

Add the Datadog connection in Leapwork Performance

1. Open Settings → App Monitoring in Leapwork Performance.

2. Select the Datadog APM provider tile.

3. Fill in the connection details using the values below.

4. Select Save.

Recommended values

Example stored configuration:

{
  "site": "datadoghq.eu",
  "apiKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "defaultTags": ["env:prod", "team:perf"],
  "metricNamespace": "lp.run_results"
}

Understand how publishing works

Leapwork Performance publishes metrics to Datadog automatically when a run reaches a terminal state: Finished, Stopped, or Failed.

The backend checks whether your company has an enabled Datadog connection. If it does, Leapwork Performance sends metrics to:

https://api.<site>/api/v1/series

For example:

https://api.datadoghq.eu/api/v1/series

Metric catalog

Leapwork Performance publishes the following metric groups.

Per-step terminal metrics

These metrics are emitted for each step in each selected track item after a run completes.

Run-level summary metrics

These metrics are emitted once per run from the weighted summary data.

Track-item summary metrics

These metrics are emitted from aggregated track-item statistics.

Historical timeseries metrics

These metrics are emitted from historical run_data graph points so Datadog can display the run over time.

Status-code breakdown metrics

These metrics are emitted from aggregated step status-code counts.

Tags added to metrics

Leapwork Performance adds tags to every metric so you can filter, group, and build dashboards.

Base tags

These tags appear on most or all published metrics.

Step-level tags

These tags appear on per-step metrics.

Track-item and status-code tags

These tags appear where applicable.

Default tags

Any default tags you configured on the connection are also attached. For example:

• env:prod

• team:perf

Example metrics and tags

Per-step metric

metric: lp.run_results.latency.p95_ms
value: 821
tags:
  run_id:r8_ynth
  run_status:finished
  company_id:v_smt_rpx
  project_id:abc123
  timeline_asset_id:new_timeline
  timeline_name:new_timeline
  track_item_id:track1
  step_id:step_login
  step_title:login
  track_item_selected:true
  geo_location:northeurope
  env:prod
  team:perf

Run summary metric

metric: lp.run_results.run.peak_throughput
value: 642
tags:
  run_id:r8_ynth
  run_status:finished
  company_id:v_smt_rpx
  project_id:abc123
  timeline_asset_id:new_timeline
  timeline_name:new_timeline

Track-item summary metric

metric: lp.run_results.track_item.vum_used
value: 150
tags:
  run_id:r8_ynth
  run_status:finished
  company_id:v_smt_rpx
  project_id:abc123
  timeline_name:new_timeline

Timeseries metric

metric: lp.run_results.timeseries.latency.avg_ms
value: 412
timestamp: 1713701900
tags:
  run_id:r8_ynth
  run_status:finished
  company_id:v_smt_rpx
  project_id:abc123
  timeline_name:new_timeline
  track_item_id:track1
  geo_location:northeurope

Status-code metric

metric: lp.run_results.status_code.count
value: 638
tags:
  run_id:r8_ynth
  run_status:finished
  company_id:v_smt_rpx
  project_id:abc123
  timeline_name:new_timeline
  track_item_id:track1
  step_id:step_login
  step_title:login
  status_code:200
  geo_location:northeurope

Validate that Leapwork Performance is publishing

Check Leapwork Performance logs

Look for log entries from RushRunner:

• Success: Published ... Datadog series for run ...

• Failure: Failed to publish run ... to Datadog

Check Datadog API key usage

Open API Keys in Datadog. Your key should show usage after Leapwork Performance publishes metrics.

Check Datadog Metrics Explorer

Search for any of these metrics to confirm data is arriving:

• lp.run_results.latency.avg_ms

• lp.run_results.run.latency.p95_ms

• lp.run_results.timeseries.requests_per_second

• lp.run_results.status_code.count

Create a Datadog dashboard

Create the dashboard

1. Open Dashboards in Datadog.

2. Select New Dashboard.

3. Enter a name — for example, Leapwork Performance Dashboard.

Recommended widgets

Widget 1 — Run P95 latency

• Widget type: Timeseries

• Metric: lp.run_results.run.latency.p95_ms

Widget 2 — Run average latency

• Widget type: Timeseries

• Metric: lp.run_results.run.latency.avg_ms

Widget 3 — Run peak throughput

• Widget type: Query Value or Timeseries

• Metric: lp.run_results.run.peak_throughput

Widget 4 — Run error rate

• Widget type: Query Value or Timeseries

• Metric: lp.run_results.run.error_rate_pct

Widget 5 — Step latency

• Widget type: Timeseries

• Metric: lp.run_results.latency.p95_ms

• Group by: step_title

Widget 6 — Status-code table

• Widget type: Top List, Table, or Bar Chart

• Metric: lp.run_results.status_code.count

• Group by: status_code

Widget 7 — Track-item throughput over time

• Widget type: Timeseries

• Metric: lp.run_results.timeseries.requests_per_second

• Group by: track_item_id

Widget 8 — Track-item latency over time

• Widget type: Timeseries

• Metric: lp.run_results.timeseries.latency.avg_ms

• Group by: track_item_id

Recommended dashboard filters

Add dashboard template variables for:

• run_status

• timeline_name

• project_id

• track_item_id

• geo_location

• status_code

Note: run_id is high-cardinality and may not display well as a dashboard variable. Use it as a widget-level filter when investigating a specific run.

Example widget queries

Run P95 latency

avg:lp.run_results.run.latency.p95_ms{*}

Step P95 latency by step title

avg:lp.run_results.latency.p95_ms{*} by {step_title}

Requests per second by track item

avg:lp.run_results.timeseries.requests_per_second{*} by {track_item_id}

Status-code counts by code

sum:lp.run_results.status_code.count{*} by {status_code}

Understand graph differences

Leapwork Performance front-end graphs use custom scaling for some overlays. Datadog charts do not reproduce that scaling automatically.

Differences you may notice:

• Leapwork Performance can scale latency and throughput independently on the same chart.

• Datadog Timeseries widgets plot real metric values on the Y-axis.

• Two different units may look visually different in Datadog — this is expected.

To work around this:

• Use separate widgets for latency and throughput.

• Use Datadog formulas or normalization for visualization-only graphs.

Troubleshooting

Datadog connection is missing apiKey

Symptom: Publishing fails with an error about a missing API key.

Likely cause: JSON property casing mismatch or the API key was not saved in the connection configuration.

Fix:

1. Open the stored connection configuration.

2. Confirm it contains the apiKey property.

3. Confirm the backend deserializes the configuration case-insensitively.

Metrics not visible in Datadog

Check these in order:

1. The Datadog connection is enabled in Leapwork Performance.

2. The Site value is correct — for example, datadoghq.eu.

3. The API key is valid.

4. A Leapwork Performance run has completed.

5. RushRunner logs show a successful publish.

Dashboard filter tags do not appear

Datadog does not always surface custom metric tags immediately.

Try these steps:

1. Complete another run in Leapwork Performance.

2. Wait a few minutes for Datadog to index the tags.

3. Reopen the dashboard variable editor.

4. Use widget-level tag filters if the dashboard variable still does not show the tag.